View a markdown version of this page

EC2 Image Builder 구성 요소 제품 작업 - AWS Marketplace

AWS Marketplace API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 AWS Marketplace API 참조를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

EC2 Image Builder 구성 요소 제품 작업

AWS Marketplace 판매자는 EC2 Image Builder 구성 요소를 사용하여 AWS Marketplace 구매자에게 제공되는 AMI 기반 제품을 나열할 수 있습니다. 구성 요소를 생성하고 AWS Marketplace 목록을 게시하려면 다음 섹션을 순차적으로 진행합니다.

Image Builder 구성 요소 빌드 및 테스트

Image Builder에서 구성 요소를 빌드하고 테스트합니다. 지침은 Image Builder 사용 설명서의 Image Builder 이미지에 대한 사용자 지정 구성 요소 개발을 참조하세요. Image Builder를 사용하여 구성 요소를 생성할 때 다음을 수행해야 합니다.

  • Amazon Simple Storage Service(Amazon S3) 버킷, 보안 암호 또는 파라미터와 같은 구성 요소 및 모든 기본 종속성은 미국 동부(버지니아 북부)(us-east-1) AWS 리전에서 생성해야 합니다.

  • 구성 요소 설명에 지원되는 아키텍처 및 모든 소프트웨어 종속성을 포함합니다.

  • 이미지 파이프라인을 생성하고 파이프라인에서 생성한 AMI를 배포하여 AWS 계정에서 구성 요소를 테스트합니다.

  • 구성 요소에 S3 버킷에서 바이너리, 패키지 또는 파일을 복사하는 지침이 포함되어 있는 경우 S3Download 작업 모듈을 사용합니다. S3Download 모듈의에 S3 버킷에 있는 파일의 정적 위치를 source입력합니다. 다음 예제에서는 구성 요소 설치의 일부로 S3 버킷에서 바이너리를 복사합니다.

    - name: DownloadMyFile action: S3Download inputs: - source: s3://amzn-s3-demo-source-bucket/path/to/package.zip destination: C:\myfolder\package.zip
  • 구성 요소는 S3Download 작업을 사용할 때 최대 2GB의 파일을 수집할 수 있습니다.

  • 구성 요소에서 파라미터를 사용하는 경우 모든 파라미터에 기본값이 있는지 확인합니다. 예를 들어 라는 파라미터가 있는 경우 region와 같은 유효한 기본값이 있는지 확인합니다us-east-1. 이러한 기본값은 AWS Marketplace 처리 및 테스트를 위한 것입니다. 기본값을 포함하지 않으면 테스트가 실패할 수 있습니다.

  • 구성 요소에서 파라미터 스토어 또는 AWS Secrets Manager의 기능을 사용하여 파라미터를 저장하는 경우 다음을 수행합니다 AWS Systems Manager .

    • 구성 요소의 한 단계로 값을 검색하려면 YAML 구성 파일에 명령을 포함합니다 AWS Command Line Interface .

    • AWS 계정의 Secrets Manager 또는 Parameter Store에서 해당 항목을 생성합니다. 기본 키를 사용하고 AWS Marketplace 테스트 프로세스 중에 구성 요소를 빌드하는 데 도움이 되는 유효한 값을 제공합니다. 예를 들어 Parameter Store를 사용하는 기본값이 saas_token 인 라는 파라미터token가 있다고 가정해 보겠습니다. 이 경우 Parameter Store에서 키-값 페어를 생성합니다. 를 키token로 사용합니다. 값에 애플리케이션에 유효한 SaaS 토큰을 입력합니다.

      AWS Marketplace 판매자 계정에 저장된 값은 AWS Marketplace 테스트 목적으로만 사용됩니다. 이러한 값은 구매자와 공유되지 않습니다.

    • AWS Marketplace 는 구성 요소 생성 프로세스 중에 선택한 모든 호환 운영 체제 버전에서 구성 요소에 대한 Amazon Machine Image(AMIs)를 자동으로 생성합니다. 구성 요소를 빌드할 때 호환되는 운영 체제 버전을 하나 이상 선택합니다. EC2 Image Builder 파이프라인을 사용하여 AMIs.

구성 요소 ARN 복사

