ECS Service

9 min

Resumo

Cria ou encerra serviços ECS.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
cluster	string		Nome do cluster no qual o serviço existe.
name - required	string		Nome do serviço.
state - required	string	Escolhas: - present - absent - deleting	Estado desejado do serviço.
task_definition	string		A definição de tarefa que o serviço executará. Este parâmetro é necessário quando (state=present).
load_balancers	list / elements=dict		A lista de ELBs definidos para este serviço.
desired_count	integer		A contagem de quantas instâncias do serviço. Este parâmetro é necessário quando (state=present).
client_token	string		Identificador exclusivo que diferencia maiúsculas de minúsculas que você fornece para garantir a idempotência da solicitação. São permitidos até 32 caracteres ASCII.
role	string		Nome ou (ARN) de recurso completo da Amazon da função do IAM, que permite que o agente de contêiner do Amazon ECS faça chamadas para o load balancerem seu nome. Esse parâmetro só é necessário se você estiver usando um balanceador de carga com seu serviço em um modo de rede diferente de (awsvpc).
delay	integer	10 (default)	Tempo de espera antes de verificar se o serviço está disponível.
repeat	integer	10 (default)	Número de vezes para verificar se o serviço está disponível.
force_new_deployment	boolean	Escolhas: - false (default) - true	Força a implantação do serviço mesmo que não haja alterações.
deployment_configuration (Possíveis valores)	dictionary		Parâmetros opcionais que controlam o deployment_configuration. O formato é:{"maximum_percent":<inteiro>, "minimum_healthy_percent":<inteiro>}.
placement_constraints (Possíveis valores)	list / elements=dict		As restrições de posicionamento para as tarefas no serviço. Consulte:(https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PlacementConstraint.html) para obter mais detalhes.
placement_strategy (Possíveis valores)	list / elements=dict			Os objetos de estratégia de posicionamento a serem usados para tarefas em seu serviço. Você pode especificar no máximo 5 regras de estratégia por serviço.
force_deletion	boolean	Escolhas: - false (default) - true	Exclua forçadamente o serviço. Necessário ao excluir um serviço com escala > 0 ou sem grupo de destino.
network_configuration (Possíveis valores)	dictionary		Configuração de rede do serviço. Aplicável apenas para definições de tarefas criadas com (network_mode=awsvpc).
launch_type	string	Escolhas: - EC2 - FARGATE	Tipo de inicialização no qual executar seu serviço.
platform_version	string		Parte numérica da versão da plataforma ou LATEST. Consulte: (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html) para obter mais detalhes.
health_check_grace_period_seconds	integer		Segundos para aguardar antes da verificação de integridade dos serviços recém-adicionados/atualizados.
service_registries (Possíveis valores)	list / elements=dict		Descreve os registros de descoberta de serviço com os quais este serviço se registrará.
scheduling_strategy	string	Escolhas: - DAEMON - REPLICA	A estratégia de agendamento. O padrão é (REPLICA) se não for fornecido para preservar o comportamento anterior.

Subcampos da opção deployment_configuration

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
maximum_percent	integer		Limite superior do número de tarefas em um serviço que são permitidas no estado RUNNING ou PENDING durante uma implantação.
minimum_healthy_percent	integer		Um limite inferior no número de tarefas em um serviço que devem permanecer no estado RUNNING durante uma implantação.

Subcampos da opção placement_constraints

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
type	string		Tipo de restrição.
expression	string		Uma expressão de linguagem de consulta de cluster para aplicar à restrição.

Subcampos da opção placement_strategy

Parâmetro	Tipo	Escolhas \| Valor Padrão		Comentários
type	string		Tipo de estratégia.
field	string		Campo para aplicar a estratégia de posicionamento.

Subcampos da opção network_configuration

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
subnets	list / elements=string		Uma lista de IDs de sub-rede para associar à tarefa.
security_groups	list / elements=string			Uma lista de nomes de grupos de segurança ou IDs de grupos para associar à tarefa.
assign_public_ip	boolean	Escolhas: - false (default) - true	Se a interface de rede elástica da tarefa recebe um endereço IP público.

Subcampos da opção service_registries

Parâmetro	Tipo	Comentários
container_name	string	Nome do contêiner para registro de descoberta de serviço.
container_port	integer	Porta de contêiner para registro de descoberta de serviço.
arn	string	ARN do registro de descoberta de serviço.

Exemplos

# Note: Esses exemplos não definem detalhes de autenticação, consulte o guia AWS para obter detalhes.

# Exemplo de provisionamento básico
- ecs_service:
    state: present
    name: console-test-service
    cluster: new_cluster
    task_definition: 'new_cluster-task:1'
    desired_count: 0

# Exemplo: Criar serviço ECS na rede VPC
- ecs_service:
    state: present
    name: console-test-service
    cluster: new_cluster
    task_definition: 'new_cluster-task:1'
    desired_count: 0
    network_configuration:
      subnets:
      - subnet-abcd1234
      security_groups:
      - sg-aaaa1111
      - my_security_group

# Exemplo simples para excluir
- ecs_service:
    name: default
    state: absent
    cluster: new_cluster

# Exemplo: Criar serviço com configuração de implantação personalizada, restrições de posicionamento e estratégia.
- ecs_service:
    state: present
    name: test-service
    cluster: test-cluster
    task_definition: test-task-definition
    desired_count: 3
    deployment_configuration:
      minimum_healthy_percent: 75
      maximum_percent: 150
    placement_constraints:
      - type: memberOf
        expression: 'attribute:flavor==test'
    placement_strategy:
      - type: binpack
        field: memory

Valores retornados

Chave	Tipo	Retornado quando	Descrição
service	complex	when creating a service	Detalhes do serviço criado.
atmosphere_facts	complex	when deleting a service	Fatos sobre o serviço excluído.