cdk drift - AWS Cloud Development Kit (AWS CDK) v2
UtilizzoArgomentiOpzioniEsempi

Questa è la AWS CDK v2 Developer Guide. Il vecchio CDK v1 è entrato in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

cdk drift

Rileva le variazioni di configurazione per le risorse che definisci, gestisci e distribuisci utilizzando il AWS Cloud Development Kit (AWS CDK). La deriva si verifica quando la configurazione effettiva di uno stack differisce dalla configurazione prevista, il che si verifica quando le risorse vengono modificate all'esterno di. AWS CloudFormation

Questo comando identifica le risorse che sono state modificate (ad esempio, tramite la AWS console o la AWS CLI) confrontando il loro stato corrente con la configurazione prevista. Queste modifiche possono causare comportamenti imprevisti nell'infrastruttura.

Durante il rilevamento della deriva, la CLI CDK produrrà indicatori e risultati di avanzamento, mostrando:

  • Risorse che si sono discostate dalla configurazione prevista.

  • Il numero totale di risorse con deriva.

  • Un riepilogo che indica se è stata rilevata una deriva nella pila.

Importante

I cdk diff comandi cdk drift and funzionano in modo diverso:

  • cdk drift CloudFormationchiama l'operazione di rilevamento della deriva per confrontare lo stato effettivo delle risorse in AWS («realtà») con la loro configurazione prevista in CloudFormation. Non tutte le AWS risorse supportano il rilevamento della deriva. Per un elenco delle risorse supportate, consulta il supporto per i tipi di risorse nella Guida per l' AWS CloudFormation utente.

  • cdk diffconfronta il CloudFormation modello sintetizzato dal codice CDK locale con il modello dello stack distribuito. CloudFormation

Da utilizzare cdk drift quando è necessario verificare se le risorse sono state modificate all'esterno CloudFormation (ad esempio, tramite la AWS console o la AWS CLI). Da utilizzare cdk diff quando si desidera visualizzare in anteprima l'impatto delle modifiche al codice locale sull'infrastruttura prima della distribuzione.

Utilizzo

$ cdk drift <arguments> <options>

Argomenti

Stack name (Nome stack)

Il nome dello stack di cui vuoi verificare la deriva. Lo stack deve essere stato precedentemente distribuito per eseguire CloudFormation il rilevamento della deriva.

Tipo: stringa

Required: No

Se non viene specificato alcuno stack, il rilevamento della deriva verrà eseguito su tutti gli stack definiti nell'app CDK.

Opzioni

Per un elenco di opzioni globali che funzionano con tutti i comandi CDK CLI, vedete Opzioni globali.

--fail <BOOLEAN>

Ritorna con il codice di uscita 1 se viene rilevata una deriva.

Valore predefinito: false

--help, -h <BOOLEAN>

Mostra le informazioni di riferimento del cdk drift comando.

Esempi

Controlla la deriva per uno stack specifico

$ cdk drift MyStackName

Il comando produrrà risultati simili 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

Controlla la deriva quando le risorse sono state eliminate

L'esempio seguente mostra l'aspetto dell'output quando le risorse sono state sia modificate che eliminate:

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

Controlla la deriva con il codice di uscita

Per fare in modo che il comando restituisca un codice di uscita diverso da zero se viene rilevata una deriva:

$ cdk drift MyStackName --fail

Ciò è utile nelle pipeline CI/CD per rilevare e rispondere automaticamente alla deriva dell'infrastruttura.