View a markdown version of this page

Creación y administración de daemons - Amazon Elastic Container Service
Requisitos previosCreación de un daemonVerificación de la implementación del daemonActualización de un daemonEliminación de un daemon

Creación y administración de daemons

Tras registrar una definición de tarea de daemon, cree un daemon para implementarlo en sus proveedores de capacidad de instancias administradas de Amazon ECS. Amazon ECS coloca automáticamente una tarea de daemon en cada instancia de Amazon EC2 de los proveedores de capacidad asociados y administra el ciclo de vida del daemon.

Requisitos previos

Antes de crear un daemon, asegúrese de que tenga lo siguiente:

  • Un clúster de Amazon ECS.

  • Uno o varios proveedores de capacidad de instancias administradas de Amazon ECS asociados al clúster.

  • Una definición de tareas de daemon registrada.

Creación de un daemon

Consola de administración de AWS

  1. Abra la consola de Amazon ECS. En el panel de navegación izquierdo, elija Clústeres y, a continuación, seleccione su clúster.

  2. Selecciona la pestaña Daemons y, a continuación, seleccione Crear.

  3. En Familia de definiciones de tareas de daemon, seleccione su definición de tareas de daemon en el menú desplegable.

  4. A continuación, en Revisión de la definición de tareas de daemon, seleccione la revisión que desee utilizar. Deje este campo en blanco para usar la revisión más reciente.

  5. En Nombre de daemon, escriba un nombre único. El nombre puede contener hasta 255 caracteres alfanuméricos, guiones y guiones bajos.

  6. En Proveedores de capacidad, seleccione uno o varios proveedores de capacidad de instancias administradas de Amazon ECS. Estos determinan qué instancias ejecutan sus tareas de daemon.

  7. (Opcional) Configure los ajustes de implementación:

    • Porcentaje de agotamiento: porcentaje de instancias que se agotan simultáneamente durante las actualizaciones. Valor predeterminado: 25.

    • Usar alarmas de CloudWatch: actívelo para supervisar el estado de la implementación y revertirlas automáticamente si se activan las alarmas.

    • Tiempo de incorporación: el número de minutos que Amazon ECS espera después de actualizar todas las instancias a la nueva revisión del daemon antes de completar la implementación. Durante este periodo, Amazon ECS supervisa las alarmas de CloudWatch y revierte automáticamente la implementación si se activa alguna alarma. Valor predeterminado: 0.

  8. (Opcional) Añada etiquetas.

  9. (Opcional) Active la opción Habilitar ECS Exec para ejecutar comandos interactivos en sus contenedores de daemon para solucionar problemas.

  10. Revise la configuración y elija Crear.

AWS CLI

Cree un archivo JSON con la configuración del daemon y ejecute el comando create-daemon.

A continuación se muestra un ejemplo de un archivo JSON:

{
    "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-daemon-cluster",
    "daemonName": "my-monitoring-daemon",
    "daemonTaskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/my-daemon-task:1",
    "capacityProviderArns": [
        "arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-daemon-capacity-provider"
    ]
}

Ejecute el siguiente comando para crear el daemon:

aws ecs create-daemon --cli-input-json file://create-daemon.json

Campos obligatorios

  • daemonName: un nombre único para el daemon.

  • clusterArn: el ARN del clúster.

  • daemonTaskDefinitionArn: el ARN de la definición de tareas de daemon.

  • capacityProviderArns: una matriz de ARN de proveedor de capacidad de instancias administradas de Amazon ECS.

Campos opcionales

  • deploymentConfiguration: un objeto DaemonDeploymentConfiguration para personalizar el comportamiento de la implementación.

  • tags: pares clave-valor para etiquetar.

  • propagateTags: configuración de propagación de etiquetas.

  • clientToken: un token de idempotencia.

Verificación de la implementación del daemon

Tras crear un daemon, compruebe su estado mediante la Consola de administración de AWS o la AWS CLI.

Consola de administración de AWS

  1. Abra la consola de Amazon ECS. En el panel de navegación izquierdo, elija Clústeres y, a continuación, seleccione su clúster.

  2. Seleccione la pestaña Daemons.

  3. Compruebe que el daemon muestre el estado Activo.

  4. Seleccione la pestaña Tareas para confirmar que se ejecuta una tarea de daemon en cada instancia de contenedor.

AWS CLI

Ejecute los siguientes comandos para verificar el estado del daemon:

aws ecs list-daemons \
    --cluster-arn arn:aws:ecs:us-east-1:123456789012:cluster/my-daemon-cluster
aws ecs describe-daemons \
    --daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon

Actualización de un daemon

Para actualizar un daemon con una nueva revisión de la definición de tareas o para agregar proveedores de capacidad, utilice la Consola de administración de AWS o la AWS CLI. Esto desencadena una implementación progresiva en todas las instancias.

Consola de administración de AWS

  1. Abra la consola de Amazon ECS. En el panel de navegación izquierdo, elija Clústeres y, a continuación, seleccione su clúster.

  2. Seleccione la pestaña Daemons y, a continuación, seleccione el daemon que desea actualizar.

  3. Elija Actualizar.

  4. En Revisión de la definición de tareas de daemon, seleccione la nueva revisión.

  5. (Opcional) Actualice los proveedores de capacidad o la configuración de implementación.

  6. Elija Actualizar para iniciar la implementación continua.

AWS CLI

Ejecute el comando update-daemon:

aws ecs update-daemon \
    --daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon \
    --daemon-task-definition-arn arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/my-daemon-task:2 \
    --capacity-provider-arns arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-daemon-capacity-provider
importante

Cuando proporciona los ajustes de configuración de daemon en una solicitud UpdateDaemon, Amazon ECS utiliza los ajustes especificados en lugar de los predeterminados. Los ajustes de configuración de daemon, incluidas las etiquetas y el indicador de comando “enable execute”, no se conservan entre las actualizaciones. Cada llamada a UpdateDaemon debe incluir el conjunto completo de ajustes de configuración que desee aplicar. Los ajustes omitidos en la solicitud vuelven a sus valores predeterminados.

Eliminación de un daemon

Para eliminar un daemon, utilice la Consola de administración de AWS o la AWS CLI. Espere a que se detengan todas las tareas del daemon antes de eliminar el proveedor de capacidad o el clúster.

Consola de administración de AWS

  1. Abra la consola de Amazon ECS. En el panel de navegación izquierdo, elija Clústeres y, a continuación, seleccione su clúster.

  2. Seleccione la pestaña Daemons y, a continuación, seleccione el daemon que desea eliminar.

  3. Elija Eliminar.

  4. En el cuadro de diálogo de confirmación, seleccione Eliminar para confirmar.

AWS CLI

Ejecute el comando delete-daemon:

aws ecs delete-daemon \
    --daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon