cdk rollback - AWS Cloud Development Kit (AWS CDK) v2
UsoArgumentosOpções

Este é o Guia do Desenvolvedor AWS CDK v2. A CDK v1 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á.

cdk rollback

Use o comando cdk rollback da interface de linha de comandos (CLI) do AWS Cloud Development Kit (AWS CDK) para reverter uma pilha com falha ou pausada de uma implantação AWS CloudFormation para seu último estado estável.

nota

Para usar este comando, você deve ter a v23 do modelo de inicialização implantada em seu ambiente. Para ter mais informações, consulte Histórico de versões do modelo de bootstrap.

Quando você implanta usando o cdk deploy, o CDK CLI reverte uma implantação com falha por padrão. Se você especificar --no-rollback com cdk deploy, poderá usar o comando cdk rollback para reverter manualmente uma implantação com falha. Isso iniciará uma reversão para o último estado estável da sua pilha.

Uso

$ cdk rollback <arguments> <options>

Argumentos

ID da pilha CDK

O ID de constructo da pilha de CDK do seu aplicativo para a reversão.

Tipo: string

Obrigatório: não

Opções

Para obter uma lista das opções globais que funcionam com todos os comandos do CDK CLI, consulte Opções globais.

--all BOOLEAN

Reverter todas as pilhas em seu aplicativo CDK.

Valor padrão: false

--force, -f BOOLEAN

Quando você usa o cdk rollback, alguns recursos podem falhar na reversão. Forneça essa opção para forçar a reversão de todos os recursos. Esse é o mesmo comportamento de fornecer a opção --orphan para cada recurso em sua pilha.

Valor padrão: false

--help, -h BOOLEAN

Mostrar as informações de referência do comando cdk rollback.

--orphan LogicalId

Quando você usa o cdk rollback, alguns recursos podem falhar na reversão. Quando isso acontece, você pode tentar forçar a reversão de um recurso usando essa opção e fornecendo o ID lógico do recurso que falhou na reversão.

Essa opção pode ser fornecida várias vezes em um único comando. Veja a seguir um exemplo:

$ cdk rollback MyStack --orphan MyLambdaFunction --orphan MyLambdaFunction2

Para forçar a reversão de todos os recursos, use a opção --force.

--toolkit-stack-name STRING

O nome da pilha existente do CDK Toolkit com a qual o ambiente é inicializado.

Por padrão, o cdk bootstrap implanta uma pilha chamada CDKToolkit no ambiente AWS especificado. Use essa opção para fornecer um nome diferente para sua pilha de inicialização.

O CDK CLI usa esse valor para verificar a versão da pilha de inicialização.

--validate-bootstrap-version BOOLEAN

Especifique se deseja validar a versão da pilha de inicialização. Forneça o --validate-bootstrap-version=false ou --no-validate-bootsrap-version para desativar esse comportamento.

Valor padrão: true