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`
<a name="ref-cli-cmd-drift"></a>

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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html) nella *Guida per l' AWS CloudFormation utente*.
 `cdk diff`confronta 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
<a name="ref-cli-cmd-drift-usage"></a>

```
$ cdk drift <arguments> <options>
```

## Argomenti
<a name="ref-cli-cmd-drift-args"></a><a name="ref-cli-cmd-drift-args-stack-name"></a>

 **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
<a name="ref-cli-cmd-drift-options"></a>

Per un elenco di opzioni globali che funzionano con tutti i comandi CDK CLI, [vedete](ref-cli-cmd.md#ref-cli-cmd-options) Opzioni globali.<a name="ref-cli-cmd-drift-options-fail"></a>

 `--fail <BOOLEAN>`   
Ritorna con il codice di uscita 1 se viene rilevata una deriva.  
 *Valore predefinito*: `false` <a name="ref-cli-cmd-drift-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostra le informazioni di riferimento del `cdk drift` comando.

## Esempi
<a name="ref-cli-cmd-drift-examples"></a>

### Controlla la deriva per uno stack specifico
<a name="ref-cli-cmd-drift-examples-stack"></a>

```
$ 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
<a name="ref-cli-cmd-drift-examples-deleted"></a>

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
<a name="ref-cli-cmd-drift-examples-fail"></a>

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.