Azione «Distribuisci su AmazonECS» YAML

Di seguito è riportata la YAML definizione dell'ECSazione Deploy to Amazon. Per informazioni su come utilizzare questa azione, consultaImplementazione su Amazon ECS 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.   
  ECSDeployAction_nn: 
    Identifier: aws/ecs-deploy@v1
    DependsOn:
      - build-action
    Compute:  
      Type: EC2 | Lambda
      Fleet: fleet-name
    Timeout: timeout-minutes
    Environment:
      Name: environment-name
      Connections:
        - Name: account-connection-name
          Role: iam-role-name
    Inputs:
      # Specify a source or an artifact, but not both.
      Sources:
        - source-name-1
      Artifacts:
        - task-definition-artifact
    Configuration: 
      region: us-east-1 
      cluster: ecs-cluster
      service: ecs-service
      task-definition: task-definition-path
      force-new-deployment: false|true
      codedeploy-appspec: app-spec-file-path
      codedeploy-application: application-name
      codedeploy-deployment-group: deployment-group-name
      codedeploy-deployment-description: deployment-description

ECSDeployAction

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

Interfaccia utente corrispondente: scheda di configurazione/nome visualizzato dell'azione

Identifier

(ECSDeployAction/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/ecs-deploy@v1.

Interfaccia utente corrispondente: Workflow diagram/ ECSDeployAction _nn/ aws/ecs-deploy @v1 label

DependsOn

(ECSDeployAction/DependsOn)

(Facoltativo)

Specificate un'azione, un gruppo di azioni o un gate che deve essere eseguito correttamente affinché questa azione venga eseguita.

Per ulteriori informazioni sulla funzionalità «dipende da», vedere. Azioni di sequenziamento

Interfaccia utente corrispondente: scheda Ingressi/Dipende da - opzionale

Compute

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

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

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

(ECSDeployAction/Timeout)

(Facoltativo)

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

Environment

(ECSDeployAction/Environment)

(Obbligatorio)

Specificare l' CodeCatalyst 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

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

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

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

(ECSDeployAction/Environment/Connections/Role)

Connections(Richiesto se incluso)

Specificare il nome del IAM ruolo a cui l'ECSazione Deploy to Amazon utilizza per accedere AWS. 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.

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.


{
    "Version": "2012-10-17",
    "Statement": [{
    "Action":[
      "ecs:DescribeServices",
      "ecs:CreateTaskSet",
      "ecs:DeleteTaskSet",
      "ecs:ListClusters",
      "ecs:RegisterTaskDefinition",
      "ecs:UpdateServicePrimaryTaskSet",
      "ecs:UpdateService",
      "elasticloadbalancing:DescribeTargetGroups",
      "elasticloadbalancing:DescribeListeners",
      "elasticloadbalancing:ModifyListener",
      "elasticloadbalancing:DescribeRules",
      "elasticloadbalancing:ModifyRule",
      "lambda:InvokeFunction",
      "lambda:ListFunctions",
      "cloudwatch:DescribeAlarms",
      "sns:Publish",
      "sns:ListTopics", 
      "s3:GetObject",
      "s3:GetObjectVersion",
      "codedeploy:CreateApplication", 
      "codedeploy:CreateDeployment", 
      "codedeploy:CreateDeploymentGroup", 
      "codedeploy:GetApplication", 
      "codedeploy:GetDeployment", 
      "codedeploy:GetDeploymentGroup", 
      "codedeploy:ListApplications", 
      "codedeploy:ListDeploymentGroups", 
      "codedeploy:ListDeployments", 
      "codedeploy:StopDeployment", 
      "codedeploy:GetDeploymentTarget", 
      "codedeploy:ListDeploymentTargets", 
      "codedeploy:GetDeploymentConfig", 
      "codedeploy:GetApplicationRevision", 
      "codedeploy:RegisterApplicationRevision", 
      "codedeploy:BatchGetApplicationRevisions", 
      "codedeploy:BatchGetDeploymentGroups", 
      "codedeploy:BatchGetDeployments", 
      "codedeploy:BatchGetApplications", 
      "codedeploy:ListApplicationRevisions", 
      "codedeploy:ListDeploymentConfigs", 
      "codedeploy:ContinueDeployment"           
   ],
   "Resource":"*",
   "Effect":"Allow"
},{"Action":[
      "iam:PassRole"
   ],
   "Effect":"Allow",
   "Resource":"*",
   "Condition":{"StringLike":{"iam:PassedToService":[
            "ecs-tasks.amazonaws.com",
            "codedeploy.amazonaws.com"
         ]
      }
   }
}]
}

Nota

La prima volta che il ruolo viene utilizzato, utilizza il seguente carattere jolly nell'informativa sulla politica delle risorse, quindi definisci la 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-spaceName 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 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) Scheda di configurazione/Ambiente/Cosa c'è in my-environment? /menu a tre punti/ Cambia ruolo
(Versioni precedenti) Scheda di configurazione/'Environment/Account/Role'/ Ruolo

Inputs

(ECSDeployAction/Inputs)

(Facoltativo)

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

Nota

È consentito un solo input (fonte o artefatto) per azione Deploy to Amazon. ECS

Interfaccia utente corrispondente: scheda Input

Sources

(ECSDeployAction/Inputs/Sources)

(Richiesto se il file di definizione delle attività è archiviato in un repository di origine)

Se il file di definizione delle attività è archiviato in un repository di origine, specifica l'etichetta di tale repository di origine. Attualmente, l'unica etichetta supportata è. WorkflowSource

Se il file di definizione dell'attività non è contenuto 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

(ECSDeployAction/Inputs/Artifacts)

(Richiesto se il file di definizione dell'attività è memorizzato in un elemento di output di un'azione precedente)

Se il file di definizione dell'attività che desideri distribuire è contenuto in un artefatto generato da un'azione precedente, specifica l'artefatto qui. Se il file di definizione dell'attività non è contenuto 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 di configurazione/artefatti - opzionale

Configuration

(ECSDeployAction/Configuration)

(Obbligatorio)

Una sezione in cui è possibile definire le proprietà di configurazione dell'azione.

Interfaccia utente corrispondente: scheda Configurazione

region

(Configuration/region)

(Obbligatorio)

Specificare la AWS regione in cui risiedono il ECS cluster e il servizio Amazon. Per un elenco dei codici regionali, consulta Endpoint regionali nel. Riferimenti generali di AWS

Interfaccia utente corrispondente: scheda/regione di configurazione

cluster

(ECSDeployAction/Configuration/cluster)

(Obbligatorio)

Specificare il nome di un ECS cluster Amazon esistente. L'ECSazione Deploy to Amazon distribuirà la tua applicazione containerizzata come attività in questo cluster. Per ulteriori informazioni sui ECS cluster Amazon, consulta Clusters nella Amazon Elastic Container Service Developer Guide.

Interfaccia utente corrispondente: scheda di configurazione/ Cluster

service

(ECSDeployAction/Configuration/service)

(Obbligatorio)

Specificate il nome di un ECS servizio Amazon esistente che creerà un'istanza del file di definizione delle attività. Questo servizio deve risiedere nel cluster specificato nel campo. cluster Per ulteriori informazioni sui ECS servizi Amazon, consulta i ECSservizi Amazon nella Amazon Elastic Container Service Developer Guide.

Interfaccia utente corrispondente: scheda di configurazione/servizio

task-definition

(ECSDeployAction/Configuration/task-definition)

(Obbligatorio)

Specificare il percorso di un file di definizione delle attività esistente. Se il file si trova nel repository di origine, il percorso è relativo alla cartella principale del repository di origine. Se il file si trova in un elemento di un'azione precedente del flusso di lavoro, il percorso è relativo alla cartella principale dell'elemento. Per ulteriori informazioni sui file di definizione delle attività, consulta Definizioni delle attività nella Amazon Elastic Container Service Developer Guide.

Interfaccia utente corrispondente: scheda di configurazione/definizione dell'attività

force-new-deployment

(ECSDeployAction/Configuration/force-new-deployment)

(Obbligatorio)

Se abilitato, il ECS servizio Amazon è in grado di avviare nuove distribuzioni senza modifiche alla definizione del servizio. Forzare una distribuzione fa sì che il servizio interrompa tutte le attività attualmente in esecuzione e avvii nuove attività. Per ulteriori informazioni su come forzare nuove distribuzioni, consulta Updating a service nella Amazon Elastic Container Service Developer Guide.

Impostazione predefinita: false

Interfaccia utente corrispondente: scheda Configurazione/ Forza una nuova distribuzione del servizio

codedeploy-appspec

(ECSDeployAction/Configuration/codedeploy-appspec)

(Obbligatorio se hai configurato il tuo ECS servizio Amazon per utilizzare distribuzioni blu/verdi, altrimenti ometti)

Specificate il nome e il percorso di un file di specifiche CodeDeploy dell'applicazione () esistente. AppSpec Questo file deve risiedere nella directory principale del repository di CodeCatalyst origine. Per ulteriori informazioni sui AppSpec file, consultate i file delle specifiche CodeDeploy dell'applicazione (AppSpec) nella Guida per l'AWS CodeDeploy utente.

Nota

Fornisci CodeDeploy informazioni solo se hai configurato il tuo ECS servizio Amazon per eseguire distribuzioni blu/verdi. Per le distribuzioni di aggiornamento in sequenza (impostazione predefinita), ometti le informazioni. CodeDeploy Per ulteriori informazioni sulle ECS distribuzioni di Amazon, consulta i tipi di ECS distribuzione di Amazon nella Amazon Elastic Container Service Developer Guide.

Nota

I CodeDeploycampi possono essere nascosti nell'editor visuale. Per farli apparire, vediPerché mancano CodeDeploy dei campi nell'editor visivo?.

Interfaccia utente corrispondente: scheda Configurazione/ CodeDeploy AppSpec

codedeploy-application

(ECSDeployAction/Configuration/codedeploy-application)

(Richiesto se codedeploy-appspec è incluso)

Specificate il nome di un' CodeDeploy applicazione esistente. Per ulteriori informazioni sulle CodeDeploy applicazioni, vedere Lavorare con le applicazioni CodeDeploy nella Guida per l'AWS CodeDeploy utente.

Interfaccia utente corrispondente: scheda di configurazione/ applicazione CodeDeploy

codedeploy-deployment-group

(ECSDeployAction/Configuration/codedeploy-deployment-group)

(Richiesto se codedeploy-appspec incluso)

Specificare il nome di un gruppo CodeDeploy di distribuzione esistente. Per ulteriori informazioni sui gruppi di CodeDeploy distribuzione, vedere Lavorare con i gruppi di distribuzione CodeDeploy nella Guida per l'AWS CodeDeploy utente.

Interfaccia utente corrispondente: scheda di configurazione/gruppo CodeDeploy di distribuzione

codedeploy-deployment-description

(ECSDeployAction/Configuration/codedeploy-deployment-description)

(Facoltativo)

Specificare una descrizione della distribuzione che verrà creata con questa azione. Per ulteriori informazioni, consulta Lavorare con le distribuzioni CodeDeploy nella Guida per l'AWS CodeDeploy utente.

Interfaccia utente corrispondente: scheda di configurazione/descrizione della distribuzione CodeDeploy

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Variabili - 'Distribuisci su Amazon 'ECS

Distribuzione su Amazon EKS