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 사용을 시작합니다. 터미널 세션을 닫고 나서 다시 시작하거나 명령을 포함하는 ~/.bashrc 파일을 소싱하여 nvm을 로드합니다.

. ~/.bashrc

Node.js 설치 여부를 확인하고, 설치한 경우 설치된 버전이 16.17.0 이상인지 확인합니다. 이 샘플은 Node.js 16.17.0에서 테스트되었습니다. 확인하려면 에서 터미널 세션이 아직 열려 있는 상태에서 --version 옵션을 사용하여 node 명령을 IDE실행합니다.

node --version

Node.js를 설치했으면 출력에 버전 번호가 포함됩니다. 버전 번호가 v16.17.0이면 1.3단계: 설치 TypeScript 섹션으로 이동합니다.

nvm 명령을 install 작업과 함께 실행하여 Node.js 16을 설치합니다.

nvm install v16

Node.js 16 사용을 시작합니다. 이렇게 하려면 다음과 같이 alias 작업, 별칭을 지정할 버전 번호 및 해당 별칭에 사용할 버전을 사용하여 nvm 명령을 실행합니다.

nvm alias default 16

Node.js 16을 사용 중인지 확인하려면 node --version 명령을 다시 실행합니다. 올바른 버전이 설치된 경우 출력에 버전 v16이 포함됩니다.

이미 를 TypeScript 설치했는지 확인합니다. 이렇게 하려면 에서 터미널 세션이 여전히 열려 있는 상태에서 --version 옵션을 사용하여 명령줄 TypeScript 컴파일러를 IDE실행합니다.

tsc --version

를 TypeScript 설치한 경우 출력에 TypeScript 버전 번호가 포함됩니다. TypeScript 가 설치된 경우 로 건너뜁니다1.4단계: 설치 AWS CDK.

를 설치합니다 TypeScript. 이렇게 하려면 install 작업, -g 옵션 및 TypeScript 패키지 이름을 사용하여 npm 명령을 실행합니다. 이는 환경에 글로벌 패키지 TypeScript 로 설치됩니다.

npm install -g typescript

TypeScript 이 설치되어 있는지 확인합니다. 이렇게 하려면 --version 옵션을 사용하여 명령줄 TypeScript 컴파일러를 실행합니다.

tsc --version

TypeScript 가 설치된 경우 출력에는 TypeScript 버전 번호가 포함됩니다.

가 이미 AWS CDK 설치되어 있는지 확인합니다. 이렇게 하려면 에서 터미널 세션이 여전히 열려 있는 상태에서 --version 옵션을 사용하여 cdk 명령을 IDE실행합니다.

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 버전 및 빌드 번호가 표시됩니다.

에서 터미널 세션이 아직 열려 있는 상태에서 환경의 디렉터리와 같이 프로젝트의 소스 코드를 저장할 ~/environment/hello-cdk 디렉터리를 IDE생성합니다. 그런 다음 해당 디렉터리로 전환합니다.

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 하도록 활성화합니다. 이렇게 하려면 프로젝트의 루트 디렉터리에서 다음과 같이 package.json 파일에 build 명령 값을 지정하고 run 작업을 사용하여 npm 명령을 실행합니다.

npm run build

앞의 명령은 TypeScript 컴파일러를 실행하여 지원 bin/hello-cdk.d.ts 및 lib/hello-cdk-stack.d.ts 파일을 추가합니다. 이 컴파일러는 hello-cdk.ts 및 hello-cdk-stack.ts 파일을 hello-cdk.js 및 hello-cdk-stack.js 파일로 트랜스컴파일합니다.

AWS CloudFormation 스택 템플릿을 AWS CDK 생성하도록 합니다. 이렇게 하려면 에서 터미널 세션이 열려 있는 상태에서 프로젝트의 루트 디렉터리IDE에서 synth 작업 및 스택 이름으로 cdk 명령을 실행합니다.

cdk synth HelloCdkStack

성공하면 출력에 AWS CloudFormation 스택 템플릿의 Resources 섹션이 표시됩니다.

특정 AWS 계정 및 AWS 리전 조합의 환경에 AWS CDK 앱을 처음 배포할 때는 부트스트랩 스택 을 설치해야 합니다. 이 스택에는 이 다양한 작업을 완료하는 데 AWS CDK 필요한 다양한 리소스가 포함되어 있습니다. 예를 들어 이 스택에는 이 배포 프로세스 중에 템플릿과 자산을 저장하는 데 AWS CDK 사용하는 Amazon S3 버킷이 포함되어 있습니다. 부트스트랩 스택을 설치하려면 bootstrap 작업을 사용하여 cdk 명령을 실행합니다.

cdk bootstrap

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

가 AWS CloudFormation 스택 템플릿을 AWS CDK 실행하여 스택을 배포하도록 합니다. 이렇게 하려면 deploy 작업 및 스택의 이름을 사용하여 프로젝트의 루트 디렉터리에서 cdk 명령을 실행합니다.

cdk deploy HelloCdkStack

성공하면 출력에 HelloCdkStack 스택이 오류 없이 배포되었다는 메시지가 표시됩니다.

Amazon SNS 주제와 Amazon SQS 대기열이 성공적으로 배포되었는지 확인하려면 주제에 메시지를 보낸 다음 대기열에서 수신된 메시지를 확인합니다. 이렇게 하려면 AWS Command Line Interface (AWS CLI) 또는 와 같은 도구를 사용할 수 있습니다 AWS CloudShell. 이러한 도구에 대한 자세한 내용은 AWS CLI 및 aws-shell 자습서 AWS Cloud9 단원을 참조하십시오.

예를 들어, 에서 터미널 세션이 열려 있는 상태에서 주제에 메시지를 보내려면 IDE를 사용하여 Amazon SNS publish 명령을 실행 AWS CLI 하고 메시지의 주제와 본문, 주제의 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

앞의 명령에서 주제에 AWS CloudFormation 할당ARN하는 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

앞의 명령에서 대기열에 AWS CloudFormation 할당ARN하는 https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K로 를 바꿉니다. 를 가져오려면 Amazon SQS list-queues 명령을 실행할 URL수 있습니다.

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

성공하면 receive-message 명령의 출력에 수신된 메시지에 대한 정보가 표시됩니다.