(Opcional) Instalación del complemento de Session Manager para la AWS CLI - AWS Systems Manager

(Opcional) Instalación del complemento de Session Manager para la AWS CLI

Si desea utilizar la AWS Command Line Interface (AWS CLI) para iniciar y terminar sesiones que lo conectan a los nodos administrados, primero debe instalar el complemento de Session Manager en su equipo local. El complemento se puede instalar en versiones compatibles de Microsoft Windows, macOS, Linux y Ubuntu Server.

Uso de la versión más reciente del complemento de Session Manager

El complemento de Session Manager se actualiza ocasionalmente con funcionalidades mejoradas. Le recomendamos asegurarse con regularidad de estar utilizando la versión más reciente del complemento. Para obtener más información, consulte Última versión del complemento de Session Manager e historial de versiones .

Requisitos previos de instalación

La versión 1.16.12 de la AWS CLI o una posterior debe estar instalada en su equipo local para poder utilizar el complemento de Session Manager.

Instalación del complemento de Session Manager en Windows

Puede instalar el complemento de Session Manager en Microsoft Windows Vista o una versión posterior con el instalador independiente.

Cuando se hayan publicado las actualizaciones, deberá repetir el proceso de instalación para obtener la versión más reciente del complemento de Session Manager.

nota

Para obtener mejores resultados, le recomendamos iniciar las sesiones en los clientes de Windows utilizando la versión 5 o una posterior de Windows PowerShell. También puede utilizar el shell de comandos en Microsoft Windows 10. El complemento de Session Manager solo es compatible con PowerShell y el shell de comandos. Es posible que las herramientas de línea de comandos de terceros no sean compatibles con el complemento.

Para instalar el complemento de Session Manager con el instalador EXE

  1. Descargue el instalador mediante la siguiente dirección URL.

    https://s3.amazonaws.com/session-manager-downloads/plugin/latest/windows/SessionManagerPluginSetup.exe

    También puede descargar una versión comprimida del instalador utilizando la siguiente URL.

    https://s3.amazonaws.com/session-manager-downloads/plugin/latest/windows/SessionManagerPlugin.zip
  2. Ejecute el instalador descargado y siga las instrucciones que aparecen en la pantalla. Si descargó la versión comprimida del instalador, primero debe descomprimir el instalador.

    Deje el cuadro de ubicación de la instalación en blanco para instalar el complemento en el directorio predeterminado.

    • %PROGRAMFILES%\Amazon\SessionManagerPlugin\bin\

  3. Compruebe que la instalación se ha realizado correctamente. Para obtener información, consulte Verificación de la instalación del complemento de Session Manager.

    nota

    Si Windows no puede encontrar el ejecutable, es posible que tenga que volver a abrir el símbolo del sistema o añadir el directorio de instalación a su variable de entorno PATH manualmente. Para obtener información, consulte el tema sobre solución de problemas Complemento de Session Manager no agregado automáticamente a la ruta de la línea de comandos (Windows).

Instalación y desinstalación del complemento de Session Manager en macOS

Puede instalar el complemento de Session Manager en macOS con el instalador empaquetado.

importante

El instalador empaquetado no admite la instalación en rutas que contienen espacios.

Para instalar el complemento de Session Manager con el instalador empaquetado (macOS)

  1. Descargue el instalador empaquetado.

    curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/sessionmanager-bundle.zip" -o "sessionmanager-bundle.zip"
  2. Descomprima el paquete.

    unzip sessionmanager-bundle.zip
  3. Ejecute el comando de instalación.

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

    El complemento requiere Python 2.6.5 o uno posterior o Python 3.3 o uno posterior. El script de instalación se ejecuta en la versión de Python predeterminada del sistema. Si tiene instalada una versión alternativa de Python y desea utilizarla para instalar el complemento de Session Manager, ejecute el script de instalación de esa versión mediante una ruta absoluta al ejecutable de Python. A continuación, se muestra un ejemplo.

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

    El instalador instala el complemento de Session Manager en /usr/local/sessionmanagerplugin y crea el symlink session-manager-plugin en el directorio /usr/local/bin. De este modo, no es necesario especificar el directorio de instalación en la variable $PATH del usuario.

    Para ver una explicación de las opciones -i y -b, use la opción -h.

    ./sessionmanager-bundle/install -h
  4. Compruebe que la instalación se ha realizado correctamente. Para obtener información, consulte Verificación de la instalación del complemento de Session Manager.

