AWS CDK のチュートリアル AWS Cloud9

のターミナルセッションで AWS Cloud9 IDE、最新のセキュリティ更新プログラムとバグ修正がインストールされていることを確認します。これを行うには、 yum update (Amazon Linux 用)または apt update コマンド (Ubuntu Server 用) を実行します。(新しいターミナルセッションを開始するには、メニューバーで、［Window (ウィンドウ)］、［New Terminal (新しいターミナル)］の順に選択します。)

Amazon Linux の場合:

sudo yum -y update

Ubuntu Server の場合:

sudo apt update

nvm がインストール済みであるかどうかを確認します。これを行うには、 --version オプションを使用して nvm コマンドを実行します。

nvm --version

成功すると、出力に nvm バージョン番号が表示されます。この場合、「ステップ 1.2: Node.js をインストールする」までスキップできます。

nvm をダウンロードしてインストールします。これを行うには、インストールスクリプトを実行します。この例では、v0.33.0 がインストールされていますが、nvm の最新バージョンはこちらで確認できます。

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

nvm の使用を開始します。ターミナルセッションを閉じて再起動するか nvm をロードするコマンドを含む ~/.bashrc ファイルを入手してください。

. ~/.bashrc

Node.js がインストール済みであるかどうかを確認します。インストール済みである場合は、そのバージョンが 16.17.0 以上であることを確認します。このサンプルは Node.js 16.17.0 を使用してテスト済みです。確認するには、 でターミナルセッションが開いている状態でIDE、 --versionオプションを使用して node コマンドを実行します。

node --version

Node.js がインストール済みである場合は、出力にバージョン番号が表示されます。バージョン番号が v16.17.0 である場合は、「ステップ 1.3: インストール TypeScript」に進みます。

nvm コマンドを install アクションと共に実行して、Node.js 16 をインストールします。

nvm install v16

Node.js 16 の使用を開始します。これを行うには、nvm コマンドを実行します。次のように alias アクション、エイリアスを作成するバージョン番号、このエイリアスで使用するバージョンを指定します。

nvm alias default 16

Node.js 16 を使用していることを確認するには、node --version コマンドを再度実行します。正しいバージョンをインストールしている場合は、出力にバージョン v16 と表示されます。

が既に TypeScript インストールされているかどうかを確認します。これを行うには、ターミナルセッションを で開いたままにしてIDE、 --versionオプションを使用してコマンドライン TypeScript コンパイラを実行します。

tsc --version

TypeScript がインストールされている場合、出力には TypeScript バージョン番号が含まれます。 TypeScript がインストールされている場合は、 に進みますステップ 1.4: をインストールする AWS CDK。

をインストールします TypeScript。これを行うには、 installアクション、 -gオプション、パッケージの名前を使用して npm コマンドを実行します TypeScript 。これにより、 環境のグローバルパッケージ TypeScript としてインストールされます。

npm install -g typescript

TypeScript がインストールされていることを確認します。これを行うには、 --versionオプションを使用してコマンドライン TypeScript コンパイラを実行します。

tsc --version

TypeScript がインストールされている場合、出力には TypeScript バージョン番号が含まれます。

が既に AWS CDK インストールされているかどうかを確認します。これを行うには、ターミナルセッションを で開いたままにしてIDE、 --versionオプションで cdk コマンドを実行します。

cdk --version

AWS CDK がインストールされている場合、出力には AWS CDK バージョンとビルド番号が含まれます。ステップ 2: コードを追加する に進んでください。

コマンドを installアクション、インストールする AWS CDK パッケージの名前、および 環境にパッケージをグローバルにインストールする-gオプションnpmとともに実行 AWS CDK して、 をインストールします。

npm install -g aws-cdk

がインストールされ、正しく参照 AWS CDK されていることを確認します。これを行うには、 --version オプションを使用して cdk コマンドを実行します。

cdk --version

成功すると、 AWS CDK バージョンとビルド番号が表示されます。

ターミナルセッションを で開いたままにしIDE、プロジェクトのソースコードを保存するディレクトリを作成します。例えば、 環境内の~/environment/hello-cdkディレクトリなどです。次に、このディレクトリに切り替えます。

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.

