Tutorial do AWS CDK para o AWS Cloud9

Em uma sessão de terminal no IDE do AWS Cloud9, certifique-se de que as últimas atualizações de segurança e correções de bugs estejam instaladas. Para fazer isso, execute o comando yum update para Amazon Linux ou apt update para Ubuntu Server. (Para iniciar uma nova sessão de terminal, na barra de menus, selecione Janela, Novo terminal.)

Para Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt update

Confirme se o nvm já está instalado. Para fazer isso, execute o comando nvm com a opção --version .

nvm --version

Se for bem-sucedido, a saída conterá o número da versão do nvm , e você poderá ir direto para Etapa 1.2: Instalar o Node.js.

Faça download e instale nvm . Para fazer isso, execute o script de instalação. Neste exemplo, a versão v0.33.0 é instalada, mas é possível verificar a versão mais recente do nvm aqui.

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

Comece a utilizar nvm . Você pode fechar a sessão de terminal e depois iniciá-la novamente ou extrair o arquivo ~/.bashrc que contém os comandos para carregar o nvm .

. ~/.bashrc

Confirme se você já tem o Node.js instalado e, se tiver, confirme se a versão instalada é a 16.17.0 ou posterior. Este exemplo foi testado no Node.js 16.17.0. Para verificar, com a sessão de terminal ainda aberta no IDE, execute o comando node com a opção --version .

node --version

Se já tem o Node.js instalado, a saída contém o número da versão. Se o número da versão for v16.17.0, avance para Etapa 1.3: Instalar o TypeScript.

Instale o Node.js 16 executando o comando nvm com a ação install .

nvm install v16

Comece a usar o Node.js 16. Para fazer isso, execute o comando nvm com a ação alias , o número da versão para alias e a versão a ser usada para esse alias, como mostrado a seguir.

nvm alias default 16

Para confirmar se está usando o Node.js 16, execute o comando node --version novamente. Se a versão correta estiver instalada, a saída conterá a versão v16.

Confirme se você já tem o TypeScript instalado. Para fazer isso, com a sessão de terminal ainda aberta no IDE, execute a linha de comando do compilador do TypeScript com a opção --version .

tsc --version

Se já tem o TypeScript instalado, a saída contém o número da versão do TypeScript. Se o TypeScript estiver instalado, avance para Etapa 1.4: Instalar o AWS CDK.

Instale o TypeScript. Para fazer isso, execute o comando npm com a ação install , a opção -g , e o nome do pacote do TypeScript. Isso instala o TypeScript como um pacote global no ambiente.

npm install -g typescript

Confirme se o TypeScript está instalado. Para fazer isso, execute a linha de comando do compilador do Typescript com a opção --version .

tsc --version

Se o TypeScript já estiver instalado, a saída conterá o número da versão do TypeScript.

Confirme se você já tem o AWS CDK instalado. Para fazer isso, com a sessão de terminal ainda aberta no IDE, execute o comando cdk com a opção --version .

cdk --version

Se o AWS CDK estiver instalado, a saída conterá a versão do AWS CDK e os números de revisão. Avance para Etapa 2: Adicionar código.

Instale o AWS CDK executando o comando npm junto com a ação install, o nome do pacote do AWS CDK a ser instalado e a opção -g para instalar o pacote globalmente no ambiente.

npm install -g aws-cdk

Confirme se o AWS CDK está instalado e referenciado corretamente. Para fazer isso, execute o comando cdk com a opção --version .

cdk --version

Se for bem-sucedido, a versão e os números de revisão do AWS CDK serão exibidos.

Com a sessão de terminal ainda aberta no IDE, crie um diretório para armazenar o código-fonte do projeto, por exemplo, um diretório ~/environment/hello-cdk no seu ambiente. Depois, mude para esse diretório.

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.

Configure o diretório como um projeto de linguagem TypeScript para o AWS CDK. Para fazer isso, execute o comando cdk com a ação init , o modelo sample-app e a opção --language com o nome da linguagem de programação.

