AWS CDK Tutorial für AWS Cloud9

Stellen Sie in einer Terminalsitzung in der sicher AWS Cloud9 IDE, dass die neuesten Sicherheitsupdates und Bugfixes installiert sind. Um dies zu tun, führen Sie den Befehl yum update (für Amazon Linux) oder apt update (für Ubuntu Server) aus. (Um eine neue Terminalsitzung zu starten, wählen Sie in der Menüleiste Window (Fenster), New Terminal (Neues Terminal) aus.

Für Amazon Linux:

sudo yum -y update

Für Ubuntu Server:

sudo apt update

Prüfen Sie, ob nvm bereits installiert ist. Führen Sie zu diesem Zweck den Befehl nvm mit der Option --version aus.

nvm --version

Ist der Befehl erfolgreich, enthält die Ausgabe die nvm -Versionsnummer, und Sie können zur Schritt 1.2: Installieren von Node.js springen.

Laden Sie nvm herunter und installieren Sie es. Führen Sie dazu das Installationsskript aus. In diesem Beispiel ist v0.33.0 installiert, Sie können jedoch nach der neuesten Version von nvm Hier gilt:aus.

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash

Beginnen Sie mit der Nutzung von nvm . Sie können die Terminalsitzung entweder schließen und dann neu starten oder die Datei ~/.bashrc auslesen, die die Befehle zum Laden von nvm enthält.

. ~/.bashrc

Überprüfen Sie, ob Sie Node.js bereits installiert haben, und wenn ja, ob die installierte Version 16.17.0 oder höher ist. Dieses Beispiel wurde mit Node.js 16.17.0 getestet. Um dies zu überprüfen, führen Sie den nodeBefehl mit der --versionOption ausIDE, während die Terminalsitzung noch geöffnet ist.

node --version

Wenn Sie Node.js installiert haben, enthält die Ausgabe die Versionsnummer. Wenn die Versionsnummer v16.17.0 ist, fahren Sie mit Schritt 1.3: Installieren TypeScript fort.

Installieren Sie Node.js 16, indem Sie den nvmBefehl mit der installAktion ausführen.

nvm install v16

Fangen Sie an, Node.js 16 zu verwenden. Führen Sie dazu den Befehl nvm mit der Aktion alias , der Versionsnummer des Alias und der Version, die für diesen Alias verwendet werden soll, wie folgt aus.

nvm alias default 16

Um zu bestätigen, dass Sie Node.js 16 verwenden, führen Sie den node --versionBefehl erneut aus. Wenn die richtige Version installiert ist, enthält die Ausgabe Version v16.

Bestätigen Sie, ob Sie es bereits TypeScript installiert haben. Führen Sie dazu den TypeScript Befehlszeilen-Compiler mit der --versionOption ausIDE, während die Terminalsitzung noch geöffnet ist.

tsc --version

Wenn Sie es TypeScript installiert haben, enthält die Ausgabe die TypeScript Versionsnummer. Falls installiert TypeScript ist, fahren Sie mit fortSchritt 1.4: Installieren Sie das AWS CDK.

Installiere TypeScript. Führen Sie dazu den npmBefehl mit der installAktion, der -gOption und dem Namen des TypeScript Pakets aus. Dies wird TypeScript als globales Paket in der Umgebung installiert.

npm install -g typescript

Vergewissern Sie sich, dass TypeScript es installiert ist. Führen Sie dazu den TypeScript Befehlszeilen-Compiler mit der --versionOption aus.

tsc --version

Wenn installiert TypeScript ist, enthält die Ausgabe die TypeScript Versionsnummer.

Bestätigen Sie, ob Sie das bereits AWS CDK installiert haben. Führen Sie dazu den cdkBefehl mit der --versionOption ausIDE, während die Terminalsitzung noch geöffnet ist.

cdk --version

Wenn der installiert AWS CDK ist, enthält die Ausgabe die AWS CDK Versions- und Buildnummern. Fahren Sie mit Schritt 2: Code hinzufügen fort.

Installieren Sie das, AWS CDK indem Sie den npmBefehl zusammen mit der install Aktion, dem Namen des zu installierenden AWS CDK Pakets und der -g Option zur globalen Installation des Pakets in der Umgebung ausführen.

npm install -g aws-cdk

Stellen Sie sicher, dass das installiert AWS CDK ist und korrekt referenziert wird. Führen Sie zu diesem Zweck den Befehl cdk mit der Option --version aus.

cdk --version

Bei Erfolg werden die AWS CDK Versions- und Buildnummern angezeigt.

Wenn die Terminalsitzung noch geöffnet istIDE, erstellen Sie ein Verzeichnis, in dem der Quellcode des Projekts gespeichert wird, z. B. ein ~/environment/hello-cdk Verzeichnis in Ihrer Umgebung. Wechseln Sie dann in dieses Verzeichnis.

rm -rf ~/environment/hello-cdk # Remove this directory if it already exists.
mkdir ~/environment/hello-cdk  # Create the directory.
cd ~/environment/hello-cdk     # Switch to the directory.

Richten Sie das Verzeichnis als TypeScript Sprachprojekt für das ein AWS CDK. Führen Sie dazu den Befehl cdk mit der Aktion init , der Vorlage sample-app und der Option --language zusammen mit dem Namen der Programmiersprache aus.

cdk init sample-app --language typescript

Dadurch werden die folgenden Dateien und Unterverzeichnisse im Verzeichnis erstellt.

Öffnen Sie im Fenster Environment (Umgebung) die Datei lib/hello-cdk-stack.ts und durchsuchen Sie den folgenden Code in dieser Datei.

import sns = require('@aws-cdk/aws-sns');
import sqs = require('@aws-cdk/aws-sqs');
import cdk = require('@aws-cdk/cdk');

export class HelloCdkStack extends cdk.Stack {
  constructor(parent: cdk.App, name: string, props?: cdk.StackProps) {
    super(parent, name, props);

    const queue = new sqs.Queue(this, 'HelloCdkQueue', {
      visibilityTimeoutSec: 300
    });

    const topic = new sns.Topic(this, 'HelloCdkTopic');

    topic.subscribeQueue(queue);
  }
}

Öffnen Sie im Fenster Environment (Umgebung) die Datei bin/hello-cdk.ts und durchsuchen Sie den folgenden Code in dieser Datei.

#!/usr/bin/env node
import cdk = require('@aws-cdk/cdk');
import { HelloCdkStack } from '../lib/hello-cdk-stack';

const app = new cdk.App();
new HelloCdkStack(app, 'HelloCdkStack');
app.run();

Dieser Code lädt die Klasse HelloCdkStack aus der Datei lib/hello-cdk-stack.ts, instanziiert sie und führt sie aus.

Wird verwendet npm, um den TypeScript Compiler auszuführen, um nach Codierungsfehlern zu suchen, und um dann den AWS CDK zu aktivieren, um die bin/hello-cdk.js Projektdatei auszuführen. Führen Sie dazu aus dem Stammverzeichnis des Projekts den Befehl npm mit der Aktion run aus, indem Sie den Wert des Befehls build in der Datei package.json wie folgt angeben.

npm run build

Mit dem vorherigen Befehl wird der TypeScript Compiler ausgeführt, der unterstützende Dateien bin/hello-cdk.d.ts und lib/hello-cdk-stack.d.ts Dateien hinzufügt. Die Compiler transpiliert außerdem die Dateien hello-cdk.ts und hello-cdk-stack.ts in die Dateien hello-cdk.js und hello-cdk-stack.js.

Lassen Sie sie die AWS CloudFormation Stack-Vorlage AWS CDK erstellen. Führen Sie dazu im Stammverzeichnis des Projekts den cdkBefehl mit der IDE synthAktion und dem Namen des Stacks aus, während die Terminalsitzung noch geöffnet ist.

cdk synth HelloCdkStack

Bei Erfolg wird in der Ausgabe der Resources Abschnitt der AWS CloudFormation Stack-Vorlage angezeigt.

Wenn Sie eine AWS CDK App zum ersten Mal in einer Umgebung für eine bestimmte Kombination aus AWS Konto und AWS Region bereitstellen, müssen Sie einen Bootstrap-Stack installieren. Dieser Stack enthält verschiedene Ressourcen, die er AWS CDK benötigt, um die verschiedenen Operationen abzuschließen. Dieser Stack umfasst beispielsweise einen Amazon S3 S3-Bucket, in AWS CDK dem Vorlagen und Ressourcen während der Bereitstellungsprozesse gespeichert werden. Um den Bootstrap-Stack zu installieren, führen Sie den Befehl cdk mit der Aktion bootstrap aus.

cdk bootstrap

cdk bootstrap --profile test 123456789012/us-east-1

Lassen Sie sie die AWS CloudFormation Stack-Vorlage AWS CDK ausführen, um den Stack bereitzustellen. Führen Sie dazu aus dem Stammverzeichnis des Projekts den Befehl cdk mit der Aktion deploy und dem Namen des Stacks aus.

cdk deploy HelloCdkStack

Bei Erfolg zeigt die Ausgabe an, dass der HelloCdkStack-Stack fehlerfrei bereitgestellt wurde.

Um zu überprüfen, ob das SNS Amazon-Thema und die SQS Amazon-Warteschlange erfolgreich bereitgestellt wurden, senden Sie eine Nachricht an das Thema und überprüfen Sie dann die Warteschlange auf die empfangene Nachricht. Dazu können Sie ein Tool wie das AWS Command Line Interface (AWS CLI) oder das verwenden AWS CloudShell. Weitere Informationen zu diesen Tools finden Sie unter AWS CLI und AWS-Shell-Tutorial für AWS Cloud9.

Um beispielsweise eine Nachricht an das Thema zu senden, während die Terminalsitzung noch geöffnet istIDE, verwenden Sie den, AWS CLI um den SNS publishAmazon-Befehl auszuführen und dabei den Betreff und den Hauptteil der Nachricht, die AWS Region für das Thema und den Amazon-Ressourcennamen (ARN) des Themas anzugeben.

aws sns publish --subject "Hello from the AWS CDK" --message "This is a message from the AWS CDK." --topic-arn arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K

Ersetzen Sie den Befehl im vorherigen Befehl arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K durch den BefehlARN, der dem Thema AWS CloudFormation zugewiesen ist. Um die ID zu erhalten, können Sie den SNS list-topicsAmazon-Befehl ausführen.

aws sns list-topics --output table --query 'Topics[*].TopicArn'

Wenn erfolgreich, zeigt die Ausgabe des Befehls publish den Wert MessageId für die veröffentlichte Nachricht an.

Um die Warteschlange auf die empfangene Nachricht zu überprüfen, führen Sie den SQS receive-messageAmazon-Befehl aus und geben Sie die Warteschlange anURL.

aws sqs receive-message --queue-url https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K

Ersetzen Sie den Befehl im vorherigen Befehl https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K durch den BefehlARN, der der Warteschlange AWS CloudFormation zugewiesen ist. Um das zu erhaltenURL, können Sie den SQS list-queuesAmazon-Befehl ausführen.

aws sqs list-queues --output table --query 'QueueUrls[*]'

Wenn erfolgreich, zeigt die Ausgabe des Befehls receive-message Informationen über die empfangene Nachricht an.