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à.
# Avvio di un' AWS CDK app con un flusso di lavoro
Questa sezione descrive come avviare un'applicazione utilizzando un AWS CDK flusso di lavoro. CodeCatalyst A tale scopo, è necessario aggiungere l'azione **AWS CDK bootstrap** al flusso di lavoro. [L'azione **AWS CDK bootstrap** fornisce uno stack di bootstrap nell' AWS ambiente utilizzando il modello moderno.](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-template) Se esiste già uno stack di bootstrap, l'azione lo aggiorna se necessario. La presenza di uno stack di bootstrap AWS è un prerequisito per la distribuzione di un'app. AWS CDK
[https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html)
**Topics**
+ [Quando usare l'azione 'bootstrap'AWS CDK](#cdk-boot-action-when-to-use)
+ [Come funziona l'azione 'AWS CDK bootstrap'](#cdk-boot-action-how-it-works)
+ [Versioni CDK CLI utilizzate dall'azione AWS CDK "bootstrap»](#cdk-boot-action-cdk-version)
+ [Immagine di runtime utilizzata dall'azione 'bootstrap'AWS CDK](#cdk-boot-action-runtime)
+ [Esempio: avvio di un'app AWS CDK](cdk-boot-action-example-workflow.md)
+ [Aggiungere l'azione 'AWS CDK bootstrap'](cdk-boot-action-add.md)
+ [variabili 'AWS CDK bootstrap'](cdk-boot-action-variables.md)
+ [azione 'AWS CDK bootstrap' YAML](cdk-boot-action-ref.md)
## Quando usare l'azione 'bootstrap'AWS CDK
Utilizza questa azione se disponi di un flusso di lavoro che distribuisce un' AWS CDK app e desideri distribuire (e aggiornare, se necessario) lo stack di bootstrap contemporaneamente. In questo caso, aggiungeresti l'azione **AWS CDK bootstrap** allo stesso flusso di lavoro di quello che distribuisce l'app. AWS CDK
**Non** utilizzare questa azione se si verifica una delle seguenti condizioni:
+ Hai già distribuito uno stack di bootstrap utilizzando un altro meccanismo e desideri mantenerlo intatto (nessun aggiornamento).
+ **Vuoi usare un modello di [bootstrap personalizzato](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-customizing), che non è supportato con l'azione bootstrap.AWS CDK **
## Come funziona l'azione 'AWS CDK bootstrap'
Il **AWS CDK bootstrap funziona** come segue:
1. [In fase di esecuzione, se hai specificato la versione 1.0.7 o precedente dell'azione, l'azione scarica l'ultima CLI CDK (chiamata anche AWS CDK Tookit) nell'immagine di build. CodeCatalyst ](build-images.md)
Se hai specificato la versione 1.0.8 o successiva, l'azione viene fornita in bundle con una [versione specifica](cdk-dep-action.md#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 bootstrap`. *Questo comando esegue le attività di bootstrap descritte nell'argomento [Bootstrap](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) della Guida per gli sviluppatori.AWS Cloud Development Kit (AWS CDK) *
## Versioni CDK CLI utilizzate dall'azione AWS CDK "bootstrap»
La tabella seguente mostra quale versione della CLI CDK viene utilizzata per impostazione predefinita da diverse versioni **AWS CDK dell'**azione bootstrap.
**Nota**
Potresti essere in grado di sovrascrivere l'impostazione predefinita. Per ulteriori informazioni, consulta [CdkCliVersion](cdk-boot-action-ref.md#cdk.boot.cdk.cli.version) nella [azione 'AWS CDK bootstrap' YAML](cdk-boot-action-ref.md).
| versione d'azione 'AWS CDK bootstrap' | AWS CDK Versione CLI |
| --- | --- |
| 1.0.0 — 1.0.7 | più recente |
| 1.0.8 o versione successiva | 2.99.1 |
## Immagine di runtime utilizzata dall'azione 'bootstrap'AWS CDK
La tabella seguente mostra le immagini dell'ambiente di runtime CodeCatalyst utilizzate per eseguire diverse versioni dell'azione **AWS CDK bootstrap.** 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 **AWS CDK bootstrap** 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-bootstrap@v2`. Per ulteriori informazioni, consulta [AWS CDK azione 'distribuisci' YAML](cdk-dep-action-ref.md).
| versione d'azione 'AWS CDK bootstrap' | Immagini dell'ambiente di runtime |
| --- | --- |
| 1.x | Immagini di novembre 2022 |
| 2.x | Immagini di marzo 2024 |
# Esempio: avvio di un'app AWS CDK
**Fate riferimento a [Esempio: distribuzione di un'app AWS CDK](cdk-dep-action-example-workflow.md) in [Implementazione di un' AWS CDK app con un flusso di lavoro](cdk-dep-action.md) per un flusso di lavoro che include l'AWS CDK azione bootstrap.**
# Aggiungere l'azione 'AWS CDK bootstrap'
**Utilizza le seguenti istruzioni per aggiungere l'azione bootstrap al tuo flusso di lavoro AWS CDK .**
**Prima di iniziare**
Prima di poter utilizzare l'azione **AWS CDK bootstrap**, assicurati di avere un' AWS CDK app pronta. L'azione bootstrap sintetizzerà l'app prima del AWS CDK bootstrap. Puoi scrivere la tua app in qualsiasi linguaggio di programmazione supportato da. AWS CDK
Assicurati che i file AWS CDK dell'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
------
#### [ Visual ]
**Per aggiungere l'azione 'AWS CDK bootstrap' 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 **AWS CDK bootstrap** 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 bootstrap**. Viene visualizzata la finestra di dialogo con i dettagli dell'azione. In questa finestra di dialogo:
+ (Facoltativo) Scegliete **Visualizza sorgente** 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 aprire il relativo riquadro di configurazione.
1. Nelle schede **Ingressi**, **Configurazione** e **Uscite**, completa i campi in base alle tue esigenze. Per una descrizione di ogni campo, vedi. [azione 'AWS CDK bootstrap' YAML](cdk-boot-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'operazione di **AWS CDK bootstrap** 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 bootstrap' usando 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 **AWS CDK bootstrap** e scegli **\$1** per aggiungerla al diagramma del flusso di lavoro e aprire il relativo riquadro di configurazione.
1. Modifica le proprietà del codice YAML in base alle tue esigenze. Una spiegazione di ogni proprietà disponibile è fornita in. [azione 'AWS CDK bootstrap' YAML](cdk-boot-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'operazione di **AWS CDK bootstrap** 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 bootstrap'
L'azione **AWS CDK bootstrap** 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 |
| --- | --- |
| piattaforma di distribuzione | Il nome della piattaforma di distribuzione. Codificato in. `AWS:CloudFormation` |
| region | Il codice regionale in cui è stato distribuito Regione AWS lo stack di AWS CDK bootstrap durante l'esecuzione del flusso di lavoro. Ad esempio: `us-west-2` |
| stack-id | L'Amazon Resource Name (ARN) dello stack di bootstrap distribuito AWS CDK . Ad esempio: `arn:aws:cloudformation:us-west-2:111122223333:stack/codecatalyst-cdk-bootstrap-stack/6aad4380-100a-11ec-a10a-03b8a84d40df` |
| SALTA LA DISTRIBUZIONE | Il valore di `true` indica che la distribuzione dello stack di AWS CDK bootstrap è 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` |
# azione 'AWS CDK bootstrap' YAML
**Di seguito è riportata la definizione YAML dell'azione bootstrap.AWS CDK ** Per informazioni su come utilizzare questa azione, consulta. [Avvio di un' AWS CDK app con un flusso di lavoro](cdk-boot-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.
CDKBootstrapAction\$1nn:
Identifier: aws/cdk-bootstrap@v2
DependsOn:
- action-name
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_bootstrap_artifacts
Files:
- "cdk.out/**/*"
Environment:
Name: environment-name
Connections:
- Name: account-connection-name
Role: iam-role-name
Configuration:
Region: us-west-2
CdkCliVersion: version
```
## CDKBootstrapAction
(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: `CDKBootstrapAction_nn`.
Interfaccia utente corrispondente: scheda di configurazione/nome visualizzato **dell'azione**
## Identifier
(*CDKBootstrapAction*/**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-bootstrap@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-bootstrap@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-bootstrap@v2`.
**Interfaccia utente corrispondente: Workflow diagram/ \$1nn/ CDKBootstrapAction aws/cdk-bootstrap @v2 label**
## DependsOn
(*CDKBootstrapAction*/**DependsOn**)
(Facoltativo)
Specificate un'azione, un gruppo di azioni o un gate che deve essere eseguito correttamente per l'esecuzione di questa azione.
Per ulteriori informazioni sulla funzionalità «dipende da», vedere. [Azioni di sequenziamento](workflows-depends-on.md)
**Interfaccia utente corrispondente: scheda Input/Dipende da - opzionale**
## Compute
(*CDKBootstrapAction*/**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
(*CDKBootstrapAction*/Compute/**Type**)
(Obbligatorio se [Compute](#cdk.boot.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
(*CDKBootstrapAction*/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
(*CDKBootstrapAction*/**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
(*CDKBootstrapAction*/**Inputs**)
(Facoltativo)
La `Inputs` sezione definisce i dati necessari all'azione **AWS CDK bootstrap** durante l'esecuzione di un flusso di lavoro.
Interfaccia utente corrispondente: scheda **Input**
**Nota**
**È consentito un solo input (fonte o artefatto) per ogni AWS CDK azione di bootstrap.**
## Sources
(*CDKBootstrapAction*/Inputs/**Sources**)
(Richiesto se AWS CDK l'app è archiviata in un archivio 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 bootstrap** sintetizza l'app in questo repository prima di avviare il processo di bootstrap. Attualmente, l'unica etichetta di repository 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
(*CDKBootstrapAction*/Inputs/**Artifacts**)
(Richiesto se AWS CDK l'app è memorizzata in un elemento [di output di un'azione precedente](workflows-working-artifacts-output.md))
Se la tua AWS CDK app è contenuta in un artefatto generato da un'azione precedente, specifica quell'artefatto qui. L'azione **AWS CDK bootstrap** sintetizza l'app nell'artefatto specificato in un modello prima di iniziare il processo di avvio. 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
(*CDKBootstrapAction*/**Outputs**)
(Facoltativo)
Definisce i dati emessi dall'azione durante l'esecuzione di un flusso di lavoro.
Interfaccia utente corrispondente: **scheda Output**
## Artifacts - output
(*CDKBootstrapAction*/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
(*CDKBootstrapAction*/Outputs/Artifacts/**Name**)
(Richiesto se incluso) [Artifacts - output](#cdk.boot.outputs.artifacts)
Specificate il nome dell'elemento che conterrà il CloudFormation modello sintetizzato dall'azione **AWS CDK bootstrap** in fase di esecuzione. Il valore predefinito è `cdk_bootstrap_artifacts`. Se non specificate un artefatto, l'azione sintetizza il modello, ma non lo salva in un artefatto. Valuta 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 l'artefatto tab/Artifacts/Add**
## Files
(*CDKBootstrapAction*/Outputs/Artifacts/**Files**)
(Obbligatorio se incluso) [Artifacts - output](#cdk.boot.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
(*CDKBootstrapAction*/**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
(*CDKBootstrapAction*/Environment/**Name**)
(Richiesto se [Environment](#cdk.boot.environment) incluso)
Specificate il nome di un ambiente esistente che desiderate associare all'azione.
**Interfaccia utente corrispondente: scheda di configurazione/ambiente**
## Connections
(*CDKBootstrapAction*/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
(*CDKBootstrapAction*/Environment/Connections/**Name**)
(Richiesto se è incluso[Connections](#cdk.boot.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
(*CDKBootstrapAction*/Environment/Connections/**Role**)
(Richiesto se è incluso[Connections](#cdk.boot.environment.connections))
Specificate il nome del ruolo IAM utilizzato dall'azione **AWS CDK bootstrap** per accedere AWS e aggiungere lo stack di bootstrap. 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 politiche appropriate.
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
(*CDKBootstrapAction*/**Configuration**)
(Obbligatorio)
Una sezione in cui è possibile definire le proprietà di configurazione dell'azione.
Interfaccia utente corrispondente: scheda **Configurazione**
## Region
(*CDKBootstrapAction*/Configuration/**Region**)
(Obbligatorio)
Specificare Regione AWS in che modo verrà distribuito lo stack di bootstrap. Questa regione deve corrispondere a quella in cui viene distribuita AWS CDK l'app. Per un elenco dei codici regionali, consulta [Endpoint regionali](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes).
**Interfaccia utente corrispondente: scheda di configurazione/regione**
## CdkCliVersion
(*CDKBootstrapAction*/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**