Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

cdk diff

Modo de foco
cdk diff - AWS Cloud Development Kit (AWS CDK) v2

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

Este é o Guia do Desenvolvedor AWS CDK v2. O CDK v1 antigo 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 AWS CDK pilhas.

Esse comando geralmente é usado para comparar as diferenças entre o estado atual das pilhas em sua aplicação CDK local e as pilhas implantadas. No entanto, você também pode comparar uma pilha implantada com qualquer modelo local AWS CloudFormation .

Uso

$ cdk diff <arguments> <options>

Argumentos

ID da pilha CDK

O ID de constructo da pilha CDK da sua aplicação para realizar uma comparação.

Type: string

Obrigatório: não

Opções

Para obter uma lista de opções globais que funcionam com todos os CDK CLI comandos, vejaOpções globais.

--change-set BOOLEAN

Especifique se deseja criar um conjunto de alterações para analisar as substituições de recursos.

Quandotrue, o CDK CLI criará um conjunto de AWS CloudFormation alterações 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.

Quandofalse, uma comparação mais rápida, mas menos precisa, é realizada comparando modelos. 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 CloudFormation transformações já processadas.

Valor padrão: false

--quiet, -q BOOLEAN

Não imprimir o nome da pilha CDK e a mensagem padrão cdk diff para stdout 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á AWS::CDK::Metadata recursos ou caracteres não ASCII ilegíveis.

Valor padrão: false

--template STRING

O caminho para o CloudFormation modelo com o qual comparar uma pilha de CDK.

Exemplos

Compare com a pilha atualmente implantada chamada MyStackName

O CDK CLI usa os seguintes símbolos na saída diff:

  • [+]— Identifica o código ou os recursos que serão adicionados se você implantar suas alterações.

  • [-]— Identifica o código ou os recursos que serão removidos se você implantar suas alterações.

  • [~]— Identifica um recurso ou propriedade que será modificado se você implantar suas alterações.

Veja a seguir um exemplo que mostra uma diferença de alterações locais em uma função Lambda:

$ cdk diff MyStackName start: Building asset-hash:account-Region success: Built asset-hash:account-Region start: Publishing asset-hash:account-Region success: Published asset-hash:account-Region Hold on while we create a read-only change set to get a diff with accurate replacement information (use --no-change-set to use a less accurate but faster template-only diff) Stack MyStackName Resources [~] AWS::Lambda::Function HelloWorldFunction resource-logical-ID └─ [~] Code └─ [~] .ZipFile: ├─ [-] exports.handler = async function(event) { return { statusCode: 200, body: JSON.stringify('Hello World!'), }; }; └─ [+] exports.handler = async function(event) { return { statusCode: 200, body: JSON.stringify('Hello from CDK!'), }; }; ✨ Number of stacks with differences: 1

Um [~] indicador de recursos que serão modificados nem sempre significa uma substituição completa de recursos:

  • Algumas propriedades do recurso, por exemploCode, atualizarão o recurso.

  • Algumas propriedades do recurso, comoFunctionName, podem causar a substituição total do recurso.

Compare com um modelo específico 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

Nesta página

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.