AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

(可选)为 AWS CLI 安装 Session Manager Plugin

如果需要使用 AWS CLI 启动和终止连接到托管实例的会话,必须先在本地计算机上安装 Session Manager plugin。可以在支持的 Microsoft Windows、macOS、Linux 和 Ubuntu Server 版本上安装此插件。

使用最新版本的 Session Manager Plugin

此插件的更新偶尔会包含增强功能。我们建议您定期确保使用的是最新版本的插件。有关更多信息,请参阅 Session Manager Plugin 最新版本和发布历史记录

安装先决条件

必须在本地计算机上安装 AWS CLI 版本 1.16.12 或更高版本才能使用 Session Manager plugin。

在 Windows 上安装 Session Manager Plugin

您可以使用独立安装程序在 Microsoft Windows Vista 或更高版本上安装 Session Manager plugin。

更新发布后,您必须重复安装过程以获取最新版本的 Session Manager plugin。

注意

为获得最佳效果,建议使用 Windows PowerShell 应用程序版本 5 或更高版本在 Windows 客户端上启动会话。在 Microsoft Windows 10 上,命令提示符也为 Session Manager 操作提供了可靠的支持。

使用 EXE 安装程序安装 Session Manager plugin

  1. 使用以下 URL 下载安装程序:

    https://s3.amazonaws.com/session-manager-downloads/plugin/latest/windows/SessionManagerPluginSetup.exe
  2. 运行下载的安装程序,然后按照屏幕上的说明操作。

    将安装位置框留空以将插件安装到默认目录:

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

  3. 验证安装是否成功。有关信息,请参阅 验证 Session Manager Plugin安装

    注意

    如果 Windows 无法找到可执行文件,您需要重新打开命令提示符或手动将安装目录添加到 PATH 环境变量。有关信息,请参阅故障排除主题 Session Manager Plugin未自动添加到命令行路径 (Windows)

在 macOS 上安装和卸载 Session Manager Plugin

您可以使用捆绑安装程序在 macOS 上安装 Session Manager plugin。

重要

捆绑安装程序不支持安装到包含空格的路径。

使用捆绑安装程序安装 Session Manager plugin (macOS)

  1. 下载捆绑安装程序:

    curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/sessionmanager-bundle.zip" -o "sessionmanager-bundle.zip"
  2. 解压缩软件包:

    unzip sessionmanager-bundle.zip
  3. 运行安装命令:

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

    注意

    此插件需要 Python 2.6.5 或更高版本或 Python 3.3。默认情况下,安装脚本在系统默认版本的 Python 下运行。如果已安装 Python 的可选版本并希望使用该版本安装 Session Manager plugin,请使用该版本按 Python 可执行文件的绝对路径运行安装脚本。例如:

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

    安装程序在 /usr/local/sessionmanagerplugin 中安装 Session Manager plugin,并在 /usr/local/bin 目录中创建符号链接 session-manager-plugin。这样,不必在用户的 $PATH 变量中指定安装目录。

    要查看 -i-b 选项的说明,请使用 -h 选项:

    ./sessionmanager-bundle/install -h
  4. 验证安装是否成功。有关信息,请参阅 验证 Session Manager Plugin安装

注意

如果需要卸载此插件,请运行以下两个命令(一次运行一个):

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

在 Linux 上安装 Session Manager Plugin

  1. 下载 Session Manager plugin RPM 软件包:

    • 64 位:

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

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/linux_32bit/session-manager-plugin.rpm" -o "session-manager-plugin.rpm"
  2. 运行安装命令:

    sudo yum install -y session-manager-plugin.rpm
  3. 验证安装是否成功。有关信息,请参阅 验证 Session Manager Plugin安装

注意

如果需要卸载此插件,请运行 sudo yum erase session-manager-plugin -y

在 Ubuntu Server 上安装 Session Manager Plugin

  1. 下载 Session Manager plugin deb 软件包:

    • 64 位:

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

      curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_32bit/session-manager-plugin.deb" -o "session-manager-plugin.deb"
  2. 运行安装命令:

    sudo dpkg -i session-manager-plugin.deb
  3. 验证安装是否成功。有关信息,请参阅 验证 Session Manager Plugin安装

注意

如果需要卸载此插件,请运行 sudo dpkg -r session-manager-plugin

验证 Session Manager Plugin安装

