Exemples d'utilisation d'Elastic Load Balancing à l'aide du AWS CLI

Utilisez le AWS Command Line Interface (AWS CLI) pour attacher, détacher et décrire les équilibreurs de charge et les groupes cibles, ajouter et supprimer les tests de santé d'Elastic Load Balancing et modifier les zones de disponibilité activées.

Cette rubrique présente des exemples de AWS CLI commandes qui exécutent des tâches courantes pour Amazon EC2 Auto Scaling.

Attachez votre groupe cible ou votre équilibreur Classic Load Balancer

Utilisez la create-auto-scaling-groupcommande suivante pour créer un groupe Auto Scaling et associer simultanément un groupe cible en spécifiant son Amazon Resource Name (ARN). Le groupe cible peut être associé à un équilibreur Application Load Balancer, un équilibreur Network Load Balancer ou un équilibreur Gateway Load Balancer.

Remplacez les valeurs d’exemple de --auto-scaling-group-name, --vpc-zone-identifier, --min-size, et --max-size. Pour l’option --launch-template, remplacez my-launch-template et 1 par le nom et la version d’un modèle de lancement de votre groupe Auto Scaling. Pour --traffic-sources cette option, remplacez l'exemple ARN par celui ARN d'un groupe cible pour un Application Load Balancer, un Network Load Balancer ou un 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"

Utilisez la attach-traffic-sourcescommande pour associer des groupes cibles supplémentaires au groupe Auto Scaling une fois celui-ci créé.

La commande suivante ajoute un autre groupe cible au même groupe.

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

Vous pouvez également attacher un équilibreur Classic Load Balancer à votre groupe. Renseignez les options --traffic-sources et --type lorsque vous utilisez create-auto-scaling-group ou attach-traffic-sources, comme dans l’exemple suivant. Remplacez my-classic-load-balancer par le nom d’un équilibreur Classic Load Balancer. Pour l’option --type, indiquez une valeur de elb.

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

Décrivez vos groupes cibles ou vos équilibreurs Classic Load Balancer

Pour décrire les équilibreurs de charge ou les groupes cibles attachés à votre groupe Auto Scaling, utilisez la describe-traffic-sourcescommande suivante. Remplacez my-asg par le nom de votre groupe.

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

L'exemple renvoie les ARN groupes cibles Elastic Load Balancing que vous avez attachés au groupe 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"
        }
    ]
}

Pour en savoir plus sur le champ State de la sortie, consultez Vérifier l’état d’attachement de votre équilibreur de charge.

Ajouter des surveillances d'état Elastic Load Balancing

Pour ajouter les contrôles de santé d'Elastic Load Balancing aux contrôles de santé effectués par votre groupe Auto Scaling sur les instances, utilisez la update-auto-scaling-groupcommande suivante et spécifiez ELB la valeur de l'--health-check-typeoption. Remplacez my-asg par le nom de votre groupe.

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

Les nouvelles instances ont souvent besoin de temps pour un bref échauffement avant de pouvoir passer un bilan de santé. Si le délai de grâce ne fournit pas un temps de préchauffage suffisant, les instances peuvent ne pas sembler prêtes à traiter le trafic. Amazon EC2 Auto Scaling peut considérer que ces instances ne sont pas saines et les remplacer.

Pour mettre à jour la période de grâce de la surveillance de l’état, utilisez l’option --health-check-grace-period lorsque vous utilisez update-auto-scaling-group, comme dans l’exemple suivant. Remplacez 300 par le nombre de secondes nécessaires pour maintenir les nouvelles instances en service avant de les mettre hors service si elles s'avèrent défectueuses.

--health-check-grace-period 300

Pour de plus amples informations, veuillez consulter Surveillance de l’état des instances dans un groupe Auto Scaling.

Modifier vos zones de disponibilité

La modification de vos zones de disponibilité présente des limites que vous devez connaître. Pour de plus amples informations, veuillez consulter Ajouter une zone de disponibilité.

Détachez votre groupe cible ou votre équilibreur Classic Load Balancer

La detach-traffic-sourcescommande suivante détache un groupe cible de votre groupe Auto Scaling lorsque vous n'en avez plus besoin.

Pour l’option --auto-scaling-group-name, remplacez my-asg par le nom de votre groupe. Pour --traffic-sources cette option, remplacez l'exemple ARN par celui ARN d'un groupe cible pour un Application Load Balancer, un Network Load Balancer ou un 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"

Pour détacher un équilibreur Classic Load Balancer de votre groupe, renseignez les options --traffic-sources et --type, comme dans l’exemple suivant. Remplacez my-classic-load-balancer par le nom d’un équilibreur Classic Load Balancer. Pour l’option --type, indiquez une valeur de elb.

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

Supprimer les surveillances de l’état Elastic Load Balancing

Pour supprimer les tests de santé d'Elastic Load Balancing de votre groupe Auto Scaling, utilisez la update-auto-scaling-groupcommande suivante et spécifiez EC2 la valeur de l'--health-check-typeoption. Remplacez my-asg par le nom de votre groupe.

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

Pour de plus amples informations, veuillez consulter Surveillance de l’état des instances dans un groupe Auto Scaling.

Anciennes commandes

Les exemples suivants montrent comment utiliser CLI les anciennes commandes pour attacher, détacher et décrire les équilibreurs de charge et les groupes cibles. Ils servent de référence pour les clients qui souhaitent les utiliser. Nous continuons à prendre en charge les anciennes CLI commandes, mais nous vous recommandons d'utiliser les nouvelles CLI commandes « sources de trafic », qui peuvent associer et détacher plusieurs types de sources de trafic. Vous pouvez utiliser à la fois CLI les anciennes commandes et les CLI commandes « sources de trafic » dans le même groupe 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