

Amazon non CodeCatalyst è più aperta a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [Come migrare da CodeCatalyst](migration.md).

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

# Implementazione di un AWS CDK app con un flusso di lavoro
<a name="cdk-dep-action"></a>

Questa sezione descrive come distribuire un' AWS Cloud Development Kit (AWS CDK) app nel tuo AWS account utilizzando un flusso di lavoro. A tale scopo, è necessario aggiungere l'azione di **AWS CDK distribuzione al flusso** di lavoro. L'azione di **AWS CDK distribuzione** sintetizza e distribuisce l'app in. AWS Cloud Development Kit (AWS CDK) AWS Se l'app esiste già in AWS, l'azione la aggiorna se necessario. 

Per informazioni generali sulla scrittura di app utilizzando il AWS CDK, vedi [Cos'è il AWS CDK?](https://docs.aws.amazon.com/cdk/v2/guide/home.html) nella *Guida per gli AWS Cloud Development Kit (AWS CDK) sviluppatori*.

**Topics**
+ [Quando usare il 'AWS CDK azione 'deploy'](#cdk-dep-action-when-to-use)
+ [Come si fa il 'AWS CDK funziona l'azione 'deploy'](#cdk-dep-action-how-it-works)
+ [Versioni CDK CLI utilizzate da 'AWS CDK azione «deploy»](#cdk-dep-action-cdk-version)
+ [Immagine di runtime utilizzata da 'AWS CDK azione «deploy»](#cdk-dep-action-runtime)
+ [Quanti stack può dispiegare l'azione?](#cdk-dep-action-how-many-stacks)
+ [Esempio: implementazione di un AWS CDK app](cdk-dep-action-example-workflow.md)
+ [Aggiungere il 'AWS CDK azione «deploy»](cdk-dep-action-add.md)
+ ['AWS CDK variabili 'deploy'](cdk-dep-action-variables.md)
+ [AWS CDK azione 'distribuisci' YAML](cdk-dep-action-ref.md)

## Quando usare il 'AWS CDK azione 'deploy'
<a name="cdk-dep-action-when-to-use"></a>

Utilizza questa azione se hai sviluppato un'app utilizzando e ora desideri distribuirla AWS CDK automaticamente come parte del flusso di lavoro automatizzato di integrazione e distribuzione continue ()CI/CD. Ad esempio, potresti voler distribuire la tua AWS CDK app automaticamente ogni volta che qualcuno unisce una pull request relativa alla fonte dell'app AWS CDK . 

## Come si fa il 'AWS CDK funziona l'azione 'deploy'
<a name="cdk-dep-action-how-it-works"></a>

La **AWS CDK distribuzione funziona nel modo seguente**:

1. [In fase di esecuzione, se hai specificato la versione 1.0.12 o precedente dell'azione, l'azione scarica l'ultima CLI CDK (chiamata anche Tookit) AWS CDK nell'immagine dell'ambiente di runtime. CodeCatalyst ](#cdk-dep-action-runtime)

   Se hai specificato la versione 1.0.13 o successiva, l'azione viene fornita in bundle con una [versione specifica](#cdk-dep-action-cdk-version) della CLI CDK, quindi non viene effettuato alcun download.

1. L'azione utilizza la CLI CDK per eseguire il comando`cdk deploy`. Questo comando sintetizza e distribuisce l'app in. AWS CDK AWS*Per ulteriori informazioni su questo comando, consultate l'argomento [AWS CDK Toolkit (comando cdk)](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html) nella Guida per gli sviluppatori.AWS Cloud Development Kit (AWS CDK) *

## Versioni CDK CLI utilizzate da 'AWS CDK azione «deploy»
<a name="cdk-dep-action-cdk-version"></a>

La tabella seguente mostra quale versione della CLI CDK viene utilizzata per impostazione predefinita dalle diverse versioni **AWS CDK dell'**azione di distribuzione.

**Nota**  
Potresti essere in grado di sovrascrivere l'impostazione predefinita. Per ulteriori informazioni, consulta [CdkCliVersion](cdk-dep-action-ref.md#cdk.dep.cdk.cli.version) nella [AWS CDK azione 'distribuisci' YAML](cdk-dep-action-ref.md).


| versione dell'AWS CDK azione 'deploy' | AWS CDK Versione CLI | 
| --- | --- | 
| 1.0.0 — 1.0.12 | più recente | 
| 1.0.13 o versione successiva | 2.99.1 | 

## Immagine di runtime utilizzata da 'AWS CDK azione «deploy»
<a name="cdk-dep-action-runtime"></a>

La tabella seguente mostra le immagini dell'ambiente di runtime CodeCatalyst utilizzate per eseguire diverse versioni dell'azione di **AWS CDK distribuzione.** Le immagini includono diversi set di strumenti preinstallati. Per ulteriori informazioni, consulta [Immagini attive](build-images.md#build-curated-images).

**Nota**  
Ti consigliamo di aggiornare l'azione di **AWS CDK distribuzione** alla versione 2.x per sfruttare gli strumenti più recenti disponibili nell'immagine di marzo 2024. Per aggiornare l'azione, impostane la `Identifier` proprietà su nel file di definizione del flusso di lavoro`aws/cdk-deploy@v2`. Per ulteriori informazioni, consulta [AWS CDK azione 'distribuisci' YAML](cdk-dep-action-ref.md). 


| versione dell'AWS CDK azione 'deploy' | Immagini dell'ambiente di runtime | 
| --- | --- | 
| 1.x | Immagini di novembre 2022 | 
| 2.x | Immagini di marzo 2024 | 

## Quanti stack può dispiegare l'azione?
<a name="cdk-dep-action-how-many-stacks"></a>

La **AWS CDK distribuzione può implementare solo un singolo stack**. Se la tua AWS CDK app è composta da più stack, devi creare uno stack principale con stack annidati e distribuire lo stack principale utilizzando questa azione.