배포 패키지 만들기

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 페이지에서는 가상 머신(VM) 제품의 배포 패키지를 만드는 단계를 설명합니다. Google Cloud Marketplace에 제품을 게시하려면 배포 패키지를 만들고 제출해야 합니다.

배포는 제품에 필요한 리소스와 같이 함께 만들고 관리하는 리소스 모음입니다. 배포 패키지는 일반적으로 함께 배포되는 리소스 집합의 사양이며 특정 제품을 배포하는 프로세스를 간소화합니다.

이 가이드에서는 Deployment Manager를 사용하여 배포 패키지를 만듭니다. Deployment Manager를 사용 설정하면 간단한 YAML, JSON 또는 ProtoText 구성 파일을 사용하여 VM 제품의 배포 패키지를 만들 수 있습니다.

배포 패키지를 만드는 방법 결정

Producer Portal의 가이드 방식 구성 옵션을 사용하여 Google Cloud 콘솔에서 직접 배포 패키지를 만드는 것이 좋습니다.

가이드 방식 구성에서는 기본 방화벽 규칙을 사용한 단일 VM 배포와 같은 간단한 VM 제품을 지원하지만 여러 VM 및 커스텀 구성 필드가 있는 배포 등의 일부 복잡한 기능은 지원하지 않습니다. 가이드 방식 구성에서 지원하지 않는 기능이 필요한 경우 오픈소스 mpdev 도구를 사용하여 배포 패키지를 만들거나 추가 기능을 통해 기존 패키지를 맞춤 설정할 수 있습니다.

가이드 방식 구성 및 수동 구성 간 전환

Producer Portal의 가이드 방식 구성 옵션을 사용하고 나중에 배포 패키지를 수동으로 구성하도록 전환하려는 경우 수동 구성으로 이동을 클릭하여 수동 구성으로 전환할 수 있습니다.

전환할 때 가이드 방식 구성에서 만든 배포 패키지의 Autogen 사양을 다운로드하여 수동 구성의 기초로 사용할 수 있습니다.

시작하기 전에

  1. 배포는 Terraform을 사용하지 않거나 Terraform에 대한 종속 항목을 갖지 않아야 합니다.

  2. mpdev 도구를 사용하여 배포 패키지를 만드는 경우 다음 단계를 완료합니다.

    1. marketplace-tools 저장소의 안내에 따라 mpdev 도구를 설치합니다.
    2. Google Cloud SDK를 다운로드합니다.

배포 패키지 만들기 및 제출

다음 섹션에서는 배포 패키지를 만들고 패키지를 검토할 수 있도록 Google에 제출하는 방법을 설명합니다.

다음 방법 중 하나를 사용하여 배포 패키지를 만듭니다.

Google Cloud 콘솔을 사용하여 배포 패키지 만들기

Google Cloud 콘솔을 사용하여 간단한 배포 패키지를 만들고 제출하려면 다음 안내를 따르세요.

  1. Producer Portal에서 배포 패키지 섹션으로 이동합니다.

  2. 간단한 솔루션을 위한 가이드 방식 구성를 선택하고 계속을 클릭합니다.

  3. 자동 생성 사양 구성 섹션에서 Cloud Storage Bucket 라벨이 지정된 입력 필드 옆에 있는 찾아보기를 클릭합니다.

    Cloud Storage 버킷을 이미 만들었으면 여기에서 선택합니다.

    Cloud Storage 버킷이 없으면 라벨이 새 버킷 만들기로 표시된 아이콘을 클릭합니다. 새 버킷을 만들 때는 다음을 수행합니다.

    • 버킷 이름을 선택합니다.
    • 버킷에서 데이터를 저장하는 리전을 지정합니다.
    • 데이터의 스토리지 클래스를 지정합니다.
    • 버킷 데이터의 Identity and Access Management(IAM) 권한에 적용할 세부사항 수준을 결정합니다.
    • 암호화 또는 데이터 보관 정책과 같은 선택적 고급 설정을 구성합니다.

  4. Cloud Storage 버킷에서 객체 버전 관리가 사용 설정되어 있는지 확인합니다.

  5. 버킷 설정을 저장하고 배포 패키지를 구성하려면 구성을 클릭합니다.

  6. 제품 이미지 선택에서 VM 이미지를 선택합니다.

    선택한 VM 이미지는 다음과 같아야 합니다.

    • 현재 Google Cloud 프로젝트와 연결되어 있습니다.

    • 제품의 올바른 라이선스에 연결되어 있습니다. VM 이미지를 만들 때 이 라이선스를 만들고 연결합니다.

  7. 머신 유형 선택에서 VM 제품의 기본 영역, 최소 머신 유형 및 기본 머신 유형을 부팅 디스크의 크기 및 유형과 함께 지정해야 합니다.

  8. 운영체제 지정에서 VM 이미지가 사용하는 OS의 이름 및 버전과 함께 VM 이미지의 버전 번호를 지정해야 합니다.

  9. 원하는 경우 VM 액세스 설정에서 사용자가 배포 후 VM에 액세스하는 데 사용할 수 있는 사용자 이름 및 비밀번호와 함께 사이트 및 관리자 URL을 지정할 수 있습니다.

  10. 원하는 경우 네트워킹 구성에서 IP 전달 설정을 지정하고 방화벽 규칙을 구성할 수 있습니다.

  11. 원하는 경우 다음 단계 정의에서 제품 사용자에게 제품 시작에 대한 가이드를 제공할 수 있습니다. 이러한 안내는 제품을 배포한 후에 표시됩니다.

  12. 이전 단계를 완료한 후 생성을 클릭하여 배포 패키지를 만듭니다.

    나중에 추가로 배포 패키지를 변경해야 할 경우 수정을 클릭하여 변경한 다음 생성을 클릭하여 해당 변경 사항이 적용된 배포 패키지를 다시 생성할 수 있습니다.

    수동 구성으로 전환하려는 경우 다운로드를 클릭하여 가이드 방식 구성에서 만든 배포 패키지의 Autogen 사양을 다운로드하여 수동 구성의 기반으로 사용할 수 있습니다.

  13. 배포 패키지를 검토하도록 제출 - Producer Portal에서 배포 패키지를 제출합니다. 패키지를 제출한 후 Google에서 패키지를 검토하고 승인하는 데 최대 2주 걸릴 수 있습니다.

