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à.
# Modifica della definizione di un'attività Amazon ECS
Questa sezione descrive come aggiornare il `image` campo in un file di [definizione delle attività di Amazon Elastic Container Service (Amazon ECS) utilizzando un flusso di lavoro](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html#welcome-task-definitions). CodeCatalyst A tale scopo, è necessario aggiungere l'azione di **definizione delle attività Render Amazon ECS** al flusso di lavoro. Questa azione aggiorna il campo dell'immagine nel file di definizione dell'attività con un nome di immagine Docker fornito dal flusso di lavoro in fase di esecuzione.
**Nota**
È inoltre possibile utilizzare questa azione per aggiornare il `environment` campo della definizione dell'attività con variabili di ambiente.
**Topics**
+ [Quando usare questa azione](#render-ecs-action-when-to-use)
+ [Come funziona l'azione «Render Amazon ECS task definition»](#render-ecs-action-how-it-works)
+ [Immagine di runtime utilizzata dall'azione «Render Amazon ECS task definition»](#render-ecs-action-runtime)
+ [Esempio: modificare un taskdef di Amazon ECS](render-ecs-action-example-workflow.md)
+ [Aggiungere l'azione «Render Amazon ECS task definition»](render-ecs-action-add.md)
+ [Visualizzazione del file di definizione delle attività aggiornato](render-ecs-action-view.md)
+ [Variabili «Render Amazon ECS task definition»](render-ecs-action-variables.md)
+ [Azione «Render Amazon ECS task definition» YAML](render-ecs-action-ref.md)
## Quando usare questa azione
Usala se disponi di un flusso di lavoro che crea e contrassegna un'immagine Docker con contenuti dinamici, come un ID di commit o un timestamp.
Non utilizzare questa azione se il file di definizione dell'attività contiene un valore di immagine che rimane sempre lo stesso. In questo caso, puoi inserire manualmente il nome dell'immagine nel file di definizione dell'attività.
## Come funziona l'azione «Render Amazon ECS task definition»
È necessario utilizzare l'azione di **definizione delle attività Render Amazon ECS** con le azioni **Build** e **Deploy to Amazon ECS** nel flusso di lavoro. Insieme, queste azioni funzionano come segue:
1. L'azione di **compilazione** crea l'immagine Docker e la contrassegna con un nome, un ID di commit, un timestamp o altri contenuti dinamici. Ad esempio, l'azione di compilazione potrebbe essere simile alla seguente:
```
MyECSWorkflow
Actions:
BuildAction:
Identifier: aws/build@v1
...
Configuration:
Steps:
# Build, tag, and push the Docker image...
- Run: docker build -t MyDockerImage:${WorkflowSource.CommitId} .
...
```
Nel codice precedente, la `docker build -t` direttiva indica di creare l'immagine Docker e di etichettarla con l'ID di commit in fase di esecuzione dell'azione. Il nome dell'immagine generata potrebbe essere simile al seguente:
`MyDockerImage:a37bd7e`
1. L'azione **Render Amazon ECS di definizione dell'attività** aggiunge il nome dell'immagine generato dinamicamente al file di definizione dell'attività, in questo modo: `MyDockerImage:a37bd7e`
```
{
"executionRoleArn": "arn:aws:iam::account_ID:role/codecatalyst-ecs-task-execution-role",
"containerDefinitions": [
{
"name": "codecatalyst-ecs-container",
"image": MyDockerImage:a37bd7e,
"essential": true,
...
"portMappings": [
{
"hostPort": 80,
"protocol": "tcp",
"containerPort": 80
}
]
}
],
...
}
```
Facoltativamente, puoi anche fare in modo che l'azione **Render Amazon ECS di definizione dell'attività** aggiunga variabili di ambiente alla definizione dell'attività, in questo modo:
```
{
"executionRoleArn": "arn:aws:iam::account_ID:role/codecatalyst-ecs-task-execution-role",
"containerDefinitions": [
{
"name": "codecatalyst-ecs-container",
"image": MyDockerImage:a37bd7e,
...
"environment": [
{
name": "ECS_LOGLEVEL",
value": "info"
}
]
}
],
...
}
```
Per ulteriori informazioni sulle variabili di ambiente, consulta [Specificare le variabili di ambiente](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/taskdef-envfiles.html) nella *Amazon Elastic Container Service Developer Guide*.
1. L'azione **Deploy to Amazon ECS** registra il file di definizione delle attività aggiornato con Amazon ECS. La registrazione del file di definizione delle attività aggiornato distribuisce la nuova immagine in `MyDockerImage:a37bd7e` Amazon ECS.
## Immagine di runtime utilizzata dall'azione «Render Amazon ECS task definition»
L'azione di **definizione delle attività Render Amazon ECS** viene eseguita su un'[immagine di novembre 2022](build-images.md#build.previous-image). Per ulteriori informazioni, consulta [Immagini attive](build-images.md#build-curated-images).
# Esempio: modificare un taskdef di Amazon ECS
Di seguito è riportato un esempio di flusso di lavoro completo che include l'azione di **definizione delle attività di Render Amazon ECS**, insieme alle azioni di compilazione e distribuzione. Lo scopo del flusso di lavoro è creare e distribuire un'immagine Docker nel tuo cluster Amazon ECS. Il flusso di lavoro è costituito dai seguenti elementi costitutivi eseguiti in sequenza:
+ Un **trigger**: questo trigger avvia l'esecuzione automatica del flusso di lavoro quando invii una modifica al tuo repository di origine. Per ulteriori informazioni sui trigger, consulta [L'avvio di un flusso di lavoro viene eseguito automaticamente utilizzando i trigger](workflows-add-trigger.md).
+ Un'azione di **compilazione** (`BuildDocker`): all'attivazione, l'azione crea l'immagine Docker utilizzando il Dockerfile, la contrassegna con un ID di commit e invia l'immagine ad Amazon ECR. Per ulteriori informazioni sull'azione di compilazione, consulta. [Creazione con flussi di lavoro](build-workflow-actions.md)
+ Un'azione di **definizione dell'attività di Render Amazon ECS** (`RenderTaskDef`): al termine dell'azione di compilazione, questa azione aggiorna un'azione esistente `taskdef.json` situata nella radice del repository di origine con un valore di `image` campo che include l'ID di commit corretto. Salva il file aggiornato con un nuovo nome di file (`task-definition-random-string.json`) e quindi crea un elemento di output che contiene questo file. L'azione di rendering genera anche una variabile chiamata `task-definition` e la imposta sul nome del nuovo file di definizione dell'attività. L'artefatto e la variabile verranno utilizzati nell'azione di distribuzione, che è la successiva.
+ Un'azione **Deploy to Amazon ECS** (`DeployToECS`): al termine dell'azione di **definizione dell'attività Render Amazon ECS**, l'azione **Deploy to Amazon** ECS cerca l'artefatto di output generato dall'azione di rendering `TaskDefArtifact` (), trova il file `task-definition-random-string.json` al suo interno e lo registra con il servizio Amazon ECS. Il servizio Amazon ECS segue quindi le istruzioni contenute nel `task-definition-random-string.json` file per eseguire le attività Amazon ECS e i contenitori di immagini Docker associati all'interno del cluster Amazon ECS.
```
Name: codecatalyst-ecs-workflow
SchemaVersion: 1.0
Triggers:
- Type: PUSH
Branches:
- main
Actions:
BuildDocker:
Identifier: aws/build@v1
Environment:
Name: codecatalyst-ecs-environment
Connections:
- Name: codecatalyst-account-connection
Role: codecatalyst-ecs-build-role
Inputs:
Variables:
- Name: REPOSITORY_URI
Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo
- Name: IMAGE_TAG
Value: ${WorkflowSource.CommitId}
Configuration:
Steps:
#pre_build:
- Run: echo Logging in to Amazon ECR...
- Run: aws --version
- Run: aws ecr get-login-password --region us-east-2 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-east-2.amazonaws.com
#build:
- Run: echo Build started on `date`
- Run: echo Building the Docker image...
- Run: docker build -t $REPOSITORY_URI:latest .
- Run: docker tag $REPOSITORY_URI:latest $REPOSITORY_URI:$IMAGE_TAG
#post_build:
- Run: echo Build completed on `date`
- Run: echo Pushing the Docker images...
- Run: docker push $REPOSITORY_URI:latest
- Run: docker push $REPOSITORY_URI:$IMAGE_TAG
RenderTaskDef:
DependsOn:
- BuildDocker
Identifier: aws/ecs-render-task-definition@v1
Inputs:
Variables:
- Name: REPOSITORY_URI
Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo
- Name: IMAGE_TAG
Value: ${WorkflowSource.CommitId}
Configuration:
task-definition: taskdef.json
container-definition-name: codecatalyst-ecs-container
image: $REPOSITORY_URI:$IMAGE_TAG
# The output artifact contains the updated task definition file.
# The new file is prefixed with 'task-definition'.
# The output variable is set to the name of the updated task definition file.
Outputs:
Artifacts:
- Name: TaskDefArtifact
Files:
- "task-definition*"
Variables:
- task-definition
DeployToECS:
Identifier: aws/ecs-deploy@v1
Environment:
Name: codecatalyst-ecs-environment
Connections:
- Name: codecatalyst-account-connection
Role: codecatalyst-ecs-deploy-role
#Input artifact contains the updated task definition file.
Inputs:
Sources: []
Artifacts:
- TaskDefArtifact
Configuration:
region: us-east-2
cluster: codecatalyst-ecs-cluster
service: codecatalyst-ecs-service
task-definition: ${RenderTaskDef.task-definition}
```
# Aggiungere l'azione «Render Amazon ECS task definition»
Utilizza le seguenti istruzioni per aggiungere l'azione di **definizione delle attività di Render Amazon ECS** al tuo flusso di lavoro.
**Prerequisito**
Prima di iniziare, assicurati di disporre di un flusso di lavoro che includa un'azione di compilazione che generi dinamicamente un'immagine Docker. Per i dettagli, consulta il [flusso di lavoro di esempio](render-ecs-action-example-workflow.md) precedente.
------
#### [ Visual ]
**Per aggiungere l'azione «Render Amazon ECS task definition» utilizzando l'editor visuale**
1. [Apri la console all'indirizzo https://codecatalyst.aws/ CodeCatalyst .](https://codecatalyst.aws/)
1. Scegliere il progetto.
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.
1. Scegli **Modifica**.
1. Scegli **Visual**.
1. In alto a sinistra, scegli **\$1 Azioni** per aprire il catalogo delle azioni.
1. **Dall'elenco a discesa, scegli Amazon. CodeCatalyst**
1. Cerca l'azione di **definizione dell'attività Render Amazon ECS** ed esegui una delle seguenti operazioni:
+ Scegli il segno più (**\$1**) per aggiungere l'azione al diagramma del flusso di lavoro e apri il relativo riquadro di configurazione.
Or
+ Scegli la **definizione delle attività di Render Amazon ECS**. Viene visualizzata la finestra di dialogo con i dettagli dell'azione. In questa finestra di dialogo:
+ (Facoltativo) Scegliete **Visualizza sorgente** per [visualizzare il codice sorgente dell'azione](workflows-view-source.md#workflows-view-source.title).
+ Scegli **Aggiungi al flusso di lavoro** per aggiungere l'azione al diagramma del flusso di lavoro e aprire il relativo riquadro di configurazione.
1. Nelle schede **Ingressi** e **Configurazione**, completa i campi in base alle tue esigenze. Per una descrizione di ogni campo, vedi. [Azione «Render Amazon ECS task definition» YAML](render-ecs-action-ref.md) Questo riferimento fornisce informazioni dettagliate su ogni campo (e il valore della proprietà YAML corrispondente) così come appaiono sia nell'editor YAML che in quello visivo.
1. (Facoltativo) Scegliete **Convalida per convalidare il codice YAML** del flusso di lavoro prima di eseguire il commit.
1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.**
------
#### [ YAML ]
**Per aggiungere l'azione «Render Amazon ECS task definition» utilizzando l'editor YAML**
1. [Apri la console all'indirizzo https://codecatalyst.aws/. CodeCatalyst ](https://codecatalyst.aws/)
1. Scegliere il progetto.
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.
1. Scegli **Modifica**.
1. Scegli **YAML**.
1. In alto a sinistra, scegli **\$1 Azioni per aprire il catalogo delle azioni**.
1. **Dall'elenco a discesa, scegli Amazon. CodeCatalyst**
1. Cerca l'azione di **definizione dell'attività Render Amazon ECS** ed esegui una delle seguenti operazioni:
+ Scegli il segno più (**\$1**) per aggiungere l'azione al diagramma del flusso di lavoro e apri il relativo riquadro di configurazione.
Or
+ Scegli la **definizione delle attività di Render Amazon ECS**. Viene visualizzata la finestra di dialogo con i dettagli dell'azione. In questa finestra di dialogo:
+ (Facoltativo) Scegliete **Visualizza sorgente** per [visualizzare il codice sorgente dell'azione](workflows-view-source.md#workflows-view-source.title).
+ Scegli **Aggiungi al flusso di lavoro** per aggiungere l'azione al diagramma del flusso di lavoro e aprire il relativo riquadro di configurazione.
1. Modifica le proprietà del codice YAML in base alle tue esigenze. Una spiegazione di ogni proprietà disponibile è fornita in. [Azione «Render Amazon ECS task definition» YAML](render-ecs-action-ref.md)
1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit.
1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.**
------
**Fasi successive**
Dopo aver aggiunto l'azione di rendering, aggiungi l'azione **Deploy to Amazon ECS** al tuo flusso di lavoro seguendo le istruzioni riportate in. [Distribuzione su Amazon ECS con un flusso di lavoro](deploy-action-ecs.md) Mentre aggiungi l'azione di distribuzione, procedi come segue:
1. Nella scheda **Input** dell'azione di distribuzione, in **Artefatti - opzionale, selezionate l'artefatto** generato dall'azione di rendering. Contiene il file di definizione dell'attività aggiornato.
Per ulteriori informazioni sugli artefatti, vedi [Condivisione di artefatti e file tra azioni](workflows-working-artifacts.md).
1. Nella scheda **Configurazione** dell'azione di distribuzione, nel campo **Definizione del task**, specifica la seguente variabile di azione: `${action-name.task-definition}` *action-name* dov'è il nome dell'azione di rendering, ad esempio,`RenderTaskDef`. L'azione di rendering imposta questa variabile sul nuovo nome del file di definizione dell'attività.
Per ulteriori informazioni sulle variabili, consultate[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md).
Per ulteriori informazioni su come configurare l'azione di distribuzione, vedere il flusso di lavoro di [esempio](render-ecs-action-example-workflow.md) precedente.
# Visualizzazione del file di definizione delle attività aggiornato
Puoi visualizzare il nome e il contenuto del file di definizione delle attività aggiornato.
**Per visualizzare il nome del file di definizione dell'attività aggiornato, dopo l'elaborazione dell'azione di **definizione dell'attività di Render Amazon ECS**.**
1. Trova l'esecuzione che include un'azione di rendering completata:
1. Apri la CodeCatalyst console all'[indirizzo https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Scegliere il progetto.
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.
1. Scegliete un'esecuzione che includa l'azione di rendering completata.
1. Nel diagramma del flusso di lavoro, scegliete l'azione di rendering.
1. Scegliete **Output**.
1. Scegliete **Variabili**.
1. Viene visualizzato il nome del file di definizione dell'attività. Sembra simile a`task-definition--259-0a2r7gxlTF5X-.json`.
**Per visualizzare il contenuto del file di definizione delle attività aggiornato**
1. Trova l'esecuzione che include un'azione di rendering completata:
1. Apri la CodeCatalyst console all'[indirizzo https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Scegliere il progetto.
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.
1. Scegliete un'esecuzione che includa l'azione di rendering completata.
1. Nell'esecuzione del flusso di lavoro, in alto, accanto a **Visual** e **YAML**, scegli Output del **flusso di lavoro**.
1. Nella sezione **Artefatti**, scegli **Scarica** accanto all'elemento che contiene il file di definizione dell'attività aggiornato. Questo artefatto avrà una colonna **Prodotto da** impostata sul nome dell'azione di rendering.
1. Apri il file.zip per visualizzare il file.json di definizione dell'attività.
# Variabili «Render Amazon ECS task definition»
L'azione di **definizione dell'attività Render Amazon ECS** produce e imposta le seguenti variabili in fase di esecuzione. Queste sono note come variabili *predefinite*.
Per informazioni su come fare riferimento a queste variabili in un flusso di lavoro, vedere. [Utilizzo di variabili predefinite](workflows-using-predefined-variables.md)
| Chiave | Valore |
| --- | --- |
| definizione dell'attività | Il nome assegnato al file di definizione dell'attività che è stato aggiornato dall'azione di **definizione dell'attività Render Amazon ECS**. Il nome segue il formato `task-definition-random-string.json`. Ad esempio: `task-definition--259-0a2r7gxlTF5Xr.json` |
# 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**