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 YAML definizione dell'azione bootstrap.AWS CDK Per informazioni su come utilizzare questa azione, consultaAvvio di un' AWS CDK app con un flusso di lavoro.
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 YAMLDefinizione del workflow.
Nota
La maggior parte delle YAML proprietà che seguono hanno elementi dell'interfaccia utente corrispondenti nell'editor visivo. Per cercare un elemento dell'interfaccia utente, usa Ctrl+F. L'elemento verrà elencato con la proprietà associata. YAML
# The workflow definition starts here.
# See Proprietà di primo livello for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The action definition starts here.
CDKBootstrapAction_nn
:
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)
Specificate 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 (_). 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.
Nota
La specificazione aws/cdk-bootstrap@v2
causa l'esecuzione dell'azione sull'immagine di marzo 2024 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 che include strumenti meno recenti come Node.js 16.
Default: aws/cdk-bootstrap@v2
.
Interfaccia utente corrispondente: Workflow diagram/ _nn/ 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
Interfaccia utente corrispondente: scheda Ingressi/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.
Interfaccia utente corrispondente: nessuna
Type
(CDKBootstrapAction
/Compute/Type)
(Obbligatorio se Compute incluso)
Il tipo di motore di calcolo. È possibile utilizzare uno dei seguenti valori:
-
EC2(editor visivo) o
EC2
(YAMLeditor)Ottimizzato per la flessibilità durante le sessioni di azione.
-
Lambda (editor visivo) o
Lambda
(YAMLeditor)Velocità di avvio dell'azione ottimizzate.
Per ulteriori informazioni sui tipi di calcolo, consulta Tipi di calcolo.
Interfaccia utente corrispondente: scheda di configurazione/Avanzata - 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 veicoli su richiesta
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 veicoli assegnate
Se Fleet
viene omesso, l'impostazione predefinita è. Linux.x86-64.Large
Interfaccia utente corrispondente: scheda Configurazione/Avanzata - opzionale/ Compute fleet
Timeout
(CDKBootstrapAction
/Timeout)
(Obbligatorio)
Specificate il periodo di tempo, in minuti (YAMLeditor) 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 inQuote per i flussi di lavoro in CodeCatalyst. 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 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 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.
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)
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
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
Interfaccia utente corrispondente: scheda Outputs/Artifacts
Name
(CDKBootstrapAction
/Outputs/Artifacts/Name)
(Richiesto se incluso) Artifacts - output
Specificate il nome dell'artefatto che conterrà il AWS 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: scheda Outputs/Artifacts/Aggiungi artefatto/Crea nome artefatto
Files
(CDKBootstrapAction
/Outputs/Artifacts/Files)
(Artifacts - outputObbligatorio se incluso)
Specificate i file da includere nell'artefatto. È necessario specificare "cdk.out/**/*"
di includere il modello sintetizzato AWS 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: Outputs tab/Artifacts/Add artifact/ Files prodotti da build
Environment
(CDKBootstrapAction
/Environment)
(Obbligatorio)
CodeCatalyst Specificare l'ambiente da utilizzare con l'azione. L'azione si collega Account AWS all'Amazon opzionale VPC specificato nell'ambiente scelto. L'azione utilizza il IAM ruolo predefinito specificato nell'ambiente per connettersi a e utilizza il IAM ruolo specificato nella VPCconnessione Amazon per connettersi ad AmazonVPC. Account AWS
Nota
Se il IAM ruolo predefinito non dispone delle autorizzazioni richieste dall'azione, puoi configurare l'azione per utilizzare un ruolo diverso. Per ulteriori informazioni, consulta Cambiare il IAM ruolo di un'azione.
Per ulteriori informazioni sugli ambienti, vedere Implementazione in e Account AWS VPCs eCreazione di un ambiente.
Interfaccia utente corrispondente: scheda di configurazione/ambiente
Name
(CDKBootstrapAction
/Environment/Name)
(Richiesto se 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 inEnvironment
.
Se non si specifica una connessione all'account:
-
L'azione utilizza la Account AWS connessione e il IAM ruolo predefinito specificati nell'ambiente della CodeCatalyst console. Per informazioni sull'aggiunta di una connessione all'account e di un IAM ruolo predefinito all'ambiente, consultaCreazione di un ambiente.
-
Il IAM ruolo predefinito deve includere le politiche e le autorizzazioni richieste dall'azione. Per determinare quali sono tali politiche e autorizzazioni, consulta la descrizione della proprietà Role nella documentazione sulla YAML definizione dell'azione.
Per ulteriori informazioni sulle connessioni degli account, vedereConsentire l'accesso alle AWS risorse con connessione Account AWS. Per informazioni sull'aggiunta di una connessione tramite account a un ambiente, vedereCreazione di un ambiente.
Interfaccia utente corrispondente: una delle seguenti a seconda della versione dell'azione:
-
(Versioni più recenti) Scheda di configurazione/Ambiente/Cosa c'è in
my-environment
? /menu a tre punti/ Cambia ruolo -
(Versioni precedenti) Scheda di configurazione/'Environment/Account/Role'/connessione all'account AWS
Name
(CDKBootstrapAction
/Environment/Connections/Name)
Connections(Richiesto se incluso)
Specificare il nome della connessione all'account.
Interfaccia utente corrispondente: una delle seguenti a seconda della versione dell'azione:
-
(Versioni più recenti) Scheda di configurazione/Ambiente/Cosa c'è in
my-environment
? /menu a tre punti/ Cambia ruolo -
(Versioni precedenti) Scheda di configurazione/'Environment/Account/Role'/connessione all'account AWS
Role
(CDKBootstrapAction
/Environment/Connections/Role)
Connections(Richiesto se incluso)
Specificate il nome del IAM ruolo 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 e che il ruolo includa le seguenti politiche.
Se non specifichi un IAM ruolo, l'azione utilizza il IAM ruolo predefinito elencato nell'ambiente della CodeCatalyst console. Se utilizzi il ruolo predefinito nell'ambiente, assicurati che abbia le seguenti politiche.
Nota
Le autorizzazioni mostrate nella seguente politica di autorizzazione sono quelle richieste dal cdk bootstrap
comando per eseguire il bootstrap al momento della scrittura. Queste autorizzazioni possono cambiare se cambia il comando bootstrap. AWS CDK
avvertimento
Usa questo ruolo solo con l'azione AWS CDK bootstrap. È molto permissivo e utilizzarlo con altre azioni potrebbe rappresentare un rischio per la sicurezza.
-
La seguente politica di autorizzazioni:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "iam:GetRole", "ssm:GetParameterHistory", "ecr:PutImageScanningConfiguration", "cloudformation:*", "iam:CreateRole", "iam:AttachRolePolicy", "ssm:GetParameters", "iam:PutRolePolicy", "ssm:GetParameter", "ssm:DeleteParameters", "ecr:DeleteRepository", "ssm:PutParameter", "ssm:DeleteParameter", "iam:PassRole", "ecr:SetRepositoryPolicy", "ssm:GetParametersByPath", "ecr:DescribeRepositories", "ecr:GetLifecyclePolicy" ], "Resource": [ "arn:aws:ssm:
aws-region
:aws-account
:parameter/cdk-bootstrap/*", "arn:aws:cloudformation:aws-region
:aws-account
:stack/CDKToolkit/*", "arn:aws:ecr:aws-region
:aws-account
:repository/cdk-*", "arn:aws:iam::aws-account
:role/cdk-*" ] }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": [ "cloudformation:RegisterType", "cloudformation:CreateUploadBucket", "cloudformation:ListExports", "cloudformation:DescribeStackDriftDetectionStatus", "cloudformation:SetTypeDefaultVersion", "cloudformation:RegisterPublisher", "cloudformation:ActivateType", "cloudformation:ListTypes", "cloudformation:DeactivateType", "cloudformation:SetTypeConfiguration", "cloudformation:DeregisterType", "cloudformation:ListTypeRegistrations", "cloudformation:EstimateTemplateCost", "cloudformation:DescribeAccountLimits", "cloudformation:BatchDescribeTypeConfigurations", "cloudformation:CreateStackSet", "cloudformation:ListStacks", "cloudformation:DescribeType", "cloudformation:ListImports", "s3:*", "cloudformation:PublishType", "ecr:CreateRepository", "cloudformation:DescribePublisher", "cloudformation:DescribeTypeRegistration", "cloudformation:TestType", "cloudformation:ValidateTemplate", "cloudformation:ListTypeVersions" ], "Resource": "*" } ] }Nota
La prima volta che il ruolo viene utilizzato, utilizza il seguente carattere jolly nell'informativa sulla politica delle risorse, quindi definisci l'ambito della politica inserendo il nome della risorsa dopo che è disponibile.
"Resource": "*"
-
La seguente politica di fiducia personalizzata:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": [ "codecatalyst-runner.amazonaws.com", "codecatalyst.amazonaws.com" ] }, "Action": "sts:AssumeRole" } ] }
Nota
Puoi usare il CodeCatalystWorkflowDevelopmentRole-
ruolo con questa azione, se lo desideri. Per ulteriori informazioni su questo ruolo, consulta Creazione del CodeCatalystWorkflowDevelopmentRole-spaceNameruolo per il tuo account e il tuo spazio. Tieni presente che il spaceName
CodeCatalystWorkflowDevelopmentRole-
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. spaceName
Interfaccia utente corrispondente: una delle seguenti a seconda della versione di azione:
-
(Versioni più recenti) Scheda di configurazione/Ambiente/Cosa c'è in
my-environment
? /menu a tre punti/ Cambia ruolo -
(Versioni precedenti) Scheda di configurazione/'Environment/Account/Role'/ Ruolo
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.
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 desideri sfruttare le funzionalità e le correzioni più recenti di. CDK CLI
L'azione scaricherà la versione specificata (o la versione più recente) di nell' AWS CDK CLIimmagine di CodeCatalyst build, quindi utilizzerà questa versione per eseguire i comandi necessari per distribuire CDK l'applicazione o avviare l'ambiente. AWS
Per un elenco delle CDK CLI versioni supportate che puoi utilizzare, consulta AWS CDK Versioni.
Se si omette questa proprietà, l'azione utilizza una AWS CDK CLI versione predefinita descritta in uno dei seguenti argomenti:
Interfaccia utente corrispondente:AWS CDK CLI scheda/ versione di configurazione