ディレクトリを の TypeScript 言語プロジェクトとしてセットアップします AWS CDK。これを行うには、init アクション、sample-app テンプレート、--language オプション、およびプログラミング言語の名前を指定して cdk コマンドを実行します。

cdk init sample-app --language typescript

これにより、ディレクトリ内に以下のファイルとサブディレクトリが作成されます。

[Environment (環境)] ウィンドウで、lib/hello-cdk-stack.ts ファイルを開き、このファイル内で次のコードを参照します。

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);
  }
}

[Environment (環境)] ウィンドウで、bin/hello-cdk.ts ファイルを開き、このファイル内で次のコードを参照します。

#!/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();

このコードは、lib/hello-cdk-stack.ts の HelloCdkStack クラスをロードし、インスタンス化して、実行します。

npm を使用して TypeScript コンパイラを実行してコーディングエラーを確認し、 を有効にしてプロジェクトのbin/hello-cdk.jsファイル AWS CDK を実行します。これを行うには、プロジェクトのルートディレクトリから、npm コマンドを run アクションで実行します。build コマンドの値は package.json ファイルで次のように指定します。

npm run build

前述のコマンドはコン TypeScript パイラを実行し、サポートファイルbin/hello-cdk.d.tsとlib/hello-cdk-stack.d.tsファイルを追加します。また、このコンパイラーは、hello-cdk.js ファイルおよび hello-cdk-stack.js ファイルを、hello-cdk.ts ファイルおよび hello-cdk-stack.ts ファイルとしてトランスパイルします。

に AWS CloudFormation スタックテンプレート AWS CDK を作成してもらいます。これを行うには、ターミナルセッションを で開いたままIDE、プロジェクトのルートディレクトリから、 synthアクションとスタックの名前を使用して cdk コマンドを実行します。

cdk synth HelloCdkStack

成功すると、出力に AWS CloudFormation スタックテンプレートResourcesのセクションが表示されます。

特定の AWS アカウントと AWS リージョンの組み合わせの環境に AWS CDK アプリケーションを初めてデプロイするときは、ブートストラップスタック をインストールする必要があります。このスタックには、 がさまざまなオペレーションを完了 AWS CDK するために必要なさまざまなリソースが含まれています。例えば、このスタックには、デプロイプロセス中に がテンプレートとアセットを保存 AWS CDK するために使用する Amazon S3 バケットが含まれています。ブートストラップスタックをインストールするには、 cdk コマンドを bootstrap アクションと共に実行します。

cdk bootstrap

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

AWS CloudFormation スタックテンプレート AWS CDK を実行してスタックをデプロイします。これを行うには、プロジェクトのルートディレクトリから、cdk コマンドに deploy アクションとスタック名を指定して実行します。

cdk deploy HelloCdkStack

成功すると、エラーなしでデプロイされた HelloCdkStack スタックが出力に表示されます。

Amazon SNSトピックと Amazon SQSキューが正常にデプロイされたことを確認するには、 トピックにメッセージを送信し、キューで受信したメッセージを確認します。これを行うには、 AWS Command Line Interface （AWS CLI) や などのツールを使用できます AWS CloudShell。これらのツールの詳細については、AWS CLI および の aws-shell チュートリアル AWS Cloud9 を参照してください。

例えば、 でターミナルセッションを開いたまま、 トピックにメッセージを送信するにはIDE、 AWS CLI を使用して Amazon SNS publish コマンドを実行し、メッセージの件名と本文、トピックの AWS リージョン、トピックの Amazon リソースネーム () を指定しますARN。

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

前のコマンドで、 をトピックARN AWS CloudFormation に割り当てる arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0Kに置き換えます。ID を取得するには、Amazon SNS list-topics コマンドを実行できます。

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

成功すると、publish コマンドの出力に、発行されたメッセージの MessageId 値が表示されます。

キューで受信したメッセージを確認するには、Amazon SQS receive-message コマンドを実行し、キューの を指定しますURL。

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

前のコマンドで、 をキューARN AWS CloudFormation に割り当てる https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0Kに置き換えます。を取得するにはURL、Amazon SQS list-queues コマンドを実行します。

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

成功すると、receive-message コマンドの出力に、受信されたメッセージの情報が表示されます。