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

# Guida introduttiva alla libreria CDK Toolkit
<a name="toolkit-library-gs"></a>

Inizia a utilizzare la AWS CDK Toolkit Library per eseguire in modo programmatico azioni CDK, come la sintesi e la distribuzione, nel tuo codice.

## Prerequisiti
<a name="toolkit-library-gs-prerequisites"></a>

1. Versione supportata di Node.js installata.

1.  AWS credenziali configurate.

1. Familiarità di base con il CDK. AWS 

Per ulteriori informazioni, consulta Prerequisiti [AWS CDK](prerequisites.md).

## Fase 1: Installazione della libreria CDK Toolkit
<a name="toolkit-library-gs-install"></a>

Installa il pacchetto CDK Toolkit Library nell'ambiente di sviluppo del tuo progetto eseguendo quanto segue:

```
npm install --save @aws-cdk/toolkit-lib
```

## Fase 2: Inizializzazione della libreria CDK Toolkit
<a name="toolkit-library-gs-initialize"></a>

Crea un'istanza CDK Toolkit per eseguire azioni programmatiche sulla tua app CDK.

```
import { Toolkit } from '@aws-cdk/toolkit-lib';

const toolkit = new Toolkit({
    // Optional configuration options go here
});
```

È possibile personalizzare l'istanza CDK Toolkit durante la creazione. Per istruzioni, consulta [Configurazione dell'istanza CDK Toolkit](toolkit-library-configure.md).

## Fase 3: Creazione di una fonte di assemblaggio cloud per l'app CDK
<a name="toolkit-library-gs-ca"></a>

Una fonte di assemblaggio cloud fornisce istruzioni per generare CloudFormation modelli dall'app CDK. Puoi crearne uno in diversi modi. Di seguito sono riportati alcuni esempi:

1.  **Una funzione di creazione di assemblaggi in linea:**

   ```
   import * as cdk from 'aws-cdk-lib';
   
   const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => {
     const app = new cdk.App();
     new MyStack(app, 'MyStack');
     return app.synth();
   });
   ```

1.  **Un file dell'app CDK esistente**:

   ```
   const cloudAssemblySource = await toolkit.fromCdkApp("ts-node app.ts");
   ```

Per ulteriori informazioni, consulta [Configurare le fonti di assemblaggio cloud](toolkit-library-configure-ca.md).

## Fase 4: Definizione delle azioni programmatiche per l'app CDK
<a name="toolkit-library-gs-define"></a>

Ora che avete creato un'istanza di CDK Toolkit e una fonte di assemblaggio cloud, potete iniziare a definire le azioni programmatiche. Di seguito è riportato un esempio di base che crea una distribuzione dello stack: `MyStack`

```
import { StackSelectionStrategy } from '@aws-cdk/toolkit-lib';

await toolkit.deploy(cloudAssemblySource, {
  stacks: {
    strategy: StackSelectionStrategy.PATTERN_MUST_MATCH, // Deploy only stacks that exactly match the provided patterns
    patterns: ["MyStack"],
  },
});
```

## Fase 5: Personalizzazione ulteriore del CDK Toolkit
<a name="toolkit-library-gs-customize"></a>

È possibile configurare e personalizzare ulteriormente il CDK Toolkit in base alle proprie esigenze:
+  **Messaggi e interazioni**: configura il modo in cui CDK Toolkit comunica con utenti e applicazioni. Vedi [Configurare messaggi](toolkit-library-configure-messages.md) e interazioni.
+  **Gestione degli errori**: implementa la gestione strutturata degli errori per le operazioni CDK. Vedi [Configurare la gestione degli errori](toolkit-library-configure.md#toolkit-library-configure-errors).

## Risorse aggiuntive
<a name="toolkit-library-gs-resources"></a>

Per ulteriori informazioni sul pacchetto CDK Toolkit Library, consultate il `npm` pacchetto *@aws [ReadMe](https://www.npmjs.com/package/@aws-cdk/toolkit-lib)`npm`-cdk/toolkit-lib*.

[Per informazioni di riferimento sulle API, consultate il riferimento all'API CDK Toolkit Library.](https://docs.aws.amazon.com/cdk/api/toolkit-lib/)