Exemplos para trabalhar com o Elastic Load Balancing usando o AWS CLI

Use o AWS Command Line Interface (AWS CLI) para anexar, separar e descrever balanceadores de carga e grupos-alvo, adicionar e remover verificações de saúde do Elastic Load Balancing e alterar quais zonas de disponibilidade estão habilitadas.

Este tópico mostra exemplos de AWS CLI comandos que realizam tarefas comuns para o Amazon EC2 Auto Scaling.

Anexar seu grupo-alvo ou Classic Load Balancer

Use o create-auto-scaling-groupcomando a seguir para criar um grupo de Auto Scaling e anexar simultaneamente um grupo-alvo especificando seu Amazon Resource Name (). ARN O grupo de destino pode ser associado a um Application Load Balancer, um Network Load Balancer ou um balanceador de carga do Gateway.

Substitua os valores de amostra por,--auto-scaling-group-name,--vpc-zone-identifier --min-size e --max-size. Para a opção,--launch-template substitua my-launch-template e 1 pelo nome e versão de um modelo de execução para seu grupo do Auto Scaling. Para a --traffic-sources opção, substitua a amostra ARN pela ARN de um grupo-alvo para um Application Load Balancer, Network Load Balancer ou Gateway Load Balancer.

aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg \
  --launch-template LaunchTemplateName=my-launch-template,Version='1' \
  --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" \
  --min-size 1 --max-size 5 \
  --traffic-sources "Identifier=arn:aws:elasticloadbalancing:region:account-id:targetgroup/my-targets/12345678EXAMPLE1"

Use o attach-traffic-sourcescomando para anexar outros grupos-alvo ao grupo Auto Scaling depois que ele for criado.

O comando a seguir adiciona outro grupo-alvo ao mesmo grupo.

aws autoscaling attach-traffic-sources --auto-scaling-group-name my-asg \
  --traffic-sources "Identifier=arn:aws:elasticloadbalancing:region:account-id:targetgroup/my-targets/12345678EXAMPLE2"

Como alternativa, para anexar um Classic Load Balancer ao seu grupo, especifique as opções --traffic-sources e --type ao usar create-auto-scaling-group ou,attach-traffic-sources como no exemplo a seguir. Substitua my-classic-load-balancer pelo nome de um Classic Load Balancer. Para a opção,--type especifique um valor de elb.

--traffic-sources "Identifier=my-classic-load-balancer" --type elb

Descreva seus grupos de destino ou Classic Load Balancers

Para descrever os balanceadores de carga ou os grupos-alvo vinculados ao seu grupo de Auto Scaling, use o comando a describe-traffic-sourcesseguir. Substitua my-asg pelo nome do seu grupo.

aws autoscaling describe-traffic-sources --auto-scaling-group-name my-asg

O exemplo retorna os grupos-alvo ARN do Elastic Load Balancing que você anexou ao grupo Auto Scaling.

{
    "TrafficSources": [
        {
            "Identifier": "arn:aws:elasticloadbalancing:region:account-id:targetgroup/my-targets/12345678EXAMPLE1",
            "State": "InService",
            "Type": "elbv2"
        },
        {
            "Identifier": "arn:aws:elasticloadbalancing:region:account-id:targetgroup/my-targets/12345678EXAMPLE2",
            "State": "InService",
            "Type": "elbv2"
        }
    ]
}

Para ver uma explicação do campo State na saída, consulte Verificar o status do anexo de seu balanceador de carga.

Adicionar verificações de integridade do Elastic Load Balancing

Para adicionar as verificações de saúde do Elastic Load Balancing às verificações de saúde que seu grupo de Auto Scaling realiza nas instâncias, use o comando a update-auto-scaling-groupseguir e ELB especifique como o valor da opção. --health-check-type Substitua my-asg pelo nome do seu grupo.

aws autoscaling update-auto-scaling-group --auto-scaling-group-name my-asg \
  --health-check-type "ELB"

As novas instâncias geralmente precisam de tempo para um breve aquecimento antes de passarem por uma verificação de integridade. Se o período de carência não proporcionar tempo de aquecimento suficiente, as instâncias poderão não parecer prontas para servir tráfego. O Amazon EC2 Auto Scaling pode considerar essas instâncias insalubres e substituí-las.

