AWS CDK tutorial untuk AWS Cloud9

Dalam sesi terminal di AWS Cloud9 IDE, pastikan pembaruan keamanan terbaru dan perbaikan bug diinstal. Untuk melakukan ini, jalankan perintah yum update (untuk Amazon Linux) atau apt update (untuk Server Ubuntu). (Untuk memulai sesi terminal baru, pada bilah menu, pilih Jendela, Terminal Baru.)

Untuk Amazon Linux:

sudo yum -y update

Untuk Ubuntu Server:

sudo apt update

Konfirmasi apakah nvm sudah terpasang. Untuk melakukan ini, jalankan perintah nvm dengan opsi --version .

nvm --version

Jika berhasil, output berisi nomor versi nvm , dan Anda dapat langsung melanjutkan ke Langkah 1.2: Pasang Node.js.

Unduh dan pasang nvm . Untuk melakukan ini, jalankan skrip pemasangan. Dalam contoh ini, v0.33.0 terpasang, tetapi Anda dapat memeriksa versi terbaru nvm di sini.

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

Mulai menggunakan nvm . Anda dapat menutup sesi terminal dan kemudian memulai kembali, atau cari file ~/.bashrc yang berisi perintah untuk memuat nvm ..

. ~/.bashrc

Konfirmasikan apakah Anda sudah menginstal Node.js, dan jika Anda melakukannya, konfirmasikan bahwa versi yang diinstal adalah 16.17.0 atau lebih tinggi. Sampel ini telah diuji dengan Node.js 16.17.0. Untuk memeriksa, dengan sesi terminal masih terbuka di IDE, jalankan perintah node dengan opsi --version .

node --version

Jika Anda telah memasang Node.js, output berisi nomor versi. Jika nomor versi v16.17.0 lompat ke depan. Langkah 1.3: Instal TypeScript

Instal Node.js 16 dengan menjalankan nvmperintah dengan installtindakan.

nvm install v16

Mulai gunakan Node.js 16. Untuk melakukannya, jalankan perintah nvm dengan tindakan alias , nomor versi ke alias, dan versi yang digunakan untuk alias itu, sebagai berikut.

nvm alias default 16

Untuk mengonfirmasi bahwa Anda menggunakan Node.js 16 jalankan node --versionperintah lagi. Jika versi yang benar diinstal, output berisi versi v16.

Konfirmasikan apakah Anda sudah TypeScript menginstal. Untuk melakukan ini, dengan sesi terminal masih terbuka di IDE, jalankan TypeScript kompiler baris perintah dengan --versionopsi.

tsc --version

Jika Anda telah TypeScript menginstal, output berisi nomor TypeScript versi. Jika TypeScript diinstal, lewati ke depanLangkah 1.4: Instal AWS CDK.

Instal TypeScript. Untuk melakukan ini, jalankan npmperintah dengan installtindakan, -gopsi, dan nama TypeScript paket. Ini diinstal TypeScript sebagai paket global di lingkungan.

npm install -g typescript

Konfirmasikan bahwa TypeScript sudah diinstal. Untuk melakukan ini, jalankan TypeScript compiler baris perintah dengan --versionopsi.

tsc --version

Jika TypeScript diinstal, output berisi nomor TypeScript versi.

Konfirmasikan apakah Anda sudah AWS CDK menginstal. Untuk melakukan ini, dengan sesi terminal masih terbuka di IDE, jalankan perintah cdk dengan opsi --version .

cdk --version

Jika AWS CDK diinstal, output berisi AWS CDK versi dan nomor build. Lewati ke Langkah 2: Menambahkan kode.

Instal AWS CDK dengan menjalankan npmperintah bersama dengan install tindakan, nama AWS CDK paket yang akan diinstal, dan -g opsi untuk menginstal paket secara global di lingkungan.

npm install -g aws-cdk

Konfirmasikan bahwa AWS CDK sudah diinstal dan direferensikan dengan benar. Untuk melakukan ini, jalankan perintah cdk dengan opsi --version .

cdk --version

Jika berhasil, AWS CDK versi dan nomor build akan ditampilkan.

Dengan sesi terminal masih terbuka di IDE, buat direktori untuk menyimpan kode sumber proyek, misalnya direktori ~/environment/hello-cdk di lingkungan Anda. Kemudian beralih ke direktori itu.

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.

