Azione «Render Amazon ECS task definition» YAML

Di seguito è riportata la YAML definizione dell'azione di definizione dell'ECSattività di Render Amazon. Per informazioni su come utilizzare questa azione, consultaModifica della definizione di un'ECSattività Amazon.

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.   
  ECSRenderTaskDefinition_nn: 
    Identifier: aws/ecs-render-task-definition@v1
    DependsOn:
      - build-action
    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:
        - task-definition-artifact
      Variables:
        - Name: variable-name-1
          Value: variable-value-1
        - Name: variable-name-2
          Value: variable-value-2
    Configuration 
      task-definition: task-definition-path
      container-definition-name: container-definition-name
      image: docker-image-name
      environment-variables:
        - variable-name-1=variable-value-1
        - variable-name-2=variable-value-2
    Outputs:
      Artifacts:
        - Name: TaskDefArtifact
          Files: "task-definition*"
      Variables:
        - task-definition
        

ECSRenderTaskDefinition

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

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

Identifier

(ECSRenderTaskDefinition/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-render-task-definition@v1.

Interfaccia utente corrispondente: Workflow diagram/ ECSRenderTaskDefinition _nn/ aws/ @v1 label ecs-render-task-definition

DependsOn

(ECSRenderTaskDefinition/DependsOn)

(Facoltativo)

Specificate un'azione, un gruppo di azioni o un gate che deve essere eseguito correttamente per eseguire questa azione.

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

Interfaccia utente corrispondente: scheda Ingressi/Dipende da - opzionale

Compute

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

(ECSRenderTaskDefinition/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/tipo di calcolo

Fleet

(ECSRenderTaskDefinition/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 di configurazione/parco di calcolo

Timeout

(ECSRenderTaskDefinition/Timeout)

(Facoltativo)

Specificate il periodo di tempo, in minuti (YAMLeditor) o ore e minuti (editor visivo), entro il quale l'azione può essere eseguita prima che CodeCatalyst termini l'azione. 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

(ECSRenderTaskDefinition/Inputs)

(Facoltativo)

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

Nota

È consentito un solo input (una fonte o un artefatto) per ogni azione di definizione delle ECS attività di Render Amazon. Le variabili non vengono conteggiate per questo totale.

Interfaccia utente corrispondente: scheda Ingressi

Sources

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

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

Variables - input

(ECSRenderTaskDefinition/Inputs/Variables)

(Obbligatorio)

Specificate una sequenza di coppie nome/valore che definiscono le variabili di input che desiderate rendere disponibili all'azione. I nomi delle variabili 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 variabili.

Per ulteriori informazioni sulle variabili, inclusi esempi, vedereUtilizzo delle variabili nei flussi di lavoro.

Interfaccia utente corrispondente: scheda Input/Variabili - opzionale

Configuration

(ECSRenderTaskDefinition/Configuration)

(Obbligatorio)

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

Interfaccia utente corrispondente: scheda Configurazione

task-definition

(ECSRenderTaskDefinition/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à

container-definition-name

(ECSRenderTaskDefinition/Configuration/container-definition-name)

(Obbligatorio)

Specificate il nome del contenitore in cui verrà eseguita l'immagine Docker. Puoi trovare questo nome nel name campocontainerDefinitions, del file di definizione dell'attività. Per ulteriori informazioni, consulta Name nella Amazon Elastic Container Service Developer Guide.

Interfaccia utente corrispondente: scheda di configurazione/nome del contenitore

image

(ECSRenderTaskDefinition/Configuration/image)

(Obbligatorio)

Specificate il nome dell'immagine Docker che desiderate che l'azione di definizione delle ECS attività di Render Amazon aggiunga al file di definizione dell'attività. L'azione aggiunge questo nome al image campocontainerDefinitions, nel file di definizione dell'attività. Se nel image campo esiste già un valore, l'azione lo sovrascrive. È possibile includere variabili nel nome dell'immagine.

Esempi:

Se si specificaMyDockerImage:${WorkflowSource.CommitId}, l'azione viene aggiunta MyDockerImage:commit-id al file di definizione dell'attività, dove commit-id è un ID di commit generato in fase di esecuzione dal flusso di lavoro.

Se si specificamy-ecr-repo/image-repo:$(date +%m-%d-%y-%H-%m-%s), l'azione aggiunge my-ecr-repo/image-repo:date +%m-%d-%y-%H-%m-%s nel file di definizione dell'attività, dove my-ecr-repo è il contenuto URI di un Amazon Elastic Container Registry (ECR) e date +%m-%d-%y-%H-%m-%s è un timestamp nel formato month-day-year-hour-minute-second generato in fase di esecuzione dal flusso di lavoro.

Per ulteriori informazioni sul image campo, consulta Image nella Amazon Elastic Container Service Developer Guide. Per ulteriori informazioni sulle variabili, consultaUtilizzo delle variabili nei flussi di lavoro.

Interfaccia utente corrispondente: scheda di configurazione/nome immagine

environment-variables

(ECSRenderTaskDefinition/Configuration/environment-variables)

(Obbligatorio)

Specificate le variabili di ambiente che desiderate che l'azione Render Amazon di definizione delle ECS attività aggiunga al file di definizione dell'attività. L'azione aggiunge le variabili al environment campocontainerDefinitions, nel file di definizione dell'attività. Se nel file esistono già delle variabili, l'azione sovrascrive i valori delle variabili esistenti e aggiunge nuove variabili. Per ulteriori informazioni sulle variabili di ECS ambiente di Amazon, consulta Specificare le variabili di ambiente nella Amazon Elastic Container Service Developer Guide.

Interfaccia utente corrispondente: scheda di configurazione/variabili di ambiente - opzionale

Outputs

(ECSRenderTaskDefinition/Outputs)

(Obbligatorio)

Definisce i dati emessi dall'azione durante l'esecuzione di un flusso di lavoro.

Interfaccia utente corrispondente: scheda Output

Artifacts

(ECSRenderTaskDefinition/Outputs/Artifacts)

(Obbligatorio)

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

(ECSRenderTaskDefinition/Outputs/Artifacts/Name)

(Obbligatorio)

Specificare il nome dell'elemento che conterrà il file di definizione dell'attività aggiornato. Il valore predefinito è MyTaskDefinitionArtifact. È quindi necessario specificare questo artefatto come input nell'azione Deploy to Amazon. ECS Per capire come aggiungere questo artefatto come input all'ECSazione Deploy to Amazon, consulta. Esempio: modificare un Amazon ECS taskdef

Interfaccia utente corrispondente: Outputs tab/Artifacts/ Name

Files

(ECSRenderTaskDefinition/Outputs/Artifacts/Files)

(Obbligatorio)

Specificate i file da includere nell'artefatto. È necessario specificare task-definition-* in modo che venga incluso il file di definizione delle attività aggiornatotask-definition-, che inizia con.

Interfaccia utente corrispondente: scheda Output/Artifacts/ Files

Variables

(ECSRenderTaskDefinition/Outputs/Variables)

(Obbligatorio)

Specificate il nome di una variabile che deve essere impostata dall'azione di rendering. L'azione di rendering imposterà il valore di questa variabile sul nome del file di definizione dell'attività aggiornato (ad esempio,task-definition-random-string.json). È quindi necessario specificare questa variabile nella proprietà Task definition (editor visivo) o task-definition (yaml editor) dell'ECSazione Deploy to Amazon. Per informazioni su come aggiungere questa variabile all'ECSazione Deploy to Amazon, consultaEsempio: modificare un Amazon ECS taskdef.

Impostazione predefinita: task-definition

Interfaccia utente corrispondente: scheda Outputs/Variables/ Campo Name