Este é o Guia do Desenvolvedor AWS CDK v2. A versão CDK 1 mais antiga entrou em manutenção em 1º de junho de 2022 e encerrou o suporte em 1º de junho de 2023.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Implemente AWS CDK aplicativos

Uma AWS Cloud Development Kit (AWS CDK) implantação é o processo de provisionamento de sua infraestrutura. AWS

Como as AWS CDK implantações funcionam

Ele AWS CDK utiliza o AWS CloudFormation serviço para realizar implantações. Antes de implantar, você sintetiza suas CDK pilhas. Isso cria um CloudFormation modelo e artefatos de implantação para cada CDK pilha no seu aplicativo. As implantações são iniciadas a partir de uma máquina de desenvolvimento local ou de um ambiente de integração e entrega contínuas (CI/CD). Durante a implantação, os ativos são enviados para os recursos inicializados e o CloudFormation modelo é enviado para CloudFormation provisionar seus recursos. AWS

Para que uma implantação seja bem-sucedida, é necessário o seguinte:

Pré-requisitos para implantações CDK

Antes de implantar um AWS CDK aplicativo, você deve concluir o seguinte:

Configurar credenciais de segurança

Para usar o CDK CLI para interagir AWS, você deve configurar as credenciais de segurança em sua máquina local. Para obter instruções, consulte Configure as credenciais de segurança para o AWS CDKCLI.

Inicialize seu ambiente AWS

Uma implantação está sempre associada a um ou mais AWS ambientes. Antes que você possa implantar, o ambiente deve primeiro ser inicializado. O bootstrapping provisiona recursos em seu ambiente que ele CDK usa para realizar e gerenciar implantações. Esses recursos incluem um bucket do Amazon Simple Storage Service (Amazon S3) e um repositório Amazon Elastic Container Registry (ECRAmazon) para armazenar e gerenciar ativos. Esses recursos também incluem AWS Identity and Access Management (IAM) funções que são usadas para fornecer permissões durante o desenvolvimento e a implantação.

Recomendamos que você use o AWS CDK comando Command Line Interface (AWS CDK CLI) cdk bootstrap para inicializar seu ambiente. Você pode personalizar a inicialização ou criar manualmente esses recursos em seu ambiente, se necessário. Para obter instruções, consulte Inicialize seu ambiente para uso com o AWS CDK.

Configurar AWS ambientes

Cada CDK pilha deve estar associada a um ambiente para determinar onde a pilha é implantada. Para obter instruções, consulte Configure ambientes para usar com o AWS CDK.

Desenvolva seu CDK aplicativo

Dentro de um CDK projeto, você cria e desenvolve seu CDK aplicativo. No seu aplicativo, você cria uma ou mais CDK pilhas. Em suas pilhas, você importa e usa construções da AWS Construct Library para definir sua infraestrutura. Antes de implantar, seu CDK aplicativo deve conter pelo menos uma pilha.

CDKsíntese de aplicativos

Para realizar a síntese, recomendamos que você use o CDK CLI cdk synth comando. O cdk deploy comando também realizará a síntese antes de iniciar a implantação. No entanto, usandocdk synth, você pode validar seu CDK aplicativo e detectar erros antes de iniciar a implantação.

O comportamento da síntese é determinado pelo sintetizador de pilha que você configura para sua pilha. CDK Se você não configurar um sintetizador, DefaultStackSynthesizer será usado. Você também pode configurar e personalizar a síntese para atender às suas necessidades. Para obter instruções, consulte Configurar e realizar a síntese CDK da pilha.

Para que seu CloudFormation modelo sintetizado seja implantado com êxito em seu ambiente, ele deve ser compatível com a forma como seu ambiente foi inicializado. Por exemplo, seu CloudFormation modelo deve especificar o bucket correto do Amazon S3 no qual implantar ativos. Se você usar o método padrão de inicializar seu ambiente, o sintetizador de pilha padrão funcionará. Se você personalizar o CDK comportamento, como personalizar a inicialização ou a síntese, o comportamento da CDK implantação poderá variar.

