

# Actualización de una definición de tareas de Amazon ECS mediante la consola
<a name="update-task-definition-console-v2"></a>

Una *revisión de definición de tareas* es una copia de la definición de tarea actual con los nuevos valores de parámetro que sustituyen a los existentes. Todos los parámetros que no modifica se encuentran en la nueva revisión.

Para actualizar una definición de tarea, cree una revisión de definición de tarea. Si la definición de tarea se utiliza en un servicio, debe actualizar ese servicio para usar la definición de tarea actualizada.

Al crear una revisión, puede modificar las siguientes propiedades de contenedor y de entorno.
+ ID de imagen de contenedor
+ Mapeos de puertos
+ Variables de entorno
+ Requisitos de infraestructura
+ Tamaño de tarea
+ Tamaño del contenedor
+ Rol de de la tarea
+ Rol de ejecución de tareas
+ Volúmenes y puntos de montaje de contenedores
+ Registro privado

Puede hacer que Amazon Q dé recomendaciones cuando utilice el editor JSON. Para obtener más información, consulte [Uso de Amazon Q Developer para proporcionar recomendaciones de la definición de tareas en la consola de Amazon ECS](using-amazon-q.md)

## Validación de JSON
<a name="json-validate-for-update"></a>

El editor JSON de la consola de Amazon ECS valida lo siguiente en el archivo JSON:
+ El archivo es un archivo JSON válido
+ El archivo no contiene claves extrañas
+ El archivo contiene el parámetro `familyName`
+ Hay por lo menos una entrada en `containerDefinitions`

## Procedimiento
<a name="update-task-definition-console-v2-procedure"></a>

------
#### [ Amazon ECS console ]

1. Abra la consola en [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. En la barra de navegación, seleccione la Región que contiene la definición de tarea.

1. En el panel de navegación, elija **Task Definitions** (Definiciones de tareas).

1. Elija la definición de tareas.

1. Seleccione la revisión de las definiciones de tareas y, a continuación, elija **Crear nueva revisión** y **Crear nueva revisión**.

1. En la página **Create new task definition revision** (Crear nueva revisión de definición de tarea), realice cambios. Por ejemplo, para cambiar las definiciones de contenedor existentes (como la imagen de contenedor, los límites de memoria, o las asignaciones de puertos), seleccione el contenedor, realice los cambios. Puede actualizar la compatibilidad de las definiciones de tareas a una de las instancias de **AWS Fargate**, **Managed Instances** o **Amazon EC2**.

1. Verifique la información y, luego, seleccione **Actualizar**.

1. Si la definición de tarea se utiliza en un servicio, actualice su servicio con la definición de tarea actualizada. Para obtener más información, consulte [Actualización de un servicio de Amazon ECS](update-service-console-v2.md).

------
#### [ Amazon ECS console JSON editor ]

1. Abra la consola en [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. En el panel de navegación, elija **Task Definitions** (Definiciones de tareas).

1. Elija **Create new revision** (Crear nueva revisión) y **Create new revision with JSON** (Crear nueva revisión con JSON).

1. En el cuadro del editor de JSON, edite su archivo JSON,

   El JSON debe pasar las comprobaciones de validación especificadas en [Validación de JSON](#json-validate-for-update).

1. Seleccione **Crear**.

------