Image Builder에서 구성 요소를 생성하고 테스트한 후 구성 요소 ARN을 복사하고 저장합니다. AWS Marketplace 카탈로그 API를 사용하여 제품 목록을 게시할 때 ARN을 사용합니다.

Image Builder 구성 요소 ARN을 복사하려면
  1. AWS Management Console에 로그인하고에서 Image Builder 콘솔을 엽니다https://console.aws.amazon.com/imagebuilder/.

  2. 왼쪽 탐색 모음의 저장된 리소스에서 구성 요소를 선택합니다.

  3. 구성 요소 페이지의 필터 소유자에서 내 소유를 선택합니다.

  4. 구성 요소 이름을 선택합니다.

  5. 구성 요소 세부 정보 페이지의 요약 섹션에서 ARN을 복사합니다.

AWS Marketplace IAM 정책 생성

다음 IAM 정책을 생성하여 Image Builder 구성 요소 및 Amazon S3 버킷 및 보안 암호와 같은 관련 리소스에 대한 AWS Marketplace 액세스 권한을 부여합니다. 제공된 예제 정책을 사용합니다. 이러한 정책을 AWS Marketplace IAM 역할에 연결합니다. 정책 생성에 대한 도움말은 IAM 사용 설명서의 JSON 편집기를 사용하여 정책 생성을 참조하세요.

  • Image Builder에서가 구성 요소에 AWS Marketplace 액세스할 수 있도록 허용하는 Image Builder 구성 요소 가져오기 정책입니다. 이 정책은 필수입니다. 정책 이름을 mp_ib_ingest로 지정합니다.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": "imagebuilder:GetComponent", "Resource": "*" } ] }
  • 가 S3 버킷에서 바이너리를 검색할 수 있도록 허용하는 Amazon S3 읽기 액세스 정책입니다. AWS Marketplace 이 정책은 구성 요소가 S3Download 작업 모듈을 사용하고 연결된 바이너리를 S3 버킷에 저장하는 경우에만 필요합니다. 정책 이름을 mp_ib_s3_read_only로 지정합니다.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "ListObjectsInBucket", "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::bucket_name" ] }, { "Sid": "ReadObjectsInBucket", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectAttributes" ], "Resource": [ "arn:aws:s3:::bucket_name/*" ] } ] }
  • 가 Secrets Manager에 저장된 보안 암호를 AWS Marketplace 검색할 수 있도록 허용하는 Secrets Manager 읽기 액세스 정책입니다. 이 정책은 구성 요소가 Secrets Manager를 사용하여 암호를 저장하는 경우에만 필요합니다. 정책 이름을 mp_ib_sm_read_only로 지정합니다. 정책을 보안 암호로만 제한하려면 Resource 섹션의 *를 보안 암호로 바꿉니다.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue" ], "Resource": [ "*" ] } ] }
  • AWS Marketplace 가 파라미터 스토어에 저장된 보안 암호를 검색할 수 있도록 허용하는 파라미터 스토어 읽기 액세스 정책입니다. 이 정책은 구성 요소가 Parameter Store를 사용하여 암호를 저장하는 경우에만 필요합니다. 정책 이름을 mp_ib_ssm_parameter_read_only로 지정합니다. 정책을 보안 암호로만 제한하려면 Resource 섹션의 *를 보안 암호로 바꿉니다.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Action": [ "ssm:getParameter" ], "Resource": [ "*" ] } ] }

AWS Marketplace IAM 역할 생성

다음 절차에 따라 구성 요소 및 해당 종속성에 대한 AWS Marketplace 액세스 권한을 부여하는 정책이 포함된 AWS Marketplace IAM 역할을 생성합니다.

AWS Marketplace IAM 역할을 생성하려면
  1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/iam/ IAM 콘솔을 엽니다.

  2. 왼쪽 탐색 모음에서 역할을 선택합니다.

  3. 역할 생성을 선택합니다.

  4. 사용자 지정 신뢰 정책을 선택합니다.

  5. 다음 문을 입력합니다.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Principal": { "Service": "assets.marketplace.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
  6. 다음을 선택합니다.

  7. 이전에 생성한 Image Builder get-component 정책을 추가합니다. get-component 정책이 필요합니다. 구성 요소에서 이러한 AWS 서비스를 사용하는 경우 S3, Secrets Manager 및 Parameter Store에 대한 관련 정책을 추가합니다.

  8. 다음을 선택합니다.

  9. 와 같은 역할 이름을 입력합니다MPEC2IBIngestion.

  10. 역할 생성을 선택합니다.

AWS Marketplace IAM 역할 ARN 복사

AWS Marketplace IAM 역할을 생성한 후 역할 ARN을 복사하고 저장합니다. AWS Marketplace 카탈로그 API를 사용하여 목록을 게시할 때 ARN을 사용합니다.

AWS Marketplace IAM 역할 ARN을 복사하려면
  1. IAM 콘솔의 왼쪽 탐색 모음에서 역할을 선택합니다.

  2. 와 같이 이전에 생성한 AWS Marketplace IAM 역할을 선택합니다MPEC2IBIngestion.

  3. 역할 세부 정보 페이지의 요약 섹션에서 ARN을 복사합니다.

Image Builder 구성 요소 목록 준비

AWS Marketplace 목록을 게시하기 전에 다음 정보를 준비해야 합니다.

  • 제품 메타데이터 - 메타데이터에는 제품 로고, 제품 제목, 최종 사용자 라이선스 계약, 지원되는 인스턴스 유형 및 AWS 리전이 포함됩니다.

  • 요금 정보 - 제품을 무료, 시간당 요금 또는 초기 무료 평가판 기간에 시간당 요금으로 제공할 수 있습니다. 기존 보유 라이선스 사용(BYOL)은 지원되지 않습니다.

  • 구성 요소 세부 정보 - 세부 정보에는가 구성 요소를 처리하기 위해 수임할 구성 요소 Amazon 리소스 번호(ARN), 사용 세부 정보 및 AWS Identity and Access Management (IAM) 역할 AWS Marketplace 이 포함됩니다.

Image Builder 구성 요소 제품 목록 게시

이 주제에는 AWS Marketplace 카탈로그 API를 AWS Marketplace 사용하여에 EC2 Image Builder 구성 요소 목록을 게시하는 지침이 포함되어 있습니다.

사전 조건

Image Builder 구성 요소 제품 목록을 게시하기 전에 다음이 있는지 확인합니다.

  • 에서 판매자로 등록 AWS Marketplace. 자세한 내용은 AWS Marketplace 판매자로 등록을 참조하세요.

  • AWSMarketplaceSellerFullAccess 권한이 있는 IAM 사용자.

  • 구성 요소에 사용되는 경우 회사 로고와 EULA를 호스팅하기 위한 공개적으로 액세스 가능한 Amazon Simple Storage Service(Amazon S3) 버킷입니다. ChangeSet JSON 파일에 S3 버킷의 URL을 입력합니다.

  • AWS Command Line Interface (AWS CLI). 자세한 내용은 AWS 명령줄 인터페이스란 무엇입니까?를 참조하세요. AWS Command Line Interface 사용 설명서의 .

에서 Image Builder 구성 요소 제품 생성 AWS Marketplace

카탈로그 API를 AWS Marketplace 사용하여에서 EC2 Image Builder 구성 요소 제품을 생성하려면 섹션을 참조하세요제품 생성.

Image Builder 구성 요소 제품 정보 업데이트

AWS Marketplace Management Portal에서 Image Builder 구성 요소 제품에 대한 정보를 업데이트할 수 있습니다.

Image Builder 구성 요소 제품 정보를 업데이트하려면
  1. AWS Marketplace Management Portal을 열고 판매자 계정에 로그인합니다.

  2. 제품 메뉴에서 서버를 선택합니다.

  3. 서버 제품 페이지에서 제품을 선택합니다.

  4. 제품 세부 정보 페이지의 변경 요청 메뉴에서 업데이트하려는 정보에 해당하는 항목을 선택합니다.

  5. 변경 사항을 제출하면 요청이 요청 탭의 '검토 중' 상태로 나타나고 완료되면 '성공'으로 변경됩니다.

기존 Image Builder 구성 요소 제품에 새 버전 추가

를 AWS Marketplace 사용하여에서 Image Builder 구성 요소 제품에 새 버전을 추가할 수 있습니다 AWS Marketplace Catalog API.

새 버전을 추가하는 방법
  1. 에서 제품 ID를 AWS Marketplace Management Portal가져옵니다.

    1. AWS Marketplace Management Portal을 열고 판매자 계정에 로그인합니다.

    2. 제품 메뉴에서 서버를 선택합니다.

    3. 서버 제품 페이지에서 제품을 선택합니다.

    4. 제품 요약에서 제품 ID를 복사합니다.

  2. 다음 코드 예제를 사용하여 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" } } } ] } } ]
  3. 이름이 인 변경 세트 파일을 저장합니다addIBversion.json.

  4. 터미널 또는에서 다음 명령을 AWS CloudShell실행합니다.

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

start-change-set 명령은 ChangeSetId 값을 반환합니다. 변경 세트를 모니터링하려면 섹션을 참조하세요변경 세트 모니터링.

비동기 오류

다음 오류는의 AddDeliveryOptions 작업에만 해당됩니다 AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 섹션을 참조하세요변경 세트 작업.

참고

다음 오류 코드는 Image Builder 전송 방법에 따라 다릅니다. Usage Instructions, Recommended Instance type및와 같은 필드의 기존 오류 메시지는 섹션을 AccessRoleArn참조하세요새 버전 추가.

오류 코드 오류 메시지

ASSET_NOT_FOUND

[account-id] AWS 계정에 [component arn]이 있고 제공된 AccessARN[ARN]에이 Image Builder 구성 요소를와 공유할 권한이 있는지 확인합니다 AWS Marketplace.

ASSET_NOT_FOUND

구성 요소[x] 내에 지정된 S3 링크[x]가 존재하지 않습니다. 구성 요소 내에 유효한 S3 링크를 제공합니다.

DUPLICATE_COMPONENT_NAME

구성 요소 이름 [x]가 이미 동일한 버전 내에 있습니다. 다른 구성 요소 이름을 입력합니다.

DUPLICATE_COMPONENT_NAME

제공한 구성 요소 이름 [x]가 이미 다른 제품에서 사용 중입니다. 다른 구성 요소 이름을 입력합니다.

DUPLICATE_COMPONENT_ARN

구성 요소 Arn [x]는이 제품의 동일한 버전의 다른 전송 옵션에 사용되는 구성 요소 Arn과 달라야 합니다.

DUPLICATE_COMPONENT_ARN

구성 요소 ARN [x]는이 제품의 다른 버전에서 사용되는 구성 요소 ARN과 달라야 합니다.

SCAN_ERROR

구성 요소 [x]의 보안 취약성 [y]를 수정합니다.

ASSET_ACCESS_EXCEPTION

지정된 S3 버킷[x]에서 콘텐츠를 읽는 데 필요한 권한이 없습니다. S3 버킷에 적절한 읽기 권한이 있는지 확인합니다.

ASSET_ACCESS_EXCEPTION

지정된 구성 요소 ARN[x]의 내용을 읽는 데 필요한 권한이 없습니다. 구성 요소 ARN에 적절한 읽기 권한이 있는지 확인합니다.

ASSET_ACCESS_EXCEPTION

지정된 패키지 URI [x]의 내용을 읽는 데 필요한 권한이 없습니다. 패키지 URI에 적절한 읽기 권한이 있는지 확인합니다.

ASSET_ACCESS_EXCEPTION

HTTP 소스 [x]에서 읽지 못했습니다. 제공된 HTTP 소스가 올바른지 확인합니다.

INVALID_IMAGE_BUILDER_COMPONENT_PACKAGE

구성 요소 자산이 수집 크기 제한을 초과합니다. S3/웹 다운로드 크기를 줄이거나 불필요한 다운로드를 제거하여 계속 진행합니다.

INVALID_IMAGE_BUILDER_COMPONENT_PACKAGE

구성 요소 자산을 수집하는 데 너무 오래 걸립니다. 네트워크 연결이 안정적이고 대역폭이 적절한지 확인합니다.

TOO_MANY_IMAGE_BUILDER_COMPONENTS

제품당 최대 5개의 고유한 구성 요소 이름이 지원되므로 추가 전송 옵션을 제한합니다.

INCOMPLETE_SELLER_PUBLIC_PROFILE

판매자 공개 프로필이 완료되지 않았습니다. 제품에 버전을 추가하기 전에 퍼블릭 프로필을 작성합니다.

INVALID_DESCRIPTION

설명이 누락되었습니다. 구성 요소 [x]에 1,024자 미만의 설명을 입력합니다.

INVALID_COMPONENT_NAME

[x]자 미만의 구성 요소 이름을 입력합니다.

INVALID_SUPPORTED_OS_VERSION

OS 버전이 누락되었습니다. 구성 요소 [x]에 지원되는 유효한 OS 버전을 제공합니다.

INVALID_PATH_FORMAT

[PHASE_NAME] 단계의 [STEP_NAME]단계는 InstallMSI/UninstallMSI 작업에 S3 또는 웹 URLs을 사용할 수 없습니다. 지정된 경로가 작업을 실행하는 시스템에서 액세스할 수 있는 유효한 로컬 경로인지 확인합니다.

INCOMPATIBLE_OS_TYPE

지정된 구성 요소 OS 유형[x]이 기본 이미지의 플랫폼과 호환되지 않습니다. 기본 이미지와 호환되는 OS 유형을 제공합니다.

ASSET_ACCESS_EXCEPTION

지정된 SSM 파라미터 [x]에서 콘텐츠를 읽는 데 필요한 권한이 없습니다. API 입력에 제공된 IAM 액세스 역할에 필요한 읽기 권한이 있는지 확인합니다.

ASSET_ACCESS_EXCEPTION

지정된 SecretsManager 보안 암호 [x]에서 콘텐츠를 읽는 데 필요한 권한이 없습니다. API 입력에 제공된 IAM 액세스 역할에 필요한 읽기 권한이 있는지 확인합니다.

INVALID_IB_COMPONENT_BUILD_VERSION

구성 요소 ARN [x]의 빌드 버전은 [y]입니다.는 빌드 버전 1 AWS Marketplace 만 지원합니다. 빌드 버전 1을 사용하여 새 EC2 Image Builder 버전을 생성하고 다시 시도하세요. AWS Marketplace

INVALID_IB_COMPONENT_PARAMETER

구성 요소 [y]에 대한 입력 [x]에서 SSM 파라미터를 구문 분석할 수 없습니다.

INVALID_IB_COMPONENT_PARAMETER

구성 요소 [y]에 대한 입력 [x]에서 SecretsManager 보안 암호를 구문 분석할 수 없습니다.

MISSING_IB_COMPONENT_PARAMETER

입력 [y]에 대한 구성 요소 [x]에서 파라미터를 찾을 수 없음

INVALID_IB_COMPONENT_PARAMETER

구성 요소 [y]에 파라미터 [x]의 기본값을 입력합니다.

FAILED_LAUNCH_TEST

구성 요소 [x]에 대한 시작 테스트가 실패했습니다. 오류 메시지: [z]

SSHAuthFailedForUserAndKeypair

OS 기본 사용자 이름 [X]로 인스턴스에 로그인할 수 없습니다.

INVALID_IB_COMPONENT

구성 요소 빌드 단계가 필요합니다. 구성 요소에 유효한 빌드 단계 추가 [x]

DUPLICATE_VERSION_TITLE

버전 제목은이 제품의 다른 버전 제목과 달라야 합니다.

INVALID_VERSION_TITLE

상표 기호 앞에 공백을 제거합니다.

INVALID_VERSION_TITLE

지원되지 않는 문자 제거: [x, y, z]

INVALID_VERSION_TITLE

버전 제목의 시작 부분에서 공백을 제거합니다.

INVALID_VERSION_TITLE

[x]자 미만의 버전 제목을 제공합니다.

INVALID_RELEASE_NOTES

상표 기호 앞에 공백을 제거합니다.

INVALID_RELEASE_NOTES

지원되지 않는 문자 제거: [x, y, z]

INVALID_RELEASE_NOTES

릴리스 정보 시작 부분에서 공백을 제거합니다.

INVALID_RELEASE_NOTES

(x)자 미만의 릴리스 정보를 제공합니다.

INVALID_USAGE_INSTRUCTIONS

상표 기호 앞에 공백을 제거합니다.

INVALID_USAGE_INSTRUCTIONS

지원되지 않는 문자 제거: [x, y, z]

INVALID_USAGE_INSTRUCTIONS

(x)자 미만의 사용 지침을 제공합니다.

DUPLICATE_DELIVERY_OPTION_TITLES

고유한 전송 옵션 제목을 제공합니다.

INVALID_DELIVERY_OPTION_TITLES

전송 옵션 제목이 이미 있습니다. 다른 제목으로 다시 시도하세요.

기존 버전에 대한 정보 업데이트

기존 버전에 대한 정보를 업데이트하려면
  1. 에서 제품 ID를 AWS Marketplace Management Portal가져옵니다.

    1. AWS Marketplace Management Portal을 열고 판매자 계정에 로그인합니다.

    2. 제품 메뉴에서 서버를 선택합니다.

    3. 서버 제품 페이지에서 제품을 선택합니다.

    4. 제품 요약에서 제품 ID를 복사합니다.

  2. 터미널에서 다음 명령을 실행합니다. 명령에서 your-product-ID를 1단계에서 얻은 ID로 바꿉니다.

    aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID'
  3. 반환된 출력에서 DetailsDocument, Versions 섹션으로 이동합니다. 업데이트하려는 버전의 IdDeliveryOptions인를 복사합니다.

  4. 다음 코드 예제를 사용하여 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" } } } ] } } ]
  5. 이름이 인 변경 세트 파일을 저장합니다updateVersionInfo.json.

  6. 터미널 또는에서 다음 명령을 AWS CloudShell실행합니다.

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

start-change-set 명령은 ChangeSetId 값을 반환합니다. 변경 세트를 모니터링하려면 섹션을 참조하세요변경 세트 모니터링.

Image Builder 구성 요소 제품 버전 제한

버전을 제한하면 구매자가 버전을 사용할 수 없게 됩니다. AWS Marketplace 카탈로그 API를 AWS Marketplace 사용하여에서 Image Builder 구성 요소 제품의 버전을 제한할 수 있습니다. 제품 버전을 하나 이상 무제한으로 유지해야 합니다 AWS Marketplace. 유일한 퍼블릭 버전에 대한 액세스를 제한할 수 없습니다.

기존 버전에 대한 정보를 업데이트하려면
  1. 에서 제품 ID를 AWS Marketplace Management Portal가져옵니다.

    1. AWS Marketplace Management Portal을 열고 판매자 계정에 로그인합니다.

    2. 제품 메뉴에서 서버를 선택합니다.

    3. 서버 제품 페이지에서 제품을 선택합니다.

    4. 제품 요약에서 제품 ID를 복사합니다.

  2. 터미널에서 다음 명령을 실행합니다. 명령에서 your-product-ID를 1단계에서 얻은 ID로 바꿉니다.

    aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID'
  3. 반환된 출력에서 DetailsDocument, Versions 섹션으로 이동합니다. 업데이트하려는 버전의 IdDeliveryOptions인를 복사합니다.

  4. 다음 코드 예제를 사용하여 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" ] } } ]
  5. 이름이 인 변경 세트 파일을 저장합니다restrictec2ibversion.json.

  6. 터미널 또는에서 다음 명령을 AWS CloudShell실행합니다.

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

start-change-set 명령은 ChangeSetId 값을 반환합니다. 변경 세트를 모니터링하려면 섹션을 참조하세요변경 세트 모니터링.

변경 세트 모니터링

start-change-set 명령은 ChangeSetId 값을 반환합니다. 다음과 같은 방법으로 변경 세트 진행 상황을 모니터링할 수 있습니다.

  • 터미널에서 다음 명령을 실행합니다. 명령에서 changeset-IDstart-change-set 명령에서 반환된 ChangeSetId 값으로 바꿉니다.

    aws marketplace-catalog describe-change-set ‐‐catalog AWSMarketplace ‐‐change-set-id changesetID
  • AWS Marketplace Management Portal의 요청 탭에서 요청 상태를 확인합니다.

소프트웨어 다운로드 보안

ISV 소프트웨어 지적 재산을 보호하고 AWS Marketplace 구매자에게 안정적이고 일관된 소프트웨어 제공을 보장하기 위해 구성 요소의 S3DownloadWebDownload 작업 모듈을 AWS Marketplace 자동으로 구문 분석합니다. 그러면 참조된 파일이에서 관리하는 프라이빗 Amazon S3 버킷에 안전하게 저장됩니다 AWS Marketplace. 이 수집 프로세스를 옵트아웃하고 소프트웨어 다운로드를 독립적으로 관리하려면 wget 또는 curl 다운로드 명령을 사용하는 bash 스크립트를 실행합니다.