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 deploy' YAML

Di seguito è riportata la YAML definizione dell'azione di AWS CDK distribuzione. Per informazioni su come utilizzare questa azione, consultaImplementazione 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.

# The workflow definition starts here.
# See Proprietà di primo livello for details.
        
Name: MyWorkflow
SchemaVersion: 1.0 
Actions:

# The action definition starts here.   
  CDKDeploy_nn: 
    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)

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

Default: aws/cdk-deploy@v2.

Interfaccia utente corrispondente: Workflow diagram/ _nn/ 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

Per ulteriori informazioni sulla funzionalità 'depends on', consulta. Azioni di sequenziamento

Interfaccia utente corrispondente: scheda Input/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.

Interfaccia utente corrispondente: nessuna

Type

(CDKDeploy/Compute/Type)

(Obbligatorio se Compute incluso)

Il tipo di motore di calcolo. È possibile utilizzare uno dei seguenti valori:

Per ulteriori informazioni sui tipi di calcolo, consulta Tipi di calcolo.

Interfaccia utente corrispondente: scheda di configurazione/Avanzata - 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 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

(CDKDeploy/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

(CDKDeploy/Inputs)

(Facoltativo)

La Inputs sezione definisce i dati CDKDeploy necessari durante l'esecuzione di un flusso di lavoro.

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.

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)

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

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

Interfaccia utente corrispondente: scheda Outputs/Artifacts

Name

(CDKDeploy/Outputs/Artifacts/Name)

(Richiesto se incluso) Artifacts - output

Specificate il nome dell'artefatto che conterrà il AWS 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: scheda Outputs/Artifacts/Aggiungi artefatto/Crea nome artefatto

Files

(CDKDeploy/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.

Interfaccia utente corrispondente: Outputs tab/Artifacts/Add artifact/ Files prodotti da build

Environment

(CDKDeploy/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

Per ulteriori informazioni sugli ambienti, vedere Implementazione in e Account AWS VPCs eCreazione di un ambiente.

Interfaccia utente corrispondente: scheda di configurazione/ambiente

Name

(CDKDeploy/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

(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 inEnvironment.

Se non si specifica una connessione all'account:

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:

Name

(CDKDeploy/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:

Role

(CDKDeploy/Environment/Connections/Role)

Connections(Richiesto se incluso)

Specificare il nome della connessione all'account.

Specificate il nome del IAM ruolo 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 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.

Interfaccia utente corrispondente: una delle seguenti a seconda della versione di azione:

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.

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.

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 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 dell' AWS CDK applicazione. I tag vengono applicati allo stack stesso e alle singole risorse dello stack. Per ulteriori informazioni sui tag, consulta Tagging nella Developer Guide.AWS Cloud Development Kit (AWS CDK)

Interfaccia utente corrispondente: scheda Configurazione/Avanzata - opzionale/ Tag

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 nella Developer Guide.AWS Cloud Development Kit (AWS CDK)

Interfaccia utente corrispondente: scheda Configurazione/Avanzata - opzionale/ Contesto

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

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

CdkRootPath

(CDKDeploy/Configuration/CdkRootPath)

(Facoltativo)

Il percorso della directory che contiene il cdk.json file del AWS CDK 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, vedereUtilizzo delle variabili nei flussi di lavoro.

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:

È 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, consultaRiferimento a una variabile predefinita.

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

Per ulteriori informazioni sulle variabili di AWS CloudFormation output, consultate la documentazione relativa al CfnOutput costrutto, disponibile all'indirizzo class CfnOutput (construct) nel AWS Cloud Development Kit (AWS CDK) API Reference.

Interfaccia utente corrispondente: scheda di configurazione/variabili di output AWS CloudFormation

CloudAssemblyRootPath

(CDKDeploy/Configuration/CloudAssemblyRootPath)

(Facoltativo)

Se hai già sintetizzato lo stack dell' AWS CDK app in un assembly cloud (utilizzando l'cdk synthoperazione), specifica il percorso principale della directory dell'assembly cloud (). cdk.out Il AWS 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'--appopzione è presente, l'cdk synthoperazione non viene eseguita.

Se non si specifica una directory di assemblaggio cloud, l'azione AWS CDK deploy eseguirà il cdk deploy comando senza l'--appopzione. Senza l'--appopzione, l'cdk deployoperazione 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:

Per informazioni sulla configurazione del cdk.json file in modo che includa i comandi per l'installazione e l'esecuzione AWS CDK dell'app, vedi Specificazione del comando dell'app.

Per informazioni sui cdk synth comandi cdk deploy and e sull'--appopzione, consulta Deploying stacks, Synthesizing stacks e Skipping synthesis nella Developer Guide.AWS Cloud Development Kit (AWS CDK)

Per informazioni sugli assembly cloud, consulta Cloud Assembly nella Guida di riferimento.AWS Cloud Development Kit (AWS CDK) API

Interfaccia utente corrispondente: scheda di configurazione/ Percorso della directory di cloud assembly