Para atualizar o período de carência da verificação de integridade, use a opção --health-check-grace-period ao usar,update-auto-scaling-group como no exemplo a seguir. 300Substitua pelo número de segundos para manter as novas instâncias em serviço antes de encerrá-las, caso não estejam íntegras.

--health-check-grace-period 300

Para obter mais informações, consulte Verificações de integridade para instâncias em um grupo do Auto Scaling.

Alterar suas zonas de disponibilidade

Alterar suas zonas de disponibilidade apresenta algumas limitações das quais você deve estar ciente. Para obter mais informações, consulte Adicione uma Zona de disponibilidade.

Desvincular seu grupo-alvo ou Classic Load Balancer

O detach-traffic-sourcescomando a seguir separa um grupo-alvo do seu grupo de Auto Scaling quando você não precisar mais dele.

Para a opção,--auto-scaling-group-name substitua my-asg pelo nome do seu grupo. Para a --traffic-sources opção, substitua a amostra ARN pela ARN de um grupo-alvo para um Application Load Balancer, Network Load Balancer ou Gateway Load Balancer.

aws autoscaling detach-traffic-sources --auto-scaling-group-name my-asg \
  --traffic-sources "Identifier=arn:aws:elasticloadbalancing:region:account-id:targetgroup/my-targets/1234567890123456"

Para desvincular um Classic Load Balancer do seu grupo, especifique as opções --traffic-sources e,--type como no exemplo a seguir. Substitua my-classic-load-balancer pelo nome de um Classic Load Balancer. Para a opção,--type especifique um valor de elb.

--traffic-sources "Identifier=my-classic-load-balancer" --type elb

Remover as verificações de integridade do Elastic Load Balancing

Para remover as verificações de saúde do Elastic Load Balancing do seu grupo de Auto Scaling, use o comando a update-auto-scaling-groupseguir e EC2 especifique como o valor da opção. --health-check-type Substitua my-asg pelo nome do seu grupo.

aws autoscaling update-auto-scaling-group --auto-scaling-group-name my-asg \
  --health-check-type "EC2"

Para obter mais informações, consulte Verificações de integridade para instâncias em um grupo do Auto Scaling.

Comandos legados

Os exemplos a seguir mostram como você pode usar CLI comandos legados para anexar, separar e descrever balanceadores de carga e grupos-alvo. Eles permanecem neste documento como referência para todos os clientes que desejam usá-los. Continuamos oferecendo suporte aos CLI comandos antigos, mas recomendamos que você use os novos CLI comandos “fontes de tráfego”, que podem anexar e separar vários tipos de fontes de tráfego. Você pode usar os CLI comandos legados e os comandos “fontes de tráfego” CLI no mesmo grupo do Auto Scaling.

aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg \
  --launch-template LaunchTemplateName=my-launch-template,Version='1' \
  --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" \
  --target-group-arns "arn:aws:elasticloadbalancing:region:account-id:targetgroup/my-targets/1234567890123456" \
  --min-size 1 --max-size 5

aws autoscaling attach-load-balancer-target-groups --auto-scaling-group-name my-asg \
  --target-group-arns "arn:aws:elasticloadbalancing:region:account-id:targetgroup/my-targets/1234567890123456"

aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg \
  --launch-configuration-name my-launch-config \
  --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" \
  --load-balancer-names "my-load-balancer" \
  --min-size 1 --max-size 5

aws autoscaling attach-load-balancers --auto-scaling-group-name my-asg \
  --load-balancer-names my-lb

aws autoscaling describe-load-balancer-target-groups --auto-scaling-group-name my-asg

aws autoscaling describe-load-balancers --auto-scaling-group-name my-asg

aws autoscaling detach-load-balancer-target-groups --auto-scaling-group-name my-asg \
  --target-group-arns "arn:aws:elasticloadbalancing:region:account-id:targetgroup/my-targets/1234567890123456"

aws autoscaling detach-load-balancers --auto-scaling-group-name my-asg \
  --load-balancer-names my-lb