A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md). 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á. # Inicializando um AWS CDK aplicativo com um fluxo de trabalho Esta seção descreve como inicializar um AWS CDK aplicativo usando um CodeCatalyst fluxo de trabalho. Para fazer isso, você deve adicionar a ação **Inicialização do AWS CDK ** ao seu fluxo de trabalho. A ação **Inicialização do AWS CDK ** provisiona uma pilha de inicialização no ambiente da AWS usando o [modelo moderno](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-template). Se já existir uma pilha de inicialização, a ação a atualizará, se necessário. Ter uma pilha de bootstrap presente AWS é um pré-requisito para implantar um aplicativo. AWS CDK Para ter mais informações sobre inicialização, consulte [Inicialização](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) no *Guia do desenvolvedor do AWS Cloud Development Kit (AWS CDK) *. **Topics** + [Quando usar a ação 'AWS CDK bootstrap'](#cdk-boot-action-when-to-use) + [Como funciona a ação 'AWS CDK bootstrap'](#cdk-boot-action-how-it-works) + [Versões do CDK CLI usadas pela ação AWS CDK "bootstrap”](#cdk-boot-action-cdk-version) + [Imagem de tempo de execução usada pela ação 'AWS CDK bootstrap'](#cdk-boot-action-runtime) + [Exemplo: inicialização de um aplicativo AWS CDK](cdk-boot-action-example-workflow.md) + [Adicionando a ação 'AWS CDK bootstrap'](cdk-boot-action-add.md) + [variáveis de “Inicialização do AWS CDK ”](cdk-boot-action-variables.md) + [YAML da ação “Inicialização do AWS CDK ”](cdk-boot-action-ref.md) ## Quando usar a ação 'AWS CDK bootstrap' Use essa ação se você tiver um fluxo de trabalho que implanta um AWS CDK aplicativo e quiser implantar (e atualizar, se necessário) a pilha de bootstrap ao mesmo tempo. Nesse caso, você adicionaria a ação de **AWS CDK bootstrap** ao mesmo fluxo de trabalho que implanta seu AWS CDK aplicativo. **Não** use essa ação se uma das seguintes opções se aplicar: + Você já implantou uma pilha de inicialização usando outro mecanismo e deseja mantê-la intacta (sem atualizações). + Você quer usar um [modelo de inicialização personalizado](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-customizing), que não é compatível com a ação **Inicialização do AWS CDK **. ## Como funciona a ação 'AWS CDK bootstrap' A **Inicialização do AWS CDK ** funciona da seguinte maneira: 1. [Em tempo de execução, se você especificou a versão 1.0.7 ou anterior da ação, a ação baixará a CLI CDK mais recente (também chamada de AWS CDK Tookit) para a imagem de compilação. CodeCatalyst ](build-images.md) Se você especificou a versão 1.0.8 ou posterior, a ação vem junto com uma [versão específica](cdk-dep-action.md#cdk-dep-action-cdk-version) da CLI do CDK e, portanto, nenhum download ocorre. 1. A ação usa a CLI do CDK para executar o comando `cdk bootstrap`. Esse comando executa as tarefas de inicialização descritas no tópico [Inicialização](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) no *Guia do desenvolvedor do AWS Cloud Development Kit (AWS CDK) *. ## Versões do CDK CLI usadas pela ação AWS CDK "bootstrap” A tabela a seguir mostra qual versão da CLI do CDK é usada por padrão por diferentes versões da ação **Inicialização do AWS CDK **. **nota** Talvez você consiga substituir o padrão. Para ter mais informações, consulte [CdkCliVersion](cdk-boot-action-ref.md#cdk.boot.cdk.cli.version) no [YAML da ação “Inicialização do AWS CDK ”](cdk-boot-action-ref.md). | versão de ação “Inicialização do AWS CDK ” | AWS CDK Versão CLI | | --- | --- | | 1.0.0 – 1.0.7 | mais recente | | 1.0.8 ou posterior | 2.99.1 | ## Imagem de tempo de execução usada pela ação 'AWS CDK bootstrap' A tabela a seguir mostra as imagens do ambiente de execução CodeCatalyst usadas para executar diferentes versões da ação de **AWS CDK bootstrap**. As imagens incluem diferentes conjuntos de ferramentas pré-instaladas. Para obter mais informações, consulte [Imagens ativas](build-images.md#build-curated-images). **nota** Recomendamos atualizar sua ação **Inicialização do AWS CDK ** para a versão 2.x para aproveitar as ferramentas mais recentes disponíveis na imagem de março de 2024. Para atualizar a ação, defina a propriedade `Identifier` como `aws/cdk-bootstrap@v2` no arquivo de definição de fluxo de trabalho. Para obter mais informações, consulte [YAML da ação “Implantação do AWS CDK ”](cdk-dep-action-ref.md). | versão de ação “Inicialização do AWS CDK ” | Imagens de ambiente de runtime | | --- | --- | | 1.x | Imagens de novembro de 2022 | | 2.x | Imagens de março de 2024 | # Exemplo: inicialização de um aplicativo AWS CDK Consulte o [Exemplo: implantação de um aplicativo AWS CDK](cdk-dep-action-example-workflow.md) na [Implantando um AWS CDK aplicativo com um fluxo de trabalho](cdk-dep-action.md) para obter um fluxo de trabalho que inclui a ação **AWS CDK bootstrap**. # Adicionando a ação 'AWS CDK bootstrap' Use as instruções a seguir para adicionar a ação **Inicialização do AWS CDK ** ao seu fluxo de trabalho. **Antes de começar** Antes de usar a ação **Inicialização do AWS CDK **, verifique se você tem uma aplicação AWS CDK pronta. A ação bootstrap sintetizará o AWS CDK aplicativo antes da inicialização. Você pode escrever a aplicação em qualquer linguagem de programação compatível com o AWS CDK. Verifique se os arquivos AWS CDK do seu aplicativo estão disponíveis em: + Um [repositório de CodeCatalyst origem](source.md) ou + Um [artefato CodeCatalyst de saída](workflows-working-artifacts.md) gerado por outra ação do fluxo de trabalho ------ #### [ Visual ] **Para adicionar a ação 'AWS CDK bootstrap' usando o editor visual** 1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Selecione o projeto. 1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**. 1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho. 1. Escolha **Editar**. 1. Selecione **Visual**. 1. No canto superior esquerdo, selecione **\$1 Ações** para abrir o catálogo de ações. 1. **Na lista suspensa, escolha Amazon. CodeCatalyst** 1. Procure a ação **Inicialização do AWS CDK ** e faça o seguinte: + Selecione o sinal de adição (**\$1**) para adicionar a ação ao diagrama do fluxo de trabalho e abrir seu painel de configuração. Ou + Selecione **Inicialização do AWS CDK **. A caixa de diálogo de detalhes da ação é exibida. Nessa caixa de diálogo: + (Opcional) Selecione **Visualizar origem** para [visualizar o código-fonte da ação](workflows-view-source.md#workflows-view-source.title). + Selecione **Adicionar ao fluxo de trabalho** para adicionar a ação ao diagrama do fluxo de trabalho e abrir seu painel de configuração. 1. Nas guias **Entradas**, **Configuração** e **Saídas**, preencha os campos de acordo com suas necessidades. Para ver uma descrição de cada campo, consulte [YAML da ação “Inicialização do AWS CDK ”](cdk-boot-action-ref.md). Essa referência fornece informações detalhadas sobre cada campo (e o valor da propriedade YAML correspondente) conforme elas aparecem nos editores YAML e visual. 1. (Opcional) Selecione **Validar** para validar o código YAML do fluxo de trabalho antes de confirmar. 1. Selecione **Confirmar**, insira uma mensagem de confirmação e escolha **Confirmar** novamente. **nota** Se a ação **Inicialização do AWS CDK ** falhar com um erro `npm install`, consulte [Como faço para corrigir erros de “instalação npm”?](troubleshooting-workflows.md#troubleshooting-workflows-npm) para ter informações sobre como corrigir o erro. ------ #### [ YAML ] **Para adicionar a ação 'AWS CDK bootstrap' usando o editor YAML** 1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Selecione o projeto. 1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**. 1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho. 1. Escolha **Editar**. 1. Selecione **YAML**. 1. No canto superior esquerdo, selecione **\$1 Ações** para abrir o catálogo de ações. 1. **Na lista suspensa, escolha Amazon. CodeCatalyst** 1. Procure a ação **Inicialização do AWS CDK ** e selecione **\$1** para adicioná-la ao diagrama do fluxo de trabalho e abrir o painel de configuração. 1. Modifique as propriedades no código YAML de acordo com as suas necessidades. Uma explicação de cada propriedade disponível é fornecida em [YAML da ação “Inicialização do AWS CDK ”](cdk-boot-action-ref.md). 1. (Opcional) Selecione **Validar** para validar o código YAML do fluxo de trabalho antes de confirmar. 1. Selecione **Confirmar**, insira uma mensagem de confirmação e escolha **Confirmar** novamente. **nota** Se a ação **Inicialização do AWS CDK ** falhar com um erro `npm install`, consulte [Como faço para corrigir erros de “instalação npm”?](troubleshooting-workflows.md#troubleshooting-workflows-npm) para ter informações sobre como corrigir o erro. ------ # variáveis de “Inicialização do AWS CDK ” A ação **Inicialização do AWS CDK ** produz e define as seguintes variáveis em runtime. Elas são conhecidas como *variáveis predefinidas*. Para ter informações sobre como referenciar essas variáveis em um fluxo de trabalho, consulte [Usar variáveis predefinidas](workflows-using-predefined-variables.md). | Chave | Valor | | --- | --- | | deployment-platform | O nome da plataforma de implantação. Codificado para `AWS:CloudFormation`. | | region | O código de região em Região da AWS que a pilha de AWS CDK bootstrap foi implantada durante a execução do fluxo de trabalho. Exemplo: `us-west-2` | | stack-id | O Amazon Resource Name (ARN) da pilha de bootstrap implantada. AWS CDK Exemplo: `arn:aws:cloudformation:us-west-2:111122223333:stack/codecatalyst-cdk-bootstrap-stack/6aad4380-100a-11ec-a10a-03b8a84d40df` | | SKIP-DEPLOYMENT | Um valor de `true` indica que a implantação da sua pilha de AWS CDK bootstrap foi ignorada durante a execução do fluxo de trabalho. Uma implantação da pilha será ignorada se não houver nenhuma alteração na pilha desde a última implantação. Essa variável só será produzida se o valor for `true`. Codificado para `true`. | # YAML da ação “Inicialização do AWS CDK ” Confira a seguir a definição de YAML da ação **Inicialização do AWS CDK **. Para saber como usar essa ação, consulte [Inicializando um AWS CDK aplicativo com um fluxo de trabalho](cdk-boot-action.md). Essa definição de ação existe como uma seção dentro de um arquivo de definição de fluxo de trabalho mais amplo. Para obter mais informações sobre esse arquivo, consulte [Definição do YAML do fluxo de trabalho](workflow-reference.md). **nota** A maioria das propriedades YAML a seguir tem elementos de interface de usuário correspondentes no editor visual. Para pesquisar um elemento de interface, use **Ctrl\$1F**. O elemento será listado com a propriedade YAML associada. ``` # The workflow definition starts here. # See Propriedades de nível superior for details. Name: MyWorkflow SchemaVersion: 1.0 Actions: # The action definition starts here. CDKBootstrapAction\$1nn: Identifier: aws/cdk-bootstrap@v2 DependsOn: - action-name Compute: Type: EC2 | Lambda Fleet: fleet-name Timeout: timeout-minutes Inputs: # Specify a source or an artifact, but not both. Sources: - source-name-1 Artifacts: - artifact-name Outputs: Artifacts: - Name: cdk_bootstrap_artifacts Files: - "cdk.out/**/*" Environment: Name: environment-name Connections: - Name: account-connection-name Role: iam-role-name Configuration: Region: us-west-2 CdkCliVersion: version ``` ## CDKBootstrapAction (Obrigatório) Especifique o nome da ação. Todos os nomes de ação devem ser exclusivos no fluxo de trabalho. Os nomes de ação são limitados a caracteres alfanuméricos (a-z, A-Z, 0-9), hifens (-) e sublinhados (\$1). Não são permitidos espaços. Não é possível usar aspas para habilitar caracteres especiais e espaços nos nomes de ação. Padrão: `CDKBootstrapAction_nn`. Interface de usuário correspondente: guia Configuração/**Nome de exibição da ação** ## Identifier (*CDKBootstrapAction*/**Identifier**) (Obrigatório) Identifica a ação. Não altere essa propriedade, a menos que você queira alterar a versão. Para obter mais informações, consulte [Especificação da versão da ação a ser usada](workflows-action-versions.md). **nota** A especificação de `aws/cdk-bootstrap@v2` faz com que a ação seja executada na [imagem de março de 2024](build-images.md#build.default-image), que inclui ferramentas mais recentes, como Node.js 18. A especificação de `aws/cdk-bootstrap@v1` faz com que a ação seja executada na [imagem de novembro de 2022](build-images.md#build.previous-image), que inclui ferramentas mais antigas, como Node.js 16. Padrão: `aws/cdk-bootstrap@v2`. Interface de usuário correspondente: Diagrama de fluxo de trabalho/CDKBootstrapAction\$1nn/rótulo **aws/cdk-bootstrap@v2** ## DependsOn (*CDKBootstrapAction*/**DependsOn**) (Optional) Especifique uma ação, um grupo de ação ou um portão que deve ser executado com êxito para que essa ação seja executada. Para ter mais informações sobre a funcionalidade “Depende de”, consulte [Sequenciar ações](workflows-depends-on.md). Interface de usuário correspondente: guia Entradas/**Depende de - opcional** ## Compute (*CDKBootstrapAction*/**Compute**) (Optional) O mecanismo de computação usado para executar as ações de fluxo de trabalho. É possível especificar a computação em nível de fluxo de trabalho ou em nível de ação, mas não em ambos. Quando especificada em nível de fluxo de trabalho, a configuração de computação se aplica a todas as ações definidas no fluxo de trabalho. Em nível de fluxo de trabalho, também é possível realizar várias ações na mesma instância. Para obter mais informações, consulte [Compartilhamento de computação entre ações](compute-sharing.md). Interface de usuário correspondente: *nenhuma* ## Type (*CDKBootstrapAction*/Compute/**Type**) (Obrigatório se [Compute](#cdk.boot.computename) for incluído) O tipo do mecanismo de computação. É possível usar um dos seguintes valores: + **EC2**(editor visual) ou `EC2` (editor YAML) Otimizado para flexibilidade durante as execuções de ação. + **Lambda** (editor visual) ou `Lambda` (editor YAML) Velocidades otimizadas de inicialização da ação. Para obter informações sobre tipos de dados, consulte [Tipos de computação](workflows-working-compute.md#compute.types). **UI correspondente: Configuração tab/Advanced - opcional/Tipo de computação** ## Fleet (*CDKBootstrapAction*/Compute/**Fleet**) (Optional) Especifique a máquina ou a frota que executará o fluxo de trabalho ou as ações de fluxo de trabalho. Com frotas sob demanda, quando uma ação é iniciada, o fluxo de trabalho provisiona os recursos necessários e as máquinas são destruídas quando a ação termina. Exemplos de frota sob demanda: `Linux.x86-64.Large`, `Linux.x86-64.XLarge`. Para ter mais informações sobre frotas sob demanda, consulte [Propriedades da frota sob demanda](workflows-working-compute.md#compute.on-demand). Com frotas provisionadas, você configura um conjunto de máquinas dedicadas para realizar as ações do fluxo de trabalho. Essas máquinas permanecem ociosas, prontas para processar ações imediatamente. Para ter mais informações sobre frotas provisionadas, consulte [Propriedades da frota provisionada](workflows-working-compute.md#compute.provisioned-fleets). Se `Fleet` for omitido, o padrão será `Linux.x86-64.Large`. **UI correspondente: configuração tab/Advanced - opcional/frota de computação** ## Timeout (*CDKBootstrapAction*/**Timeout**) (Obrigatório) Especifique a quantidade de tempo em minutos (editor YAML) ou horas e minutos (editor visual) que a ação pode ser executada antes de CodeCatalyst finalizar a ação. O mínimo é de cinco minutos e o máximo está descrito em [Cotas para fluxos de trabalho em CodeCatalyst](workflows-quotas.md). O tempo limite padrão é igual ao tempo limite máximo. Interface de usuário correspondente: guia Configuração/**Tempo limite - opcional** ## Inputs (*CDKBootstrapAction*/**Inputs**) (Optional) A seção `Inputs` define os dados que a ação **Inicialização do AWS CDK ** precisa durante a execução de um fluxo de trabalho. Interface de usuário correspondente: guia **Entradas** **nota** Somente uma entrada (uma fonte ou um artefato) é permitida para cada ação **Inicialização do AWS CDK **. ## Sources (*CDKBootstrapAction*/Inputs/**Sources**) (Obrigatório se seu AWS CDK aplicativo estiver armazenado em um repositório de origem) Se seu AWS CDK aplicativo estiver armazenado em um repositório de origem, especifique o rótulo desse repositório de origem. A ação **Inicialização do AWS CDK ** sintetiza a aplicação nesse repositório antes de iniciar o processo de inicialização. Atualmente, o único rótulo do repositório compatível é `WorkflowSource`. Se seu AWS CDK aplicativo não estiver contido em um repositório de origem, ele deverá residir em um artefato gerado por outra ação. Para obter mais informações sobre fontes, consulte [Conectar repositórios de origem aos fluxos de trabalho](workflows-sources.md). Interface de usuário correspondente: guia Entradas/**Origens - opcional** ## Artifacts - input (*CDKBootstrapAction*/Inputs/**Artifacts**) (Obrigatório se seu AWS CDK aplicativo estiver armazenado em um [artefato de saída](workflows-working-artifacts-output.md) de uma ação anterior) Se seu AWS CDK aplicativo estiver contido em um artefato gerado por uma ação anterior, especifique esse artefato aqui. A ação **AWS CDK bootstrap** sintetiza o aplicativo no artefato especificado em um CloudFormation modelo antes de iniciar o processo de inicialização. Se a aplicação AWS CDK não estiver em um artefato, ela deverá residir em seu repositório de origem. Para ter mais informações sobre artefatos, inclusive exemplos, consulte [Compartilhar artefatos e arquivos entre ações](workflows-working-artifacts.md). Interface de usuário correspondente: guia Entradas/**Artefatos - opcional** ## Outputs (*CDKBootstrapAction*/**Outputs**) (Optional) Define os dados que são gerados pela ação durante a execução de um fluxo de trabalho. Interface de usuário correspondente: guia **Saídas** ## Artifacts - output (*CDKBootstrapAction*/Outputs/**Artifacts**) (Optional) Especifique os artefatos gerados pela ação. Você pode referenciar esses artefatos como entrada em outras ações. Para ter mais informações sobre artefatos, inclusive exemplos, consulte [Compartilhar artefatos e arquivos entre ações](workflows-working-artifacts.md). Interface de usuário correspondente: guia Saídas/**Artefatos** ## Name (*CDKBootstrapAction*/Outputs/Artifacts/**Name**) (Obrigatório se [Artifacts - output](#cdk.boot.outputs.artifacts) for incluído) Especifique o nome do artefato que conterá o CloudFormation modelo sintetizado pela ação de **AWS CDK bootstrap** em tempo de execução. O valor padrão é `cdk_bootstrap_artifacts`. Se você não especificar um artefato, a ação sintetizará o modelo, mas não o salvará em um artefato. Pense em salvar o modelo sintetizado em um artefato para preservar um registro dele para fins de teste ou solução de problemas. **UI correspondente: artefato de tab/Artifacts/Add saída/Nome do artefato de construção** ## Files (*CDKBootstrapAction*/Outputs/Artifacts/**Files**) (Obrigatório se [Artifacts - output](#cdk.boot.outputs.artifacts) for incluído) Especifique os arquivos a serem incluídos no artefato. Você deve especificar `"cdk.out/**/*"` para incluir o modelo sintetizado CloudFormation do seu AWS CDK aplicativo. **nota** `cdk.out` é o diretório padrão no qual os arquivos sintetizados são salvos. Se você especificou um diretório de saída diferente de `cdk.out` no arquivo `cdk.json`, especifique esse diretório aqui em vez de `cdk.out`. **UI correspondente: produz tab/Artifacts/Add artefatos/arquivos produzidos pela compilação** ## Environment (*CDKBootstrapAction*/**Environment**) (Obrigatório) Especifique o CodeCatalyst ambiente a ser usado com a ação. A ação se conecta à Conta da AWS Amazon VPC opcional especificada no ambiente escolhido. A ação usa a função padrão do IAM especificada no ambiente para se conectar ao e usa a Conta da AWS função do IAM especificada na [conexão da Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) para se conectar à Amazon VPC. **nota** Se o perfil do IAM padrão não tiver as permissões exigidas pela ação, você poderá configurar a ação para usar um perfil diferente. Para obter mais informações, consulte [Alteração do perfil do IAM de uma ação](deploy-environments-switch-role.md). Para ter mais informações sobre ambientes, consulte [Implantação em e Contas da AWS VPCs](deploy-environments.md) e [Criar um ambiente](deploy-environments-creating-environment.md). Interface de usuário correspondente: guia Configuração/**Ambiente** ## Name (*CDKBootstrapAction*/Environment/**Name**) (Obrigatório se [Environment](#cdk.boot.environment) for incluído) Especifique o nome de um ambiente existente que deseja associar à ação. Interface de usuário correspondente: guia Configuração/**Ambiente** ## Connections (*CDKBootstrapAction*/Environment/**Connections**) (Opcional nas versões mais recentes da ação; obrigatório nas versões mais antigas) Especifique a conexão da conta a ser associada à ação. É possível especificar no máximo uma conexão de conta em `Environment`. Se você não especificar uma conexão de conta: + A ação usa a Conta da AWS conexão e a função padrão do IAM especificadas no ambiente no CodeCatalyst console. Para ter informações sobre como adicionar uma conexão de conta e um perfil do IAM padrão ao ambiente, consulte [Criar um ambiente](deploy-environments-creating-environment.md). + O perfil do IAM padrão deve incluir as políticas e as permissões exigidas pela ação. Para determinar quais são essas políticas e permissões, consulte a descrição da propriedade **Perfil** na documentação de definição de YAML da ação. Para ter mais informações sobre conexões de conta, consulte [Permitindo acesso a AWS recursos com conexão Contas da AWS](ipa-connect-account.md). Para ter informações sobre como adicionar uma conexão de conta a um ambiente, consulte [Criar um ambiente](deploy-environments-creating-environment.md). Interface de usuário correspondente: uma das seguintes, dependendo da versão da ação: + (Versões mais recentes) A configuração tab/Environment/What está pronta? *my-environment* **/menu de três pontos/ Mudar função** + **(Versões mais antigas) Guia de configuração/' Environment/account/role AWS '/ conexão de conta** ## Name (*CDKBootstrapAction*/Environment/Connections/**Name**) (Obrigatório se [Connections](#cdk.boot.environment.connections) for incluído) Especifique o nome da conexão da conta. Interface de usuário correspondente: uma das seguintes, dependendo da versão da ação: + (Versões mais recentes) A configuração tab/Environment/What está pronta? *my-environment* **/menu de três pontos/ Mudar função** + **(Versões mais antigas) Guia de configuração/' Environment/account/role AWS '/ conexão de conta** ## Role (*CDKBootstrapAction*/Environment/Connections/**Role**) (Obrigatório se [Connections](#cdk.boot.environment.connections) for incluído) Especifique o nome da função do IAM que a ação **AWS CDK bootstrap** usa para acessar AWS e adicionar a pilha de bootstrap. Certifique-se de ter [adicionado a função ao seu CodeCatalyst espaço](ipa-connect-account-addroles.md) e de que a função inclua as seguintes políticas. Se você não especificar uma função do IAM, a ação usará a função padrão do IAM listada no [ambiente](deploy-environments.md) no CodeCatalyst console. Se você usar o perfil padrão no ambiente, verifique se ele tem as políticas apropriadas. Você pode usar o perfil `CodeCatalystWorkflowDevelopmentRole-spaceName` com essa ação, se desejar. Para obter mais informações sobre essa função, consulte [Criar o perfil **CodeCatalystWorkflowDevelopmentRole-*spaceName*** para a conta e o espaço](ipa-iam-roles.md#ipa-iam-roles-service-create). Entenda que o perfil `CodeCatalystWorkflowDevelopmentRole-spaceName` tem permissões de acesso completas, o que pode representar um risco de segurança. Recomendamos que você use esse perfil apenas em tutoriais e em cenários em que a segurança seja menos preocupante. Interface de usuário correspondente: uma das seguintes, dependendo da versão da ação: + (Versões mais recentes) A configuração tab/Environment/What está pronta? *my-environment* **/menu de três pontos/ Mudar função** + **(Versões mais antigas) Guia de configuração/' '/ Função Environment/account/role** ## Configuration (*CDKBootstrapAction*/**Configuration**) (Obrigatório) Uma seção na qual você pode definir as propriedades de configuração da ação. Interface de usuário correspondente: guia **Configuração** ## Region (*CDKBootstrapAction*/Configuration/**Region**) (Obrigatório) Especifique Região da AWS no qual a pilha de bootstrap será implantada. Essa região deve corresponder àquela na qual seu AWS CDK aplicativo está implantado. Para obter uma lista dos códigos das regiões, consulte [Endpoints regionais](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes). Interface de usuário correspondente: guia Configuração/**Região** ## CdkCliVersion (*CDKBootstrapAction*/Configuration/**CdkCliVersion**) (Optional) Essa propriedade está disponível com a versão 1.0.13 ou posterior da ação **Implantação do AWS CDK ** e a versão 1.0.8 ou posterior da ação **Inicialização do AWS CDK **. Especifique um dos seguintes: + A versão completa da interface de linha de AWS Cloud Development Kit (AWS CDK) comando (CLI) (também chamada de AWS CDK kit de ferramentas) que você deseja que essa ação use. Exemplo: `2.102.1`. Considere especificar uma versão completa para garantir consistência e estabilidade ao criar e implantar a aplicação. Ou + `latest`. Pense em especificar `latest` para aproveitar os recursos e correções mais recentes da CLI do CDK. A ação baixará a versão especificada (ou a versão mais recente) da AWS CDK CLI para a [imagem de CodeCatalyst compilação](build-images.md) e, em seguida, usará essa versão para executar os comandos necessários para implantar seu aplicativo CDK ou inicializar seu ambiente. AWS Para ter uma lista das versões compatíveis da CLI do CDK que você pode usar, consulte [Versões do AWS CDK](https://docs.aws.amazon.com/cdk/api/versions.html). Se você omitir essa propriedade, a ação usará uma versão padrão da AWS CDK CLI descrita em um dos tópicos a seguir: + [Versões da CLI do CDK usadas pela ação 'implantar'AWS CDK](cdk-dep-action.md#cdk-dep-action-cdk-version) + [Versões do CDK CLI usadas pela ação AWS CDK "bootstrap”](cdk-boot-action.md#cdk-boot-action-cdk-version) UI correspondente: guia de configuração/versão **AWS CDK CLI**