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