使用 EC2 Image Builder 组件产品

登录 AWS 管理控制台并打开 Image Builder 控制台，网址为https://console.aws.amazon.com/imagebuilder/。

在左侧导航栏的 “保存的资源” 下，选择 “组件”。

在 “组件” 页面上，在 “筛选器所有者” 中，选择 “我拥有”。

选择组件名称。

在组件详情页面的摘要部分，复制 ARN。

登录 AWS 管理控制台并打开 IAM 控制台，网址为https://console.aws.amazon.com/iam/。

在左侧导航栏中，选择角色。

选择创建角色。

选择 “自定义信任策略”。

输入以下语句：

选择下一步。

添加您之前创建的 Image Builder 获取组件策略。获取组件策略是必需的。如果您的组件使用这些 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 格式的变更集文件。在示例中，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'

在返回的输出中，转到DetailsDocument，Versions部分。复制要更新的版本的DeliveryOptions、Id值。

使用以下代码示例，创建 JSON 格式的变更集文件。在示例中，your-product-ID替换为您在步骤 1 中获得的产品 ID。your-release-notes替换为您的发行说明。your-delivery-option-ID替换为您在步骤 3 中获得的配送选项的 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'

在返回的输出中，转到DetailsDocument，Versions部分。复制要更新的版本的DeliveryOptions、Id值。

使用以下代码示例，创建 JSON 格式的变更集文件。在示例中，your-product-ID替换为您在步骤 1 中获得的产品 ID。your-delivery-option-ID替换为您在步骤 3 中获得的配送选项的 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