(Facultatif) Installer le Session Manager plugin pour l'AWS CLI - AWS Systems Manager

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.

(Facultatif) Installer le Session Manager plugin pour l'AWS CLI

Si vous souhaitez utiliser l' AWS Command Line Interface (AWS CLI) pour démarrer et mettre fin aux sessions qui vous connectent à vos instances gérées, vous devez d'abord installer l' Session Manager plugin sur votre ordinateur local. Le plug-in peut être installé sur les versions prises en charge de Microsoft Windows, , macOSLinux et Ubuntu Server.

Utiliser la dernière version de l' Session Manager plugin

Session Manager plugin est mis à jour occasionnellement avec des fonctionnalités améliorées. Nous vous recommandons de vous assurer régulièrement que vous utilisez la dernière version du plug-in. Pour plus d'informations, consultez Session Manager pluginDernière version et historique des versions .

Prérequis d'installation

L'AWS CLI version 1.16.12 ou ultérieure doit être installée sur votre ordinateur local pour pouvoir utiliser le Session Manager plugin.

Installation de l'Session Manager plugin sur Windows

Vous pouvez installer le Session Manager plugin sur Microsoft Windows Vista ou une version ultérieure à l'aide du programme d'installation autonome.

Lorsque des mises à jour sont publiées, vous devez relancer le processus d'installation pour obtenir la version la plus récente de l'Session Manager plugin.

Note

Pour obtenir de meilleurs résultats, nous vous recommandons de démarrer des sessions sur les clients Windows à l'aide de PowerShell l'application Windows version 5 ou ultérieure. Sous Microsoft Windows 10, l'invite de commande offre également une prise en charge fiable des opérations Session Manager

Pour installer le Session Manager plugin à l'aide du programme d'installation EXE

  1. Téléchargez le programme d'installation à l'aide de l'URL suivante.

    https://s3.amazonaws.com/session-manager-downloads/plugin/latest/windows/SessionManagerPluginSetup.exe
  2. Exécutez le programme d'installation téléchargé et suivez les instructions à l'écran.

    Laissez la zone de l'emplacement d'installation vide pour installer le plug-in dans le répertoire par défaut.

    • C:\%PROGRAMFILES%\Amazon\SessionManagerPlugin\bin\

  3. Vérifiez que l'installation a réussi. Pour plus d'informations, consultez Vérifier l'installation Session Manager plugin.

    Note

    Si Windows ne parvient pas à localiser le fichier exécutable, vous devrez peut-être rouvrir l'invite de commande ou ajouter manuellement le répertoire d'installation à votre variable d'environnement PATH Pour en savoir plus, consultez la rubrique de dépannage Session Manager plugin n'est pas ajouté automatiquement au chemin de la ligne de commande (Windows).

Installer et désinstaller l' Session Manager plugin sur macOS

Vous pouvez installer l' Session Manager plugin sur macOS à l'aide du programme d'installation fourni.

Important

Le programme d'installation fourni ne prend pas en charge l'installation dans des chemins contenant des espaces.

Pour installer l' Session Manager plugin à l'aide du programme d'installation fourni (macOS)

  1. Téléchargez le programme d'installation fourni.

    curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/sessionmanager-bundle.zip" -o "sessionmanager-bundle.zip"
  2. Décompressez le package.

    unzip sessionmanager-bundle.zip
  3. Exécutez la commande install.

    sudo ./sessionmanager-bundle/install -i /usr/local/sessionmanagerplugin -b /usr/local/bin/session-manager-plugin
    Note

    Le plug-in nécessite Python 2.6.5 ou version ultérieure, ou Python 3.3 ou version ultérieure. Par défaut, le script d'installation s'exécute sous la version système par défaut de Python. Si vous avez installé une autre version de Python et souhaitez l'utiliser pour installer le Session Manager plugin, exécutez le script d'installation avec cette version dans le chemin d'accès absolu au fichier exécutable Python. Voici un exemple de.

    sudo /usr/local/bin/python3.6 sessionmanager-bundle/install -i /usr/local/sessionmanagerplugin -b /usr/local/bin/session-manager-plugin

    Le programme d'installation installe le Session Manager plugin sous /usr/local/sessionmanagerplugin et crée le lien symbolique session-manager-plugin dans le répertoire /usr/local/bin Cela permet d'éviter de devoir spécifier le répertoire d'installation dans la variable utilisateur $PATH

    Pour afficher une explication de -i et -b , utilisez le -h option.

    ./sessionmanager-bundle/install -h
  4. Vérifiez que l'installation a réussi. Pour plus d'informations, consultez Vérifier l'installation Session Manager plugin.

Note

Si vous souhaitez désinstaller le plug-in, exécutez les deux commandes suivantes dans l'ordre indiqué.

sudo rm -rf /usr/local/sessionmanagerplugin
sudo rm /usr/local/bin/session-manager-plugin

Installer le Session Manager plugin sur Linux

  1. Téléchargez le package Session Manager plugin RPM.

    • Intel 64-bit (x86_64)

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/linux_64bit/session-manager-plugin.rpm" -o "session-manager-plugin.rpm"
    • Intel 32-bit (x86)

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/linux_32bit/session-manager-plugin.rpm" -o "session-manager-plugin.rpm"
    • ARM 64-bit (arm64)

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/linux_arm64/session-manager-plugin.rpm" -o "session-manager-plugin.rpm"
  2. Exécutez la commande install.

    sudo yum install -y session-manager-plugin.rpm
  3. Vérifiez que l'installation a réussi. Pour plus d'informations, consultez Vérifier l'installation Session Manager plugin.

Note

Si vous souhaitez désinstaller le plug-in, exécutez sudo yum erase session-manager-plugin -y

Installation de l'Session Manager plugin sur Ubuntu Server

  1. Téléchargez le package Session Manager plugin deb.

    • Intel 64-bit (x86_64)

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_64bit/session-manager-plugin.deb" -o "session-manager-plugin.deb"
    • Intel 32-bit (x86)

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_32bit/session-manager-plugin.deb" -o "session-manager-plugin.deb"
    • ARM 64-bit (arm64)

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_arm64/session-manager-plugin.deb" -o "session-manager-plugin.deb"
  2. Exécutez la commande install.

    sudo dpkg -i session-manager-plugin.deb
  3. Vérifiez que l'installation a réussi. Pour plus d'informations, consultez Vérifier l'installation Session Manager plugin.

Note

Si vous souhaitez désinstaller le plug-in, exécutez sudo dpkg -r session-manager-plugin

Vérifier l'installation Session Manager plugin

Exécutez les commandes suivantes pour vérifier que l' Session Manager plugin est installée correctement.

session-manager-plugin

Si l'installation a réussi, le message suivant est renvoyé.

The Session Manager plugin is installed successfully. Use the AWS CLI to start a session.

Vous pouvez également tester l'installation en exécutant la commande suivante dans l'AWS CLI.

Note

Cette commande fonctionne uniquement si votre administrateur Session Manager vous a accordé les autorisations IAM nécessaires pour accéder à l'instance cible via Session Manager.

aws ssm start-session --target id-of-an-instance-you-have-permissions-to-access

(Facultatif) Activer la Session Manager plugin journalisation

Le Session Manager plugin inclut une option permettant d'activer la journalisation pour les sessions que vous exécutez. Par défaut, la journalisation est désactivée.

Si vous activez la journalisation, le Session Manager plugin crée des fichiers journaux relatifs à l'activité de l'application (session-manager-plugin.log) et aux erreurs (errors.log) sur votre ordinateur local.

Activer la journalisation dans le Session Manager plugin (Windows)

  1. Recherchez le fichier seelog.xml.template du plug-in.

    L'emplacement par défaut est C:\Program Files\Amazon\SessionManagerPlugin\seelog.xml.template.

  2. Remplacez le nom du fichier par seelog.xml.

  3. Ouvrez le fichier et remplacez par minlevel="off" minlevel="info" ou minlevel="debug".

    Note

    Par défaut, les entrées de journal sur l'ouverture d'un canal de données et la reconnexion aux sessions sont enregistrées au niveau INFO. Les entrées de flux de données (paquets et accusé de réception) sont enregistrées au niveau DEBUG.

  4. Modifiez les autres options de configuration que vous souhaitez modifier. Vous pouvez modifier les options suivantes :

    • Niveau de débogage : vous pouvez remplacer le niveau de débogage de formatid="fmtinfo" par outputs formatid="fmtdebug".

    • Options des fichiers journaux : vous pouvez modifier les options des fichiers journaux, y compris l'emplacement de stockage des journaux, à l'exception des noms des fichiers journaux.

      Important

      Ne modifiez pas les noms de fichier, la journalisation ne fonctionnerait pas correctement.

      <rollingfile type="size" filename="C:\%PROGRAMDATA%\Amazon\SessionManagerPlugin\Logs\session-manager-plugin.log" maxsize="30000000" maxrolls="5"/> <filter levels="error,critical" formatid="fmterror"> <rollingfile type="size" filename="C:\%PROGRAMDATA%\Amazon\SessionManagerPlugin\Logs\errors.log" maxsize="10000000" maxrolls="5"/>
  5. Sauvegardez le fichier.