cdk init sample-app --language typescript

Isso cria os seguintes arquivos e subdiretórios no diretório:

Na janela Ambiente, abra o arquivo lib/hello-cdk-stack.ts e procure o código a seguir.

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

Na janela Ambiente, abra o arquivo bin/hello-cdk.ts e procure o código a seguir.

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

Esse código carrega, cria uma instância e executa a classe HelloCdkStack do arquivo lib/hello-cdk-stack.ts.

Use npm para executar o compilador do TypeScript para verificar se há erros de codificação e habilitar o AWS CDK para executar o arquivo bin/hello-cdk.js do projeto. Para fazer isso, no diretório raiz do projeto, execute o comando npm com a ação run , especificando o valor do comando build no arquivo package.json, conforme mostrado a seguir.

npm run build

O comando anterior executa o compilador TypeScript, que adiciona suporte aos arquivos lib/hello-cdk-stack.d.ts e bin/hello-cdk.d.ts. O compilador também desmembra os arquivos hello-cdk.ts e hello-cdk-stack.ts nos arquivos hello-cdk.js e hello-cdk-stack.js.

Faça com que o AWS CDK crie o modelo de pilha do AWS CloudFormation. Para fazer isso, com a sessão de terminal ainda aberta no IDE, no diretório raiz do projeto, execute o comando cdk com a ação synth e o nome da pilha.

cdk synth HelloCdkStack

Se for bem-sucedido, a saída exibirá a seção Resources do modelo de pilha do AWS CloudFormation.

Na primeira vez que implantar um aplicativo um AWS CDK em um ambiente para uma combinação específica de conta da AWS e Região da AWS, é necessário instalar uma pilha de bootstrap. Essa pilha inclui vários recursos necessários para o AWS CDK concluir suas várias operações. Por exemplo, essa pilha inclui um bucket do Amazon S3 que o AWS CDK usa para armazenar modelos e ativos durante os processos de implantação. Para instalar a pilha de bootstrap, execute o comando cdk com a ação de bootstrap .

cdk bootstrap

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

Faça com que o AWS CDK execute o modelo de pilha do AWS CloudFormation para implantar a pilha. Para fazer isso, no diretório raiz do projeto, execute o comando cdk com a ação deploy e o nome da pilha.

cdk deploy HelloCdkStack

Se for bem-sucedido, a saída exibe que a pilha HelloCdkStack foi implantada sem erros.

Para confirmar se o tópico do Amazon SNS e a fila do Amazon SQS foram implantados com êxito, envie uma mensagem ao tópico e consulte a fila para verificar se a mensagem foi recebida. Para fazer isso, você pode usar uma ferramenta, como a AWS Command Line Interface (AWS CLI) ou o AWS CloudShell. Para mais informações sobre essas ferramentas, consulte AWS CLI e tutorial aws-shell para o AWS Cloud9.

Por exemplo, para enviar uma mensagem ao tópico, com a sessão de terminal ainda aberta no IDE, use a AWS CLI para executar o comando publish do Amazon SNS, fornecendo o assunto e o corpo da mensagem, a região da AWS para o tópico e o nome do recurso da Amazon (ARN) do tópico.

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

No comando anterior, substitua arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K pelo ARN que o AWS CloudFormation atribui ao tópico. Para obter o ID, você pode executar o comando list-topics do Amazon SNS.

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

Se for bem-sucedido, a saída do comando publish exibe o valor MessageId para a mensagem que foi publicada.

Para verificar se a fila recebeu a mensagem, execute o comando receive-message do Amazon SQS, fornecendo o URL da fila.

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

No comando anterior, substitua https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K pelo ARN que o AWS CloudFormation atribui à fila. Para obter o URL, você pode executar o comando list-queues do Amazon SQS.

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

Se for bem-sucedido, a saída do comando receive-message exibe as informações sobre a mensagem que foi recebida.