O ciclo de vida do aplicativo

Quando você realiza a síntese, seu CDK aplicativo passa pelas seguintes fases, conhecidas como ciclo de vida do aplicativo:

Executando seu aplicativo

A CDK CLI necessidade de saber como executar seu CDK aplicativo. Se você criou o projeto a partir de um modelo usando o cdk init comando, o cdk.json arquivo do seu aplicativo inclui uma app chave. Essa chave especifica o comando necessário para o idioma em que o aplicativo está escrito. Se sua linguagem exigir compilação, a linha de comando executará essa etapa antes de executar o aplicativo automaticamente.

TypeScript

{
  "app": "npx ts-node --prefer-ts-exts bin/my-app.ts"
}

JavaScript

{
  "app": "node bin/my-app.js"
}

Python

{
    "app": "python app.py"
}

Java

{
  "app": "mvn -e -q compile exec:java"
}

C#

{
  "app": "dotnet run -p src/MyApp/MyApp.csproj"
}

Go

{
  "app": "go mod download && go run my-app.go"
}

Se você não criou seu projeto usando o. CDK CLI ou se quiser substituir a linha de comando fornecida emcdk.json, você pode fornecer a --app opção ao executar o cdk comando.

$ cdk --app 'executable' cdk-command ...

A ferramenta executable parte do comando indica o comando que deve ser executado para executar seu CDK aplicativo. Use aspas conforme mostrado, pois esses comandos contêm espaços. A ferramenta cdk-command é um subcomando como synth or deploy que informa o CDK CLI que você quer fazer com seu aplicativo. Siga isso com todas as opções adicionais necessárias para esse subcomando.

Eles também CDK CLI podem interagir diretamente com um conjunto de nuvem já sintetizado. Para fazer isso, passe o diretório no qual o conjunto de nuvem está armazenado--app. O exemplo a seguir lista as pilhas definidas no conjunto de nuvem armazenado em./my-cloud-assembly.

$ cdk --app ./my-cloud-assembly ls

Montagens em nuvem

A chamada para app.synth() é o que diz AWS CDK para sintetizar uma montagem em nuvem a partir de um aplicativo. Normalmente, você não interage diretamente com os conjuntos de nuvem. São arquivos que incluem tudo o que é necessário para implantar seu aplicativo em um ambiente de nuvem. Por exemplo, ele inclui um AWS CloudFormation modelo para cada pilha em seu aplicativo. Também inclui uma cópia de todos os ativos de arquivo ou Docker imagens que você referenciar no seu aplicativo.

Consulte a especificação de montagem em nuvem para obter detalhes sobre como as montagens em nuvem são formatadas.

Para interagir com o conjunto de nuvem que seu AWS CDK aplicativo cria, você normalmente usa AWS CDK CLI o. No entanto, qualquer ferramenta que possa ler o formato de montagem em nuvem pode ser usada para implantar seu aplicativo.

Implantar o aplicativo

Para implantar seu aplicativo, recomendamos que você use o CDK CLI cdk deploy comando para iniciar implantações ou configurar implantações automatizadas.

Quando você executacdk deploy, ele CDK CLI inicia a preparação cdk synth para a implantação. O diagrama a seguir ilustra o ciclo de vida do aplicativo no contexto de uma implantação:

Durante a implantação, ele CDK CLI pega a montagem da nuvem produzida pela síntese e a implanta em um AWS ambiente. Os ativos são enviados para o Amazon S3 e para a Amazon ECR e o CloudFormation modelo é enviado AWS CloudFormation para implantação.

Quando a fase de AWS CloudFormation implantação começa, seu CDK aplicativo já terminou de ser executado e foi encerrado. Isso ocasiona o seguinte:

Permissões de implantação

Antes que a implantação possa ser executada, as permissões devem ser estabelecidas. O diagrama a seguir ilustra as permissões que são usadas durante uma implantação padrão, ao usar o processo de inicialização padrão e o sintetizador de pilha: