AWS-ECSRunTask

Descrição

O AWS-ECSRunTask runbook executa a tarefa do Amazon Elastic Container Service (AmazonECS) especificada por você.

Executar esta automação (console)

Tipo de documento

Automação

Proprietário

Amazon

Plataformas

Linux

Parâmetros

• AutomationAssumeRole

  Tipo: string

  Descrição: (Opcional) O Amazon Resource Name (ARN) da função AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation execute as ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.

• capacityProviderStrategy

  Tipo: string

  Descrição: (Opcional) A estratégia do provedor de capacidade a ser usada para a tarefa.

• cluster

  Tipo: string

  Descrição: (Opcional) O nome abreviado ou ARN do cluster no qual executar sua tarefa. Se você não especificar um cluster, o cluster padrão será usado.

• contagem

  Tipo: string

  Descrição: (Opcional) O número de instanciações da tarefa especificada a serem colocadas em seu cluster. Você pode especificar até 10 tarefas para cada solicitação.

• enableECSManagedEtiquetas

  Tipo: booliano

  Descrição: (Opcional) Especifica se as tags ECS gerenciadas pela Amazon devem ser usadas para a tarefa. Para obter mais informações, consulte Como marcar seus ECS recursos da Amazon no Guia do desenvolvedor do Amazon Elastic Container Service.

• enableExecuteCommand

  Tipo: booliano

  Descrição: (Opcional) Determina se a funcionalidade de execução do comando deve ser ativada para os contêineres nessa tarefa. Se verdadeiro, isso ativa a funcionalidade de execução do comando em todos os contêineres da tarefa.

• group

  Tipo: string

  Descrição: (Opcional) O nome do grupo de tarefas a ser associado à tarefa. O valor padrão é o nome da família da definição da tarefa. Por exemplo, family:my-family-name.

• launchType

  Tipo: string

  Valores válidos: EC2 | FARGATE | EXTERNAL

  Descrição: (Opcional) A infraestrutura na qual executar sua tarefa autônoma.

• networkConfiguration

  Tipo: string

  Descrição: (Opcional) A configuração de rede para a tarefa. Esse parâmetro é necessário para definições de tarefas que usam o modo de awsvpc rede para receber sua própria interface de rede elástica e não é compatível com outros modos de rede.

• substituições

  Tipo: string

  Descrição: (Opcional) Uma lista de substituições de contêiner em JSON formato que especifica o nome de um contêiner na definição de tarefa especificada e as substituições que ele deve receber. Você pode substituir o comando padrão de um contêiner especificado na definição da tarefa ou na imagem do Docker com uma substituição de comando. Você também pode substituir as variáveis de ambiente existentes que são especificadas na definição da tarefa ou na imagem do Docker em um contêiner. Além disso, você pode adicionar novas variáveis de ambiente com uma substituição de ambiente.

• placementConstraints

  Tipo: string

  Descrição: (Opcional) Uma matriz de objetos de restrição de posicionamento a serem usados na tarefa. Você pode especificar até 10 restrições para cada tarefa, incluindo restrições na definição da tarefa e aquelas especificadas em tempo de execução.

• placementStrategy

  Tipo: string

  Descrição: (Opcional) Os objetos da estratégia de posicionamento a serem usados na tarefa. Você pode especificar no máximo 5 regras de estratégia para cada tarefa.

• platformVersion

  Tipo: string

  Descrição: (Opcional) A versão da plataforma que a tarefa usa. Uma versão da plataforma é especificada somente para tarefas hospedadas no Fargate. Se não for especificada uma versão da plataforma, a versão da plataforma LATEST será usada.

• propagateTags

  Tipo: string

  Descrição: (Opcional) Determina se as tags se propagam da definição da tarefa para a tarefa. Se nenhum valor for especificado, as tags não serão propagadas. As tags só podem ser propagadas para a tarefa durante sua criação.

• referenceId

  Tipo: string

  Descrição: (Opcional) O ID de referência a ser usado para a tarefa. O ID de referência pode ter um tamanho máximo de 1024 caracteres.

• startedBy

  Tipo: string

  Descrição: (Opcional) Uma tag opcional especificada quando uma tarefa é iniciada. Isso ajuda você a identificar quais tarefas pertencem a um trabalho específico filtrando os resultados de uma ListTasks API operação. São permitidos até 36 letras (maiúsculas e minúsculas), números, hífens (-) e sublinhados (_).

• tags

  Tipo: string

  Descrição: (Opcional) Metadados que você deseja aplicar à tarefa para ajudá-lo a categorizar e organizar tarefas. Cada tag consiste em uma chave e um valor definidos pelo usuário.

• taskDefinition

  Tipo: string

  Descrição: (Opcional) O family e revision (family:revision) ou completo ARN da definição da tarefa a ser executada. Se uma revisão não for especificada, a ACTIVE revisão mais recente será usada.

IAMPermissões necessárias

O parâmetro AutomationAssumeRole requer as seguintes ações para usar o runbook com êxito.

• ecs:RunTask

Etapas do documento

aws:executeScript- Executa a ECS tarefa da Amazon com base nos valores que você especifica para os parâmetros de entrada do runbook.