Activer la journalisation pour le Session Manager plugin (Linux et macOS)

  1. Recherchez le fichier seelog.xml.template du plug-in.

    L'emplacement par défaut est /usr/local/sessionmanagerplugin/seelog.xml.template.

  2. Remplacez le nom du fichier par seelog.xml.

  3. Ouvrez le fichier et remplacez par minlevel="off" minlevel="info" ou minlevel="debug".

    Note

    Par défaut, les entrées de journal sur l'ouverture des canaux de données et la reconnexion des sessions sont enregistrées au niveau INFO. Les entrées de flux de données (paquets et accusé de réception) sont enregistrées au niveau DEBUG.

  4. Modifiez les autres options de configuration que vous souhaitez modifier. Vous pouvez modifier les options suivantes :

    • Niveau de débogage : vous pouvez remplacer le niveau de débogage de formatid="fmtinfo" par outputs formatid="fmtdebug"

    • Options des fichiers journaux : vous pouvez modifier les options des fichiers journaux, y compris l'emplacement de stockage des journaux, à l'exception des noms des fichiers journaux.

      Important

      Ne modifiez pas les noms de fichier, la journalisation ne fonctionnerait pas correctement.

      <rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/session-manager-plugin.log" maxsize="30000000" maxrolls="5"/> <filter levels="error,critical" formatid="fmterror"> <rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/errors.log" maxsize="10000000" maxrolls="5"/>
      Important

      Si vous utilisez le répertoire par défaut spécifié pour le stockage des journaux, vous devez exécuter des commandes de session à l'aide de la commande sudo ou accorder au répertoire dans lequel le plug-in est installé, des autorisations complètes de lecture et d'écriture. Pour contourner ces restrictions, modifiez l'emplacement de stockage des journaux.

  5. Sauvegardez le fichier.

Session Manager pluginDernière version et historique des versions

Votre ordinateur local doit exécuter une version prise en charge du Session Manager plugin. La version minimale actuellement prise en charge est 1.1.17.0. Si vous exécutez une version antérieure, vos opérations Session Manager peuvent échouer.

Pour vérifier que vous disposez bien de la dernière version, exécutez la commande suivante dans l'AWS CLI.

Note

La commande renvoie un résultat uniquement si le plug-in est situé dans le répertoire d'installation par défaut de votre type de système d'exploitation. Vous pouvez également vérifier la version dans le contenu du fichier VERSION, dans le répertoire où vous avez installé le plug-in.

session-manager-plugin --version

Le tableau suivant répertorie toutes les versions du Session Manager plugin, ainsi que les fonctionnalités et les améliorations incluses dans chaque version.

Version Date de publication Détails
1.2.30.0

24 novembre 2020

Amélioration : (sessions de réacheminement de port uniquement) Amélioration des performances globales.

1.2.7.0

15 octobre 2020

Amélioration : (sessions de réacheminement de port uniquement) latence réduite et performances globales améliorées.

1.1.61.0

17 avril 2020

Amélioration : ajout de la prise en charge ARM pour Linux et Ubuntu Server.

1.1.54.0

6 janvier 2020

Correction de bogue : gérer le scénario de condition de course des paquets abandonnés lorsque le Session Manager plugin n'est pas prêt.

1.1.50.0

19 novembre 2019

Amélioration: Ajout du support pour le transfert d'un port vers un socket unix local.

1.1.35.0

7 novembre 2019

Amélioration : (sessions de réacheminement de port uniquement) Envoi d'une TerminateSession commande à Agent SSM lorsque l'utilisateur local appuie sur Ctrl+C.

1.1.33.0 26 septembre 2019 Amélioration : (sessions de réacheminement de port uniquement) Envoie d'un signal de déconnexion au serveur lorsque le client abandonne la connexion TCP.
1.1.31.0 6 septembre 2019 Amélioration : mise à jour pour maintenir la session de réacheminement de port ouverte jusqu'à ce que le serveur distant ferme la connexion.

1.1.26.0

30 juillet 2019

Amélioration : mise à jour pour limiter le taux de transfert de données au cours d'une session.

1.1.23.0

9 juillet 2019

Amélioration : ajout de la prise en charge de l'exécution de sessions SSH à l'aide Session Managerd'.

1.1.17.0 4 avril 2019

Amélioration : ajout de la prise en charge d'autres données de chiffrement de session avec AWS Key Management Service (AWS KMS).

1.0.37.0 20 septembre 2018

Amélioration : bug correctif pour la version Windows.

1.0.0.0 11 septembre 2018

Version initiale du Session Manager plugin.