(可选)为 Session Manager plugin 安装 AWS CLI - AWS Systems Manager

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

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

如果要使用 AWS Command Line Interface (AWS CLI) 启动和结束连接到托管实例的会话,您必须先Session Manager plugin在本地计算机上安装 。该插件可以安装在受支持的 Microsoft macOSWindows、、Linux 和 版本上Ubuntu Server。

使用最新版本的 Session Manager plugin

偶尔会使用增强的功能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 客户端上使用 Windows PowerShell 应用程序版本 5 或更高版本启动会话。在 Microsoft Windows 10 上,命令提示符也为 Session Manager 操作提供了可靠的支持。

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

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

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

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

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

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

    注意

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

在 Session Manager plugin 上安装和卸载 macOS

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

重要

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

使用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

    安装程序在 Session Manager plugin 中安装 /usr/local/sessionmanagerplugin,并在 session-manager-plugin 目录中创建符号链接 /usr/local/bin 这样,不必在用户的 $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 程序包。

    • 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. 验证安装是否成功。有关信息,请参阅 验证 Session Manager plugin 安装.

注意

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

在 Session Manager plugin 上安装 Ubuntu Server

  1. 下载 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. 运行安装命令。

    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 管理员已授予您使用 IAM 访问目标实例所需的 Session Manager. 权限时,此命令才有效。

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

为 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. 当前支持的最低版本为 1.1.17.0. 如果运行的是更早的版本,则 Session Manager 操作可能会失败。

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

注意

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

session-manager-plugin --version

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

版本 发行日期 详细信息
1.2.30.0

2020 年 11 月 24 日

增强功能:(仅限端口转发会话)改进了整体性能。

1.2.7.0

2020 年 10 月 15 日

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

1.1.61.0

2020 年 4 月 17 日

增强功能:添加了对 Linux 和 Ubuntu Server. 的 ARM 支持。

1.1.54.0

2020 年 1 月 6 日

Bug 修复:处理 Session Manager plugin 未准备就绪时丢弃数据包的竞争条件情况。

1.1.50.0

2019 年 11 月 19 日

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

1.1.35.0

2019 年 11 月 7 日

增强功能:(仅限端口转发会话)当本地用户按下 TerminateSession 时,向 发送SSM 代理命令 Ctrl+C.

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 日

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

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.