• Amazon Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

# 在 macOS 上安装 Session Manager 插件
<a name="install-plugin-macos-overview"></a>

选择以下主题之一，在 macOS 上安装 Session Manager 插件。

**注意**  
签名的安装程序是一个签名的 `.pkg` 文件。捆绑的安装程序使用 `.zip` 文件。文件解压缩后，您可以使用二进制文件安装插件。

## 使用已签名的安装程序在 macOS 上安装 Session Manager 插件
<a name="install-plugin-macos-signed"></a>

本节介绍如何使用已签名的安装程序在 macOS 上安装 Session Manager 插件。

**要使用已签名的安装程序安装 Session Manager 插件 (macOS)，请执行以下步骤：**

1. 下载已签名的安装程序。

------
#### [ x86\$164 ]

   ```
   curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/session-manager-plugin.pkg" -o "session-manager-plugin.pkg"
   ```

------
#### [ 搭载 Apple 硅芯片的 Mac ]

   ```
   curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac_arm64/session-manager-plugin.pkg" -o "session-manager-plugin.pkg"
   ```

------

1. 运行安装命令。如果命令失败，确认 `/usr/local/bin` 文件夹是否存在。如果不存在，创建后再次运该此命令。

   ```
   sudo installer -pkg session-manager-plugin.pkg -target /
   sudo ln -s /usr/local/sessionmanagerplugin/bin/session-manager-plugin /usr/local/bin/session-manager-plugin
   ```

1. 验证安装是否成功。有关信息，请参阅[验证 Session Manager 插件安装](install-plugin-verify.md)。

## 在 macOS 上安装 Session Manager 插件
<a name="install-plugin-macos"></a>

本节介绍如何使用捆绑安装程序在 macOS 上安装 Session Manager 插件。

**重要**  
请注意以下重要信息。  
默认情况下，安装程序需要 sudo 访问权限才能运行，因为脚本会将插件安装到 `/usr/local/sessionmanagerplugin` 系统目录中。如果不想使用 sudo 安装插件，则手动更新安装程序脚本，将插件安装到不需要 sudo 访问权限的目录中。
捆绑安装程序不支持安装到包含空格的路径。

**要使用捆绑安装程序安装 Session Manager 插件 (macOS)，请执行以下步骤：**

1. 下载捆绑安装程序。

------
#### [ x86\$164 ]

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

------
#### [ 搭载 Apple 硅芯片的 Mac ]

   ```
   curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac_arm64/sessionmanager-bundle.zip" -o "sessionmanager-bundle.zip"
   ```

------

1. 解压缩程序包。

   ```
   unzip sessionmanager-bundle.zip
   ```

1. 运行安装命令。

   ```
   sudo ./sessionmanager-bundle/install -i /usr/local/sessionmanagerplugin -b /usr/local/bin/session-manager-plugin
   ```
**注意**  
 该插件需要 Python 3.10 或更高版本。默认情况下，安装脚本在系统默认版本的 Python 下运行。如果已安装 Python 的可选版本并希望使用该版本安装 Session Manager 插件，请使用该版本按 Python 可执行文件的绝对路径运行安装脚本。示例如下：  

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

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

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

   ```
   ./sessionmanager-bundle/install -h
   ```

1. 验证安装是否成功。有关信息，请参阅[验证 Session Manager 插件安装](install-plugin-verify.md)。

**注意**  
如果需要卸载此插件，请按照所示顺序运行以下两个命令。  

```
sudo rm -rf /usr/local/sessionmanagerplugin
```

```
sudo rm /usr/local/bin/session-manager-plugin
```