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á.
Faça uma comparação para ver as mudanças na infraestrutura entre as pilhas AWS CDK.
Esse comando geralmente é usado para comparar as diferenças entre o estado atual das pilhas em seu aplicativo CDK local e as pilhas implantadas. No entanto, você também pode comparar uma pilha implantada com qualquer modelo AWS CloudFormation local.
Uso
$
cdk diff
<arguments>
<options>
Argumentos
- ID da pilha CDK
-
O ID de constructo da pilha CDK do seu aplicativo para realizar uma comparaçã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.
--change-set
BOOLEAN
-
Especifique se deseja criar um conjunto de alterações para analisar as substituições de recursos.
Quando
true
, o CDK CLI criará um conjunto de alterações AWS CloudFormation para exibir as alterações exatas que serão feitas em sua pilha. Essa saída inclui se os recursos serão atualizados ou substituídos. O CDK CLI usa a função de implantação em vez da função de pesquisa para realizar essa ação.Quando
false
, uma comparação mais rápida, mas menos precisa, é realizada comparando os modelos do CloudFormation. Qualquer alteração detectada nas propriedades que exijam a substituição de um recurso será exibida como uma substituição de recurso, mesmo que a alteração seja puramente cosmética, como a substituição de uma referência de recurso por um ARN com codificação rígida.Valor padrão:
true
--context-lines
NUMBER
-
Número de linhas de contexto a serem incluídas na renderização arbitrária de diferenças JSON.
Valor padrão:
3
--exclusively, -e
BOOLEAN
-
Diferenciar apenas as pilhas solicitadas e não incluir dependências.
--fail
BOOLEAN
-
Falhar e sair com um código de
1
se forem detectadas diferenças. --help, -h
BOOLEAN
-
Mostrar as informações de referência do comando
cdk diff
. --processed
BOOLEAN
-
Especifique se deseja comparar com o modelo com as transformações do CloudFormation já processadas.
Valor padrão:
false
--quiet, -q
BOOLEAN
-
Não imprimir o nome da pilha CDK e a mensagem padrão
cdk diff
parastdout
quando nenhuma alteração for detectada.Valor padrão:
false
--security-only
BOOLEAN
-
Diferenciar apenas para mudanças de segurança ampliadas.
Valor padrão:
false
--strict
BOOLEAN
-
Modifique o comportamento
cdk diff
para ser mais preciso ou rigoroso. Quando verdadeiro, o CDK CLI não filtrará recursosAWS::CDK::Metadata
ou caracteres não ASCII ilegíveis.Valor padrão:
false
--template
STRING
-
O caminho para o modelo do CloudFormation com o qual comparar uma pilha do CDK.
Exemplos
Compare com a pilha atualmente implantada chamada MyStackName
$
cdk diff MyStackName --app='node bin/main.js'
Compare com um modelo específico do CloudFormation
$
cdk diff MyStackName --app='node bin/main.js' --template-path='./MyStackNameTemplate.yaml'
Diferencie uma pilha local com sua pilha implantada. Não imprima em stdout se nenhuma alteração for detectada
$
cdk diff MyStackName --app='node bin/main.js' --quiet