运行以下命令验证是否已成功安装 Session Manager plugin:

session-manager-plugin

如果安装成功,将返回以下消息:

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

您还可以通过在 AWS CLI 中运行以下命令来测试安装:

注意

仅当 Session Manager 管理员已授予您使用 Session Manager 访问目标实例所需的 IAM 权限时,此命令才有效。

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

(可选)启用 Session Manager Plugin日志记录

Session Manager plugin包括一个为运行的会话启用日志记录的选项。默认情况下,日志记录处于禁用状态。

如果启用日志记录,则 Session Manager plugin会在本地计算机上为应用程序活动 (session-manager-plugin.log) 和错误 (errors.log) 创建日志文件。

启用 Session Manager Plugin日志记录 (Windows)

  1. 找到插件的 seelog.xml.template 文件。

    默认位置是 C:\%PROGRAMDATA%\Amazon\SessionManagerPlugin\seelog.xml.template

  2. 将文件名更改为 seelog.xml

  3. 打开文件,然后将 minlevel="off" 更改为 minlevel="info"minlevel="debug"

    注意

    默认情况下,有关打开数据通道和重新连接会话的日志条目在 INFO 级别记录。数据流(数据包和确认)条目在 DEBUG 级别记录。

  4. 更改要修改的其他配置选项。可以更改的选项包括:

    • 调试级别:您可以将调试级别从 formatid="fmtinfo" 更改为 outputs formatid="fmtdebug"

    • 日志文件选项:您可以更改日志文件选项,包括日志的存储位置,但日志文件名除外。

      重要

      不要更改文件名,否则日志记录无法正常工作。

      <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. 保存文件。

启用 Session Manager Plugin日志记录(Linux 和 macOS)

  1. 找到插件的 seelog.xml.template 文件。

    默认位置是 /usr/local/sessionmanagerplugin/seelog.xml.template

  2. 将文件名更改为 seelog.xml

  3. 打开文件,然后将 minlevel="off" 更改为 minlevel="info"minlevel="debug"

    注意

    默认情况下,有关打开数据通道和重新连接会话的日志条目在 INFO 级别记录。数据流(数据包和确认)条目在 DEBUG 级别记录。

  4. 更改要修改的其他配置选项。可以更改的选项包括:

    • 调试级别:您可以将调试级别从 formatid="fmtinfo" 更改为 outputs formatid="fmtdebug"

    • 日志文件选项:您可以更改日志文件选项,包括日志的存储位置,但日志文件名除外。

      重要

      不要更改文件名,否则日志记录无法正常工作。

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

      重要

      如果使用指定的默认目录存储日志,则必须使用 sudo 运行会话命令,或者给安装插件的目录指定完全读写权限。要绕过这些限制,请更改存储日志的位置。

  5. 保存文件。

Session Manager Plugin 最新版本和发布历史记录

本地计算机必须运行支持的 Session Manager plugin版本。如果运行的是更早的版本,则 Session Manager 操作可能会失败。

当前支持的最低版本为 1.1.17.0。

最新版本是 1.1.33.0。

要查看使用的是不是最新版本,请在 AWS CLI 中运行以下命令:

注意

仅当插件位于操作系统类型的默认安装目录中时,此命令才返回结果。您也可以在 VERSION 文件(位于安装此插件的目录中)内容中找到版本信息。

session-manager-plugin --version

下表列出了 Session Manager plugin的所有版本,以及每个版本所含的功能和增强功能。

版本 发行日期 详细信息
1.1.33.0 2019 年 9 月 26 日 增强功能:(仅限端口转发会话)当客户端断开 TCP 连接时,向服务器发送断开连接信号。
1.1.31.0 2019 年 9 月 6 日 增强功能:更新以保持端口转发会话打开,直到远程服务器关闭连接。

1.1.26.0

2019 年 7 月 30 日

增强功能:限制会话期间的数据传输速率。

1.1.23.0

2019 年 7 月 9 日

增强功能:添加对使用 Session Manager 运行 SSH 会话的支持。

1.1.17.0 2019 年 4 月 4 日

增强功能:增加了对使用 AWS Key Management Service (AWS KMS) 进一步加密会话数据的支持。

1.0.37.0 2018 年 9 月 20 日

增强功能:Windows 版本错误修复。

1.0.0.0 2018 年 9 月 11 日

Session Manager plugin首次发布。