(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.
Temas
- Instalación del complemento de Session Manager en Windows
- Instalación y desinstalación del complemento de Session Manager en macOS
- Instalación del complemento de Session Manager en macOS con el instalador firmado
- Instalación del complemento de Session Manager en Linux
- Instalación del complemento de Session Manager en Ubuntu Server
- Verificación de la instalación del complemento de Session Manager
- Complemento de Session Manager en GitHub
- (Opcional) Activación del registro del complemento de Session Manager
- Última versión del complemento de Session Manager e historial de versiones
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.
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
-
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
-
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\
-
-
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.
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)
-
Descargue el instalador empaquetado.
curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/sessionmanager-bundle.zip" -o "sessionmanager-bundle.zip"
-
Descomprima el paquete.
unzip sessionmanager-bundle.zip
-
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 symlinksession-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
-
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.
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)
-
Descargue el instalador firmado.
curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/session-manager-plugin.pkg" -o "session-manager-plugin.pkg"
-
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
-
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
-
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"
-
-
Ejecute el comando de instalación.
sudo yum install -y session-manager-plugin.rpm
-
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.
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
-
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"
-
-
Ejecute el comando de instalación.
sudo dpkg -i session-manager-plugin.deb
-
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.
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
(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.
Temas
Activación del registro del complemento de Session Manager (Windows)
-
Localice el archivo
seelog.xml.template
del complemento.La ubicación predeterminada es
C:\Program Files\Amazon\SessionManagerPlugin\seelog.xml.template
. -
Cambie el nombre del archivo a
seelog.xml
. -
Abra el archivo y cambie
minlevel="off"
aminlevel="info"
ominlevel="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.
-
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"
aoutputs 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"/>
-
-
Guarde el archivo.
Habilitación del registro del complemento de Session Manager (Linux y macOS)
-
Localice el archivo
seelog.xml.template
del complemento.La ubicación predeterminada es
/usr/local/sessionmanagerplugin/seelog.xml.template
. -
Cambie el nombre del archivo a
seelog.xml
. -
Abra el archivo y cambie
minlevel="off"
aminlevel="info"
ominlevel="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.
-
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"
aoutputs 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.
-
-
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.
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 | Detalles |
---|---|---|
1.2.398.0 |
14 de octubre de 2022 |
Mejora: es compatible con la versión 1.17 de Golang. Actualice el ejecutor de complementos del administrador de sesiones predeterminado para macOS si desea usar python3. Actualice la ruta de importación de SSMCLI al complemento del administrador de sesiones. |
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. |