AWS CDK tutorial para AWS Cloud9

Em uma sessão de terminal no AWS Cloud9 IDE, certifique-se de que as atualizações de segurança e correções de erros mais recentes 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 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á TypeScript instalou. Para fazer isso, com a sessão do terminal ainda aberta no IDE, execute o TypeScript compilador da linha de comando com a --versionopção.

tsc --version

Se você tiver TypeScript instalado, a saída conterá o número da TypeScript versão. Se TypeScript estiver instalado, vá paraEtapa 1.4: Instalar o AWS CDK.

Instalar TypeScript. Para fazer isso, execute o npmcomando com a installação, a -gopção e o nome do TypeScript pacote. Isso é instalado TypeScript como um pacote global no ambiente.

npm install -g typescript

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

tsc --version

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

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 AWS CDK versão e os números de compilação. Avance para Etapa 2: Adicionar código.

Instale o AWS CDK executando o npmcomando junto com a install ação, o nome do AWS CDK pacote a ser instalado e a -g opção de 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, os números da AWS CDK versão e da versão 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 TypeScript linguagem para AWS CDK o. 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 npmpara executar o TypeScript compilador para verificar se há erros de codificação e, em seguida, habilite o AWS CDK para executar o arquivo do bin/hello-cdk.js 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 TypeScript compilador, que adiciona suporte bin/hello-cdk.d.ts e lib/hello-cdk-stack.d.ts arquivos. 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 eles AWS CDK criem o modelo CloudFormation de pilha. 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-sucedida, a saída exibirá a Resources seção do modelo de CloudFormation pilha.

Na primeira vez que você implanta um AWS CDK aplicativo em um ambiente para uma combinação específica de AWS conta e AWS região, você deve instalar uma pilha de bootstrap. Essa pilha inclui vários recursos AWS CDK necessários para concluir suas várias operações. Por exemplo, essa pilha inclui um bucket Amazon S3 que é AWS CDK usado para armazenar modelos e ativos durante seus 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 AWS CDK execute o modelo de CloudFormation pilha 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 o AWS Command Line Interface (AWS CLI) ou AWS CloudShell o. Para mais informações sobre essas ferramentas, consulte AWS CLI e tutorial aws-shell para AWS Cloud9.

Por exemplo, para enviar uma mensagem para o tópico, com a sessão do terminal ainda aberta no IDE, use o AWS CLI para executar o publishcomando Amazon SNS, fornecendo o assunto e o corpo da mensagem, a AWS região do tópico e o nome de 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, arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K substitua pelo ARN atribuído CloudFormation 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, https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K substitua pelo ARN atribuído CloudFormation à 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.