Este é o Guia do desenvolvedor do 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á.
cdk drift
Detecte desvios na configuração dos recursos que você define, gerencia e implanta usando o AWS Cloud Development Kit (AWS CDK). O desvio ocorre quando a configuração real de uma pilha difere da configuração esperada, o que acontece quando os recursos são modificados externamente. AWS CloudFormation
Esse comando identifica os recursos que foram modificados (por exemplo, por meio do AWS console ou da AWS CLI) comparando seu estado atual com a configuração esperada. Essas modificações podem causar um comportamento inesperado em sua infraestrutura.
Durante a detecção de desvios, a CLI do CDK produzirá indicadores de progresso e resultados, mostrando:
-
Recursos que se afastaram da configuração esperada.
-
O número total de recursos com deriva.
-
Um resumo indicando se o desvio foi detectado na pilha.
Importante
Os cdk diff comandos cdk drift e funcionam de forma diferente:
-
cdk driftoperação CloudFormation de detecção de desvio de chamadas para comparar o estado real dos recursos em AWS (“realidade”) com a configuração esperada em CloudFormation. Nem todos os AWS recursos oferecem suporte à detecção de desvios. Para ver a lista de recursos compatíveis, consulte Compatibilidade com tipo de recurso no AWS Guia do usuário do CloudFormation . -
cdk diffcompara o CloudFormation modelo sintetizado a partir do seu código CDK local com o modelo da pilha implantada. CloudFormation
Use cdk drift quando precisar verificar se os recursos foram modificados fora do CloudFormation (por exemplo, por meio do AWS console ou da AWS CLI). Use cdk diff quando quiser visualizar como suas alterações no código local afetariam sua infraestrutura antes da implantação.
Uso
$ cdk drift <arguments> <options>
Argumentos
- Nome da stack
-
O nome da pilha que você deseja verificar quanto ao desvio. A pilha deve ser implantada anteriormente para realizar CloudFormation a detecção de desvios.
Tipo: string
Obrigatório: não
Se nenhuma pilha for especificada, a detecção de desvio será executada em todas as pilhas definidas em seu aplicativo CDK.
Opções
Para obter uma lista de opções globais que funcionam com todos os comandos da CLI do CDK, consulte Opções globais.
-
--fail <BOOLEAN> -
Retorne com o código de saída 1 se for detectado desvio.
Valor padrão:
false
-
--help, -h <BOOLEAN> -
Mostrar as informações de referência do comando
cdk drift.
Exemplos
Verifique o desvio de uma pilha específica
$ cdk drift MyStackName
O comando produzirá resultados semelhantes a:
Stack MyStackName Modified Resources [~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD └─ [~] /Description ├─ [-] My original hello world Lambda function └─ [+] My drifted hello world Lambda function 1 resource has drifted from their expected configuration ✨ Number of resources with drift: 1
Verifique o desvio quando os recursos foram excluídos
O exemplo a seguir mostra a aparência da saída quando os recursos são modificados e excluídos:
Stack MyStackName Modified Resources [~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD └─ [~] /Description ├─ [-] My original hello world Lambda function └─ [+] My drifted hello world Lambda function Deleted Resources [-] AWS::CloudWatch::Alarm MyAlarm MyCWAlarmABCD1234 2 resources have drifted from their expected configuration ✨ Number of resources with drift: 2
Verifique o desvio com o código de saída
Para que o comando retorne um código de saída diferente de zero se for detectado um desvio:
$ cdk drift MyStackName --fail
Isso é útil em pipelines de CI/CD para detectar e responder automaticamente ao desvio da infraestrutura.