nota

Si alguna vez desea desinstalar el complemento, ejecute los dos siguientes comandos en el orden que aparecen.

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

Instalación del complemento de Session Manager en macOS con el instalador firmado

Puede instalar el complemento de Session Manager en macOS con el instalador firmado.

Para instalar el complemento de Session Manager con el instalador firmado (macOS)

  1. Descargue el instalador firmado.

    curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/session-manager-plugin.pkg" -o "session-manager-plugin.pkg"
  2. Ejecute el comando de instalación.

    sudo installer -pkg session-manager-plugin.pkg -target / sudo ln -s /usr/local/sessionmanagerplugin/bin/session-manager-plugin /usr/local/bin/session-manager-plugin
  3. Compruebe que la instalación se ha realizado correctamente. Para obtener información, consulte Verificación de la instalación del complemento de Session Manager.

Instalación del complemento de Session Manager en Linux

  1. Descargue el paquete RPM del complemento de Session Manager.

    • x86_64

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

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/linux_32bit/session-manager-plugin.rpm" -o "session-manager-plugin.rpm"
    • ARM64

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/linux_arm64/session-manager-plugin.rpm" -o "session-manager-plugin.rpm"
  2. Ejecute el comando de instalación.

    sudo yum install -y session-manager-plugin.rpm
  3. Compruebe que la instalación se ha realizado correctamente. Para obtener información, consulte Verificación de la instalación del complemento de Session Manager.

nota

Si alguna vez desea desinstalar el complemento, ejecute sudo yum erase session-manager-plugin -y

Instalación del complemento de Session Manager en Ubuntu Server

  1. Descargue el paquete deb del complemento de Session Manager.

    • x86_64

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

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_32bit/session-manager-plugin.deb" -o "session-manager-plugin.deb"
    • ARM64

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_arm64/session-manager-plugin.deb" -o "session-manager-plugin.deb"
  2. Ejecute el comando de instalación.

    sudo dpkg -i session-manager-plugin.deb
  3. Compruebe que la instalación se ha realizado correctamente. Para obtener información, consulte Verificación de la instalación del complemento de Session Manager.

nota

Si alguna vez desea desinstalar el complemento, ejecute sudo dpkg -r session-manager-plugin

Verificación de la instalación del complemento de Session Manager

Ejecute los siguientes comandos para verificar que el complemento de Session Manager se instaló correctamente.

session-manager-plugin

Si la instalación se realizó de forma correcta, se devuelve el siguiente mensaje.

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

También puede probar la instalación ejecutando el siguiente comando en la AWS CLI. En el siguiente comando, reemplace instance-id por su propia información.

aws ssm start-session --target instance-id

Este comando funcionará solo si el administrador de Session Manager le ha concedido los permisos de IAM necesarios para acceder al nodo administrado de destino con Session Manager.

Complemento de Session Manager en GitHub

El código fuente del complemento de Session Manager está disponible en GitHub, de modo que puede adaptar el complemento de acuerdo a sus necesidades. Le recomendamos enviar solicitudes de inserción para los cambios que le gustaría que incluyamos. No obstante, Amazon Web Services no admite la ejecución de copias modificadas de este software.

(Opcional) Activación del registro del complemento de Session Manager

El complemento de Session Manager incluye una opción para permitir el registro de las sesiones que ejecute. De forma predeterminada, el registro está desactivado.

