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
<a name="render-ecs-action"></a>

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
<a name="render-ecs-action-when-to-use"></a>

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»
<a name="render-ecs-action-how-it-works"></a>

È 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»
<a name="render-ecs-action-runtime"></a>

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