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à.

# Esegui azioni programmatiche utilizzando la libreria CDK Toolkit
<a name="toolkit-library"></a>

## Comprendere la libreria CDK Toolkit
<a name="toolkit-library-intro"></a>

La CDK Toolkit Library consente di eseguire azioni CDK a livello di codice a livello di codice anziché utilizzare i comandi CLI. Puoi utilizzare questa libreria per creare strumenti personalizzati, creare applicazioni CLI specializzate e integrare le funzionalità CDK nei flussi di lavoro di sviluppo.

 **Gestisci il ciclo di vita dell'infrastruttura con il controllo programmatico**   
La CDK Toolkit Library fornisce interfacce programmatiche per le seguenti azioni CDK:  
+  **Sintesi**: genera AWS CloudFormation modelli e artefatti di distribuzione.
+  **Distribuzione**: fornisce o aggiorna l'infrastruttura utilizzando CloudFormation modelli.
+  **Refactor**: preserva le risorse distribuite durante il refactoring del codice CDK, ad esempio rinominando i costrutti o spostandoli tra gli stack.
+  **Elenco: visualizza** le informazioni sugli stack e sulle loro dipendenze.
+  **Guarda**: monitora le app CDK per rilevare eventuali modifiche locali.
+  **Rollback: riporta** gli stack al loro ultimo stato stabile.
+  **Distruggi**: rimuove gli stack CDK e le risorse associate.

 **Migliora e personalizza la gestione dell'infrastruttura**   
+  **Controllo tramite codice**: integra la gestione dell'infrastruttura direttamente nelle applicazioni e crea pipeline di implementazione reattive.
+  **Gestisci gli assembly cloud**: crea, ispeziona e trasforma le definizioni dell'infrastruttura prima dell'implementazione.
+  **Personalizza le implementazioni**: configura i parametri, il comportamento di rollback e il monitoraggio in base alle tue esigenze.
+  **Conserva le risorse durante il refactoring**: rileva e preserva automaticamente le risorse quando esegui il refactoring del codice CDK.
+  **Gestisci gli errori con precisione**: implementa la gestione strutturata degli errori con informazioni diagnostiche dettagliate.
+  **Comunicazioni personalizzate**: configura indicatori di avanzamento personalizzati e registrazione delle implementazioni. `IoHost`
+  **Connect with AWS **: configura profili, regioni e flussi di autenticazione a livello di codice.

## Scelta del momento in cui utilizzare la CDK Toolkit Library
<a name="toolkit-library-intro-when"></a>

La CDK Toolkit Library è particolarmente utile quando è necessario:
+ Automatizza le implementazioni dell'infrastruttura come parte delle pipeline. CI/CD 
+ Crea strumenti di distribuzione personalizzati in base alle esigenze della tua organizzazione.
+ Integra le azioni CDK nelle applicazioni o nelle piattaforme esistenti.
+ Crea flussi di lavoro di implementazione specializzati con fasi di convalida o approvazione personalizzate.
+ Implementa modelli avanzati di gestione dell'infrastruttura in più ambienti.
+ Automatizza le operazioni di refactoring per preservare le risorse quando esegui il refactoring del codice CDK.

## Utilizzo della CDK Toolkit Library
<a name="toolkit-library-intro-example"></a>

L'esempio seguente mostra come creare e distribuire un semplice bucket S3 utilizzando la CDK Toolkit Library:

```
// Import required packages
import { Toolkit } from '@aws-cdk/toolkit-lib';
import { App, Stack } from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';

// Create and configure the CDK Toolkit
const toolkit = new Toolkit();

// Create a cloud assembly source with an inline app
const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => {
   const app = new App();
   const stack = new Stack(app, 'SimpleStorageStack');

   // Create an S3 bucket in the stack
   new s3.Bucket(stack, 'MyFirstBucket', {
      versioned: true
   });

   return app.synth();
});

// Deploy the stack
await toolkit.deploy(cloudAssemblySource);
```

 **Cosa puoi fare dopo**   
+  **Automatizza le distribuzioni: attiva le distribuzioni** in modo programmatico e aggiungi passaggi di implementazione. pre/post 
+  **Integrazione con i sistemi** - Connettiti con CI/CD flussi di lavoro, strumenti personalizzati e soluzioni di monitoraggio.
+  **Controlla i dettagli dell'implementazione**: configura opzioni dettagliate per la selezione degli stack e le implementazioni multiambiente.
+  **Migliora l'affidabilità**: implementa la gestione degli errori pronta per la produzione e il monitoraggio dei progressi di implementazione.
+  **Automatizza il refactoring**: rileva e preserva le risorse quando esegui il refactoring del codice CDK.

## Passaggi successivi
<a name="toolkit-library-intro-next"></a>

[Per iniziare a utilizzare la CDK Toolkit Library, consulta Guida introduttiva alla CDK Toolkit Library.](toolkit-library-gs.md)

## Ulteriori informazioni
<a name="toolkit-library-intro-learn"></a>

Per ulteriori informazioni sulla CDK Toolkit Library, consulta quanto segue:
+  [ReadMe](https://www.npmjs.com/package/@aws-cdk/toolkit-lib)nel pacchetto *@aws -cdk/toolkit-lib*`npm`.
+  [AWS Riferimento all'API CDK Toolkit Library](https://docs.aws.amazon.com/cdk/api/toolkit-lib/).