Si permite el registro, el complemento de Session Manager creará archivos de registros para la actividad de la aplicación (session-manager-plugin.log) y los errores (errors.log) en su equipo local.

Activación del registro del complemento de Session Manager (Windows)

  1. Localice el archivo seelog.xml.template del complemento.

    La ubicación predeterminada es C:\Program Files\Amazon\SessionManagerPlugin\seelog.xml.template.

  2. Cambie el nombre del archivo a seelog.xml.

  3. Abra el archivo y cambie minlevel="off" a minlevel="info" o minlevel="debug".

    nota

    De forma predeterminada, las entradas de registro sobre la apertura de un canal de datos y la reconexión de sesiones se registran en el nivel DE INFORMACIÓN. Las entradas de flujos de datos (paquetes y confirmación) se registran en el nivel DE DEPURACIÓN.

  4. Cambie otras opciones de configuración que desea modificar. Entre las opciones que se pueden cambiar se encuentran las siguientes:

    • Nivel de depuración: puede cambiar el nivel de depuración de formatid="fmtinfo" a outputs formatid="fmtdebug".

    • Opciones de archivos de registro: puede realizar cambios en las opciones de archivos de registro, como la ubicación en la que se almacenan los registros, con la excepción de los nombres de los archivos de registro.

      importante

      No cambie los nombres de los archivos, si no, el registro no funcionará correctamente.

      <rollingfile type="size" filename="C:\Program Files\Amazon\SessionManagerPlugin\Logs\session-manager-plugin.log" maxsize="30000000" maxrolls="5"/> <filter levels="error,critical" formatid="fmterror"> <rollingfile type="size" filename="C:\Program Files\Amazon\SessionManagerPlugin\Logs\errors.log" maxsize="10000000" maxrolls="5"/>
  5. Guarde el archivo.

Habilitación del registro del complemento de Session Manager (Linux y macOS)

  1. Localice el archivo seelog.xml.template del complemento.

    La ubicación predeterminada es /usr/local/sessionmanagerplugin/seelog.xml.template.

  2. Cambie el nombre del archivo a seelog.xml.

  3. Abra el archivo y cambie minlevel="off" a minlevel="info" o minlevel="debug".

    nota

    De forma predeterminada, las entradas de registro sobre la apertura de canales de datos y la reconexión de sesiones se registran en el nivel DE INFORMACIÓN. Las entradas de flujos de datos (paquetes y confirmación) se registran en el nivel DE DEPURACIÓN.

  4. Cambie otras opciones de configuración que desea modificar. Entre las opciones que se pueden cambiar se encuentran las siguientes:

    • Nivel de depuración: puede cambiar el nivel de depuración de formatid="fmtinfo" a outputs formatid="fmtdebug".

    • Opciones de archivos de registro: puede realizar cambios en las opciones de archivos de registro, como la ubicación en la que se almacenan los registros, con la excepción de los nombres de los archivos de registro.

      importante

      No cambie los nombres de los archivos, si no, el registro no funcionará correctamente.

      <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"/>
      importante

      Si utiliza el directorio predeterminado especificado para almacenar registros, debe ejecutar comandos de sesión usando sudo o proporcionar el directorio donde el complemento instaló todos los permisos de lectura y escritura. Para eludir estas restricciones, cambie la ubicación donde se almacenan los registros.

  5. Guarde el archivo.

Última versión del complemento de Session Manager e historial de versiones

El equipo local debe ejecutar una versión compatible del complemento de Session Manager. En la actualidad, la versión más antigua compatible es la 1.1.17.0. Si ejecuta una versión anterior, es posible que las operaciones de Session Manager no se efectúen de manera correcta.

Para ver si tiene la versión más reciente, ejecute el siguiente comando en la AWS CLI.

nota

El comando devuelve los resultados únicamente si el complemento se encuentra en el directorio de instalación predeterminado de su sistema operativo. También puede comprobar la versión en el contenido del archivo VERSION en el directorio en el que ha instalado el complemento.

