使用 EC2 Image Builder 元件產品

登入 AWS 管理主控台，並在 開啟映像建置器主控台https://console.aws.amazon.com/imagebuilder/。

在左側導覽列的已儲存資源下，選擇元件。

在元件頁面上，針對篩選條件擁有者，選擇由我擁有。

選擇元件名稱。

在元件詳細資訊頁面的摘要區段中，複製 ARN。

登入 AWS 管理主控台，並在 https://console.aws.amazon.com/iam/：// 開啟 IAM 主控台。

在左側導覽列中，選擇角色。

選擇建立角色。

選取自訂信任政策。

輸入下列陳述式：

選擇下一步。

新增您先前建立的映像建置器 get-component 政策。需要 get-component 政策。如果您的元件使用 AWS 這些服務，請新增 S3、Secrets Manager 和 Parameter Store 的相關政策。

選擇下一步。

輸入角色名稱，例如 MPEC2IBIngestion。

選擇建立角色。

在 IAM 主控台的左側導覽列中，選擇角色。

選擇您先前建立的 AWS Marketplace IAM 角色，例如 MPEC2IBIngestion。

在角色詳細資訊頁面上的摘要區段中，複製 ARN。

開啟 AWS Marketplace 管理入口網站並登入您的賣方帳戶。

在產品功能表中，選擇伺服器。

在伺服器產品頁面上，選取產品。

在產品詳細資訊頁面上的請求變更功能表上，選擇對應至您要更新之資訊的項目。

提交任何變更後，請求將顯示在「審核中」狀態的請求索引標籤上，並在完成後變更為「成功」。

從 AWS Marketplace 管理入口網站取得產品 ID。

1. 開啟 AWS Marketplace 管理入口網站並登入您的賣方帳戶。

2. 在產品功能表中，選擇伺服器。

3. 在伺服器產品頁面上，選取產品。

4. 在產品摘要中，複製產品 ID。

使用下列程式碼範例，以 JSON 格式建立 changeset 檔案。在此範例中，將 your-product-ID 取代為您在步驟 1 中取得的產品 ID。將 new-version-name 取代為您的版本標題。將 new-delivery-option-title 取代為您的交付選項標題。

[
    {
        "ChangeType": "AddDeliveryOptions",
        "Entity": {
            "Identifier": "your-product-ID",
            "Type": "AmiProduct@1.0"
        },
        "DetailsDocument": {
            "Version": {
                "VersionTitle": "new-version-name",
                "ReleaseNotes": "Release notes goes here."
            },
            "DeliveryOptions": [
                {
                    "DeliveryOptionTitle": "new title",
                    "Details": {
                        "Ec2ImageBuilderComponentDeliveryOptionDetails": {
                            "UsageInstructions": "Test usage instructions for IB",
                            "AccessRoleArn": "arn:aws:iam::123456789:role/sample",
                            "ComponentArn": "arn:aws:imagebuilder:us-east-1:123456789:component/sample/2.0.0/1"
                        }
                    }
                }
            ]
        }
    }
]

儲存名稱為 的變更集檔案addIBversion.json。

在終端機或 中 AWS CloudShell，執行下列命令：

aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://addIBversion.json

從 AWS Marketplace 管理入口網站取得產品 ID。

1. 開啟 AWS Marketplace 管理入口網站 並登入您的賣方帳戶。

2. 在產品功能表中，選擇伺服器。

3. 在伺服器產品頁面上，選取產品。

4. 在產品摘要中，複製產品 ID。

在終端機中，執行下列命令。在 命令中，將 your-product-ID 取代為您在步驟 1 中取得的 ID。

aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID'

在傳回的輸出中，前往 DetailsDocumentVersions區段。複製您要更新之版本的 DeliveryOptionsId值。

使用下列程式碼範例，建立 JSON 格式的變更集檔案。在此範例中，將 your-product-ID 取代為您在步驟 1 中取得的產品 ID。以your-release-notes取代您的版本備註。以您在步驟 3 中取得的交付選項 ID 取代 your-delivery-option-ID。將 your-usage-instructions 取代為您的使用說明。

[
    {
        "ChangeType": "UpdateDeliveryOptions",
        "Entity": {
            "Identifier": "your-product-ID",
            "Type": "AmiProduct@1.0"
        },
        "DetailsDocument": {
            "Version": {
                "ReleaseNotes": "your-release-notes"
            },
            "DeliveryOptions": [
                {
                    "Id": "your-delivery-option-ID",
                    "Details": {
                        "Ec2ImageBuilderComponentDeliveryOptionDetails": {
                            "UsageInstructions": "your-usage-instructions"
                        }
                    }
                }
            ]
        }
    }
]

儲存名稱為 的變更集檔案updateVersionInfo.json。

在終端機或 中 AWS CloudShell，執行下列命令：

aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://updateVersionInfo.json

從 AWS Marketplace 管理入口網站取得產品 ID。

1. 開啟 AWS Marketplace 管理入口網站並登入您的賣方帳戶。

2. 在產品功能表中，選擇伺服器。

3. 在伺服器產品頁面上，選取產品。

4. 在產品摘要中，複製產品 ID。

在終端機中，執行下列命令。在 命令中，將 your-product-ID 取代為您在步驟 1 中取得的 ID。

aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID'

在傳回的輸出中，前往 DetailsDocumentVersions區段。複製您要更新之版本的 DeliveryOptionsId值。

使用下列程式碼範例，建立 JSON 格式的變更集檔案。在此範例中，將 your-product-ID 取代為您在步驟 1 中取得的產品 ID。以您在步驟 3 中取得的交付選項 ID 取代 your-delivery-option-ID。

[
    {
        "ChangeType": "RestrictDeliveryOptions",
        "Entity": {
            "Identifier": "your-product-ID",
            "Type": "AmiProduct@1.0"
        },
        "DetailsDocument": {
            "DeliveryOptionIds": [
                "your-delivery-option-ID"
            ]
        }
    }
]

儲存名稱為 的變更集檔案restrictec2ibversion.json。

在終端機或 中 AWS CloudShell，執行下列命令：

aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://restrictec2ibversion.json