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

# 將元件部署到您的裝置
<a name="edge-greengrass-deploy-components"></a>

使用 AWS IoT 主控台或使用 部署您的元件 AWS CLI。

## 若要部署您的元件 (主控台)
<a name="collapsible-section-gg-deploy-console"></a>

使用 AWS IoT 主控台部署您的 AWS IoT Greengrass 元件。

1. 在 https：//[https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/greengrass/) 導覽選單的 AWS IoT Greengrass 主控台中，選擇**部署**。

1. 在**元面**頁面上的**公用元件**索引標籤上，選擇 `aws.greengrass.SageMakerEdgeManager`。

1. 在 `aws.greengrass.SageMakerEdgeManager` 頁面中，選擇**部署**。

1. 從 `Add to deployment`，選擇下列任一選項：

   1. 若要將此元件合併至目標裝置上的現有部署，請選擇**新增至現有部**署，然後選取要修訂的部署。

   1. 若要在目標裝置上建立新部署，請選擇**建立新部署**。如果您的設備上有現有的部署，則選擇此步驟將取代現有部署。

1. 在**指定目標**頁面上，執行下列作業：

   1. 在**部署資訊**下，輸入或修改部署的易記名稱。

   1. 在**部署目標**下，選取部署的目標，然後選擇**下一步**。如果您要修訂既有部署，則無法變更部署目標。

1. 在**選取元件**頁面的**我的元件**下，選擇：
   + com.{{<CUSTOM-COMPONENT-NAME>}}
   + `aws.greengrass.SageMakerEdgeManager`
   + SagemakerEdgeManager.{{<YOUR-PACKAGING-JOB>}}

1. 在**設定元件**頁面上，選擇 **com.greengrass.SageMakerEdgeManager** 並進行以下操作。

   1. 選擇**設定元件**。

   1. 在**組態更新**下的**要合併的組態**中，輸入下列組態。

      ```
      {
          "DeviceFleetName": "device-fleet-name",
          "BucketName": "{{bucket-name}}"
      }
      ```

      以您建立的 Edge 裝置機群名稱取代 {{`device-fleet-name`}}，並以與裝置機群關聯的 Amazon S3 儲存貯體名稱取代 {{`{{bucket-name}}`}}。

   1. 選擇**確認**，然後選擇**下一步**。

1. 在**設定進階設定**頁面上，保留預設組態設定，然後選擇 **下一步**。

1. 在 **Review (檢閱)** 頁面，選擇 **Deploy (部署)**。

## 若要部署您的元件 (AWS CLI)
<a name="collapsible-section-gg-deploy-cli"></a>

1. 建立 ` deployment.json` 檔案以定義 SageMaker Edge Manager 元件的部署組態。該檔案應如以下範例所示。

   ```
   {
     "targetArn":"targetArn",
     "components": {
       "aws.greengrass.SageMakerEdgeManager": {
         "componentVersion": 1.0.0,
         "configurationUpdate": {
           "merge": {
             "DeviceFleetName": "device-fleet-name",
             "BucketName": "{{bucket-name}}"
           }
         }
       },
       "com.greengrass.SageMakerEdgeManager.ImageClassification": {
         "componentVersion": 1.0.0,
         "configurationUpdate": {
         }
       }, 
       "com.greengrass.SageMakerEdgeManager.ImageClassification.Model": {
         "componentVersion": 1.0.0,
         "configurationUpdate": {
         }
       }, 
     }
   }
   ```
   + 在 `targetArn` 欄位中，{{`targetArn`}}以下列格式將物件或物群組的 Amazon Resource Name (ARN) 取代為目標部署：
     + 物件：`arn:aws:iot:{{region}}:{{account-id}}:thing/{{thingName}}`
     + 物件群組：`arn:aws:iot:{{region}}:{{account-id:}}thinggroup/{{thingGroupName}}`
   + 在 `merge` 欄位中，以您建立的 Edge 裝置機群名稱取代 {{`device-fleet-name`}}，並以與裝置機群關聯的 Amazon S3 儲存貯體名稱取代 {{`{{bucket-name}}`}}。
   + 以最新的可用版本取代每個元件的元件版本。

1. 執行下列命令以在裝置上部署元件：

   ```
   aws greengrassv2 create-deployment \
       --cli-input-json file://path/to/deployment.json
   ```

可能需要幾分鐘才能完成部署。在下一個步驟中，檢查元件記錄檔以確認部署是否已順利完成，並檢視推論結果。

如需將元件部署至個別裝置或裝置群組的詳細資訊，請參閱將[AWS IoT Greengrass 元件部署至裝置](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-deployments.html)。