Dies ist der AWS CDK v2-Entwicklerhandbuch. Das ältere CDK v1 wurde am 1. Juni 2022 in die Wartung aufgenommen und der Support wurde am 1. Juni 2023 eingestellt.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Tutorial: Erstelle deine erste AWS CDK-App
Beginnen Sie mit der Verwendung des AWS Cloud Development Kit (AWS CDK), indem Sie die AWS CDK-Befehlszeilenschnittstelle (AWS CDK CLI) verwenden, um Ihre erste CDK-App zu entwickeln, Ihre AWS Umgebung zu booten und Ihre Anwendung darauf bereitzustellen. AWS
Voraussetzungen
Bevor Sie mit diesem Tutorial beginnen, führen Sie alle Einrichtungsschritte unter Erste Schritte mit dem CDK durch. AWS
Über dieses Tutorial
In diesem Tutorial werden Sie AWS mithilfe des AWS CDK eine einfache Anwendung erstellen und bereitstellen. Die Anwendung besteht aus einer AWS Lambda-Funktion, die beim Aufruf eine Hello World!
Nachricht zurückgibt. Die Funktion wird über eine Lambda-Funktions-URL aufgerufen, die als dedizierter HTTP (S) -Endpunkt für Ihre Lambda-Funktion dient.
In diesem Tutorial werden Sie Folgendes ausführen:
-
Erstellen Sie Ihr Projekt — Erstellen Sie ein CDK-Projekt mit dem
cdk init
CDK-CLI-Befehl. -
Konfiguration Ihrer AWS Umgebung — Konfigurieren Sie die AWS Umgebung, in der Sie Ihre Anwendung bereitstellen werden.
-
Bootstrap für Ihre AWS Umgebung — Bereiten Sie Ihre AWS Umgebung für die Bereitstellung vor, indem Sie sie mit dem CDK-CLI-Befehl bootstrappen.
cdk bootstrap
-
Entwickeln Sie Ihre App — Verwenden Sie Konstrukte aus der AWS Construct-Bibliothek, um Ihre Lambda-Funktions- und Lambda-Funktions-URL-Ressourcen zu definieren.
-
Bereiten Sie Ihre App für die Bereitstellung vor — Verwenden Sie die CDK-CLI, um Ihre App zu erstellen und eine AWS CloudFormation Vorlage zu synthetisieren.
-
Stellen Sie Ihre App bereit — Verwenden Sie den
cdk deploy
CDK-CLI-Befehl, um Ihre Anwendung bereitzustellen und Ihre AWS Ressourcen bereitzustellen. -
Interagieren Sie mit Ihrer Anwendung — Interagieren Sie mit Ihrer bereitgestellten Lambda-Funktion, AWS indem Sie sie aufrufen und eine Antwort erhalten.
-
Ändern Sie Ihre App — Ändern Sie Ihre Lambda-Funktion und stellen Sie sie bereit, um Ihre Änderungen zu implementieren.
-
App löschen — Löscht alle Ressourcen, die Sie mit dem
cdk destroy
CDK-CLI-Befehl erstellt haben.
Schritt 1: Erstellen Sie Ihr CDK-Projekt
In diesem Schritt erstellen Sie ein neues CDK-Projekt. Ein CDK-Projekt sollte sich in einem eigenen Verzeichnis mit eigenen lokalen Modulabhängigkeiten befinden.
- Um ein CDK-Projekt zu erstellen
-
-
Erstellen Sie von einem Startverzeichnis Ihrer Wahl aus ein Verzeichnis mit dem Namen
hello-cdk
:$ mkdir hello-cdk && cd hello-cdk
Wichtig
Achten Sie darauf, dass Sie Ihr Projektverzeichnis genau so benennen
hello-cdk
, wie hier gezeigt. Die CDK-CLI verwendet diesen Verzeichnisnamen, um Dinge in Ihrem CDK-Code zu benennen. Wenn Sie einen anderen Verzeichnisnamen verwenden, werden Sie in diesem Tutorial auf Probleme stoßen. -
Initialisieren Sie im
hello-cdk
Verzeichnis ein neues CDK-Projekt mit dem CDK-CLI-Befehl.cdk init
Geben Sie dieapp
Vorlage und Ihre bevorzugte Programmiersprache mit der Option an:--language
-
Der cdk init
Befehl erstellt eine Struktur von Dateien und Ordnern innerhalb des hello-cdk
Verzeichnisses, um den Quellcode für Ihre CDK-App zu organisieren. Diese Struktur von Dateien und Ordnern wird Ihr CDK-Projekt genannt. Nehmen Sie sich einen Moment Zeit, um Ihr CDK-Projekt zu erkunden.
Wenn Sie es Git installiert haben, cdk init
wird jedes Projekt, mit dem Sie erstellen, auch als Git Repository initialisiert.
Während der Projektinitialisierung erstellt die CDK-CLI eine CDK-App, die einen einzelnen CDK-Stack enthält. Die CDK-App-Instanz wird mit dem Konstrukt erstellt. App
Im Folgenden finden Sie einen Teil dieses Codes aus Ihrer CDK-Anwendungsdatei:
Der CDK-Stack wird mit dem Stack
Konstrukt erstellt. Im Folgenden finden Sie einen Teil dieses Codes aus Ihrer CDK-Stack-Datei:
Schritt 2: Konfigurieren Sie Ihre AWS Umgebung
In diesem Schritt konfigurieren Sie die AWS Umgebung für Ihren CDK-Stack. Auf diese Weise geben Sie an, in welcher Umgebung Ihr CDK-Stack bereitgestellt wird.
Bestimmen Sie zunächst die AWS Umgebung, die Sie verwenden möchten. Eine AWS Umgebung besteht aus einem AWS Konto und einer AWS Region.
Wenn Sie die AWS CLI verwenden, um Sicherheitsanmeldeinformationen auf Ihrem lokalen Computer zu konfigurieren, können Sie dann die AWS CLI verwenden, um AWS Umgebungsinformationen für ein bestimmtes Profil abzurufen.
- So verwenden Sie die AWS CLI, um Ihre AWS Konto-ID abzurufen
-
-
Führen Sie den folgenden AWS CLI-Befehl aus, um die AWS Konto-ID für Ihr
default
Profil abzurufen:$ aws sts get-caller-identity --query "Account" --output text
-
Wenn Sie lieber ein benanntes Profil verwenden möchten, geben Sie den Namen Ihres Profils mit der
--profile
Option an:$ aws sts get-caller-identity --profile your-profile-name --query "Account" --output text
-
- So verwenden Sie die AWS CLI, um Ihre AWS Region abzurufen
-
-
Führen Sie den folgenden AWS CLI-Befehl aus, um die Region abzurufen, die Sie für Ihr
default
Profil konfiguriert haben:$ aws configure get region
-
Wenn Sie lieber ein benanntes Profil verwenden möchten, geben Sie den Namen Ihres Profils mit der
--profile
Option an:$ aws configure get region --profile your-profile-name
-
Als Nächstes konfigurieren Sie die AWS Umgebung für Ihren CDK-Stack, indem Sie die HelloCdkStack
Instanz in Ihrer Anwendungsdatei ändern. Für dieses Tutorial werden Sie Ihre AWS Umgebungsinformationen fest codieren. Dies wird für Produktionsumgebungen empfohlen. Informationen zu anderen Methoden zur Konfiguration von Umgebungen finden Sie unter Umgebungen für die Verwendung mit dem AWS CDK konfigurieren.
- So konfigurieren Sie die Umgebung für Ihren CDK-Stack
-
-
Verwenden Sie in Ihrer Anwendungsdatei die
env
Eigenschaft desStack
Konstrukts, um Ihre Umgebung zu konfigurieren. Im Folgenden wird ein Beispiel gezeigt:
-
Schritt 3: Bootstrap für Ihre Umgebung AWS
In diesem Schritt booten Sie die AWS Umgebung, die Sie im vorherigen Schritt konfiguriert haben. Dadurch wird Ihre Umgebung auf CDK-Bereitstellungen vorbereitet.
Um Ihre Umgebung zu booten, führen Sie im Stammverzeichnis Ihres CDK-Projekts Folgendes aus:
$ cdk bootstrap
Wenn Sie das Bootstrapping vom Stammverzeichnis Ihres CDK-Projekts aus durchführen, müssen Sie keine zusätzlichen Informationen angeben. Die CDK-CLI bezieht Umgebungsinformationen aus Ihrem Projekt. Wenn Sie außerhalb eines CDK-Projekts booten, müssen Sie Umgebungsinformationen mit dem Befehl angeben. cdk bootstrap
Weitere Informationen finden Sie unter Bootstrap für Ihre Umgebung zur Verwendung mit dem CDK. AWS
Schritt 4: Erstellen Sie Ihre CDK-App
In den meisten Programmierumgebungen erstellen oder kompilieren Sie Code, nachdem Sie Änderungen vorgenommen haben. Dies ist beim AWS CDK nicht erforderlich, da die CDK-CLI diesen Schritt automatisch durchführt. Sie können jedoch immer noch manuell bauen, wenn Sie Syntax- und Typfehler abfangen möchten. Im Folgenden wird ein Beispiel gezeigt:
Schritt 5: Listet die CDK-Stacks in eurer App auf
Zu diesem Zeitpunkt sollten Sie über eine CDK-App verfügen, die einen einzelnen CDK-Stack enthält. Verwenden Sie zur Überprüfung den cdk list
CDK-CLI-Befehl, um Ihre Stacks anzuzeigen. Die Ausgabe sollte einen einzelnen Stack mit dem Namen anzeigen: HelloCdkStack
$ cdk list HelloCdkStack
Wenn Sie diese Ausgabe nicht sehen, stellen Sie sicher, dass Sie sich im richtigen Arbeitsverzeichnis Ihres Projekts befinden, und versuchen Sie es erneut. Wenn Sie Ihren Stack immer noch nicht sehen, wiederholen Sie Schritt 1: Erstellen Sie Ihr CDK-Projekt und versuchen Sie es erneut.
Schritt 6: Definieren Sie Ihre Lambda-Funktion
In diesem Schritt importieren Sie das aws_lambda
Modul aus der Construct-Bibliothek und verwenden das AWS Function
L2-Konstrukt.
Ändern Sie Ihre CDK-Stack-Datei wie folgt:
Schauen wir uns das Function
Konstrukt genauer an. Wie alle Konstrukte benötigt die Function
Klasse drei Parameter:
-
scope — Definiert Ihre
Stack
Instanz als übergeordnetes Objekt desFunction
Konstrukts. Alle Konstrukte, die AWS Ressourcen definieren, werden innerhalb des Gültigkeitsbereichs eines Stacks erstellt. Sie können Konstrukte innerhalb von Konstrukten definieren und so eine Hierarchie (Baum) erstellen. Hier und in den meisten Fällen ist der Geltungsbereichthis
(self
in Python). -
Id — Die Konstrukt-ID von
Function
in Ihrer AWS CDK-App. Diese ID sowie ein Hash, der auf der Position der Funktion innerhalb des Stacks basiert, identifizieren die Funktion während der Bereitstellung eindeutig. Das AWS CDK verweist auch auf diese ID, wenn Sie das Konstrukt in Ihrer App aktualisieren und erneut bereitstellen, um die bereitgestellte Ressource zu aktualisieren. Hier lautet Ihre Konstrukt-ID.HelloWorldFunction
Funktionen können auch einen Namen haben, der mit derfunctionName
Eigenschaft angegeben wird. Dies unterscheidet sich von der Konstrukt-ID. -
props — Ein Bündel von Werten, die Eigenschaften der Funktion definieren. Hier definieren Sie die
code
Eigenschaftenruntime
handler
, und.Requisiten werden in den vom AWS CDK unterstützten Sprachen unterschiedlich dargestellt.
-
In TypeScript und
props
steht für ein einzelnes Argument JavaScript, und Sie übergeben ein Objekt, das die gewünschten Eigenschaften enthält. -
In Python werden Requisiten als Schlüsselwortargumente übergeben.
-
In Java wird ein Builder bereitgestellt, um die Requisiten zu übergeben. Es gibt zwei: einen dafür und einen zweiten
FunctionProps
,Function
damit Sie das Konstrukt und das zugehörige Requisitenobjekt in einem Schritt erstellen können. Dieser Code verwendet Letzteres. -
In C# instanziieren Sie ein
FunctionProps
Objekt mithilfe eines Objektinitialisierers und übergeben es als dritten Parameter.Wenn die Requisiten eines Konstrukts optional sind, können Sie den Parameter komplett weglassen.
props
-
Alle Konstrukte verwenden dieselben drei Argumente, sodass Sie beim Kennenlernen neuer Argumente leicht den Überblick behalten können. Und wie Sie vielleicht erwarten, können Sie jedes Konstrukt in Unterklassen unterteilen, um es an Ihre Bedürfnisse anzupassen oder wenn Sie die Standardwerte ändern möchten.
Schritt 7: Definieren Sie Ihre Lambda-Funktions-URL
In diesem Schritt verwenden Sie die addFunctionUrl
Hilfsmethode des Function
Konstrukts, um eine Lambda-Funktions-URL zu definieren. Um den Wert dieser URL bei der Bereitstellung auszugeben, erstellen Sie mithilfe des CfnOutput
Konstrukts eine AWS CloudFormation Ausgabe.
Fügen Sie Ihrer CDK-Stack-Datei Folgendes hinzu:
Warnung
Um dieses Tutorial einfach zu halten, ist Ihre Lambda-Funktions-URL ohne Authentifizierung definiert. Bei der Bereitstellung wird dadurch ein öffentlich zugänglicher Endpunkt erstellt, über den Sie Ihre Funktion aufrufen können. Wenn Sie mit diesem Tutorial fertig sind, folgen Sie Schritt 12: Löschen Sie Ihre Anwendung, um diese Ressourcen zu löschen.
Schritt 8: Synthetisieren Sie eine Vorlage CloudFormation
In diesem Schritt bereiten Sie sich auf die Bereitstellung vor, indem Sie eine CloudFormation Vorlage mit dem cdk synth
CDK-CLI-Befehl synthetisieren. Dieser Befehl führt eine grundlegende Validierung Ihres CDK-Codes durch, führt Ihre CDK-App aus und generiert eine CloudFormation Vorlage aus Ihrem CDK-Stack.
Wenn Ihre App mehr als einen Stapel enthält, müssen Sie angeben, welche Stapel synthetisiert werden sollen. Da Ihre App einen einzigen Stack enthält, erkennt die CDK-CLI automatisch den zu synthetisierenden Stack.
Wenn Sie keine Vorlage synthetisieren, führt die CDK-CLI diesen Schritt bei der Bereitstellung automatisch durch. Wir empfehlen jedoch, diesen Schritt vor jeder Bereitstellung auszuführen, um nach Synthesefehlern zu suchen.
Bevor Sie eine Vorlage synthetisieren, können Sie optional Ihre Anwendung so erstellen, dass Syntax- und Typfehler erkannt werden. Anweisungen finden Sie unter Schritt 4: Erstellen Sie Ihre CDK-App.
Um eine CloudFormation Vorlage zu synthetisieren, führen Sie im Stammverzeichnis Ihres Projekts Folgendes aus:
$ cdk synth
Anmerkung
Wenn Sie eine Fehlermeldung wie die folgende erhalten, überprüfen Sie, ob Sie sich im hello-cdk
Verzeichnis befinden, und versuchen Sie es erneut:
--app is required either in command-line, in cdk.json or in ~/.cdk.json
Bei Erfolg gibt die CDK-CLI eine YAML
—formatierte CloudFormation Vorlage aus stdout
und speichert eine JSON
—formatierte Vorlage im cdk.out
Verzeichnis Ihres Projekts.
Im Folgenden finden Sie ein Beispiel für die Ausgabe der Vorlage: CloudFormation
Resources: HelloWorldFunctionServiceRole<unique-identifier>: Type: AWS::IAM::Role Properties: AssumeRolePolicyDocument: Statement: - Action: sts:AssumeRole Effect: Allow Principal: Service: lambda.amazonaws.com Version: "2012-10-17" ManagedPolicyArns: - Fn::Join: - "" - - "arn:" - Ref: AWS::Partition - :iam::aws:policy/service-role/AWSLambdaBasicExecutionRole Metadata: aws:cdk:path: HelloCdkStack/HelloWorldFunction/ServiceRole/Resource HelloWorldFunction<unique-identifier>: Type: AWS::Lambda::Function Properties: Code: ZipFile: " \ exports.handler = async function(event) { \ return { \ statusCode: 200, \ body: JSON.stringify('Hello World!'), \ }; \ }; \ " Handler: index.handler Role: Fn::GetAtt: - HelloWorldFunctionServiceRole<unique-identifier> - Arn Runtime: nodejs20.x DependsOn: - HelloWorldFunctionServiceRole<unique-identifier> Metadata: aws:cdk:path: HelloCdkStack/HelloWorldFunction/Resource HelloWorldFunctionFunctionUrl<unique-identifier>: Type: AWS::Lambda::Url Properties: AuthType: NONE TargetFunctionArn: Fn::GetAtt: - HelloWorldFunction<unique-identifier> - Arn Metadata: aws:cdk:path: HelloCdkStack/HelloWorldFunction/FunctionUrl/Resource HelloWorldFunctioninvokefunctionurl<unique-identifier>: Type: AWS::Lambda::Permission Properties: Action: lambda:InvokeFunctionUrl FunctionName: Fn::GetAtt: - HelloWorldFunction<unique-identifier> - Arn FunctionUrlAuthType: NONE Principal: "*" Metadata: aws:cdk:path: HelloCdkStack/HelloWorldFunction/invoke-function-url CDKMetadata: Type: AWS::CDK::Metadata Properties: Analytics: v2:deflate64:<unique-identifier> Metadata: aws:cdk:path: HelloCdkStack/CDKMetadata/Default Condition: CDKMetadataAvailable Outputs: myFunctionUrlOutput: Value: Fn::GetAtt: - HelloWorldFunctionFunctionUrl<unique-identifier> - FunctionUrl Parameters: BootstrapVersion: Type: AWS::SSM::Parameter::Value<String> Default: /cdk-bootstrap/<unique-identifier>/version Description: Version of the CDK Bootstrap resources in this environment, automatically retrieved from SSM Parameter Store. [cdk:skip] Rules: CheckBootstrapVersion: Assertions: - Assert: Fn::Not: - Fn::Contains: - - "1" - "2" - "3" - "4" - "5" - Ref: BootstrapVersion AssertDescription: CDK bootstrap stack version 6 required. Please run 'cdk bootstrap' with a recent version of the CDK CLI.
Anmerkung
Jede generierte Vorlage enthält standardmäßig eine AWS::CDK::Metadata
Ressource. Das AWS CDK-Team verwendet diese Metadaten, um Einblicke in die AWS CDK-Nutzung zu gewinnen und Möglichkeiten zu finden, diese zu verbessern. Einzelheiten, einschließlich der Deaktivierung der Versionsberichterstattung, findest du unter Versionsberichterstattung.
Durch die Definition eines einzigen L2-Konstrukts erstellt das AWS CDK eine umfangreiche CloudFormation Vorlage, die Ihre Lambda-Ressourcen sowie die Berechtigungen und die Glue-Logik enthält, die für die Interaktion Ihrer Ressourcen in Ihrer Anwendung erforderlich sind.
Schritt 9: Stellen Sie Ihren CDK-Stack bereit
In diesem Schritt verwenden Sie den cdk deploy
CDK-CLI-Befehl, um Ihren CDK-Stack bereitzustellen. Mit diesem Befehl wird Ihre generierte CloudFormation Vorlage abgerufen und über diese bereitgestellt AWS CloudFormation, wodurch Ihre Ressourcen als Teil eines Stacks bereitgestellt werden. CloudFormation
Führen Sie im Stammverzeichnis Ihres Projekts den folgenden Befehl aus. Bestätigen Sie Änderungen, wenn Sie dazu aufgefordert werden:
$ cdk deploy ✨ Synthesis time: 2.69s HelloCdkStack: start: Building <unique-identifier>:current_account-current_region HelloCdkStack: success: Built <unique-identifier>:current_account-current_region HelloCdkStack: start: Publishing <unique-identifier>:current_account-current_region HelloCdkStack: success: Published <unique-identifier>:current_account-current_region This deployment will make potentially sensitive changes according to your current security approval level (--require-approval broadening). Please confirm you intend to make the following modifications: IAM Statement Changes ┌───┬───────────────────────────────────────┬────────┬──────────────────────────┬──────────────────────────────┬───────────┐ │ │ Resource │ Effect │ Action │ Principal │ Condition │ ├───┼───────────────────────────────────────┼────────┼──────────────────────────┼──────────────────────────────┼───────────┤ │ + │ ${HelloWorldFunction.Arn} │ Allow │ lambda:InvokeFunctionUrl │ * │ │ ├───┼───────────────────────────────────────┼────────┼──────────────────────────┼──────────────────────────────┼───────────┤ │ + │ ${HelloWorldFunction/ServiceRole.Arn} │ Allow │ sts:AssumeRole │ Service:lambda.amazonaws.com │ │ └───┴───────────────────────────────────────┴────────┴──────────────────────────┴──────────────────────────────┴───────────┘ IAM Policy Changes ┌───┬───────────────────────────────────┬────────────────────────────────────────────────────────────────────────────────┐ │ │ Resource │ Managed Policy ARN │ ├───┼───────────────────────────────────┼────────────────────────────────────────────────────────────────────────────────┤ │ + │ ${HelloWorldFunction/ServiceRole} │ arn:${AWS::Partition}:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole │ └───┴───────────────────────────────────┴────────────────────────────────────────────────────────────────────────────────┘ (NOTE: There may be security-related changes not in this list. See https://github.com/aws/aws-cdk/issues/1299) Do you wish to deploy these changes (y/n)? y
Ähnlich wie müssen cdk synth
Sie den AWS CDK-Stack nicht angeben, da die App einen einzigen Stack enthält.
Während der Bereitstellung zeigt die CDK-CLI Fortschrittsinformationen an, während Ihr Stack bereitgestellt wird. Wenn Sie fertig sind, können Sie zur AWS CloudFormation KonsoleHelloCdkStack
Stack anzusehen. Sie können auch zur Lambda-Konsole gehen, um Ihre HelloWorldFunction
Ressource anzuzeigen.
Wenn die Bereitstellung abgeschlossen ist, gibt die CDK-CLI Ihre Endpunkt-URL aus. Kopieren Sie diese URL für den nächsten Schritt. Im Folgenden wird ein Beispiel gezeigt:
... HelloCdkStack: deploying... [1/1] HelloCdkStack: creating CloudFormation changeset... ✅ HelloCdkStack ✨ Deployment time: 41.65s Outputs: HelloCdkStack.myFunctionUrlOutput = https://<api-id>.lambda-url.<Region>.on.aws/ Stack ARN: arn:aws:cloudformation:<Region:account-id>:stack/HelloCdkStack/<unique-identifier> ✨ Total time: 44.34s
Schritt 10: Interagieren Sie mit Ihrer Anwendung auf AWS
In diesem Schritt interagieren Sie mit Ihrer Anwendung, AWS indem Sie Ihre Lambda-Funktion über die Funktions-URL aufrufen. Wenn Sie auf die URL zugreifen, gibt Ihre Lambda-Funktion die Hello World!
Nachricht zurück.
Um Ihre Funktion aufzurufen, greifen Sie über Ihren Browser oder über die Befehlszeile auf die Funktions-URL zu. Im Folgenden wird ein Beispiel gezeigt:
$ curl https://<api-id>.lambda-url.<Region>.on.aws/ "Hello World!"%
Schritt 11: Ändern Sie Ihre Anwendung
In diesem Schritt ändern Sie die Meldung, die die Lambda-Funktion zurückgibt, wenn sie aufgerufen wird. Sie führen einen Vergleich mit dem cdk diff
CDK-CLI-Befehl durch, um eine Vorschau Ihrer Änderungen anzuzeigen, und stellen sie bereit, um Ihre Anwendung zu aktualisieren. Anschließend interagieren Sie mit Ihrer Anwendung AWS , um Ihre neue Nachricht zu sehen.
Ändern Sie die myFunction
Instanz in Ihrer CDK-Stack-Datei wie folgt:
Derzeit wurden durch Ihre Codeänderungen keine direkten Aktualisierungen Ihrer bereitgestellten Lambda-Ressource vorgenommen. Ihr Code definiert den gewünschten Status Ihrer Ressource. Um Ihre bereitgestellte Ressource zu ändern, verwenden Sie die CDK-CLI, um den gewünschten Status in einer neuen AWS CloudFormation Vorlage zu synthetisieren. Anschließend stellen Sie Ihre neue CloudFormation Vorlage als Änderungssatz bereit. Mit Änderungssätzen werden nur die Änderungen vorgenommen, die erforderlich sind, um den gewünschten neuen Status zu erreichen.
Führen Sie den cdk diff
Befehl aus, um eine Vorschau Ihrer Änderungen anzuzeigen. Im Folgenden wird ein Beispiel gezeigt:
$ cdk diff Stack HelloCdkStack Hold on while we create a read-only change set to get a diff with accurate replacement information (use --no-change-set to use a less accurate but faster template-only diff) Resources [~] AWS::Lambda::Function HelloWorldFunction HelloWorldFunction<unique-identifier> └─ [~] Code └─ [~] .ZipFile: ├─ [-] exports.handler = async function(event) { return { statusCode: 200, body: JSON.stringify('Hello World!'), }; }; └─ [+] exports.handler = async function(event) { return { statusCode: 200, body: JSON.stringify('Hello CDK!'), }; }; ✨ Number of stacks with differences: 1
Um diesen Diff zu erstellen, fragt die CDK-CLI Ihr AWS Kontokonto nach der neuesten AWS CloudFormation Vorlage für den HelloCdkStack
Stack ab. Anschließend vergleicht sie die neueste Vorlage mit der Vorlage, die sie gerade aus Ihrer App synthetisiert hat.
Führen Sie den cdk deploy
Befehl aus, um Ihre Änderungen zu implementieren. Im Folgenden wird ein Beispiel gezeigt:
$ cdk deploy ✨ Synthesis time: 2.12s HelloCdkStack: start: Building <unique-identifier>:current_account-current_region HelloCdkStack: success: Built <unique-identifier>:current_account-current_region HelloCdkStack: start: Publishing <unique-identifier>:current_account-current_region HelloCdkStack: success: Published <unique-identifier>:current_account-current_region HelloCdkStack: deploying... [1/1] HelloCdkStack: creating CloudFormation changeset... ✅ HelloCdkStack ✨ Deployment time: 26.96s Outputs: HelloCdkStack.myFunctionUrlOutput = https://<unique-identifier>.lambda-url.<Region>.on.aws/ Stack ARN: arn:aws:cloudformation:<Region:account-id>:stack/HelloCdkStack/<unique-identifier> ✨ Total time: 29.07s
Um mit Ihrer Anwendung zu interagieren, wiederholen Sie Schritt 10: Interagieren Sie mit Ihrer Anwendung auf AWS. Im Folgenden wird ein Beispiel gezeigt:
$ curl https://<api-id>.lambda-url.<Region>.on.aws/ "Hello CDK!"%
Schritt 12: Löschen Sie Ihre Bewerbung
In diesem Schritt verwenden Sie den cdk destroy
CDK-CLI-Befehl, um Ihre Anwendung zu löschen. Dieser Befehl löscht den mit Ihrem CloudFormation CDK-Stack verknüpften Stack, der die von Ihnen erstellten Ressourcen enthält.
Um Ihre Anwendung zu löschen, führen Sie den cdk destroy
Befehl aus und bestätigen Sie Ihre Anfrage zum Löschen der Anwendung. Im Folgenden wird ein Beispiel gezeigt:
$ cdk destroy Are you sure you want to delete: HelloCdkStack (y/n)? y HelloCdkStack: destroying... [1/1] ✅ HelloCdkStack: destroyed
Nächste Schritte
Herzlichen Glückwunsch! Sie haben dieses Tutorial abgeschlossen und das AWS CDK verwendet, um erfolgreich Ressourcen in der AWS Cloud zu erstellen, zu ändern und zu löschen. Sie sind jetzt bereit, das AWS CDK zu verwenden.
Weitere Informationen zur Verwendung des AWS CDK in Ihrer bevorzugten Programmiersprache finden Sie unter Arbeiten mit der AWS CDK-Bibliothek.
Weitere Ressourcen finden Sie im Folgenden:
-
Probieren Sie den CDK-Workshop
aus, um sich eingehender mit einem komplexeren Projekt vertraut zu machen. -
Sehen Sie sich die API-Referenz an, um mit der Erkundung der CDK-Konstrukte zu beginnen, die für Ihre bevorzugten Dienste verfügbar sind. AWS
-
Besuchen Sie Construct Hub
, um Konstrukte zu entdecken, die von und anderen erstellt AWS wurden. -
Entdecken Sie Beispiele für
die Verwendung des AWS CDK.
Das AWS CDK ist ein Open-Source-Projekt. Informationen zum Beitrag finden Sie unter Beitrag zum AWS Cloud Development Kit (AWS CDK)