AWS CDK tutorial para AWS Cloud9

Em uma sessão de terminal no AWS Cloud9 IDE, verifique se as atualizações de segurança e correções de erros mais recentes estão 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 do terminal ainda aberta noIDE, execute o nodecomando com a --versionopção.

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 noIDE, execute o TypeScript compilador de 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 do terminal ainda aberta noIDE, execute o cdkcomando com a --versionopção.

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 do terminal ainda aberta noIDE, crie um diretório para armazenar o código-fonte do projeto, por exemplo, um ~/environment/hello-cdk diretório em 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 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.

Peça AWS CDK para criar o modelo AWS CloudFormation de pilha. Para fazer isso, com a sessão do terminal ainda aberta noIDE, a partir do diretório raiz do projeto, execute o cdkcomando com a synthação e o nome da pilha.

cdk synth HelloCdkStack

Se for bem-sucedida, a saída exibirá a Resources seção do modelo de AWS 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 AWS 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 que o SNS tópico da Amazon e a SQS fila da Amazon foram implantados com sucesso, envie uma mensagem para o tópico e, em seguida, verifique a mensagem recebida na fila. 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 noIDE, use o AWS CLI para executar o SNS publishcomando da Amazon, fornecendo o assunto e o corpo da mensagem, a AWS região do tópico e o nome de recurso da Amazon do tópico (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

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

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 a fila da mensagem recebida, execute o SQS receive-messagecomando Amazon, fornecendo as da fila. URL

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 que é AWS CloudFormation atribuído à fila. Para obter oURL, você pode executar o SQS list-queuescomando Amazon.

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.