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 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 utilizzare l'azione «AWS CDK deploy»](#cdk-dep-action-when-to-use) + [Come funziona l'azione 'AWS CDK deploy'](#cdk-dep-action-how-it-works) + [Versioni CDK CLI utilizzate dall'azione 'deploy'AWS CDK](#cdk-dep-action-cdk-version) + [Immagine di runtime utilizzata dall'azione 'deploy'AWS CDK](#cdk-dep-action-runtime) + [Quanti stack può dispiegare l'azione?](#cdk-dep-action-how-many-stacks) + [Esempio: distribuzione di un'app AWS CDK](cdk-dep-action-example-workflow.md) + [Aggiungere l'azione 'AWS CDK deploy'](cdk-dep-action-add.md) + [variabili 'AWS CDK deploy'](cdk-dep-action-variables.md) + [AWS CDK azione 'distribuisci' YAML](cdk-dep-action-ref.md) ## Quando utilizzare l'azione «AWS CDK deploy» 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 funziona l'azione 'AWS CDK deploy' 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 dall'azione 'deploy'AWS CDK 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 successivo | 2.99.1 | ## Immagine di runtime utilizzata dall'azione 'deploy'AWS CDK 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? 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. # Esempio: distribuzione di un'app AWS CDK **Il seguente flusso di lavoro di esempio include l'azione **AWS CDK deploy**, insieme all'AWS CDK azione bootstrap.** Il flusso di lavoro è costituito dai seguenti elementi costitutivi eseguiti in sequenza: + Un **trigger**: questo trigger avvia l'esecuzione automatica del flusso di lavoro quando invii una modifica al tuo repository di origine. Questo repository contiene la tua AWS CDK app. Per ulteriori informazioni sui trigger, consulta [L'avvio di un flusso di lavoro viene eseguito automaticamente utilizzando i trigger](workflows-add-trigger.md). + Un'azione di **AWS CDK bootstrap** (`CDKBootstrap`): all'attivazione, l'azione distribuisce lo stack di `CDKToolkit` bootstrap in. AWS Se lo `CDKToolkit` stack esiste già nell'ambiente, verrà aggiornato se necessario; in caso contrario, non succede nulla e l'azione viene contrassegnata come riuscita. + An **AWS CDK deploy** action (`AWS CDK Deploy`): al termine dell'azione **AWS CDK bootstrap**, l'azione **AWS CDK deploy** sintetizza il codice dell' AWS CDK app in un CloudFormation modello e distribuisce lo stack definito nel modello. AWS **Nota** Il seguente esempio di flusso di lavoro è a scopo illustrativo e non funzionerà senza una configurazione aggiuntiva. **Nota** Nel codice YAML che segue, puoi omettere le `Connections:` sezioni se lo desideri. ****Se ometti queste sezioni, devi assicurarti che il ruolo specificato nel campo **Default IAM role** nel tuo ambiente includa le autorizzazioni e le policy di fiducia richieste dalle azioni bootstrap e deploy.AWS CDK AWS CDK **** Per ulteriori informazioni sulla configurazione di un ambiente con un ruolo IAM predefinito, consulta. [Creazione di un ambiente](deploy-environments-creating-environment.md) Per ulteriori informazioni sulle autorizzazioni e sulle politiche di attendibilità richieste dalle azioni **AWS CDK bootstrap** e **AWS CDK deploy**, consulta la descrizione della `Role` proprietà nel e. [azione 'AWS CDK bootstrap' YAML](cdk-boot-action-ref.md) [AWS CDK azione 'distribuisci' YAML](cdk-dep-action-ref.md) ``` Name: codecatalyst-cdk-deploy-workflow SchemaVersion: 1.0 Triggers: - Type: PUSH Branches: - main Actions: CDKBootstrap: Identifier: aws/cdk-bootstrap@v2 Inputs: Sources: - WorkflowSource Environment: Name: codecatalyst-cdk-deploy-environment Connections: - Name: codecatalyst-account-connection Role: codecatalyst-cdk-bootstrap-role Configuration: Region: us-west-2 CDKDeploy: Identifier: aws/cdk-deploy@v2 DependsOn: - CDKBootstrap Environment: Name: codecatalyst-cdk-deploy-environment Connections: - Name: codecatalyst-account-connection Role: codecatalyst-cdk-deploy-role Inputs: Sources: - WorkflowSource Configuration: StackName: my-app-stack Region: us-west-2 ``` # Aggiungere l'azione 'AWS CDK deploy' Utilizza le seguenti istruzioni per aggiungere l'azione di **AWS CDK distribuzione al tuo flusso di lavoro.** **Prima di iniziare** Prima di aggiungere l'azione di **AWS CDK distribuzione** al flusso di lavoro, completa le seguenti attività: 1. **Tieni pronta un' AWS CDK app**. Puoi scrivere la tua AWS CDK app usando AWS CDK v1 o v2, in qualsiasi linguaggio di programmazione supportato da. AWS CDK Assicurati che i file della tua AWS CDK app siano disponibili in: + Un [archivio CodeCatalyst di sorgenti](source.md), oppure + Un [artefatto CodeCatalyst di output](workflows-working-artifacts.md) generato da un'altra azione del flusso di lavoro 1. **Avvia il tuo ambiente. AWS ** Per eseguire il bootstrap, puoi: + Utilizza uno dei metodi descritti in [Come eseguire il bootstrap nella Guida](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-howto) per gli *AWS Cloud Development Kit (AWS CDK) sviluppatori*. + Usa l'azione **AWS CDK bootstrap.** Puoi aggiungere questa azione nello stesso flusso di lavoro della **AWS CDK distribuzione** o in uno diverso. Assicurati solo che l'azione bootstrap venga eseguita almeno una volta prima di eseguire l'azione di **AWS CDK distribuzione** in modo che siano disponibili le risorse necessarie. Per ulteriori informazioni sull'azione **AWS CDK bootstrap**, consulta. [Avvio di un' AWS CDK app con un flusso di lavoro](cdk-boot-action.md) *Per ulteriori informazioni sul bootstrap, consulta [Bootstrap](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) nella Developer Guide.AWS Cloud Development Kit (AWS CDK) * ------ #### [ Visual ] **Per aggiungere l'azione 'AWS CDK deploy' utilizzando l'editor visuale** 1. [Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.](https://codecatalyst.aws/) 1. Scegliere il progetto. 1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.** 1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro. 1. Scegli **Modifica**. 1. Scegli **Visual**. 1. In alto a sinistra, scegli **\$1 Azioni** per aprire il catalogo delle azioni. 1. **Dall'elenco a discesa, scegli Amazon. CodeCatalyst** 1. Cerca l'azione di **AWS CDK distribuzione** ed esegui una delle seguenti operazioni: + Scegli il segno più (**\$1**) per aggiungere l'azione al diagramma del flusso di lavoro e apri il relativo riquadro di configurazione. Or + Scegli **AWS CDK deploy**. Viene visualizzata la finestra di dialogo dei dettagli dell'azione. In questa finestra di dialogo: + (Facoltativo) Scegliete **Scarica** per [visualizzare il codice sorgente dell'azione](workflows-view-source.md#workflows-view-source.title). + Scegli **Aggiungi al flusso di lavoro** per aggiungere l'azione al diagramma del flusso di lavoro e aprirne il riquadro di configurazione. 1. Nelle schede **Ingressi** e **Configurazione**, completa i campi in base alle tue esigenze. Per una descrizione di ogni campo, vedi. [AWS CDK azione 'distribuisci' YAML](cdk-dep-action-ref.md) Questo riferimento fornisce informazioni dettagliate su ogni campo (e il valore della proprietà YAML corrispondente) così come appaiono sia nell'editor YAML che in quello visivo. 1. (Facoltativo) Scegliete **Convalida per convalidare il codice YAML** del flusso di lavoro prima di eseguire il commit. 1. **Scegliete **Commit**, inserite un messaggio di commit, quindi scegliete nuovamente Commit.** **Nota** Se l'azione di **AWS CDK distribuzione** fallisce con un `npm install` errore, consulta [Come posso correggere gli errori di «npm install»?](troubleshooting-workflows.md#troubleshooting-workflows-npm) per informazioni su come correggere l'errore. ------ #### [ YAML ] **Per aggiungere l'azione 'AWS CDK deploy' utilizzando l'editor YAML** 1. [Apri la console all'indirizzo https://codecatalyst.aws/ CodeCatalyst .](https://codecatalyst.aws/) 1. Scegliere il progetto. 1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.** 1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro. 1. Scegli **Modifica**. 1. Scegli **YAML**. 1. In alto a sinistra, scegli **\$1 Azioni per aprire il catalogo delle azioni**. 1. **Dall'elenco a discesa, scegli Amazon. CodeCatalyst** 1. Cerca l'azione di **AWS CDK distribuzione** ed esegui una delle seguenti operazioni: + Scegli il segno più (**\$1**) per aggiungere l'azione al diagramma del flusso di lavoro e apri il relativo riquadro di configurazione. Or + Scegli **AWS CDK deploy**. Viene visualizzata la finestra di dialogo dei dettagli dell'azione. In questa finestra di dialogo: + (Facoltativo) Scegliete **Scarica** per [visualizzare il codice sorgente dell'azione](workflows-view-source.md#workflows-view-source.title). + Scegli **Aggiungi al flusso di lavoro** per aggiungere l'azione al diagramma del flusso di lavoro e aprirne il riquadro di configurazione. 1. Modifica le proprietà del codice YAML in base alle tue esigenze. Una spiegazione di ogni proprietà disponibile è fornita in. [AWS CDK azione 'distribuisci' YAML](cdk-dep-action-ref.md) 1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit. 1. **Scegliete **Commit**, inserite un messaggio di commit, quindi scegliete nuovamente Commit.** **Nota** Se l'azione di **AWS CDK distribuzione** fallisce con un `npm install` errore, consulta [Come posso correggere gli errori di «npm install»?](troubleshooting-workflows.md#troubleshooting-workflows-npm) per informazioni su come correggere l'errore. ------ # variabili 'AWS CDK deploy' L'azione **AWS CDK deploy** produce e imposta le seguenti variabili in fase di esecuzione. Queste sono note come variabili *predefinite*. Per informazioni su come fare riferimento a queste variabili in un flusso di lavoro, vedere. [Utilizzo di variabili predefinite](workflows-using-predefined-variables.md) | Chiave | Valore | | --- | --- | | stack-id | L'Amazon Resource Name (ARN) dello stack di AWS CDK applicazioni su cui è stato distribuito durante l'esecuzione del flusso di lavoro. Ad esempio: `arn:aws:cloudformation:us-west-2:111122223333:stack/codecatalyst-cdk-app-stack/6aad4380-100a-11ec-a10a-03b8a84d40df` | | piattaforma di distribuzione | Il nome della piattaforma di distribuzione. Codificato in. `AWS:CloudFormation` | | region | Il codice regionale su Regione AWS cui è stato distribuito durante l'esecuzione del flusso di lavoro. Ad esempio: `us-west-2` | | SALTA LA DISTRIBUZIONE | Il valore di `true` indica che la distribuzione dello stack di AWS CDK applicazioni è stata ignorata durante l'esecuzione del flusso di lavoro. Una distribuzione dello stack verrà ignorata se non vi sono modifiche nello stack dall'ultima distribuzione. Questa variabile viene prodotta solo se il suo valore è. `true` Codificato in. `true` | | *CloudFormation variabili* | Oltre a generare le variabili elencate in precedenza, l'azione di **AWS CDK distribuzione** espone anche le variabili di *CloudFormation*output come variabili del *flusso* di lavoro da utilizzare nelle azioni successive del flusso di lavoro. Per impostazione predefinita, l'azione espone solo le prime quattro (o meno) CloudFormation variabili trovate. Per determinare quali sono esposte, esegui l'azione di **AWS CDK distribuzione** una volta, quindi consulta la scheda **Variabili** della pagina dei dettagli di esecuzione. Se le variabili elencate nella scheda **Variabili** non sono quelle desiderate, puoi configurarne di diverse utilizzando la proprietà `CfnOutputVariables` YAML. Per ulteriori informazioni, consultate la descrizione della [CfnOutputVariables](cdk-dep-action-ref.md#cdk.dep.cfn.out) proprietà in. [AWS CDK azione 'distribuisci' YAML](cdk-dep-action-ref.md) | # AWS CDK azione 'distribuisci' YAML Di seguito è riportata la definizione YAML dell'azione di **AWS CDK distribuzione**. Per informazioni su come utilizzare questa azione, consulta. [Implementazione di un' AWS CDK app con un flusso di lavoro](cdk-dep-action.md) Questa definizione di azione esiste come sezione all'interno di un file di definizione del flusso di lavoro più ampio. Per ulteriori informazioni su questo file, consulta [Definizione YAML del flusso di lavoro](workflow-reference.md). **Nota** La maggior parte delle proprietà YAML che seguono hanno elementi dell'interfaccia utente corrispondenti nell'editor visivo. **Per cercare un elemento dell'interfaccia utente, usa Ctrl\$1F.** L'elemento verrà elencato con la proprietà YAML associata. ``` # The workflow definition starts here. # See Proprietà di primo livello for details. Name: MyWorkflow SchemaVersion: 1.0 Actions: # The action definition starts here. CDKDeploy\$1nn: Identifier: aws/cdk-deploy@v2 DependsOn: - CDKBootstrap Compute: Type: EC2 | Lambda Fleet: fleet-name Timeout: timeout-minutes Inputs: # Specify a source or an artifact, but not both. Sources: - source-name-1 Artifacts: - artifact-name Outputs: Artifacts: - Name: cdk_artifact Files: - "cdk.out/**/*" Environment: Name: environment-name Connections: - Name: account-connection-name Role: iam-role-name Configuration: StackName: my-cdk-stack Region: us-west-2 Tags: '{"key1": "value1", "key2": "value2"}' Context: '{"key1": "value1", "key2": "value2"}' CdkCliVersion: version CdkRootPath: directory-containing-cdk.json-file CfnOutputVariables: '["CnfOutputKey1","CfnOutputKey2","CfnOutputKey3"]' CloudAssemblyRootPath: path-to-cdk.out ``` ## CDKDeploy (Obbligatorio) Specificare il nome dell'azione. Tutti i nomi delle azioni devono essere univoci all'interno del flusso di lavoro. I nomi delle azioni sono limitati a caratteri alfanumerici (a-z, A-Z, 0-9), trattini (-) e caratteri di sottolineatura (\$1). Gli spazi non sono consentiti. Non è possibile utilizzare le virgolette per abilitare caratteri e spazi speciali nei nomi delle azioni. Default: `CDKDeploy_nn`. **Interfaccia utente corrispondente: scheda di configurazione/nome dell'azione** ## Identifier (*CDKDeploy*/**Identifier**) (Obbligatorio) Identifica l'azione. Non modificate questa proprietà a meno che non vogliate cambiare la versione. Per ulteriori informazioni, consulta [Specificare la versione dell'azione da utilizzare](workflows-action-versions.md). **Nota** La specificazione `aws/cdk-deploy@v2` causa l'esecuzione dell'azione sull'[immagine di marzo 2024](build-images.md#build.default-image) che include strumenti più recenti come Node.js 18. La specifica `aws/cdk-deploy@v1` fa sì che l'azione venga eseguita sull'[immagine di novembre 2022](build-images.md#build.previous-image) che include strumenti meno recenti come Node.js 16. Default: `aws/cdk-deploy@v2`. **Interfaccia utente corrispondente: Workflow diagram/ \$1nn/ CDKDeploy aws/cdk-deploy @v2 label** ## DependsOn (*CDKDeploy*/**DependsOn**) (Facoltativo) **Specificare un'azione o un gruppo di azioni che deve essere eseguito correttamente per l'esecuzione dell'azione di distribuzione.AWS CDK ** Ti consigliamo di specificare l'azione **AWS CDK bootstrap** nella `DependsOn` proprietà, in questo modo: ``` CDKDeploy: Identifier: aws/cdk-deploy@v2 DependsOn: - CDKBootstrap ``` **Nota** Il [bootstrap](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) è un prerequisito obbligatorio per la distribuzione di un'app. AWS CDK **Se non includi l'azione **AWS CDK Bootstrap** nel tuo flusso di lavoro, devi trovare un altro modo per distribuire lo stack AWS CDK bootstrap prima di eseguire l'azione di distribuzione.AWS CDK ** Per ulteriori informazioni, consulta [Aggiungere l'azione 'AWS CDK deploy'](cdk-dep-action-add.md) in [Implementazione di un' AWS CDK app con un flusso di lavoro](cdk-dep-action.md). Per ulteriori informazioni sulla funzionalità 'depends on', consulta. [Azioni di sequenziamento](workflows-depends-on.md) **Interfaccia utente corrispondente: scheda Ingressi/Dipende da - opzionale** ## Compute (*CDKDeploy*/**Compute**) (Facoltativo) Il motore di calcolo utilizzato per eseguire le azioni del flusso di lavoro. È possibile specificare l'elaborazione a livello di flusso di lavoro o a livello di azione, ma non entrambi. Se specificata a livello di flusso di lavoro, la configurazione di calcolo si applica a tutte le azioni definite nel flusso di lavoro. A livello di flusso di lavoro, puoi anche eseguire più azioni sulla stessa istanza. Per ulteriori informazioni, consulta [Condivisione dell'elaborazione tra le azioni](compute-sharing.md). Interfaccia utente corrispondente: *nessuna* ## Type (*CDKDeploy*/Compute/**Type**) (Obbligatorio se [Compute](#cdk.dep.computename) incluso) Il tipo di motore di calcolo. È possibile utilizzare uno dei seguenti valori: + **EC2**(editor visivo) o `EC2` (editor YAML) Ottimizzato per la flessibilità durante le operazioni. + **Lambda** (editor visivo) o `Lambda` (editor YAML) Velocità di avvio delle azioni ottimizzate. Per ulteriori informazioni sui tipi di calcolo, consulta [Tipi di calcolo](workflows-working-compute.md#compute.types). **Interfaccia utente corrispondente: configurazione tab/Advanced : opzionale/tipo di calcolo** ## Fleet (*CDKDeploy*/Compute/**Fleet**) (Facoltativo) Specificate la macchina o il parco macchine che eseguiranno il flusso di lavoro o le azioni del flusso di lavoro. Con le flotte on-demand, all'avvio di un'azione, il flusso di lavoro fornisce le risorse necessarie e le macchine vengono distrutte al termine dell'azione. Esempi di flotte on-demand:,. `Linux.x86-64.Large` `Linux.x86-64.XLarge` Per ulteriori informazioni sulle flotte on-demand, vedere. [Proprietà del parco istanze on demand](workflows-working-compute.md#compute.on-demand) Con le flotte assegnate, puoi configurare una serie di macchine dedicate per eseguire le azioni del flusso di lavoro. Queste macchine rimangono inattive, pronte a elaborare immediatamente le azioni. Per ulteriori informazioni sulle flotte rifornite, vedere. [Proprietà del parco istanze con provisioning](workflows-working-compute.md#compute.provisioned-fleets) Se `Fleet` viene omesso, l'impostazione predefinita è. `Linux.x86-64.Large` **Interfaccia utente corrispondente: Configurazione tab/Advanced : parco opzionale/di calcolo** ## Timeout (*CDKDeploy*/**Timeout**) (Obbligatorio) Specificate il periodo di tempo, in minuti (editor YAML) o in ore e minuti (editor visivo), che l'azione può essere eseguita prima che termini l'azione. CodeCatalyst Il minimo è 5 minuti e il massimo è descritto in. [Quote per i flussi di lavoro in CodeCatalyst](workflows-quotas.md) Il timeout predefinito è lo stesso del timeout massimo. **Interfaccia utente corrispondente: scheda di configurazione/timeout - opzionale** ## Inputs (*CDKDeploy*/**Inputs**) (Facoltativo) La `Inputs` sezione definisce i dati `CDKDeploy` necessari durante l'esecuzione di un flusso di lavoro. **Nota** È consentito un solo input (una fonte o un artefatto) per ogni azione di **AWS CDK distribuzione**. **Interfaccia utente corrispondente: scheda Ingressi** ## Sources (*CDKDeploy*/Inputs/**Sources**) (Richiesto se l' AWS CDK app che desideri distribuire è archiviata in un repository di origine) Se AWS CDK l'app è archiviata in un repository di origine, specifica l'etichetta di tale repository di origine. L'azione **AWS CDK deploy** sintetizza l'app in questo repository prima di iniziare il processo di distribuzione. Attualmente, l'unica etichetta supportata è. `WorkflowSource` Se AWS CDK l'app non è contenuta in un repository di origine, deve risiedere in un artefatto generato da un'altra azione. Per ulteriori informazioni sulle origini, consulta [Connessione degli archivi di origine ai flussi di lavoro](workflows-sources.md). **Interfaccia utente corrispondente: scheda Input/Sources - opzionale** ## Artifacts - input (*CDKDeploy*/Inputs/**Artifacts**) (Richiesto se l' AWS CDK app che desideri distribuire è archiviata in un elemento di [output di un'azione precedente](workflows-working-artifacts-output.md)) Se AWS CDK l'app è contenuta in un artefatto generato da un'azione precedente, specificalo qui. L'azione **AWS CDK deploy** sintetizza l'app nell'artefatto specificato in un modello prima di iniziare il processo di distribuzione. CloudFormation Se AWS CDK l'app non è contenuta in un artefatto, deve risiedere nel repository di origine. Per ulteriori informazioni sugli artefatti, inclusi esempi, vedere. [Condivisione di artefatti e file tra azioni](workflows-working-artifacts.md) **Interfaccia utente corrispondente: scheda Input/Artifacts - opzionale** ## Outputs (*CDKDeploy*/**Outputs**) (Facoltativo) Definisce i dati emessi dall'azione durante l'esecuzione di un flusso di lavoro. Interfaccia utente corrispondente: **scheda Output** ## Artifacts - output (*CDKDeploy*/Outputs/**Artifacts** (Facoltativo) Specificate gli artefatti generati dall'azione. È possibile fare riferimento a questi artefatti come input in altre azioni. Per ulteriori informazioni sugli artefatti, inclusi esempi, vedere. [Condivisione di artefatti e file tra azioni](workflows-working-artifacts.md) **Interfaccia utente corrispondente: scheda Outputs/Artifacts** ## Name (*CDKDeploy*/Outputs/Artifacts/**Name**) (Richiesto se incluso) [Artifacts - output](#cdk.dep.outputs.artifacts) Specificate il nome dell'artefatto che conterrà il CloudFormation modello sintetizzato dall'azione di **AWS CDK distribuzione** in fase di esecuzione. Il valore predefinito è `cdk_artifact`. Se non specificate un artefatto, l'azione sintetizza il modello ma non lo salva in un artefatto. Prendi in considerazione la possibilità di salvare il modello sintetizzato in un artefatto per conservarne una registrazione a scopo di test o risoluzione dei problemi. **Interfaccia utente corrispondente: restituisce il nome dell'artefatto/crea il nome dell'artefatto tab/Artifacts/Add** ## Files (*CDKDeploy*/Outputs/Artifacts/**Files**) (Richiesto se incluso) [Artifacts - output](#cdk.dep.outputs.artifacts) Specificate i file da includere nell'artefatto. È necessario specificare `"cdk.out/**/*"` di includere il modello sintetizzato CloudFormation dell' AWS CDK app. **Nota** `cdk.out`è la directory predefinita in cui vengono salvati i file sintetizzati. Se avete specificato una directory di output diversa `cdk.out` da quella `cdk.json` del file, specificate quella directory qui invece di. `cdk.out` **Interfaccia utente corrispondente: restituisce tab/Artifacts/Add artefatti/file prodotti da build** ## Environment (*CDKDeploy*/**Environment**) (Obbligatorio) Specificare l' CodeCatalyst ambiente da utilizzare con l'azione. L'azione si connette Account AWS all'Amazon VPC opzionale specificato nell'ambiente scelto. L'azione utilizza il ruolo IAM predefinito specificato nell'ambiente per connettersi a e utilizza il ruolo IAM specificato nella [connessione Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) per connettersi ad Amazon VPC. Account AWS **Nota** Se il ruolo IAM predefinito non dispone delle autorizzazioni richieste dall'azione, puoi configurare l'azione per utilizzare un ruolo diverso. Per ulteriori informazioni, consulta [Modifica del ruolo IAM di un'azione](deploy-environments-switch-role.md). Per ulteriori informazioni sugli ambienti, consulta [Implementazione in e Account AWS VPCs](deploy-environments.md) e[Creazione di un ambiente](deploy-environments-creating-environment.md). **Interfaccia utente corrispondente: scheda di configurazione/ambiente** ## Name (*CDKDeploy*/Environment/**Name**) (Richiesto se [Environment](#cdk.dep.environment) incluso) Specificate il nome di un ambiente esistente che desiderate associare all'azione. **Interfaccia utente corrispondente: scheda di configurazione/ambiente** ## Connections (*CDKDeploy*/Environment/**Connections**) (Facoltativo nelle versioni più recenti dell'azione; richiesto nelle versioni precedenti) Specificare la connessione dell'account da associare all'azione. È possibile specificare al massimo una connessione a un account in`Environment`. Se non si specifica una connessione all'account: + L'azione utilizza la Account AWS connessione e il ruolo IAM predefinito specificati nell'ambiente della CodeCatalyst console. Per informazioni sull'aggiunta di una connessione all'account e del ruolo IAM predefinito all'ambiente, consulta[Creazione di un ambiente](deploy-environments-creating-environment.md). + Il ruolo IAM predefinito deve includere le policy e le autorizzazioni richieste dall'azione. Per determinare quali sono tali politiche e autorizzazioni, consulta la descrizione della proprietà **Role nella documentazione** sulla definizione YAML dell'azione. Per ulteriori informazioni sulle connessioni degli account, vedere. [Consentire l'accesso alle AWS risorse con connessione Account AWS](ipa-connect-account.md) Per informazioni sull'aggiunta di una connessione tramite account a un ambiente, vedere[Creazione di un ambiente](deploy-environments-creating-environment.md). Interfaccia utente corrispondente: una delle seguenti a seconda della versione dell'azione: + (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo** + **(Versioni precedenti) Scheda di configurazione/' '/ connessione all'account Environment/account/role AWS ** ## Name (*CDKDeploy*/Environment/Connections/**Name**) (Richiesto se è incluso[Connections](#cdk.dep.environment.connections)) Specificare il nome della connessione all'account. Interfaccia utente corrispondente: una delle seguenti a seconda della versione dell'azione: + (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo** + **(Versioni precedenti) Scheda di configurazione/' '/ connessione all'account Environment/account/role AWS ** ## Role (*CDKDeploy*/Environment/Connections/**Role**) (Richiesto se è incluso[Connections](#cdk.dep.environment.connections)) Specificare il nome della connessione all'account. Specificate il nome del ruolo IAM **AWS CDK utilizzato** dall'azione di distribuzione per accedere AWS e distribuire lo stack di AWS CDK applicazioni. Assicurati di aver [aggiunto il ruolo al tuo CodeCatalyst spazio](ipa-connect-account-addroles.md) e che il ruolo includa le seguenti politiche. Se non specifichi un ruolo IAM, l'azione utilizza il ruolo IAM predefinito elencato nell'[ambiente](deploy-environments.md) nella CodeCatalyst console. Se utilizzi il ruolo predefinito nell'ambiente, assicurati che abbia le seguenti politiche. + La seguente politica di autorizzazioni: **avvertimento** Limita le autorizzazioni a quelle mostrate nella seguente politica. L'utilizzo di un ruolo con autorizzazioni più ampie potrebbe rappresentare un rischio per la sicurezza. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "cloudformation:DescribeStackEvents", "cloudformation:DescribeChangeSet", "cloudformation:DescribeStacks", "cloudformation:ListStackResources" ], "Resource": "*" }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": "sts:AssumeRole", "Resource": "arn:aws:iam::111122223333:role/cdk-*" } ] } ``` ------ + La seguente politica di fiducia personalizzata: **Nota** Puoi usare il `CodeCatalystWorkflowDevelopmentRole-spaceName` ruolo con questa azione, se lo desideri. Per ulteriori informazioni su questo ruolo, consulta [Creazione del **CodeCatalystWorkflowDevelopmentRole-*spaceName***ruolo per il tuo account e il tuo spazio](ipa-iam-roles.md#ipa-iam-roles-service-create). Tieni presente che il `CodeCatalystWorkflowDevelopmentRole-spaceName` ruolo dispone di autorizzazioni di accesso complete, il che può rappresentare un rischio per la sicurezza. Ti consigliamo di utilizzare questo ruolo solo in tutorial e scenari in cui la sicurezza è meno preoccupante. Interfaccia utente corrispondente: una delle seguenti a seconda della versione di azione: + (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo** + **(Versioni precedenti) Scheda di configurazione/' '/ Ruolo Environment/account/role** ## Configuration (*CDKDeploy*/**Configuration**) (Obbligatorio) Una sezione in cui è possibile definire le proprietà di configurazione dell'azione. Interfaccia utente corrispondente: scheda **Configurazione** ## StackName (*CDKDeploy*/Configuration/**StackName**) (Obbligatorio) Il nome dello stack di AWS CDK app, così come appare nel file entrypoint nella directory AWS CDK dell'app. `bin` L'esempio seguente mostra il contenuto di un file TypeScript entrypoint, con il nome dello stack evidenziato in. *red italics* Se il file entrypoint è in una lingua diversa, avrà un aspetto simile. ``` import * as cdk from 'aws-cdk-lib'; import { CdkWorksopTypescriptStack } from '../lib/cdk_workshop_typescript-stack'; const app = new cdk.App(); new CdkWorkshopTypescriptStack(app, 'CdkWorkshopTypescriptStack'); ``` Puoi specificare solo uno stack. **Suggerimento** Se disponi di più stack, puoi creare uno stack principale con pile annidate. È quindi possibile specificare lo stack principale in questa azione per distribuire tutti gli stack. **Interfaccia utente corrispondente: scheda di configurazione/nome dello stack** ## Region (*CDKDeploy*/Configuration/**Region**) (Facoltativo) Specificare Regione AWS in che modo verrà distribuito lo stack AWS CDK dell'applicazione. Per un elenco dei codici regionali, consulta Endpoint [regionali](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes). Se non specifichi una regione, l'azione di **AWS CDK distribuzione** viene distribuita nella regione specificata nel codice. AWS CDK Per ulteriori informazioni, consulta [Environments](https://docs.aws.amazon.com/cdk/v2/guide/environments.html) nella *AWS Cloud Development Kit (AWS CDK) Developer* Guide. **Interfaccia utente corrispondente: scheda/regione di configurazione** ## Tags (*CDKDeploy*/Configuration/**Tags**) (Facoltativo) Specificate i tag che desiderate applicare alle AWS risorse nello stack di AWS CDK applicazioni. I tag vengono applicati allo stack stesso e alle singole risorse dello stack. *Per ulteriori informazioni sui tag, consulta [Tagging](https://docs.aws.amazon.com/cdk/v2/guide/tagging.html) nella Developer Guide.AWS Cloud Development Kit (AWS CDK) * **Interfaccia utente corrispondente: Configuration tab/Advanced - opzionale/ Tags** ## Context (*CDKDeploy*/Configuration/**Context**) (Facoltativo) Specificate i contesti, sotto forma di coppie chiave-valore, da associare allo stack dell'applicazione. AWS CDK *Per ulteriori informazioni sui contesti, consulta [Runtime contexts](https://docs.aws.amazon.com/cdk/v2/guide/context.html) nella Developer Guide.AWS Cloud Development Kit (AWS CDK) * **Interfaccia utente corrispondente: Configurazione tab/Advanced - opzionale/ Context** ## CdkCliVersion (*CDKDeploy*/Configuration/**CdkCliVersion**) (Facoltativo) **Questa proprietà è disponibile con la versione 1.0.13 o successiva dell'azione **AWS CDK deploy** e la versione 1.0.8 o successiva dell'azione bootstrap.AWS CDK ** Specifica una delle seguenti proprietà: + La versione completa dell'interfaccia a riga di AWS Cloud Development Kit (AWS CDK) comando (CLI) (chiamata anche AWS CDK Toolkit) che si desidera utilizzare con questa azione. Esempio: `2.102.1`. Valuta la possibilità di specificare una versione completa per garantire coerenza e stabilità durante la creazione e la distribuzione dell'applicazione. Or + `latest`. Valuta la possibilità `latest` di specificare se sfruttare le funzionalità e le correzioni più recenti della CLI CDK. L'azione scaricherà la versione specificata (o la versione più recente) della AWS CDK CLI nell'[immagine di CodeCatalyst build](build-images.md), quindi utilizzerà questa versione per eseguire i comandi necessari per distribuire l'applicazione CDK o avviare il proprio ambiente. AWS [Per un elenco delle versioni CDK CLI supportate che puoi utilizzare,AWS CDK consulta Versioni.](https://docs.aws.amazon.com/cdk/api/versions.html) Se si omette questa proprietà, l'azione utilizza una versione AWS CDK CLI predefinita descritta in uno dei seguenti argomenti: + [Versioni CDK CLI utilizzate dall'azione 'deploy'AWS CDK](cdk-dep-action.md#cdk-dep-action-cdk-version) + [Versioni CDK CLI utilizzate dall'azione AWS CDK "bootstrap»](cdk-boot-action.md#cdk-boot-action-cdk-version) Interfaccia utente corrispondente: scheda di configurazione/versione **AWS CDK CLI** ## CdkRootPath (*CDKDeploy*/Configuration/**CdkRootPath**) (Facoltativo) Il percorso della directory che contiene il file del AWS CDK `cdk.json` progetto. L'azione **AWS CDK di distribuzione** viene eseguita da questa cartella e tutti gli output creati dall'azione verranno aggiunti a questa directory. Se non è specificata, l'azione di **AWS CDK distribuzione** presuppone che il `cdk.json` file si trovi nella radice del progetto. AWS CDK Interfaccia utente corrispondente: scheda di configurazione/ **Directory in cui risiede cdk.json** ## CfnOutputVariables (*CDKDeploy*/Configuration/**CfnOutputVariables**) (Facoltativo) Specificate quali `CfnOutput` costrutti del codice AWS CDK dell'applicazione desiderate esporre come variabili di output del flusso di lavoro. È quindi possibile fare riferimento alle variabili di output del flusso di lavoro nelle azioni successive del flusso di lavoro. Per ulteriori informazioni sulle variabili in CodeCatalyst, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md). Ad esempio, se il codice AWS CDK dell'applicazione è simile al seguente: ``` import { Duration, Stack, StackProps, CfnOutput, RemovalPolicy} from 'aws-cdk-lib'; import * as dynamodb from 'aws-cdk-lib/aws-dynamodb'; import * as s3 from 'aws-cdk-lib/aws-s3'; import { Construct } from 'constructs'; import * as cdk from 'aws-cdk-lib'; export class HelloCdkStack extends Stack { constructor(scope: Construct, id: string, props?: StackProps) { super(scope, id, props); const bucket = new s3.Bucket(this, 'amzn-s3-demo-bucket', { removalPolicy: RemovalPolicy.DESTROY, }); new CfnOutput(this, 'bucketName', { value: bucket.bucketName, description: 'The name of the s3 bucket', exportName: 'amzn-s3-demo-bucket', }); const table = new dynamodb.Table(this, 'todos-table', { partitionKey: {name: 'todoId', type: dynamodb.AttributeType.NUMBER}, billingMode: dynamodb.BillingMode.PAY_PER_REQUEST, removalPolicy: RemovalPolicy.DESTROY, }) new CfnOutput(this, 'tableName', { value: table.tableName, description: 'The name of the dynamodb table', exportName: 'myDynamoDbTable', }); ... } } ``` ... e la tua `CfnOutputVariables` proprietà ha questo aspetto: ``` Configuration: ... CfnOutputVariables: '["bucketName","tableName"]' ``` ... quindi l'azione genera le seguenti variabili di output del flusso di lavoro: | Chiave | Valore | | --- | --- | | bucketName | `bucket.bucketName` | | tableName | `table.tableName` | È quindi possibile fare riferimento alle `tableName` variabili `bucketName` and nelle azioni successive. Per informazioni su come fare riferimento alle variabili di output del flusso di lavoro nelle azioni successive, consulta[Riferimento a una variabile predefinita](workflows-working-with-variables-reference-output-vars.md). Se non specificate alcun `CfnOutput` costrutto nella `CfnOutputVariables` proprietà, l'azione espone le prime quattro (o meno) variabili di output trovate come variabili di CloudFormation output del flusso di lavoro. Per ulteriori informazioni, consulta [variabili 'AWS CDK deploy'](cdk-dep-action-variables.md). **Suggerimento** **Per ottenere un elenco di tutte le variabili di CloudFormation output prodotte dall'azione, esegui una volta il flusso di lavoro contenente l'azione di **AWS CDK distribuzione**, quindi consulta la scheda Registri dell'azione.** I log contengono un elenco di tutte le variabili di CloudFormation output associate all'app. AWS CDK Una volta che sapete quali sono tutte le CloudFormation variabili, potete specificare quelle che desiderate convertire in variabili di output del flusso di lavoro utilizzando la `CfnOutputVariables` proprietà. Per ulteriori informazioni sulle variabili di CloudFormation output, consultate la documentazione relativa al `CfnOutput` costrutto, disponibile all'indirizzo [class CfnOutput (construct)](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnOutput.html) nell'*AWS Cloud Development Kit (AWS CDK) API* Reference. **Interfaccia utente corrispondente: scheda di configurazione/variabili di output CloudFormation ** ## CloudAssemblyRootPath (*CDKDeploy*/Configuration/**CloudAssemblyRootPath**) (Facoltativo) Se hai già sintetizzato lo stack dell' AWS CDK app in un assembly cloud (utilizzando l'`cdk synth`operazione), specifica il percorso principale della directory dell'assembly cloud (). `cdk.out` Il CloudFormation modello che si trova nella directory di assemblaggio cloud specificata verrà distribuito dall'azione **AWS CDK deploy** nell'utente utilizzando il comando. Account AWS `cdk deploy --app` Quando l'`--app`opzione è presente, l'`cdk synth`operazione non viene eseguita. Se non si specifica una directory di assemblaggio cloud, l'azione **AWS CDK deploy** eseguirà il `cdk deploy` comando senza l'`--app`opzione. Senza l'`--app`opzione, l'`cdk deploy`operazione sintetizzerà (`cdk synth`) e distribuirà l'app nel tuo AWS CDK . Account AWS **Perché dovrei specificare un assembly cloud esistente e sintetizzato quando l'azione "AWS CDK deploy» può eseguire la sintesi in fase di esecuzione?** Potresti voler specificare un assembly cloud esistente e sintetizzato per: + **Assicurati che venga distribuito lo stesso identico set di risorse ogni volta che viene eseguita l'azione "AWS CDK deploy»** Se non specifichi un assembly cloud, è possibile che l'azione di distribuzione sintetizzi e **AWS CDK distribuisca** file diversi a seconda di quando viene eseguita. Ad esempio, l'azione di **AWS CDK implementazione** potrebbe sintetizzare un assembly cloud con un set di dipendenze durante una fase di test e un altro set di dipendenze durante una fase di produzione (se tali dipendenze sono cambiate tra le fasi). Per garantire l'esatta parità tra ciò che viene testato e ciò che viene distribuito, consigliamo di eseguire la sintesi una volta e poi utilizzare il campo della **directory Path to cloud assembly** (editor visivo) o la `CloudAssemblyRootPath` proprietà (editor YAML) per specificare l'assembly cloud già sintetizzato. + **Usa AWS CDK gestori di pacchetti e strumenti non standard con l'app** Durante un'`synth`operazione, l'azione **AWS CDK deploy** tenta di eseguire l'app utilizzando strumenti standard come npm o pip. Se l'azione non riesce a eseguire correttamente l'app utilizzando tali strumenti, la sintesi non verrà eseguita e l'azione avrà esito negativo. Per risolvere questo problema, puoi specificare i comandi esatti necessari per eseguire correttamente l'app nel `cdk.json` file dell' AWS CDK app e quindi sintetizzare l'app utilizzando un metodo che non prevede l'azione di **AWS CDK distribuzione**. **Dopo che l'assembly cloud è stato generato, è possibile specificarlo nel campo **Path to cloud assembly directory** (editor visivo) o nella `CloudAssemblyRootPath` proprietà (editor YAML) dell'azione di distribuzione.AWS CDK ** Per informazioni sulla configurazione del `cdk.json` file per includere i comandi per l'installazione e l'esecuzione dell' AWS CDK app, consulta [Specificazione](https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli-app-command) del comando dell'app. [https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli-deploy-nosynth](https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli-deploy-nosynth) [https://docs.aws.amazon.com/cdk/api/v2/docs/cloud-assembly-schema-readme.html](https://docs.aws.amazon.com/cdk/api/v2/docs/cloud-assembly-schema-readme.html) Interfaccia utente corrispondente: scheda di **configurazione/percorso della directory di assemblaggio cloud**