Modification d’un type d’instance Amazon EC2 à l’aide d’un script bash dans l’AWS CLI - AWS Command Line Interface
Avant de commencerÀ propos de cet exempleParamètresFichiersRéférences

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Modification d’un type d’instance Amazon EC2 à l’aide d’un script bash dans l’AWS CLI

Cet exemple de scripts bash pour Amazon EC2 modifie le type d’instance d’une instance Amazon EC2 à l’aide de l’AWS Command Line Interface (AWS CLI). Il arrête l’instance si elle est en cours d’exécution, modifie le type d’instance, puis, sur demande, redémarre l’instance. Les scripts Shell sont des programmes conçus pour être exécutés dans une interface de ligne de commande.

Note

Pour voir des exemples de commandes supplémentaires, consultez le Guide de référence de l’AWS CLI.

Avant de commencer

Avant de pouvoir exécuter l’un des exemples ci-dessous, vous devez respecter les conditions requises suivantes.

  • Installez et configurez l’AWS CLI. Pour plus d’informations, consultez Installation de la dernière version de l’AWS CLI ou mise à jour vers celle-ci et Authentification et informations d’identification d’accès pour l’ AWS CLI.

  • Le profil que vous utilisez doit disposer d’autorisations permettant les opérations AWS effectuées dans les exemples.

  • Une instance Amazon EC2 en cours d’exécution dans le compte pour lequel vous disposez des autorisations d’arrêt et de modification. Si vous exécutez le script de test, il lance une instance pour vous, teste la modification du type, puis résilie l’instance.

  • Une bonne pratique AWS consiste à accorder à ce code le moindre privilège ou uniquement les autorisations requises pour effectuer une tâche. Pour plus d’informations, consultez Octroi du moindre privilège dans le Guide de l’utilisateur AWS Identity and Access Management (IAM).

  • Ce code n’a pas été testé dans toutes les régions AWS. Certains services AWS sont disponibles uniquement dans certaines régions. Pour plus d’informations, consultez Points de terminaison et quotas de service dans le Guide de référence générale AWS.

  • L’exécution de ce code peut entraîner des frais sur votre compte AWS. Il est de votre responsabilité de vous assurer que toutes les ressources créées par ce script sont supprimées lorsque vous en avez fini avec elles.

À propos de cet exemple

Cet exemple est écrit sous forme de fonction dans le fichier de script shell change_ec2_instance_type.sh que vous pouvez obtenir comme source à partir d’un autre script ou de la ligne de commande. Chaque fichier de script contient des commentaires décrivant chacune des fonctions. Une fois la fonction en mémoire, vous pouvez l’invoquer à partir de la ligne de commande. Par exemple, les commandes suivantes remplacent le type de l’instance spécifiée par t2.nano :

$ source ./change_ec2_instance_type.sh
$ ./change_ec2_instance_type -i *instance-id* -t new-type

Pour obtenir l’exemple complet et les fichiers de script téléchargeables, consultez Change Amazon EC2 Instance Type dans le Référentiel d’exemples de code AWS sur GitHub.

Paramètres

-i : (chaîne) spécifie l’ID d’instance à modifier.

-t : (chaîne) spécifie le type d’instance Amazon EC2 vers lequel basculer.

-r : (commutateur) par défaut, ce paramètre n’est pas défini. Si -r est défini, redémarre l’instance après le basculement de type.

-f : (commutateur) par défaut, le script invite l’utilisateur à confirmer l’arrêt de l’instance avant de procéder au basculement. Si -f est défini, la fonction n’invite pas l’utilisateur avant d’arrêter l’instance pour effectuer le basculement de type

-v : (commutateur) par défaut, le script fonctionne en mode silencieux et affiche le résultat uniquement en cas d’erreur. Si -v est défini, la fonction affiche l’état tout au long de son fonctionnement.

Fichiers

change_ec2_instance_type.sh

Le fichier de script principal contient la fonction change_ec2_instance_type() qui effectue les tâches suivantes :

  • Vérifie que l’instance Amazon EC2 spécifiée existe.

  • À moins que -f ne soit sélectionné, avertit l’utilisateur avant d’arrêter l’instance.

  • Modifie le type d’instance

  • Si vous définissez -r, redémarre l’instance et confirme qu’elle est en cours d’exécution

Consultez le code pour change_ec2_instance_type.sh sur GitHub.

test_change_ec2_instance_type.sh

Le script test_change_ec2_instance_type.sh de fichier teste les différents chemins de code de la fonction change_ec2_instance_type. Si toutes les étapes du script de test fonctionnent correctement, le script de test supprime toutes les ressources qu’il a créées.

Vous pouvez exécuter le script à l’aide des paramètres suivants :

  • -v : (commutateur) chaque test affiche un statut de réussite/d’échec au fur et à mesure de son exécution. Par défaut, les tests s’exécutent en mode silencieux et le résultat inclut uniquement le statut global final de réussite/d’échec.

  • -i : (commutateur) le script s’arrête après chaque test pour vous permettre de parcourir les résultats intermédiaires de chaque étape. Vous permet d’examiner l’état actuel de l’instance à l’aide de la console Amazon EC2. Le script passe à l’étape suivante une fois que vous avez appuyé sur ENTRÉE à l’invite.

Consultez le code pour test_change_ec2_instance_type.sh sur GitHub.

awsdocs_general.sh

Le fichier de script awsdocs_general.sh contient les fonctions générales utilisées dans les exemples avancés de l’AWS CLI.

Consultez le code pour awsdocs_general.sh sur GitHub.

Références

Référence de l’AWS CLI :

Autre référence :