session-manager-plugin --version

En la siguiente tabla se muestran todas las versiones del complemento de Session Manager, así como las características y las mejoras incluidas en cada versión.

Versión Fecha de lanzamiento de la nueva versión Detalles
1.2.339.0

16 de junio de 2022

Corrección de error: corrección del tiempo de espera de sesión inactiva para las sesiones de puertos.
1.2.331.0

27 de mayo de 2022

Corrección de error: corrección del cierre prematuro de las sesiones de puertos cuando el servidor local no se conecta antes de que se agote el tiempo de espera.
1.2.323.0

19 de mayo de 2022

Corrección de error: desactivación de mantenimiento de conexión de smux para utilizar la función de tiempo de espera de sesión inactiva.
1.2.312.0

31 de marzo de 2022

Mejora: admite más tipos de carga de mensajes de salida.
1.2.295.0

12 de enero de 2022

Solución de errores: sesiones que dejan de responder porque el cliente reenvía datos de flujo cuando el agente queda inactivo y registros incorrectos para mensajes de start_publication y pause_publication.
1.2.279.0

27 de octubre de 2021

Mejora: empaquetado zip para plataforma Windows.
1.2.245.0

19 de agosto de 2021

Mejora: Actualice aws-sdk-go a la versión más reciente (v1.40.17) para admitir el AWS IAM Identity Center (successor to AWS Single Sign-On).
1.2.234.0

26 de julio de 2021

Corrección de errores: gestione el escenario de sesión abruptamente terminada en el tipo de sesión interactiva.
1.2.205.0

10 de junio de 2021

Mejora: se agregó compatibilidad con el instalador firmado de macOS.
1.2.54.0

29 de enero de 2021

Mejora: se agregó compatibilidad con la ejecución de sesiones en modo de ejecución NonInteractiveCommands.
1.2.30.0

24 de noviembre de 2020

Mejora: se mejoró el rendimiento general (solo en las sesiones de reenvío de puertos).

1.2.7.0

15 de octubre de 2020

Mejora: se redujo la latencia y se mejoró el rendimiento general (solo en las sesiones de reenvío de puertos).

1.1.61.0

17 de abril de 2020

Mejora: ahora ARM es compatible con Linux y Ubuntu Server.

1.1.54.0

6 de enero de 2020

Corrección de errores: gestione el escenario de condición de carrera de paquetes que se descartan cuando el complemento de Session Manager no está listo.

1.1.50.0

19 de noviembre de 2019

Mejora: se ha añadido soporte para reenviar un puerto a un socket Unix local.

1.1.35.0

7 de noviembre de 2019

Mejora: (Solo sesiones de reenvío de puertos) Enviar un comando TerminateSession a SSM Agent cuando el usuario local presione Ctrl+C.

1.1.33.0 26 de septiembre de 2019 Mejora: (solo sesiones de reenvío de puertos) Envíe una señal de desconexión al servidor cuando el cliente interrumpa la conexión TCP.
1.1.31.0 6 de septiembre de 2019 Mejora: actualización para mantener abierta la sesión de enrutamiento de puertos hasta que el servidor remoto cierre la conexión.

1.1.26.0

30 de julio de 2019

Mejora: actualización para limitar la velocidad de transferencia de datos durante una sesión.

1.1.23.0

9 de julio de 2019

Mejora: se agregó compatibilidad con la ejecución de sesiones de SSH mediante Session Manager.

1.1.17.0 4 de abril de 2019

Mejora: se ha añadido soporte para cifrar aún más los datos de la sesión utilizando AWS Key Management Service (AWS KMS).

1.0.37.0 20 de septiembre de 2018

Mejora: corrección de errores para la versión de Windows.

1.0.0.0 11 de septiembre de 2018

Versión inicial del complemento de Session Manager.