View a markdown version of this page

更新基礎設施組態 - EC2 Image Builder

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

更新基礎設施組態

本節說明如何使用 中的映像建置器主控台或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/。

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

  3. 若要檢視詳細資訊或編輯基礎設施組態，請選擇組態名稱連結。這會開啟基礎設施組態的詳細資訊檢視。

    注意

    您也可以選取組態名稱旁的核取方塊，然後選擇檢視詳細資訊。

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

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

AWS CLI

下列範例顯示如何使用 中的 Image Builder update-infrastructure-configuration命令來更新映像的基礎設施組態 AWS CLI。

  1. 建立 CLI 輸入 JSON 文件

    在此範例中，設定符合建立範例，但 terminateInstanceOnFailure 設定為 除外true。在您執行 update-infrastructure-configuration命令後，使用此基礎設施組態的管道會在建置失敗時終止建置和測試執行個體。

    下列範例會設定常見的基礎設施欄位。若要在建置和測試執行個體上要求 IMDSv2 權杖，請新增 instanceMetadataOptions區塊，並將 httpTokens設定為 required。

    注意

    我們建議您將映像建置器從管道建置啟動的所有 EC2 執行個體設定為使用 IMDSv2，以便執行個體中繼資料擷取請求需要簽章權杖標頭。

    使用檔案編輯工具建立 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": [
    "m7i.large", "m7i.2xlarge"
],
"instanceProfileName": "myIAMInstanceProfileName",
"securityGroupIds": [
    "sg-12345678"
],
"subnetId": "subnet-12345678",
"logging": {
    "s3Logs": {
        "s3BucketName": "my-logging-bucket",
        "s3KeyPrefix": "my-path"
    }
},
"terminateInstanceOnFailure": true,
"snsTopicArn": "arn:aws:sns:us-west-2:123456789012:MyTopic"
}
  2. 當您執行下列命令時，請使用您建立的檔案做為輸入。
    aws imagebuilder update-infrastructure-configuration --cli-input-json file://update-infrastructure-configuration.json