mpdev를 사용하여 배포 패키지 만들기

이 섹션에서는 mpdev 도구를 사용하여 배포 패키지를 만들고 검토를 위해 제출하는 방법을 설명합니다.

mpdev 도구는 Deployment Manager Autogen을 사용하여 배포 패키지의 Deployment Manager 템플릿을 생성합니다. 이 도구는 VM 제품의 구성 입력이 포함된 Autogen 사양을 기반으로 배포 패키지를 생성합니다.

개략적 수준에서 배포 패키지를 생성하고 제출하려면 다음을 수행해야 합니다.

  1. Cloud Storage 버킷 생성 및 구성하기 - 배포 패키지에 대한 액세스를 저장하고 관리하기 위한 Cloud Storage 버킷을 만들고 구성합니다.
  2. Autogen 사양 만들기 - VM 제품의 이미지 세부정보 및 배포 요구사항이 포함된 Autogen 사양을 만듭니다.
  3. 배포 패키지 생성 및 업로드 - Autogen 사양을 기준으로 배포 패키지를 생성하여 Cloud Storage 버킷에 패키지를 업로드합니다.
  4. 배포 패키지를 검토하도록 제출 - Producer Portal에서 배포 패키지를 제출합니다. 패키지를 제출한 후 Google에서 패키지를 검토하고 승인하는 데 최대 2주 걸릴 수 있습니다.

다음 섹션에서는 배포 패키지를 생성하고 제출하는 단계를 완료하는 방법을 설명합니다.

Cloud Storage 버킷 만들기

Producer Portal에 사용하는 것과 동일한 공개 Google Cloud 프로젝트에 Cloud Storage 버킷을 만들고 다음 방식으로 버킷을 구성해야 합니다.

  • 배포 패키지를 삭제하거나 덮어쓰지 않으려면 버킷에 객체 버전 관리를 사용 설정해야 합니다.
  • cloud-commerce-marketplace-onboarding@twosync-src.google.com에 스토리지 객체 뷰어(roles/storage.objectViewer) 역할을 부여합니다.

Cloud Storage 버킷을 만들고 구성하려면 다음 gsutil 명령어를 실행합니다.

  BUCKET_NAME=YOUR_BUCKET_NAME
  gsutil mb $BUCKET_NAME
  gsutil versioning set on gs://$BUCKET_NAME
  gsutil iam ch "group:cloud-commerce-marketplace-onboarding@twosync-src.google.com:objectViewer" $BUCKET_NAME

여기서 YOUR_BUCKET_NAME은 이름 지정 요구사항에 따라 새 버킷에 제공하는 이름입니다.

Autogen 사양 만들기

Autogen 사양을 만들려면 marketplace-tools 저장소에서 single VM example를 사용하여 초기 Autogen 사양을 만든 후 VM의 구성 세부 정보로 맞춤설정하는 것이 좋습니다.

보다 복잡한 사용 사례의 경우 IDE(일부 통합 개발 환경)에서 자동 완성을 설정하여 configurations.yaml 파일을 수정하고 확인할 수 있습니다.

single VM example로부터 Autogen 사양을 만들려면 다음 안내를 따르세요.

  1. 로컬 디렉터리에서 예시의 사전 구성된 Autogen 사양을 확인합니다.

    PACKAGE=YOUR_PACKAGE_NAME
