Installation ou mise à jour Distributor packages

Pour installer ou mettre à jour un package une seule fois à l'aide de la console

1. Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

2. Dans le volet de navigation, choisissez Distributor.

3. Sur le Distributor page d'accueil, choisissez le package que vous souhaitez installer.

4. Sélectionnez Installer une fois.

   Cette commande s'ouvre Run Command avec le document de commande AWS-ConfigureAWSPackage et votre Distributor package déjà sélectionné.

5. Pour Document version (Version du document), sélectionnez la version du document AWS-ConfigureAWSPackage à exécuter.

6. Pour Actions, sélectionnez Installer.

7. Pour Installation type (Type d'installation), sélectionnez l'une des valeurs suivantes :

   • Uninstall and reinstall (Désinstaller et réinstaller) : le package est complètement désinstallé, puis réinstallé. L'application n'est pas disponible tant que la réinstallation n'est pas terminée.

   • In-place update (Mise à jour sur place) : seuls les fichiers nouveaux ou modifiés sont ajoutés à l'installation existante, conformément aux instructions que vous fournissez dans un script update. L'application reste disponible tout au long du processus de mise à jour. Cette option n'est pas prise en charge pour les packages AWS publiés, à l'exception AWSEC2Launch-Agent du package.

8. Pour Name (Nom), vérifiez que le nom du package sélectionné est entré.

9. Pour Version, entrez la valeur du nom de version du package. Si vous laissez ce champ vide, Run Command installe la version par défaut que vous avez sélectionnée dans Distributor.

10. Dans la section Targets (Cibles), sélectionnez les nœuds gérés sur lesquels vous souhaitez exécuter cette opération en spécifiant des balises, en sélectionnant des instances ou des appareils manuellement, ou en spécifiant un groupe de ressources.

    Note

    Si un nœud géré ne figure pas dans la liste, consultez Résolution des problèmes de disponibilité des nœuds gérés.

11. Pour Autres paramètres :

    • Pour Comment (Commentaire), saisissez des informations à propos de cette commande.

    • Pour Délai (secondes), précisez le nombre de secondes durant lesquelles le système doit attendre avant de mettre en échec l'exécution de la commande globale.

12. Dans Rate Control (Contrôle de débit) :

    • Dans Concurrency (Simultanéité), spécifiez un nombre ou un pourcentage de cibles sur lesquelles exécuter simultanément la commande.

      Note

      Si vous avez sélectionné des cibles en spécifiant des balises ou des groupes de ressources et que vous n'êtes pas certain du nombre de nœuds gérés ciblés, limitez le nombre de cibles autorisées à exécuter simultanément le document en indiquant un pourcentage.

    • Dans Error threshold (Seuil d'erreur), indiquez quand arrêter l'exécution de la commande sur les autres cibles après l'échec de celle-ci sur un certain nombre ou un certain pourcentage de nœuds gérés. Si, par exemple, vous spécifiez trois erreurs, Systems Manager cesse d'envoyer la commande à la réception de la quatrième erreur. Les nœuds gérés sur lesquels la commande est toujours en cours de traitement peuvent également envoyer des erreurs.

13. (Facultatif) Pour Output options (Options de sortie), pour enregistrer la sortie de la commande dans un fichier, cochez la case Write command output to an S3 bucket (Écrire la sortie de commande vers un compartiment S3). Saisissez les noms de compartiment et de préfixe (dossier) dans les zones.

    Note

    Les autorisations S3 qui permettent d'écrire les données dans un compartiment S3 sont celles du profil d'instance (pour les EC2 instances) ou du rôle de IAM service (machines activées par des hybrides) attribué à l'instance, et non celles de l'IAMutilisateur effectuant cette tâche. Pour plus d'informations, consultez Configurer les autorisations d'instance requises pour Systems Manager ou Créer un rôle de IAM service pour un environnement hybride. En outre, si le compartiment S3 spécifié se trouve dans un autre compartiment Compte AWS, assurez-vous que le profil d'instance ou le rôle de IAM service associé au nœud géré dispose des autorisations nécessaires pour écrire dans ce compartiment.

14. Dans la section SNSdes notifications, si vous souhaitez que des notifications soient envoyées concernant le statut de l'exécution de la commande, cochez la case Activer SNS les notifications.

    Pour plus d'informations sur la configuration des SNS notifications Amazon pour Run Command, voir Surveillance des changements de statut du Systems Manager à l'aide SNS des notifications Amazon.

15. Lorsque vous êtes prêt à installer le package, sélectionnez Run (Exécuter).

16. La zone Command status (État de la commande) indique la progression de l'exécution. Si la commande est toujours en cours, sélectionnez l'icône d'actualisation dans l'angle supérieur gauche de la console jusqu'à ce que la colonne Overall status (État général) ou Detailed status (État détaillé) affiche Success (Succès) ou Failure (Échec).

17. Dans la zone Targets and outputs (Cibles et sorties), cliquez sur le bouton situé en regard d'un nom de nœud géré, puis sélectionnez View output (Afficher la sortie).

    La page de sortie de la commande illustre les résultats de l'exécution de votre commande.

18. (Facultatif) Si vous avez choisi d'écrire la sortie de commande dans un compartiment Amazon S3, sélectionnez Amazon S3 pour afficher les données du journal de sortie.

Pour planifier l'installation d'un package à l'aide de la console

1. Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

2. Dans le volet de navigation, choisissez Distributor.

3. Sur le Distributor page d'accueil, choisissez le package que vous souhaitez installer ou mettre à jour.

4. Pour Package, sélectionnez Install on a schedule (Installation planifiée).

   Cette commande s'ouvre State Manager à une nouvelle association créée pour vous.

5. Pour Name (Nom), saisissez un nom (par exemple, Deploy-test-agent-package). Cette action est facultative, mais recommandée. Les espaces ne sont pas autorisés dans le nom.

6. Dans la liste Document, le nom du document AWS-ConfigureAWSPackage est déjà sélectionné.

7. Pour Action, vérifiez que Installer est sélectionné.

8. Pour Installation type (Type d'installation), sélectionnez l'une des valeurs suivantes :

   • Uninstall and reinstall (Désinstaller et réinstaller) : le package est complètement désinstallé, puis réinstallé. L'application n'est pas disponible tant que la réinstallation n'est pas terminée.

   • In-place update (Mise à jour sur place) : seuls les fichiers nouveaux ou modifiés sont ajoutés à l'installation existante, conformément aux instructions que vous fournissez dans un script update. L'application reste disponible tout au long du processus de mise à jour.

9. Pour Name (Nom), vérifiez que le nom de votre package est entré.

10. Pour Version, si vous souhaitez installer une version de package autre que la dernière version publiée, entrez l'identificateur de version.

11. Pour Targets (Cibles), sélectionnez Selecting all managed instances in this account (Sélection de toutes les instances gérées dans ce compte), Specifying tags (Spécification des balises) ou Manually Selecting Instance (Sélection manuelle des instances). Si vous choisissez de cibler des ressources à l'aide de balises, entrez une clé de balise et une valeur de balise dans les champs fournis.

    Note

    Vous pouvez choisir les appareils AWS IoT Greengrass principaux gérés en choisissant soit Sélection de toutes les instances gérées dans ce compte, soit Sélection manuelle de l'instance.

12. Pour Specify schedule (Spécifier le calendrier), sélectionnez On Schedule (Selon le calendrier) pour exécuter l'association selon une planification régulière ou No Schedule (Pas de calendrier) pour exécuter l'association une seule fois. Pour plus d'informations sur ces options, consultez Utilisation d'associations dans Systems Manager. Utilisez les contrôles pour créer un calendrier de type cron ou rate pour l'association.

13. Sélectionnez Create Association (Créer une association).

14. Sur la page Association cliquez sur le bouton en regard de l'association que vous avez créée, puis sélectionnez Apply association now (Appliquer l'association maintenant).

    State Manager crée et exécute immédiatement l'association sur les cibles spécifiées. Pour de plus amples informations sur les résultats de l'exécution des associations, consultez Utilisation d'associations dans Systems Manager dans ce guide.

Pour installer un package une seule fois à l'aide du AWS CLI

• Exécutez la commande suivante dans l' AWS CLI :

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "instance-IDs" \
      --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'

  Note

  Le comportement par défaut pour installationType est Uninstall and reinstall. Vous pouvez omettre "installationType":["Uninstall and reinstall"] de cette commande lorsque vous installez un package complet.

  Voici un exemple.

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "i-00000000000000" \
      --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["ExamplePackage"]}'

Pour mettre à jour un package une seule fois à l'aide du AWS CLI

• Exécutez la commande suivante dans l' AWS CLI :

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "instance-IDs" \
      --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'

  Note

  Lorsque vous ajoutez des fichiers nouveaux ou modifiés, vous devez inclure "installationType":["In-place update"] dans la commande.

  Voici un exemple.

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "i-02573cafcfEXAMPLE" \
      --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["ExamplePackage"]}'