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 «Render Amazon ECS task definition» YAML
Di seguito è riportata la definizione YAML dell'azione di definizione dell'**attività Render Amazon ECS.** Per informazioni su come utilizzare questa azione, consulta. [Modifica della definizione di un'attività Amazon ECS](render-ecs-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.
ECSRenderTaskDefinition\$1nn:
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)
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: `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](workflows-action-versions.md).
Default: `aws/ecs-render-task-definition@v1`.
**Interfaccia utente corrispondente: Workflow diagram/ ECSRenderTaskDefinition \$1nn/ 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](workflows-depends-on.md)
**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](compute-sharing.md).
Interfaccia utente corrispondente: *nessuna*
## Type
(*ECSRenderTaskDefinition*/Compute/**Type**)
(Obbligatorio se [Compute](#render.ecs.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: 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 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: scheda di configurazione/parco di calcolo**
## Timeout
(*ECSRenderTaskDefinition*/**Timeout**)
(Facoltativo)
Specificate il periodo di tempo, in minuti (editor YAML) o ore e minuti (editor visivo), che l'azione può essere eseguita prima CodeCatalyst che termini l'azione. 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
(*ECSRenderTaskDefinition*/**Inputs**)
(Facoltativo)
La `Inputs` sezione definisce i dati `ECSRenderTaskDefinition` necessari durante l'esecuzione di un flusso di lavoro.
**Nota**
È consentito un solo input (sorgente o artefatto) per azione di definizione delle **attività di Render Amazon ECS.** 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](workflows-sources.md).
**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](workflows-working-artifacts-output.md))
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](workflows-working-artifacts.md)
**Interfaccia utente corrispondente: scheda di configurazione/artefatti - opzionale**
## Variables - input
(*ECSRenderTaskDefinition*/Inputs/**Variables**)
(Obbligatorio)
Specificate una sequenza di name/value coppie che definisca 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 (\$1). 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, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md).
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à](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html#welcome-task-definitions) 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` campo`containerDefinitions`, del file di definizione dell'attività. Per ulteriori informazioni, consulta [Name](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_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 attività di Render Amazon ECS** aggiunga al file di definizione dell'attività. L'azione aggiunge questo nome al `image` campo`containerDefinitions`, 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 specifica`MyDockerImage:${WorkflowSource.CommitId}`, l'azione viene aggiunta `MyDockerImage:commit-id` al file di definizione dell'attività, dove *commit-id* è presente un ID di commit generato in fase di esecuzione dal flusso di lavoro.
Se lo specifichi`my-ecr-repo/image-repo:$(date +%m-%d-%y-%H-%m-%s)`, l'azione aggiunge *my-ecr-repo* /image-repo: *date \$1%m-%d-%y-%H-%m-%s* al file di definizione dell'attività, dove *my-ecr-repo* è l'URI di un Amazon Elastic Container Registry (ECR) ed *date \$1%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](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_image) nella *Amazon Elastic Container Service Developer Guide*. Per ulteriori informazioni sulle variabili, consulta[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md).
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 di **definizione delle attività di Render Amazon ECS** aggiunga al file di definizione dell'attività. L'azione aggiunge le variabili al `environment` campo`containerDefinitions`, nel file di definizione delle 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 ambiente di Amazon ECS, consulta [Specificare le variabili di ambiente](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/taskdef-envfiles.html) 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](workflows-working-artifacts.md)
**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'azione **Deploy to Amazon ECS**, consulta. [Esempio: modificare un taskdef di Amazon ECS](render-ecs-action-example-workflow.md)
**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à aggiornato`task-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** (visual editor) o `task-definition` (yaml editor) dell'azione **Deploy to Amazon ECS**. Per informazioni su come aggiungere questa variabile all'azione **Deploy to Amazon ECS**, consulta. [Esempio: modificare un taskdef di Amazon ECS](render-ecs-action-example-workflow.md)
Impostazione predefinita: `task-definition`
**Interfaccia utente corrispondente: scheda Outputs/Variables/ Campo Nome**