View a markdown version of this page

Criação e gerenciamento de daemons - Amazon Elastic Container Service
Pré-requisitosCriação de um daemonVerificar a implantação do daemonAtualização de um daemonExclusão de um daemon

Criação e gerenciamento de daemons

Depois de registrar uma definição de tarefa de daemon, crie um daemon para realizar a implantação dela nos provedores de capacidade do Amazon ECS Managed Instances. O Amazon ECS instala automaticamente uma tarefa de daemon em cada instância do Amazon EC2 nos provedores de capacidade associados e gerencia o ciclo de vida do daemon.

Pré-requisitos

Antes de criar um daemon, verifique se você possui o seguinte:

  • Um cluster do Amazon ECS.

  • Um ou mais provedores de capacidade de Instâncias Gerenciadas do Amazon ECS associados ao cluster.

  • Uma definição de tarefa de daemon registrada.

Criação de um daemon

Console de gerenciamento da AWS

  1. Abra o console do Amazon ECS. Na barra de navegação à esquerda, selecione Clusters e, em seguida, selecione o seu cluster.

  2. Escolha a guia Daemons e depois Criar.

  3. Em Família de definições de tarefas de daemon, selecione a definição da tarefa do daemon no menu suspenso.

  4. Em Revisão da definição da tarefa do daemon, selecione a revisão a ser usada. Deixe em branco para usar a versão mais recente.

  5. Em Nome do daemon, digite um nome exclusivo. O nome pode conter até 255 caracteres alfanuméricos, hífens e sublinhados.

  6. Em Provedores de capacidade: selecione um ou mais provedores de capacidade de Instâncias gerenciadas do Amazon ECS. Isso determina quais instâncias executam suas tarefas de daemon.

  7. (Opcional) Configure as opções de implantação:

    • Porcentagem de drenagem: porcentagem de instâncias a serem drenadas simultaneamente durante as atualizações. Padrão: 25.

    • Use alarmes do CloudWatch: ative para monitorar a integridade da implantação e reverter automaticamente se forem ativados gatilhos.

    • Tempo de incorporação: o número de minutos que o Amazon ECS aguarda após atualizar todas as instâncias para a nova versão do daemon antes de concluir a implantação. Durante esse período, o Amazon ECS monitora os alarmes do CloudWatch e reverte automaticamente a implantação caso algum alarme seja um gatilho. Padrão: 0.

  8. (Opcional) Adicione tags.

  9. (Opcional) Ative Habilitar ECS Exec para executar comandos interativos em seus contêineres de daemon para solucionar problemas.

  10. Verifique sua configuração e escolha Criar.

AWS CLI

Crie um arquivo JSON com a configuração do seu daemon e execute o comando create-daemon.

A seguir, um exemplo de arquivo 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"
    ]
}

Execute o seguinte comando para criar o daemon:

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

Campos obrigatórios

  • daemonName: um nome exclusivo para o daemon.

  • clusterArn: o ARN do cluster.

  • daemonTaskDefinitionArn: o ARN da definição da tarefa do daemon.

  • capacityProviderArns: uma matriz de ARNs de provedores de capacidade das instâncias gerenciadas do Amazon ECS.

Campos opcionais

  • deploymentConfiguration: um objeto DaemonDeploymentConfiguration para personalizar o comportamento da implantação.

  • tags: pares chave-valor para marcação.

  • propagateTags: configuração de propagação de etiquetas.

  • clientToken: um token de idempotência.

Verificar a implantação do daemon

Depois de criar um daemon, verifique seu status usando o Console de gerenciamento da AWS ou a AWS CLI.

Console de gerenciamento da AWS

  1. Abra o console do Amazon ECS. Na barra de navegação à esquerda, selecione Clusters e, em seguida, selecione o seu cluster.

  2. Escolha a guia Daemons.

  3. Verifique se seu daemon mostra o status Ativo.

  4. Escolha a guia Tarefas para confirmar se uma tarefa daemon é executada em cada instância do contêiner.

AWS CLI

Execute os seguintes comandos para verificar o status do 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

Atualização de um daemon

Para atualizar um daemon com uma nova revisão da definição de tarefa ou para adicionar provedores de capacidade, use o Console de gerenciamento da AWS ou a AWS CLI. Isso é um gatilho para uma implantação gradual em todas as instâncias.

Console de gerenciamento da AWS

  1. Abra o console do Amazon ECS. Na barra de navegação à esquerda, selecione Clusters e, em seguida, selecione o seu cluster.

  2. Escolha a guia Daemons e selecione o daemon que deseja atualizar.

  3. Selecione Atualizar.

  4. Em Revisão da definição da tarefa do daemon; selecione a nova revisão.

  5. (Opcional) Atualize os provedores de capacidade ou as configurações de implantação.

  6. Escolha Atualizar para iniciar a implantação contínua.

AWS CLI

Execute o 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

Quando você fornece configurações de daemon em uma solicitação UpdateDaemon, o Amazon ECS usa as configurações especificadas por você em vez das configurações padrão. As configurações do daemon, incluindo etiquetas e o sinalizador de comando de execução, não são mantidas entre as atualizações. Cada chamada para UpdateDaemon deve incluir o conjunto completo de configurações que você deseja aplicar. Quaisquer configurações omitidas na solicitação voltam aos seus valores padrão.

Exclusão de um daemon

Para excluir um daemon, use o Console de gerenciamento da AWS ou a AWS CLI. Aguarde até que todas as tarefas do daemon sejam encerradas antes de excluir o provedor de capacidade ou o cluster.

Console de gerenciamento da AWS

  1. Abra o console do Amazon ECS. Na barra de navegação à esquerda, selecione Clusters e, em seguida, selecione o seu cluster.

  2. Escolha a guia Daemons e selecione o daemon que deseja excluir.

  3. Escolha Excluir.

  4. Na caixa de diálogo de confirmação, selecione Excluir para confirmar.

AWS CLI

Execute o comando delete-daemon:

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