(可选)为AmazonCLI - Amazon Web Services Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

(可选)为AmazonCLI

如果要使用Amazon命令行界面 (AmazonCLI)启动和结束连接到托管实例的会话,必须先在本地计算机上安装会话 Manager 插件。可以在支持的 Microsoft Windows 版本上安装此插件,macOS、Linux 和 Ubuntu 服务器。

使用最新版本的会话管理器插件

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

安装先决条件

Amazon必须在本地计算机上安装 CLI 版本 1.16.12 或更高版本才能使用会话管理器插件。

在 Windows 上安装会话管理器插件

您可以使用独立安装程序在 Microsoft Windows Vista 或更高版本上安装会话管理器插件。

更新发布后,您必须重复安装过程以获取会话管理器插件的最新版本。

注意

为获得最佳效果,建议您使用 Windows PowerShell 版本 5 或更高版本在 Windows 客户端上启动会话。或者,您也可以使用 Windows 10 中的命令外壳程序。会话管理器插件仅支持 PowerShell 和命令外壳。第三方命令行工具可能与插件不兼容。

使用 EXE 安装程序安装会话管理器插件

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

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

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

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

  3. 验证安装是否成功。有关信息,请参阅 验证会话管理器插件安装

    注意

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

在上安装和卸载会话管理器插件macOS

您可以在上安装会话管理器插件macOS使用捆绑安装程序。

重要

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

使用捆绑安装程序安装会话管理器插件 (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 的可选版本并希望使用该版本安装会话管理器插件,请使用该版本按 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目录。这样,不必在用户的 $PATH 变量中指定安装目录。

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

    ./sessionmanager-bundle/install -h
  4. 验证安装是否成功。有关信息,请参阅 验证会话管理器插件安装

注意

如果需要卸载此插件,请按照显示的顺序运行以下两个命令。

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

在 Linux 上安装会话管理器插件

  1. 下载会话管理器插件 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. 运行安装命令。

    sudo yum install -y session-manager-plugin.rpm
  3. 验证安装是否成功。有关信息,请参阅 验证会话管理器插件安装

注意

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

在 Ubuntu 服务器上安装会话管理器插件

  1. 下载会话管理器插件 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. 运行安装命令。

    sudo dpkg -i session-manager-plugin.deb
  3. 验证安装是否成功。有关信息,请参阅 验证会话管理器插件安装

注意

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

验证会话管理器插件安装

运行以下命令以验证会话管理器插件是否已成功安装。

session-manager-plugin

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

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

您还可以通过在中运行以下命令来测试安装。AmazonCLI。

注意

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

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

GitHub 上的会话管理器插件

会话管理器插件的源代码可以在GitHub,以便您可以调整插件来满足自己的需求。我们鼓励您针对要包含的更改提交提取请求。但是,Amazon Web Services 当前不支持运行此软件的修改后副本。

(可选)启用会话管理器插件日志记录

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

如果启用日志记录,会话 Management 插件会为两个应用程序活动(session-manager-plugin.log)和错误(errors.log)。

启用日志记录会话管理器插件 (Windows)

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

    默认位置是 C:\Program Files\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. 保存文件。

启用日志记录会话管理器插件(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. 保存文件。

会话管理器插件最新版本和发布历史记录

本地计算机必须运行支持的会话管理器插件版本。当前支持的最低版本为 1.17.0 如果运行的是更早的版本,则会话管理器操作可能会失败。

若要查看您是否具有最新版本,请在AmazonCLI。

注意

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

session-manager-plugin --version

下表列出了会话管理器插件的所有版本,以及每个版本所含的功能和增强功能。

版本 发行日期 详细信息
1.2.54.0

2021 年 1 月 29 日

Enhancement:添加了对在非交互组合执行模式下运行会话的支持。
1.2.30.0

2020 年 11 月 24 日

Enhancement:(仅限端口转发会话)提高了整体性能。

1.2.7.0

2020 年 10 月 15 日

Enhancement:(仅限端口转发会话)减少延迟并提高整体性能。

1.1.61.0

2020 年 4 月 17 日

Enhancement:添加了对 Linux 和 Ubuntu 服务器的 ARM 支持。

1.1.54.0

2020 年 1 月 6 日

错误修复:处理会话 Management 插件尚未准备就绪时丢弃数据包的竞争条件情况。

1.1.50.0

2019 年 11 月 19 日

Enhancement:添加了将端口转发到本地 unix 套接字的支持。

1.1.35.0

2019 年 11 月 7 日

Enhancement:(仅限端口转发会话)在本地用户按时将 TerminateSession 命令发送到 SSM AgentCtrl+C

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

1.1.26.0

2019 年 7 月 30 日

Enhancement:更新以限制会话期间的数据传输速率。

1.1.23.0

2019 年 7 月 9 日

Enhancement:添加了使用会话管理器运行 SSH 会话的支持。

1.1.17.0 2019 年 4 月 4 日

Enhancement:添加了使用进一步加密会话数据的支持Amazon Key Management Service(Amazon KMS)。

1.0.37.0 2018 年 9 月 20 日

Enhancement:Windows 版本错误修复。

1.0.0.0 2018 年 9 月 11 日

会话管理器插件的初始版本。