Creación de una definición de tareas de Amazon ECS mediante la consola - Amazon Elastic Container Service

Creación de una definición de tareas de Amazon ECS mediante la consola

Para crear una definición de tarea, utilice la consola o edite un archivo JSON.

Validación de JSON

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.

Pilas de AWS CloudFormation

El siguiente comportamiento se aplica a las definiciones de tareas que se crearon en la nueva consola de Amazon ECS antes del 12 de enero de 2023.

Al crear una definición de tareas, la consola de Amazon ECS crea automáticamente una pila de CloudFormation cuyo nombre comienza por ECS-Console-V2-TaskDefinition-. Si utilizó la AWS CLI o el AWS SDK para anular el registro de la definición de tareas, debe eliminar manualmente la pila de la definición de tareas. Para obtener más información, consulte Elimina una pila en la Guía del usuario de AWS CloudFormation.

Para las definiciones de tareas creadas después del 12 de enero de 2023, no se crea automáticamente una pila de CloudFormation.

Procedimiento

Amazon ECS console
  1. Abra la consola en https://console.aws.amazon.com/ecs/v2.

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

  3. En el menú Crear una nueva definición de tarea, elija Crear una nueva definición de tarea.

  4. Para Task definition family (Familia de definiciones de tareas), especifique un nombre único para la definición de tareas.

  5. En Tipo de lanzamiento, elija el entorno de la aplicación. El valor predeterminado de la consola es AWS Fargate (que es sin servidor). Amazon ECS utiliza este valor para la validación y garantizar que los parámetros de la definición de tareas sean válidos para el tipo de infraestructura.

  6. Para Operating system/Architecture (Arquitectura y sistema operativo), elija el sistema operativo y la arquitectura de CPU para la tarea.

    Para ejecutar la tarea en una arquitectura ARM de 64 bits, elija Linux/ARM64. Para obtener más información, consulte Plataforma de tiempo de ejecución.

    Para ejecutar sus tareas de AWS Fargate en contenedores de Windows, elija un sistema operativo compatible con Windows. Para obtener más información, consulte Arquitecturas y sistemas operativos.

  7. En Task size (Tamaño de tarea), elija los valores de CPU y memoria que desea reservar para la tarea. El valor de CPU se especifica como vCPU y la memoria se especifica como GB.

    Para las tareas alojadas en Fargate, en la siguiente tabla, se muestran las combinaciones de CPU y memoria válidas.

    Valor de CPU

    Valor de memoria

    Sistemas operativos admitidos por AWS Fargate

    256 (0,25 vCPU)

    512 MiB, 1 GB, 2 GB

    Linux

    512 (0,5 vCPU)

    1 GB, 2 GB, 3 GB, 4 GB

    Linux

    1024 (1 vCPU)

    2 GB, 3 GB, 4 GB, 5 GB, 6 GB, 7 GB, 8 GB

    Linux, Windows

    2048 (2 vCPU)

    Entre 4 GB y 16 GB en incrementos de 1 GB

    Linux, Windows

    4096 (4 vCPU)

    Entre 8 GB y 30 GB en incrementos de 1 GB

    Linux, Windows

    8192 (8 vCPU)

    nota

    Esta opción requiere una plataforma Linux 1.4.0 o posterior.

    Entre 16 GB y 60 GB en incrementos de 4 GB

    Linux

    16 384 (16 vCPU)

    nota

    Esta opción requiere una plataforma Linux 1.4.0 o posterior.

    Entre 32 GB y 120 GB en incrementos de 8 GB

    Linux

    Para las tareas alojadas en Amazon EC2, los valores de admitidos para CPU de tareas están entre 128 unidades de CPU (0,125 vCPU) y 10240 unidades de CPU (10 vCPU). Para indicar el valor de memoria en GB, ingrese GB después del valor. Por ejemplo, para establecer Memory value en 3 GB, ingrese 3GB.

    nota

    Los parámetros de CPU y memoria de nivel de tarea se omiten para los contenedores de Windows.

  8. Para Network mode (Modo de red), elija el modo de red que desea utilizar. El valor predeterminado es el modo awsvpc. Para obtener más información, consulte redes de tareas de Amazon ECS.

    Si elige Puente, en Asignaciones de puertos, para Puerto del host, ingrese el número de puerto en la instancia de contenedor que se debe reservar para el contenedor.

  9. (Opcional) Amplíe la sección Roles de tareas para configurar los roles de AWS Identity and Access Management (IAM) de la tarea:

    1. En Task role (Rol de la tarea), elija el rol de IAM para asignar a la tarea. Un rol de IAM de tarea proporciona permisos para los contenedores de una tarea para llamar a las operaciones de la API de AWS.

    2. En Rol de ejecución de tareas, elija rol.

      Para obtener más información sobre cuándo utilizar el rol de ejecución de tareas, consulte Rol de IAM de ejecución de tareas de Amazon ECS. Si no necesita el rol, elija Ninguno.

  10. Para definir a cada contenedor en su definición de tareas, siga los pasos que se describen a continuación.

    1. En Name (Nombre), escriba un nombre para el contenedor.

    2. En Image URI (URI de imagen), ingrese la imagen que se va a usar para iniciar un contenedor. Las imágenes del registro de Galería pública de Amazon ECR se pueden especificar solo mediante el uso del nombre de registro público de Amazon ECR. Por ejemplo, si se indica public.ecr.aws/ecs/amazon-ecs-agent:latest, se utiliza el contenedor de Amazon Linux alojado en Galería pública de Amazon ECR. Para todos los demás repositorios, indique el repositorio mediante los formatos repository-url/image:tag o repository-url/image@digest.

    3. Si la imagen se encuentra en un registro privado ajeno a Amazon ECR, en Registro privado, active la Autenticación del registro privado. A continuación, en nombre o ARN de Secrets Manager, introduzca el nombre de recurso de Amazon (ARN) del secreto.

    4. En Contenedor esencial, si la definición de tarea tiene dos o varios contenedores definidos, puede especificar si el contenedor debe considerarse esencial. Cuando un contenedor está marcado como Esencial, si se detiene, la tarea se detiene. Cada definición de tarea debe contener al menos un contenedor esencial.

    5. Las asignaciones de puertos permiten a los contenedores acceder a puertos en el host para enviar o recibir tráfico. En Port mappings (Asignaciones de puertos), realice una de las siguientes operaciones:

      • Cuando usa el modo de red awsvpc, en Container port (Puerto del contenedor) y Protocol (Protocolo), elija la asignación de puertos que se va a usar para el contenedor.

      • Cuando usa el modo de red bridge (puente), en Container port (Puerto del contenedor) y Protocol (Protocolo), elija la asignación de puertos que se va a usar para el contenedor.

      Elija Add more port mappings (Agregar más asignaciones de puertos) para especificar asignaciones de puertos de contenedores adicionales.

    6. Para conceder al contenedor acceso de solo lectura a su sistema de archivos raíz, en Sistema de archivos raíz de solo lectura, seleccione Solo lectura.

    7. (Opcional) Para definir los límites de CPU, GPU y memoria a nivel de contenedor que sean diferentes de los valores a nivel de tarea incluidos en Resource allocation limits, haga lo siguiente:

      • En CPU, ingrese el número de unidades de CPU que el agente de contenedor de Amazon ECS reserva para el contenedor.

      • En GPU, ingrese el número de unidades de GPU para la instancia de contenedor.

        Una instancia de Amazon EC2 compatible con GPU tiene 1 unidad de GPU por cada GPU. Para obtener más información, consulte Definiciones de tareas de Amazon ECS para cargas de trabajo de GPU.

      • En Límite estricto de memoria, ingrese la cantidad de memoria, en GB, para presentarla al contenedor. Si el contenedor intenta superar el límite duro, se cancela el contenedor.

      • El daemon de Docker 20.10.0 o posterior reserva un mínimo de 6 mebibytes (MiB) de memoria para un contenedor, por tanto no indique menos de 6 MiB de memoria para los contenedores.

        El daemon de Docker 19.03.13-ce o anterior reserva un mínimo de 4 MiB de memoria para un contenedor, por tanto no indique menos de 4 MiB de memoria para los contenedores.

      • En Límite flexible de memoria, ingrese el límite flexible (en GB) de memoria que reservar para el contenedor.

        Cuando la memoria del sistema está en conflicto, Docker intenta mantener la memoria del contenedor en este límite flexible. Si no especifica memoria de nivel de tarea, debe especificar un entero distinto de cero para el Límite duro de memoria y el Límite flexible de memoria, o para ambos. Si especifica ambos, el Límite duro de memoria debe ser mayor que el Límite flexible de memoria.

        Esta característica no es compatible con los contenedores de Windows.

    8. (Opcional) Expanda la sección Variables de entorno para especificar variables de entorno que se van a inyectar en el contenedor. Puede indicar variables de entorno individualmente mediante pares clave-valor o de forma masiva si indica un archivo de variable de entorno alojado en un bucket de Amazon S3. Para obtener información sobre cómo dar formato a un archivo de variable de entorno, consulte Transferencia de una variable de entorno individual a un contenedor de Amazon ECS.

      Cuando especifique una variable de entorno para el almacenamiento de secretos, en Clave, ingrese el nombre del secreto. A continuación, en ValueFrom, indique el ARN completo del secreto de Almacén de parámetros de Systems Manager o del secreto de Secrets Manager.

    9. (Opcional) Seleccione la opción Use log collection (Utilizar colección de registros) para especificar una configuración de registro. Para cada controlador de registro disponible, hay opciones de controladores de registro que se deben especificar. La opción predeterminada envía registros de contenedor a Registros de Amazon CloudWatch. Las demás opciones del controlador de registros se configuran mediante AWS FireLens. Para obtener más información, consulte Envío de registros de Amazon ECS a un servicio de AWS o AWS Partner.

      A continuación, se describe con más detalle cada uno de los destinos de registro de contenedor.

      • Amazon CloudWatch: configure la tarea para enviar registros de contenedor a CloudWatch Logs. Se proporcionan las opciones de controlador de registro predeterminadas que crean un grupo de registros de CloudWatch en su nombre. Para especificar otro nombre de grupo de registros, cambie los valores de las opciones del controlador.

      • Exportar registros a Splunk: configure la tarea para enviar los registros del contenedor al controlador de Splunk que envía los registros a un servicio remoto. Debe ingresar la URL del servicio web de Splunk. El token de Splunk se indica como una opción secreta, ya que puede tratarse como información confidencial.

      • Exportar registros a Amazon Data Firehose: configure la tarea para enviar registros de contenedor a Firehose. Se proporcionan las opciones de controlador de registro predeterminadas, que envían registros a un flujo de entrega de Firehose. Para especificar un nombre de flujo de entrega distinto, cambie los valores de las opciones del controlador.

      • Exportar registros a Amazon Kinesis Data Streams: configure la tarea para enviar registros de contenedores a Kinesis Data Streams. Se proporcionan las opciones de controlador de registro predeterminadas que envían registros a un flujo de Kinesis Data Streams. Para especificar otro nombre de transmisión, cambie los valores de las opciones del controlador.

      • Exportar registros a Amazon OpenSearch Service: configure la tarea para enviar registros de contenedor a un dominio de OpenSearch Service. Se deben proporcionar las opciones del controlador de registros.

      • Exportar registros a Amazon S3: configure la tarea para enviar registros de contenedor a un bucket de Amazon S3. Se proporcionan las opciones de controlador de registro predeterminadas, pero debe especificar un nombre de bucket de Amazon S3 válido.

    10. (Opcional) Configure parámetros de contenedor adicionales.

      Para configurar esta opción Haga lo siguiente

      HealthCheck

      Estos son los comandos que determinan si un contenedor está en buen estado. Para obtener más información, consulte Determine el estado de las tareas de Amazon ECS mediante comprobaciones de estado de los contenedores.

      Expanda HealthCheck y, a continuación, configure los siguientes elementos:
      • En Command (Comando), introduzca una lista de comandos separados por comas. Puede comenzar los comandos con CMD para ejecutar los argumentos del comando directamente, o por CMD-SHELL para ejecutar el comando con el intérprete de comandos predeterminado del contenedor. Si no se especifica ninguno, se utiliza CMD.

      • En Interval (Intervalo), introduzca el número de segundos entre cada comprobación de estado. Los valores válidos se encuentran entre 5 y 30.

      • En Timeout (Tiempo de espera), ingrese el periodo (en segundos) que hay que esperar para que una comprobación de estado se realice correctamente antes de que se considere un error. Los valores válidos se encuentran entre 2 y 60.

      • En Start period (Periodo de inicio), introduzca el periodo de tiempo (en segundos) que hay que esperar para que un contenedor se inicie antes de que se ejecuten los comandos de comprobación de estado. Los valores válidos se encuentran entre 0 y 300.

      • En Retries (Reintentos), introduzca el número de veces que desea volver a intentar los comandos de comprobación de estado cuando se produzca un error. Los valores válidos se encuentran entre 1 y 10.

      Tiempos de espera de contenedor

      Estas opciones determinan cuándo iniciar y detener un contenedor.

      Expanda Tiempos de espera del contenedor y, a continuación, configure lo siguiente:
      • Para configurar el tiempo de espera antes de dejar de resolver dependencias para un contenedor, en Tiempo de espera de inicio, ingrese el número de segundos.

      • Para configurar el tiempo de espera antes de que el contenedor se detenga si no sale normalmente por sí mismo, en Tiempo de espera de inicio, ingrese el número de segundos.

      Configuraciones de red del contenedor

      Estas opciones determinan si se deben utilizar las redes dentro de un contenedor.

      Expanda Configuraciones de red del contenedor y, a continuación, configure lo siguiente:
      • Para deshabilitar las redes de contenedores, seleccione Desactivar las redes.

      • Para configurar las direcciones IP de los servidores DNS que se presentan en el contenedor, en Servidores DNS, introduzca la dirección IP de cada servidor en una línea independiente.

      • Para configurar que los dominios DNS busquen los nombres de host incompletos que se presentan en el contenedor, en Dominios de búsqueda de DNS, ingrese cada dominio en una línea independiente.

        El patrón es ^[a-zA-Z0-9-.]{0,253}[a-zA-Z0-9]$.

      • Para configurar el nombre de host del contenedor, en Nombre de host, introduzca el nombre goat del contenedor.

      • Para agregar los nombres de host y las asignaciones de direcciones IP que se adjuntan al archivo /etc/hosts del contenedor, elija Agregar host adicional y, a continuación, en Nombre de host y Dirección IP, introduzca el nombre del host y la dirección IP.

      Configuración de Docker

      Estos anulan los valores de Dockerfile.

      Amplíe Configuración de Docker y, luego, configure los elementos siguientes:

      • En Comando, ingrese un comando ejecutable para un contenedor.

        Este parámetro se asigna a Cmd en la sección Create a container de la API remota de Docker y la opción COMMAND a docker run. Este parámetro anula la instrucción de CMD de un Dockerfile.

      • En Punto de entrada, ingrese el ENTRYPOINT de Docker que se transfiere al contenedor.

        Este parámetro se asigna a Entrypoint en la sección Create a container de la API remota de Docker y la opción --entrypoint a docker run. Este parámetro anula la instrucción de ENTRYPOINT de un Dockerfile.

      • En Directorio de trabajo, ingrese el directorio en el que el contenedor ejecutará cualquier punto de entrada e instrucción de comando proporcionados.

        Este parámetro se asigna a WorkingDir en la sección Create a container de la API remota de Docker y la opción --workdir a docker run. Este parámetro anula la instrucción de WORKDIR de un Dockerfile.

      Ulimits

      Estos valores sobrescriben la configuración predeterminada de la cuota de recursos para el sistema operativo.

      Este parámetro se asigna a Ulimits en la sección Crear un contenedor de la API remota de Docker y con la opción --ulimit de docker run.

      Amplíe Límites de recursos (ulimits) y, luego, elija Agregar ulimit. En Nombre del límite, elija el límite. A continuación, en Límite flexible y Límite invariable, introduzca los valores.

      Para agregar más ulimits, elija Agregar ulimit.

      Etiquetas de Docker

      Esta opción agrega metadatos al contenedor.

      Este parámetro se asigna a Labels en la sección Crear un contenedor de la API remota de Docker y con la opción --label de docker run.

      Amplíe Etiquetas de Docker, elija Agregar par clave-valor y, luego, ingrese la clave y el valor.

      Para agregar más etiquetas de Docker, seleccione Agregar par clave-valor.

      Orden de inicio del contenedor

      Esta opción define las dependencias para el inicio y apagado del contenedor. Un contenedor puede contener varias dependencias.

      Expanda Ordenación de la dependencia de inicio y, a continuación, configure lo siguiente:
      1. Seleccione Agregar dependencia de contenedor.

      2. En Contenedor, elija el contenedor.

      3. En Condición, elija la condición de dependencia de inicio.

      Para agregar una dependencia adicional, elija Agregar dependencia de contenedor.
    11. (Opcional) Elija Add more containers (Agregar más contenedores) para agregar contenedores adicionales a la definición de tareas.

  11. (Opcional) La sección Almacenamiento se utiliza para ampliar la cantidad de almacenamiento efímero de las tareas alojadas en Fargate. También puede utilizar esta sección para agregar una configuración de volumen de datos para la tarea.

    1. Para ampliar el almacenamiento efímero disponible más allá del valor predeterminado de 20 gibibytes (GiB) para las tareas de Fargate, en Amount (Cantidad), ingrese un valor de hasta 200 GiB.

  12. (Opcional) Para agregar una configuración de volumen de datos para la definición de tareas, elija Agregar volumen y, a continuación, siga estos pasos.

    1. En Volume name (Nombre del volumen), ingrese un nombre para el volumen de datos. El nombre del volumen de datos se utiliza al crear un punto de montaje de contenedor.

    2. En Configuración de volumen, seleccione si quiere configurar el volumen al crear la definición de la tarea o durante la implementación.

      nota

      Entre los volúmenes que se pueden configurar al crear una definición de tareas se incluyen Montaje de enlace, Docker, Amazon EFS y Amazon FSx para Windows File Server. Entre los volúmenes que se pueden configurar en el momento de la implementación, al ejecutar una tarea o al crear o actualizar un servicio, se incluye Amazon EBS.

    3. En Tipo de volumen, seleccione un tipo de volumen compatible con el tipo de configuración que seleccionó y, luego, configure el tipo de volumen.

    Tipo de volumen Pasos

    Montaje de unión

    1. Elija Add mount point (Agregar punto de montaje) y, a continuación, configure lo siguiente:

      • Para Container (Contenedor), elija el contenedor para el punto de montaje.

      • Para Source volume (Volumen de origen), elija el volumen de datos que desea montar en el contenedor.

      • En Container path (Ruta del contenedor), ingrese la ruta del contenedor en el cual montar el volumen.

      • En Solo lectura, seleccione si el contenedor tiene acceso de solo lectura al volumen.

    2. Para agregar puntos de montaje adicionales, utilice Add mount point (Agregar punto de montaje).

    EFS
    1. En File system ID (ID del sistema de archivos), seleccione el ID del sistema de archivos de Amazon EFS.

    2. (Opcional) En Root directory (Directorio raíz), ingrese el directorio dentro del archivo de Amazon EFS que se va a montar como directorio raíz dentro del host. Si se omite este parámetro, se utiliza la raíz del volumen de Amazon EFS.

      Si piensa utilizar un punto de acceso de EFS, deje este campo en blanco.

    3. (Opcional) En Access point (Punto de acceso), elija el ID del punto de acceso que desee utilizar.

    4. (Opcional) Para cifrar los datos entre el sistema de archivos de Amazon EFS y el host de Amazon ECS, o para utilizar el rol de ejecución de tareas al montar el volumen, elija Advanced configurations (Configuraciones avanzadas) y, a continuación, configure lo siguiente:

      • Para cifrar los datos entre el sistema de archivos de Amazon EFS y el host de Amazon ECS, seleccione Transit encryption (Cifrado de tránsito) y, a continuación, introduzca el Port (Puerto) que se utilizará al enviar datos cifrados entre el host de Amazon ECS y el servidor de Amazon EFS. Si no se especifica un puerto de cifrado en tránsito, se emplea la estrategia de selección de puertos que utiliza el ayudante de montaje de Amazon EFS. Para obtener más información, consulte Ayudante de montaje de EFS en la Guía del usuario de Amazon Elastic File System.

      • Para utilizar el rol de IAM de tarea de Amazon ECS definido en una definición de tarea al montar el sistema de archivos de Amazon EFS, seleccione IAM authorization (Autorización de IAM).

    5. Elija Add mount point (Agregar punto de montaje) y, a continuación, configure lo siguiente:

      • Para Container (Contenedor), elija el contenedor para el punto de montaje.

      • Para Source volume (Volumen de origen), elija el volumen de datos que desea montar en el contenedor.

      • En Container path (Ruta del contenedor), ingrese la ruta del contenedor en el cual montar el volumen.

      • En Solo lectura, seleccione si el contenedor tiene acceso de solo lectura al volumen.

    6. Para agregar puntos de montaje adicionales, utilice Add mount point (Agregar punto de montaje).

    Docker

    1. En Controlador, ingrese la configuración del volumen de Docker. Los contenedores de Windows admiten solo el uso del controlador local. Para utilizar montajes vinculados, especifique un host.

    2. En Scope (Alcance), elija el ciclo de vida del volumen.

      • Para que el ciclo de vida dure cuando la tarea se inicie y se detenga, elija Task (Tarea).

      • Para que el volumen persista después de que se detenga la tarea, elija Shared (Compartido).

    3. Elija Add mount point (Agregar punto de montaje) y, a continuación, configure lo siguiente:

      • Para Container (Contenedor), elija el contenedor para el punto de montaje.

      • Para Source volume (Volumen de origen), elija el volumen de datos que desea montar en el contenedor.

      • En Container path (Ruta del contenedor), ingrese la ruta del contenedor en el cual montar el volumen.

      • En Solo lectura, seleccione si el contenedor tiene acceso de solo lectura al volumen.

    4. Para agregar puntos de montaje adicionales, utilice Add mount point (Agregar punto de montaje).

    FSx para Windows File Server
    1. En ID del sistema de archivos, elija el ID del sistema de archivos de FSx for Windows File Server.

    2. En Directorio raíz, ingrese el directorio del sistema de archivos de FSx para Windows File Server que se va a montar como directorio raíz dentro del host.

    3. En Parámetro de credenciales, elija cómo se almacenarán las credenciales.

      • Para utilizar AWS Secrets Manager, ingrese el nombre de recurso de Amazon (ARN) de un secreto de Secrets Manager.

      • Para utilizar AWS Systems Manager, ingrese el nombre de recurso de Amazon (ARN) de un parámetro de Systems Manager.

    4. En Dominio, ingrese el nombre de dominio completo que aloja un directorio de AWS Directory Service for Microsoft Active Directory (AWS Managed Microsoft AD) o un directorio de EC2 de Active Directory con alojamiento propio.

    5. Elija Add mount point (Agregar punto de montaje) y, a continuación, configure lo siguiente:

      • Para Container (Contenedor), elija el contenedor para el punto de montaje.

      • Para Source volume (Volumen de origen), elija el volumen de datos que desea montar en el contenedor.

      • En Container path (Ruta del contenedor), ingrese la ruta del contenedor en el cual montar el volumen.

      • En Solo lectura, seleccione si el contenedor tiene acceso de solo lectura al volumen.

    6. Para agregar puntos de montaje adicionales, utilice Add mount point (Agregar punto de montaje).

    Amazon EBS

    1. Elija Add mount point (Agregar punto de montaje) y, a continuación, configure lo siguiente:

      • Para Container (Contenedor), elija el contenedor para el punto de montaje.

      • Para Source volume (Volumen de origen), elija el volumen de datos que desea montar en el contenedor.

      • En Container path (Ruta del contenedor), ingrese la ruta del contenedor en el cual montar el volumen.

      • En Solo lectura, seleccione si el contenedor tiene acceso de solo lectura al volumen.

    2. Para agregar puntos de montaje adicionales, utilice Add mount point (Agregar punto de montaje).

  13. Para agregar un volumen desde otro contenedor, seleccione Agregar volumen desde y, a continuación, configure lo siguiente:

    • En Contenedor, elija el contenedor.

    • En Origen, elija el contenedor que tiene el volumen que desea montar.

    • En Solo lectura, seleccione si el contenedor tiene acceso de solo lectura al volumen.

  14. (Opcional) Para configurar los valores de seguimiento y recopilación de métricas de la aplicación mediante la integración de AWS Distro for OpenTelemetry, expanda Supervisión y, luego, seleccione Utilizar recopilación de métricas para recopilar y enviar las métricas de las tareas a Amazon CloudWatch o Amazon Managed Service para Prometheus. Cuando se selecciona esta opción, Amazon ECS crea un sidecar de contenedor de AWS Distro for OpenTelemetry que está preconfigurado para enviar las métricas de la aplicación. Para obtener más información, consulte Correlacionar el rendimiento de las aplicaciones de Amazon ECS mediante métricas de aplicaciones.

    1. Cuando se selecciona Amazon CloudWatch, las métricas de aplicaciones personalizadas se enrutan a CloudWatch como métricas personalizadas. Para obtener más información, consulte Exportación de métricas de aplicaciones a Amazon CloudWatch.

      importante

      Al exportar métricas de aplicaciones a Amazon CloudWatch, la definición de tarea requiere un rol de IAM de tarea con los permisos necesarios. Para obtener más información, consulte Permisos de IAM necesarios para la integración de AWS Distro for OpenTelemetry Amazon CloudWatch.

    2. Cuando se selecciona Amazon Managed Service for Prometheus (Prometheus libraries instrumentation) (Amazon Managed Service for Prometheus [instrumentación de bibliotecas Prometheus]), las métricas de CPU, memoria, red y almacenamiento de nivel de tarea y las métricas de aplicaciones personalizadas se enrutan a Amazon Managed Service for Prometheus. En Punto de enlace de escritura remota del espacio del espacio de trabajo, ingrese la URL de punto de conexión de escritura remota del espacio de trabajo de Prometheus. En Objetivo de raspado, ingrese el host y el puerto que el recopilador de AWS Distro for OpenTelemetry puede utilizar para extraer los datos de métricas. Para obtener más información, consulte Exportación de métricas de aplicaciones a Amazon Managed Service for Prometheus.

      importante

      Al exportar métricas de aplicaciones a Amazon Managed Service for Prometheus, la definición de tarea requiere un rol de IAM de tarea con los permisos necesarios. Para obtener más información, consulte Permisos de IAM necesarios para la integración de AWS Distro for OpenTelemetry con Amazon Managed Service for Prometheus.

    3. Cuando selecciona Amazon Managed Service para Prometheus (instrumentación de OpenTelemetry), las métricas de CPU, memoria, red y almacenamiento de nivel de tarea y las métricas de aplicaciones personalizadas se dirigen a Amazon Managed Service para Prometheus. En Punto de enlace de escritura remota del espacio del espacio de trabajo, ingrese la URL de punto de conexión de escritura remota del espacio de trabajo de Prometheus. Para obtener más información, consulte Exportación de métricas de aplicaciones a Amazon Managed Service for Prometheus.

      importante

      Al exportar métricas de aplicaciones a Amazon Managed Service for Prometheus, la definición de tarea requiere un rol de IAM de tarea con los permisos necesarios. Para obtener más información, consulte Permisos de IAM necesarios para la integración de AWS Distro for OpenTelemetry con Amazon Managed Service for Prometheus.

  15. (Opcional) Expanda la sección Tags (Etiquetas) para agregar etiquetas, como pares clave-valor, a la definición de tarea.

    • [Agregar una etiqueta] Seleccione Add tag (Agregar etiqueta), y, a continuación, haga lo siguiente:

      • En Clave, escriba el nombre de la clave.

      • En Valor, escriba el valor de la clave.

    • [Eliminar una etiqueta] Junto a la etiqueta, elija Remove tag (Quitar etiqueta).

  16. Elija Crear para registrar la definición de tarea.

Amazon ECS console JSON editor
  1. Abra la consola en https://console.aws.amazon.com/ecs/v2.

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

  3. Elija Crear una nueva definición de tarea y Crear una nueva definición de tarea con JSON.

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

  5. Seleccione Crear.