mpdev pkg get https://github.com/GoogleCloudPlatform/marketplace-tools.git/examples/deployment-manager/autogen/singlevm $PACKAGE

    여기서 YOUR_PACKAGE_NAME은 로컬 디렉터리에 제공한 이름입니다. 예를 들면 my-deployment-package입니다.

  2. 다음 정보로 configurations.yaml 파일을 수정하여 VM의 구성 세부정보로 사양을 업데이트합니다.

    • VM 이미지의 이름
    • VM 이미지를 호스팅하는 공개 Google Cloud 프로젝트의 ID. Producer Portal에서 사용하는 프로젝트와 동일한 프로젝트입니다.

    configurations.yaml 파일의 VM 이미지 및 Google Cloud 프로젝트 필드를 업데이트하는 단계별 안내는 single VM example의 README.md 파일을 참조하세요.

  3. 제품에 필요한 경우 passwords, deployInput, postDeploy와 같은 추가 필드를 맞춤설정합니다. 이러한 필드는 configurations.yaml 파일에서 DeploymentSpec 아래에 있습니다. 맞춤설정에 사용할 수 있는 필드에 대해 자세히 알아보려면 Autogen 참조 문서를 확인하세요.

배포 패키지 생성

Autogen 사양을 만들고 맞춤설정한 후에는 해당 사양을 사용하여 배포 패키지의 Deployment Manager 템플릿 파일을 생성합니다. 패키지를 저장하려면 패키지를 Cloud Storage 버킷에 업로드하세요.

배포 패키지 생성 및 업로드:

  1. 배포 패키지의 출력 위치를 Cloud Storage 버킷으로 설정합니다.

    mpdev cfg set zipPath gs://BUCKET_NAME/OBJECT

    여기서 BUCKET_NAME은 패키지에 대해 만든 버킷의 이름이며, OBJECT는 Cloud Storage 객체에 제공하는 이름으로 .이름 지정 가이드라인의 적용을 받습니다.

  2. 배포 패키지 생성:

    mpdev apply -f $PACKAGE/configurations.yaml

생성된 배포 패키지는 압축형으로 버킷에 업로드됩니다.

템플릿이 올바르게 구성되었는지 확인하려면 다음 명령어를 실행하여 배포를 만들면 됩니다.

  TMPDIR=$(mktemp -d)
  unzip $PACKAGE/template.zip -d $TMPDIR
  gcloud deployment-manager deployments create $PACKAGE --config $TMPDIR/test_config.yaml

Producer Portal에서 검토할 배포 패키지 제출

Producer Portal을 사용하여 Cloud Marketplace 제품 등록정보를 만드는 경우 배포 패키지를 만든 후 Cloud Marketplace팀에서 패키지를 검토하고 승인할 수 있도록 Producer Portal에 패키지를 제출해야 합니다.

검토할 수 있도록 배포 패키지 제출:

가이드 방식 구성

  1. Producer Portal에서 배포 패키지 섹션으로 이동합니다.

  2. Producer Portal에서 검토할 수 있도록 배포 패키지를 제출하려면 제출을 클릭합니다. 패키지를 제출한 후 Google에서 패키지를 검토하고 승인하는 데 최대 2주 걸릴 수 있습니다.

수동 구성

  1. Google Cloud Console에서 Producer Portal을 엽니다.

    https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID

    YOUR_PUBLIC_PROJECT_ID를 Cloud Marketplace에 만든 공개 프로젝트의 ID로 바꿉니다(예: my-organization-public).

  2. 제품 목록에서 제품 이름을 클릭합니다.

  3. 제품의 개요 페이지에서 배포 패키지 섹션으로 이동하고 수정을 클릭합니다.

  4. Cloud Storage 객체 위치 지정에서 이전에 업로드한 배포 패키지 객체를 선택합니다.

  5. 검증을 클릭합니다. 유효성 검사 프로세스를 완료하는 데 최대 2시간이 걸릴 수 있으며 완료 중에 화면을 종료할 수 있습니다.

  6. Producer Portal이 배포 패키지를 성공적으로 읽은 후에 배포 미리보기를 클릭하여 고객에게 VM 구성이 어떻게 표시되는지 확인할 수 있습니다.

  7. 검증이 성공적으로 완료된 후 배포 패키지를 제출하여 검토를 받으려면 제출을 클릭합니다. 패키지를 제출한 후 Google에서 패키지를 검토하고 승인하는 데 최대 2주 걸릴 수 있습니다.

고객 뷰의 배포 패키지

다음 섹션에서는 고객이 제품을 배포할 때 자동 생성된 표준 솔루션 패키지 기반 제품에 대한 화면 레이아웃을 보여줍니다.

패키지 배포의 고객 뷰

표준 고객 입력 요소는 다음 스크린샷의 왼쪽에 표시되며, 영역, 머신 유형, 디스크 옵션, 네트워크 옵션을 포함합니다.

고객의 배포에 여러 개의 네트워크 인터페이스 카드가 필요한 경우 네트워크 인터페이스 추가를 클릭하여 네트워크 인터페이스를 추가할 수 있습니다.

제품을 배포하려면 고객이 입력 필드를 채우고 배포를 클릭해야 합니다.

배포된 패키지의 고객 뷰

다음 이미지는 제품을 성공적으로 배포한 후 고객에게 제품이 어떻게 표시되는지 보여줍니다.

표준 출력 요소는 다음 스크린샷의 오른쪽에 표시되며, 사이트 주소, 임시 관리자 비밀번호, 인스턴스 정보를 포함합니다.

이전
VM 이미지 빌드
다음
VM 제품 테스트