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á.
ação 'AWS CDK bootstrap' YAML
A seguir está a YAML definição da ação de AWS CDK bootstrap. Para saber como usar essa ação, consulteInicializando um AWS CDK aplicativo com um fluxo de trabalho.
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 YAMLDefinição de fluxo de trabalho.
nota
A maioria das YAML propriedades a seguir tem elementos de interface de usuário correspondentes no editor visual. Para pesquisar um elemento de interface do usuário, use Ctrl+F. O elemento será listado com sua YAML propriedade 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_nn
:
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 das ações devem ser exclusivos no fluxo de trabalho. Os nomes das ações são limitados a caracteres alfanuméricos (a-z, A-Z, 0-9), hífens (-) e sublinhados (_). Não são permitidos espaços. Você não pode usar aspas para ativar caracteres especiais e espaços nos nomes das ações.
Padrão: CDKBootstrapAction_nn
.
UI correspondente: guia de 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 Especificando a versão da ação a ser usada.
nota
A especificação aws/cdk-bootstrap@v2
faz com que a ação seja executada na imagem de março de 2024, que inclui ferramentas mais recentes, como Node.js 18. A especificação aws/cdk-bootstrap@v1
faz com que a ação seja executada na imagem de novembro de 2022, que inclui ferramentas mais antigas, como Node.js 16.
Padrão: aws/cdk-bootstrap@v2
.
UI correspondente: diagrama de fluxo de trabalho/ CDKBootstrapAction _nn/aws/cdk-bootstrap @v2 label
DependsOn
(CDKBootstrapAction
/DependsOn)
(Optional)
Especifique uma ação, grupo de ação ou porta que deve ser executada com êxito para que essa ação seja executada.
Para obter mais informações sobre a funcionalidade “depende de”, consulte. Ações de sequenciamento
UI correspondente: guia Entradas/Depende de - opcional
Compute
(CDKBootstrapAction
/Compute)
(Optional)
O mecanismo de computação usado para executar suas ações de fluxo de trabalho. Você pode especificar a computação no nível do fluxo de trabalho ou no nível da ação, mas não em ambos. Quando especificada no nível do fluxo de trabalho, a configuração computacional se aplica a todas as ações definidas no fluxo de trabalho. No nível do fluxo de trabalho, você também pode executar várias ações na mesma instância. Para obter mais informações, consulte Compartilhamento de computação entre ações.
UI correspondente: nenhuma
Type
(CDKBootstrapAction
/Compute/Type)
(Obrigatório se Compute estiver incluído)
O tipo de mecanismo de computação. Você pode usar um dos seguintes valores:
-
EC2(editor visual) ou
EC2
(YAMLeditor)Otimizado para flexibilidade durante as corridas de ação.
-
Lambda (editor visual) ou
Lambda
(YAMLeditor)Velocidades otimizadas de inicialização da ação.
Para obter informações sobre tipos de dados, consulte Tipos de computação.
UI correspondente: guia Configuração/Avançado - opcional/Tipo de computação
Fleet
(CDKBootstrapAction
/Compute/Fleet)
(Optional)
Especifique a máquina ou frota que executará seu fluxo de trabalho ou 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 é concluída. Exemplos de frotas sob demanda:Linux.x86-64.Large
,. Linux.x86-64.XLarge
Para obter mais informações sobre frotas sob demanda, consulte. Propriedades de frota sob demanda
Com frotas provisionadas, você configura um conjunto de máquinas dedicadas para executar suas ações de fluxo de trabalho. Essas máquinas permanecem ociosas, prontas para processar ações imediatamente. Para obter mais informações sobre frotas provisionadas, consulte. Propriedades da frota provisionada
Se Fleet
for omitido, o padrão será. Linux.x86-64.Large
UI correspondente: guia Configuração/Avançado - opcional/Frota de computação
Timeout
(CDKBootstrapAction
/Timeout)
(Obrigatório)
Especifique a quantidade de tempo em minutos (YAMLeditor) ou horas e minutos (editor visual) que a ação pode ser executada antes de CodeCatalyst finalizar a ação. O mínimo é de 5 minutos e o máximo está descrito emCotas para fluxos de trabalho em CodeCatalyst. O tempo limite padrão é igual ao tempo limite máximo.
UI correspondente: guia de configuração/tempo limite - opcional
Inputs
(CDKBootstrapAction
/Inputs)
(Optional)
A Inputs
seção define os dados que a ação de AWS CDK
bootstrap precisa durante a execução de um fluxo de trabalho.
UI correspondente: guia Entradas
nota
Somente uma entrada (uma fonte ou um artefato) é permitida para cada ação de AWS CDK bootstrap.
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 AWS CDK bootstrap sintetiza o aplicativo nesse repositório antes de iniciar o processo de inicialização. Atualmente, o único rótulo de 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 Conectando repositórios de origem aos fluxos de trabalho.
UI correspondente: guia Entradas/Fontes - opcional
Artifacts - input
(CDKBootstrapAction
/Inputs/Artifacts)
(Obrigatório se seu AWS CDK aplicativo estiver armazenado em um artefato de saída 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 seu AWS CDK aplicativo não estiver contido em um artefato, ele deverá residir no seu repositório de origem.
Para obter mais informações sobre artefatos, incluindo exemplos, consulteCompartilhamento de artefatos e arquivos entre ações.
UI 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.
UI 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 obter mais informações sobre artefatos, incluindo exemplos, consulteCompartilhamento de artefatos e arquivos entre ações.
UI correspondente: guia Saídas/Artefatos
Name
(CDKBootstrapAction
/Outputs/Artifacts/Name)
(Obrigatório se Artifacts - output estiver incluído)
Especifique o nome do artefato que conterá o AWS 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. Considere salvar o modelo sintetizado em um artefato para preservar um registro dele para fins de teste ou solução de problemas.
UI correspondente: guia Saídas/Artefatos/Adicionar artefato/Criar nome do artefato
Files
(CDKBootstrapAction
/Outputs/Artifacts/Files)
(Obrigatório se Artifacts - output estiver incluído)
Especifique os arquivos a serem incluídos no artefato. Você deve especificar "cdk.out/**/*"
para incluir o modelo sintetizado AWS 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 do cdk.out
seu cdk.json
arquivo, especifique esse diretório aqui em vez decdk.out
.
UI correspondente: guia Saídas/Artefatos/Adicionar artefato/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 opcional VPC especificada no ambiente escolhido. A ação usa a IAM função padrão especificada no ambiente para se conectar ao Conta da AWS e usa a IAM função especificada na VPCconexão da Amazon para se conectar à AmazonVPC.
nota
Se a IAM função padrão não tiver as permissões exigidas pela ação, você poderá configurar a ação para usar uma função diferente. Para obter mais informações, consulte Mudando o IAM papel de uma ação.
Para obter mais informações sobre ambientes, consulte Implantação em e Contas da AWS VPCs Criar um ambiente e.
UI correspondente: guia de configuração/ambiente
Name
(CDKBootstrapAction
/Environment/Name)
(Obrigatório se Environment estiver incluído)
Especifique o nome de um ambiente existente que você deseja associar à ação.
UI correspondente: guia de 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. Você pode especificar no máximo uma conexão de conta emEnvironment
.
Se você não especificar uma conexão de conta:
-
A ação usa a Conta da AWS conexão e a IAM função padrão especificadas no ambiente no CodeCatalyst console. Para obter informações sobre como adicionar uma conexão de conta e uma IAM função padrão ao ambiente, consulteCriar um ambiente.
-
A IAM função padrão deve incluir as políticas e permissões exigidas pela ação. Para determinar quais são essas políticas e permissões, consulte a descrição da propriedade Role na documentação de YAML definição da ação.
Para obter mais informações sobre conexões de conta, consultePermitindo acesso a AWS recursos com conexão Contas da AWS. Para obter informações sobre como adicionar uma conexão de conta a um ambiente, consulteCriar um ambiente.
UI correspondente: uma das seguintes, dependendo da versão da ação:
-
(Versões mais recentes) Guia de configuração/Ambiente/O que está incluído
my-environment
? /menu de três pontos/ Mudar função -
(Versões mais antigas) Guia de configuração/'Ambiente/Conta/Função'/ conexão AWS de conta
Name
(CDKBootstrapAction
/Environment/Connections/Name)
(Obrigatório se Connections estiver incluído)
Especifique o nome da conexão da conta.
UI correspondente: uma das seguintes, dependendo da versão da ação:
-
(Versões mais recentes) Guia de configuração/Ambiente/O que está incluído
my-environment
? /menu de três pontos/ Mudar função -
(Versões mais antigas) Guia de configuração/'Ambiente/Conta/Função'/ conexão AWS de conta
Role
(CDKBootstrapAction
/Environment/Connections/Role)
(Obrigatório se Connections estiver incluído)
Especifique o nome da IAM função que a ação de 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 e de que a função inclua as seguintes políticas.
Se você não especificar uma IAM função, a ação usará a IAM função padrão listada no ambiente no CodeCatalyst console. Se você usar a função padrão no ambiente, verifique se ela tem as seguintes políticas.
nota
As permissões mostradas na política de permissões a seguir são aquelas exigidas pelo cdk bootstrap
comando para realizar sua inicialização no momento da redação. Essas permissões podem mudar se o comando bootstrap for AWS CDK alterado.
Atenção
Use essa função somente com a ação AWS CDK bootstrap. É muito permissivo e usá-lo com outras ações pode representar um risco à segurança.
-
A seguinte política de permissões:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "iam:GetRole", "ssm:GetParameterHistory", "ecr:PutImageScanningConfiguration", "cloudformation:*", "iam:CreateRole", "iam:AttachRolePolicy", "ssm:GetParameters", "iam:PutRolePolicy", "ssm:GetParameter", "ssm:DeleteParameters", "ecr:DeleteRepository", "ssm:PutParameter", "ssm:DeleteParameter", "iam:PassRole", "ecr:SetRepositoryPolicy", "ssm:GetParametersByPath", "ecr:DescribeRepositories", "ecr:GetLifecyclePolicy" ], "Resource": [ "arn:aws:ssm:
aws-region
:aws-account
:parameter/cdk-bootstrap/*", "arn:aws:cloudformation:aws-region
:aws-account
:stack/CDKToolkit/*", "arn:aws:ecr:aws-region
:aws-account
:repository/cdk-*", "arn:aws:iam::aws-account
:role/cdk-*" ] }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": [ "cloudformation:RegisterType", "cloudformation:CreateUploadBucket", "cloudformation:ListExports", "cloudformation:DescribeStackDriftDetectionStatus", "cloudformation:SetTypeDefaultVersion", "cloudformation:RegisterPublisher", "cloudformation:ActivateType", "cloudformation:ListTypes", "cloudformation:DeactivateType", "cloudformation:SetTypeConfiguration", "cloudformation:DeregisterType", "cloudformation:ListTypeRegistrations", "cloudformation:EstimateTemplateCost", "cloudformation:DescribeAccountLimits", "cloudformation:BatchDescribeTypeConfigurations", "cloudformation:CreateStackSet", "cloudformation:ListStacks", "cloudformation:DescribeType", "cloudformation:ListImports", "s3:*", "cloudformation:PublishType", "ecr:CreateRepository", "cloudformation:DescribePublisher", "cloudformation:DescribeTypeRegistration", "cloudformation:TestType", "cloudformation:ValidateTemplate", "cloudformation:ListTypeVersions" ], "Resource": "*" } ] }nota
Na primeira vez em que a função for usada, use o caractere curinga a seguir na declaração de política de recursos e, em seguida, defina o escopo da política com o nome do recurso depois que ele estiver disponível.
"Resource": "*"
-
A seguinte política de confiança personalizada:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": [ "codecatalyst-runner.amazonaws.com", "codecatalyst.amazonaws.com" ] }, "Action": "sts:AssumeRole" } ] }
nota
Você pode usar a CodeCatalystWorkflowDevelopmentRole-
função com essa ação, se quiser. Para obter mais informações sobre essa função, consulte Criando a CodeCatalystWorkflowDevelopmentRole-spaceNamefunção para sua conta e espaço. Entenda que a spaceName
CodeCatalystWorkflowDevelopmentRole-
função tem permissões de acesso completas, o que pode representar um risco de segurança. Recomendamos que você use essa função somente em tutoriais e cenários em que a segurança seja menos preocupante. spaceName
UI correspondente: uma das seguintes, dependendo da versão da ação:
-
(Versões mais recentes) Guia de configuração/Ambiente/O que está incluído
my-environment
? /menu de três pontos/ Mudar função -
(Versões mais antigas) Guia de configuração/'Ambiente/Conta/Função'/ Função
Configuration
(CDKBootstrapAction
/Configuration)
(Obrigatório)
Uma seção na qual você pode definir as propriedades de configuração da ação.
UI 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.
UI correspondente: guia de 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 de AWS CDK implantação e a versão 1.0.8 ou posterior da AWS CDK ação bootstrap.
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 seu aplicativo.Ou
-
latest
. Considere especificarlatest
para aproveitar os recursos e correções mais recentes do CDKCLI.
A ação baixará a versão especificada (ou a versão mais recente) do AWS CDK CLI para a imagem de CodeCatalyst compilação e, em seguida, usará essa versão para executar os comandos necessários para implantar seu CDK aplicativo ou inicializar seu AWS ambiente.
Para obter uma lista das CDK CLI versões compatíveis que você pode usar, consulte AWS CDK Versões.
Se você omitir essa propriedade, a ação usará uma AWS CDK CLI versão padrão descrita em um dos tópicos a seguir:
UI correspondente: guia/versão de AWS CDK CLI configuração