Siapkan direktori sebagai proyek TypeScript bahasa untuk file AWS CDK. Untuk melakukan ini, jalankan perintah cdk dengan tindakan init , templat sample-app , dan opsi --language bersama dengan nama bahasa pemrograman.

cdk init sample-app --language typescript

Ini membuat file dan subdirektori berikut di direktori.

Di jendela Lingkungan, buka file lib/hello-cdk-stack.ts, dan telusuri kode berikut di file itu.

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

Di jendela Lingkungan, buka file bin/hello-cdk.ts, dan telusuri kode berikut di file itu.

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

Kode ini memuat, membuat instans, dan kemudian menjalankan kelas HelloCdkStack dari file lib/hello-cdk-stack.ts.

Gunakan npmuntuk menjalankan TypeScript kompiler untuk memeriksa kesalahan pengkodean, dan kemudian aktifkan AWS CDK untuk mengeksekusi bin/hello-cdk.js file proyek. Untuk melakukannya, dari direktori root proyek, jalankan perintah npm dengan tindakan run , dengan menetapkan nilai perintah build dalam file package.json, sebagai berikut.

npm run build

Perintah sebelumnya menjalankan TypeScript kompiler, yang menambahkan dukungan bin/hello-cdk.d.ts dan file. lib/hello-cdk-stack.d.ts Kompiler juga mentranspilasikan file hello-cdk.ts dan hello-cdk-stack.ts menjadi file hello-cdk.js dan hello-cdk-stack.js.

Minta template AWS CDK buat AWS CloudFormation tumpukan. Untuk melakukan ini, dengan sesi terminal masih terbuka di IDE, dari direktori root proyek, jalankan perintah cdk dengan tindakan synth dan nama tumpukan.

cdk synth HelloCdkStack

Jika berhasil, output menampilkan Resources bagian AWS CloudFormation stack template ini.

Pertama kali Anda menerapkan AWS CDK aplikasi ke lingkungan untuk AWS akun tertentu dan kombinasi AWS Wilayah, Anda harus menginstal tumpukan bootstrap. Tumpukan ini mencakup berbagai sumber daya yang AWS CDK dibutuhkan untuk menyelesaikan berbagai operasinya. Misalnya, tumpukan ini menyertakan bucket Amazon S3 yang AWS CDK digunakan untuk menyimpan templat dan aset selama proses penerapannya. Untuk memasang tumpukan bootstrap, jalankan perintah cdk dengan tindakan bootstrap .

cdk bootstrap

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

AWS CDK Jalankan template AWS CloudFormation tumpukan untuk menyebarkan tumpukan. Untuk melakukan ini, dari direktori root proyek, jalankan perintah cdk dengan tindakan deploy dan nama tumpukan.

cdk deploy HelloCdkStack

Jika berhasil, output menampilkan bahwa tumpukan HelloCdkStack di-deploy tanpa kesalahan.

Untuk mengonfirmasi bahwa topik Amazon SNS dan antrean Amazon SQS berhasil di-deploy, kirim pesan ke topik tersebut, lalu periksa antrean untuk pesan yang diterima. Untuk melakukan ini, Anda dapat menggunakan alat seperti AWS Command Line Interface (AWS CLI) atau AWS CloudShell. Untuk informasi lebih lanjut tentang alat ini, lihat AWS CLI dan tutorial aws-shell untuk AWS Cloud9.

Misalnya, untuk mengirim pesan ke topik, dengan sesi terminal masih terbuka di IDE, gunakan perintah AWS CLI untuk menjalankan publishperintah Amazon SNS, memasok subjek dan isi pesan, AWS Wilayah untuk topik, dan Nama Sumber Daya Amazon topik (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

Dalam perintah sebelumnya, ganti arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K dengan ARN yang AWS CloudFormation menetapkan topik. Untuk mendapatkan ID, Anda dapat menjalankan perintah list-topics Amazon SNS.

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

Jika berhasil, output dari perintah publish menampilkan nilai MessageId untuk pesan yang dipublikasikan.

Untuk memeriksa antrean pesan yang diterima, jalankan perintah receive-message Amazon SQS, yang menyediakan URL antrean.

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

Pada perintah sebelumnya, ganti https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K dengan ARN yang AWS CloudFormation menetapkan antrian. Untuk mendapatkan URL, Anda dapat menjalankan perintah list-queues Amazon SQS.

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

Jika berhasil, output dari perintah receive-message menampilkan informasi tentang pesan yang diterima.