Dies ist das AWS CDK v2 Developer Guide. Für das ältere CDK v1 wurde am 1. Juni 2022 die Wartung abgeschlossen und der Support endete am 1. Juni 2023.
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 das AWS CDK Command Line Interface (AWS CDK CLI) verwenden, um Ihre erste CDK-App zu entwickeln, Ihre AWS Umgebung zu booten und Ihre Anwendung auf 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 erstellen und implementieren Sie eine einfache Anwendung zur AWS Verwendung des AWS CDK. Die Anwendung besteht aus einer AWS Lambda-Funktion, die beim Aufrufen eine Hello World! Meldung 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 initCDK-CLI-Befehl. -
Konfiguration Ihrer AWS Umgebung — Konfigurieren Sie die AWS Umgebung, in der Sie Ihre Anwendung bereitstellen werden.
-
Bootstrapping 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 Library, um Ihre Lambda-Funktion und die URL-Ressourcen der Lambda-Funktion zu definieren.
-
Bereiten Sie Ihre App für die Bereitstellung vor — Verwenden Sie die CDK-CLI, um Ihre App zu erstellen und eine Vorlage zu synthetisieren. AWS CloudFormation
-
Bereitstellen Ihrer App — Verwenden Sie den
cdk deployCDK-CLI-Befehl, um Ihre Anwendung bereitzustellen und Ihre Ressourcen bereitzustellen. AWS -
Interagieren Sie mit Ihrer Anwendung — Interagieren Sie mit Ihrer bereitgestellten Lambda-Funktion, AWS indem Sie sie aufrufen und eine Antwort erhalten.
-
Modifizieren Sie Ihre App — Ändern Sie Ihre Lambda-Funktion und implementieren Sie sie, um Ihre Änderungen zu implementieren.
-
Löschen Sie Ihre App — Löschen Sie alle Ressourcen, die Sie mit dem
cdk destroyCDK-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 folgenden Namen
hello-cdkund navigieren Sie zu diesem Verzeichnis:$ mkdir hello-cdk && cd hello-cdkWichtig
Achten Sie darauf, Ihr Projektverzeichnis genau so zu 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-cdkVerzeichnis ein neues CDK-Projekt mit dem CDK-CLI-Befehl.cdk initGeben Sie dieappVorlage und Ihre bevorzugte Programmiersprache mit der folgenden Option an:--languageBeispiel
-
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 aus 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, das Sie verwenden, 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 mithilfe des Konstrukts erstellt. App Das Folgende ist ein Teil dieses Codes aus Ihrer CDK-Anwendungsdatei:
Beispiel
Der CDK-Stack wird mithilfe des Stack Konstrukts erstellt. Das Folgende ist ein Teil dieses Codes aus Ihrer CDK-Stack-Datei:
Beispiel
Schritt 2: Konfiguriere deine 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 die AWS CLI dann 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
defaultProfil 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 mithilfe der
--profileOption an:$ aws sts get-caller-identity --profile your-profile-name --query "Account" --output text
-
- Um die AWS CLI zu verwenden, um Ihre AWS Region abzurufen
-
-
Führen Sie den folgenden AWS CLI-Befehl aus, um die Region abzurufen, die Sie für Ihr
defaultProfil konfiguriert haben:$ aws configure get region -
Wenn Sie lieber ein benanntes Profil verwenden möchten, geben Sie den Namen Ihres Profils mithilfe der
--profileOption 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 nicht empfohlen. Informationen zu anderen Möglichkeiten, Umgebungen zu konfigurieren, finden Sie unter Konfigurieren von Umgebungen zur Verwendung mit dem AWS CDK.
- So konfigurieren Sie die Umgebung für Ihren CDK-Stack
-
-
Verwenden Sie in Ihrer Anwendungsdatei die
envEigenschaft desStackKonstrukts, um Ihre Umgebung zu konfigurieren. Im Folgenden wird ein Beispiel gezeigt:Beispiel
-
Schritt 3: Bootstrappen Sie Ihre AWS Umgebung
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 ruft Umgebungsinformationen aus Ihrem Projekt ab. Wenn Sie außerhalb eines CDK-Projekts Bootstrap durchführen, müssen Sie mit dem Befehl Umgebungsinformationen angeben. cdk bootstrap Weitere Informationen finden Sie unter Bootstrapping Ihrer Umgebung für die 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 ausführt. Sie können jedoch immer noch manuell erstellen, wenn Sie Syntax- und Tippfehler abfangen möchten. Im Folgenden wird ein Beispiel gezeigt:
Beispiel
Schritt 5: Listen Sie die CDK-Stacks in Ihrer App auf
Zu diesem Zeitpunkt sollten Sie eine CDK-App haben, 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, überprüfen Sie, ob 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 AWS Construct Library und verwenden das Function L2-Konstrukt.
Ändern Sie Ihre CDK-Stack-Datei wie folgt:
Beispiel
Schauen wir uns das Function Konstrukt genauer an. Wie alle Konstrukte benötigt die Function Klasse drei Parameter:
-
scope — Definiert Ihre
StackInstanz als übergeordnete Instanz desFunctionKonstrukts. Alle Konstrukte, die AWS Ressourcen definieren, werden im Rahmen 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 Gültigkeitsbereichthis(selfin Python). -
Id — Die Konstrukt-ID der
Functionin 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.HelloWorldFunctionFunktionen können auch einen Namen haben, der mit derfunctionNameEigenschaft angegeben wird. Dies unterscheidet sich von der Konstrukt-ID. -
props — Ein Bündel von Werten, die Eigenschaften der Funktion definieren. Hier definieren Sie die
codeEigenschaftenruntimehandler, und.Requisiten werden in den vom AWS CDK unterstützten Sprachen unterschiedlich dargestellt.
-
In TypeScript und
propssteht 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 für und einen zweiten für
FunctionProps,Functiondamit Sie das Konstrukt und das zugehörige Requisiten-Objekt in einem Schritt erstellen können. Dieser Code verwendet Letzteres. -
In C# instanziieren Sie ein
FunctionPropsObjekt mithilfe eines Objektinitialisierers und übergeben es als dritten Parameter.Wenn die Requisiten eines Konstrukts optional sind, können Sie den Parameter vollständig weglassen.
props
-
Alle Konstrukte verwenden dieselben drei Argumente, sodass Sie sich leicht orientieren können, wenn Sie neue Argumente kennenlernen. Und wie Sie vielleicht erwarten, können Sie jedes Konstrukt unterklassifizieren, um es an Ihre Bedürfnisse anzupassen oder wenn Sie seine 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:
Beispiel
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, der zum Aufrufen Ihrer Funktion verwendet werden kann. 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-CLI-Befehl synthetisieren. cdk synth 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 einzelnen 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 aus. 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 erstellen, um Syntax- und Tippfehler abzufangen. Eine Anleitung 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 in das Verzeichnis Ihres Projekts aus stdout und speichert eine JSON —formatierte Vorlage. cdk.out
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 einen Einblick in die AWS CDK-Nutzung zu erhalten und Möglichkeiten zu finden, diese zu verbessern. Einzelheiten, einschließlich der Möglichkeit, sich von der Versionsberichterstattung abzumelden, finden Sie unter Versionsberichterstattung.
Durch die Definition eines einzelnen L2-Konstrukts erstellt das AWS CDK eine umfangreiche CloudFormation Vorlage, die Ihre Lambda-Ressourcen zusammen mit den Berechtigungen und der Glue-Logik enthält, die für die Interaktion Ihrer Ressourcen innerhalb 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 bereitgestellt AWS CloudFormation, wodurch Ihre Ressourcen als Teil eines Stacks bereitgestellt werden. CloudFormation
Führen Sie im Stammverzeichnis Ihres Projekts Folgendes 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 einzelnen Stapel 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 Konsole gehen, HelloCdkStack Stack anzusehen. Sie können auch zur Lambda-Konsole gehen, um Ihre HelloWorldFunction Ressource anzusehen.
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 Nachricht zurück. Hello World!
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 führen die Bereitstellung durch, 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:
Beispiel
Derzeit haben Ihre Codeänderungen keine direkten Aktualisierungen an Ihrer bereitgestellten Lambda-Ressource vorgenommen. Ihr Code definiert den gewünschten Zustand 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 neuen gewünschten 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 --method=template 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 Unterschied zu erstellen, fragt die CDK-CLI in Ihrem AWS Kontokonto nach der neuesten AWS CloudFormation Vorlage für den HelloCdkStack Stack ab. Dann vergleicht es die neueste Vorlage mit der Vorlage, die es 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 CloudFormation Stack, der Ihrem CDK-Stack zugeordnet ist, einschließlich der Ressourcen, die Sie erstellt haben.
Um Ihre Anwendung zu löschen, führen Sie den cdk destroy Befehl aus und bestätigen Sie Ihre Anfrage, die Anwendung zu löschen. 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 Ressourcen in der AWS Cloud erfolgreich 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 unter den folgenden Links:
-
Probieren Sie den CDK-Workshop aus,
wenn Sie einen ausführlicheren Überblick über ein komplexeres Projekt erhalten möchten. -
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. Wie Sie dazu beitragen können, finden Sie unter Zum AWS Cloud Development Kit (AWS CDK) beitragen.