AWS-ECSRunTask - AWS Systems Manager Referência do runbook de automação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 para usar 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.