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

# 更新基礎設施組態
<a name="update-infra-config"></a>

本節說明如何使用 中的映像建置器主控台或**imagebuilder**命令 AWS CLI 來更新基礎設施組態資源。若要追蹤您的 資源，您可以套用標籤，如下所示。標籤會輸入為索引鍵值對。
+ *資源標籤*會將中繼資料標籤指派給映像建置器在建置程序期間啟動的 Amazon EC2 執行個體。
+ *標籤*會將中繼資料標籤指派給 Image Builder 建立為輸出的基礎設施組態資源。

------
#### [ Console ]

您可以從 Image Builder 主控台編輯下列基礎設施組態詳細資訊：
+ 基礎設施組態的**描述**。
+ 要與執行個體描述檔建立關聯的 **IAM 角色**。
+ **AWS 基礎設施**，包括**執行個體類型**和通知的 **SNS 主題**。
+ **VPC、子網路和安全群組**。
+ **故障診斷設定**，包括**故障時終止執行個體**、用於連線的**金鑰對**，以及執行個體日誌的選用 S3 儲存貯體位置。

若要從 Image Builder 主控台更新基礎設施組態資源，請遵循下列步驟：

**選擇現有的映像建置器基礎設施組態**

1. 開啟 EC2 Image Builder 主控台，位於 [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。

1. 若要查看您帳戶下的基礎設施組態資源清單，請從導覽窗格中選擇**基礎設施組態**。

1. 若要檢視詳細資訊或編輯基礎設施組態，請選擇**組態名稱**連結。這會開啟基礎設施組態的詳細資訊檢視。
**注意**  
您也可以選取**組態名稱**旁的核取方塊，然後選擇**檢視詳細資訊**。

1. 從**基礎設施詳細資訊**面板的右上角，選擇**編輯** 。

1. 當您準備好儲存對基礎設施組態所做的更新時，請選擇**儲存變更**。

------
#### [ AWS CLI ]

下列範例顯示如何使用 中的 Image Builder **[update-infrastructure-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-infrastructure-configuration.html)**命令來更新映像的基礎設施組態 AWS CLI。

1. 

**建立 CLI 輸入 JSON 文件**

   此基礎設施組態範例使用與建立範例相同的設定，除了我們已將`terminateInstanceOnFailure`設定更新為 `false`。執行 **update-infrastructure-configuration**命令後，使用此基礎設施組態的管道會在建置失敗時終止建置和測試執行個體。

   使用檔案編輯工具建立 JSON 檔案，其中包含下列範例中顯示的索引鍵，以及適用於您環境的值。此範例使用名為 `update-infrastructure-configuration.json` 的檔案：

   ```
   {
   "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-{{2:123456789012}}:infrastructure-configuration/{{my-example-infrastructure-configuration}}",
   "description": "{{An example that will terminate instances of failed builds}}",
   "instanceTypes": [
       "m5.large", "m5.2xlarge"
   ],
   "instanceProfileName": "{{myIAMInstanceProfileName}}",
   "securityGroupIds": [
       "{{sg-12345678}}"
   ],
   "subnetId": "sub-12345678",
   "logging": {
       "s3Logs": {
           "s3BucketName": "{{my-logging-bucket}}",
           "s3KeyPrefix": "{{my-path}}"
       }
   },
   "terminateInstanceOnFailure": true,
   "snsTopicArn": "arn:aws:sns:us-west-{{{{2:123456789012}}}}:{{MyTopic}}"
   }
   ```

1. 

**當您執行下列命令時，請使用您建立的檔案做為輸入。**

   ```
   aws imagebuilder update-infrastructure-configuration --cli-input-json file://{{update-infrastructure-configuration.json}}
   ```

------