

• 2026 年 4 月 30 日之後將不再提供 AWS Systems Manager CloudWatch Dashboard。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板，就像現在一樣。如需詳細資訊，請參閱 [Amazon CloudWatch Dashboard 文件](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 Distributor
<a name="distributor-getting-started"></a>

在您使用 中的Distributor工具 AWS Systems Manager來建立、管理和部署軟體套件之前，請遵循下列步驟。

## 完成 Distributor 事前準備
<a name="distributor-prerequisites"></a>

使用 中的Distributor工具之前 AWS Systems Manager，請確定您的環境符合下列要求。


**Distributor 先決條件**  

| 需求 | Description | 
| --- | --- | 
|  SSM Agent  |  AWS Systems Manager SSM Agent 2.3.274.0 版或更新版本必須安裝在您要部署或移除套件的受管節點上。 若要安裝或更新 SSM Agent，請參閱 [使用 SSM Agent](ssm-agent.md)。  | 
|  AWS CLI  |  （選用） 若要使用 AWS Command Line Interface (AWS CLI) 而非 Systems Manager 主控台來建立和管理套件，請在本機 AWS CLI 電腦上安裝最新版本的 。 更多如何安裝或升級 CLI 的資訊，請參閱《*AWS Command Line Interface 使用者指南*》的[安裝 AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。  | 
|  AWS Tools for PowerShell  |  (選用) 若要使用 Tools for PowerShell 而非 Systems Manager 主控台來建立和管理套件，請安裝 Tools for PowerShell 的最新版本到您的本機電腦。 如需如何安裝或升級 Tools for PowerShell 的詳細資訊，請參閱 *AWS Tools for PowerShell 使用者指南*中的[設定 AWS Tools for Windows PowerShell 或 AWS Tools for PowerShell Core](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html)。  | 

**注意**  
Systems Manager 不支援使用 Distributor 將套件分配至 Oracle Linux 受管節點。

## 驗證或建立具有 Distributor 許可的 IAM 執行個體設定檔
<a name="distributor-getting-started-instance-profile"></a>

根據預設， AWS Systems Manager 沒有在您的執行個體上執行動作的許可。您必須使用 AWS Identity and Access Management (IAM) 執行個體描述檔授予存取權。執行個體設定檔是在啟動時將 IAM 角色資訊傳遞到 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體的容器。此要求適用於所有 Systems Manager 工具的許可，而不僅僅是 Distributor。

**注意**  
當您將邊緣裝置設定為執行 AWS IoT Greengrass 核心軟體和 時SSM Agent，您可以指定 IAM 服務角色，讓 Systems Manager 能夠對其執行 動作。您不需要使用執行個體設定檔來設定受管邊緣裝置。

如果您已使用 Systems Manager 的其他工具，例如 Run Command 和 State Manager，具有 Distributor 必要許可的執行個體設定檔已連接到您的執行個體。確保您有許可執行 Distributor 任務最簡單的方法是將 **AmazonSSMManagedInstanceCore** 政策連接到您的執行個體設定檔。如需詳細資訊，請參閱[設定 Systems Manager 所需的執行個體許可](setup-instance-permissions.md)。

## 控制使用者對套件的存取權
<a name="distributor-getting-started-restrict-access"></a>

使用 AWS Identity and Access Management (IAM) 政策，您可以控制誰可以建立、部署和管理套件。您也可以控制他們在受管節點上可執行的 Run Command 或 State Manager API 操作。和 一樣Distributor， Run Command和 State Manager都是 中的工具 AWS Systems Manager。

**ARN 格式**  
使用者定義的套件與文件 Amazon 資源名稱 (ARN) 相關，具有下列格式。

```
arn:aws:ssm:region:account-id:document/document-name
```

下列是 範例。

```
arn:aws:ssm:us-west-1:123456789012:document/ExampleDocumentName
```

您可以使用一對 AWS 提供的預設 IAM 政策，一個用於最終使用者，另一個用於管理員，以授予Distributor活動的許可。您也可以建立適用於您許可要求的自訂 IAM 政策。

如需有關在 IAM 政策中使用變數的詳細資訊，請參閱 [IAM 政策元素：變數](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_variables.html)。

如需有關如何建立政策並將其連接至使用者或群組的相關資訊，請參閱《IAM 使用者指南》**中的[建立 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)和[新增和移除 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。

## 建立或選擇要存放 Distributor 套件的 Amazon S3 儲存貯體
<a name="distributor-getting-s3-bucket"></a>

透過在 AWS Systems Manager 主控台中使用**簡單**工作流程來建立套件時，您可以選擇 Distributor 要將您的軟體上傳至其中的現有 Amazon Simple Storage Service (Amazon S3) 儲存貯體。Distributor 是 AWS Systems Manager中的工具。在 **Advanced** (進階) 工作流程中，您必須在開始前將軟體或資產的 .zip 檔案上傳到 Amazon Simple Storage Service (Amazon S3) 儲存貯體。無論您是透過在主控台中使用 **Simple** (簡便) 或 **Advanced** (進階) 工作流程或透過使用 API 來建立套件，您必須擁有 Amazon Simple Storage Service (Amazon S3) 儲存貯體，才能開始建立套件。在套件建立程序的過程中，Distributor 會將安裝型軟體和資產從這個儲存貯體複製到內部 Systems Manager 存放區。由於資產會複製到內部存放區，您可以在套件建立完成時刪除或重新利用您的 Amazon Simple Storage Service (Amazon S3) 儲存貯體。

若要如何建立儲存貯體的相關資訊，請參閱《*Amazon Simple Storage Service 入門指南*》中的[建立儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingABucket.html)。如需如何執行 AWS CLI 命令以建立儲存貯體的詳細資訊，請參閱《 *AWS CLI 命令參考*[https://docs.aws.amazon.com/cli/latest/reference/s3/mb.html](https://docs.aws.amazon.com/cli/latest/reference/s3/mb.html)》中的 。