배포 패키지 만들기

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

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

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

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

Producer Portal

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

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

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

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

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

파트너 포털

제품이 기본 방화벽 규칙이 있는 단일 VM 인스턴스의 단순 배포인 경우 Google Cloud Console에서 직접 간단한 배포 패키지를 만들 수 있습니다.

제품이 복잡한 배포인 경우 오픈소스 mpdev 도구를 사용하여 추가 기능이 있는 배포 패키지를 만들고 맞춤설정합니다.

다음 표에서는 간단한 배포와 복잡한 배포의 차이점을 설명합니다.

배포 설명 패키지 생성 방법
간단함 기본 방화벽 규칙이 있는 단일 VM 인스턴스 Google Cloud Console
복잡함 복잡한 배포(단일 또는 멀티 VM). 배포에는 다음 기능이 필요할 수 있습니다.
  • 할당량 - CPU 및 GPU를 확인하므로 사용자가 할당량 요구사항을 초과하면 제품을 배포할 수 없음
  • Deployment Manager 페이지에서 유동 가격 업데이트
  • 공유 VPC(Virtual Private Cloud) 지원
  • 네트워크 인터페이스 카드가 여러 개인 VM 지원.
  • 사용자가 선택한 영역에서 사용할 수 없는 머신 유형, GPU 또는 서브네트워크를 선택하지 못하게 하는 기능.
mpdev 도구

어떤 배포 옵션이 제품에 더 적합한지 모르겠으면 Google 파트너 엔지니어에게 도움을 요청하세요.

시작하기 전에

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

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

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

배포 패키지 만들기 및 제출

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

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

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

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

Producer Portal

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

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

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

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

    Cloud Storage 버킷이 없으면 새 버킷 만들기 아이콘을 클릭합니다. 새 버킷을 만들 때 다음을 수행합니다.

    • 버킷의 이름을 선택합니다.
    • 버킷이 데이터를 저장하는 리전을 지정합니다.
    • 데이터의 스토리지 클래스를 지정합니다.
    • 버킷 데이터의 ID 및 액세스 관리(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주 걸릴 수 있습니다.

파트너 포털

  1. 파트너 포털로 이동하여 제품 목록에서 제품을 선택합니다.
  2. 배포 패키지 옆에 있는 편집을 클릭합니다.
  3. 패키지 생성을 선택한 다음 계속을 클릭합니다.
  4. 프로젝트이미지 드롭다운을 사용하여 VM 이미지를 선택한 다음 계속을 클릭합니다.
  5. 최소 머신 유형기본 머신 유형 설정을 선택한 다음 계속을 클릭합니다.
  6. 고객이 수행해야 할 배포 후 다음 단계를 추가한 다음 계속을 클릭합니다.
  7. 해당되는 경우 방화벽 규칙과 기타 네트워킹 옵션을 설정한 후 계속을 클릭합니다.
  8. 사이트 또는 관리자 URL을 선언할 수 있습니다. 제품에 로그인이 필요한 경우 솔루션을 제출할 때 로그인 세부정보를 설정할 수 있습니다. 계속을 클릭합니다.
  9. 패키지 콘텐츠 등록에서 VM 이미지 운영체제의 운영체제 이름OS 버전을 선택합니다. 그러면 제품의 일부로 포함된 각 추가 소프트웨어에 대해 이름버전을 추가 할 수 있습니다. 패키지의 모든 콘텐츠를 등록한 후 계속을 클릭합니다.
  10. 이전 단계를 완료하면 검토 아래에 솔루션 패키지가 표시됩니다. 솔루션 패키지를 다운로드하거나 JSON 수정을 클릭하여 수동으로 수정할 수 있습니다. 저장을 클릭하여 패키지를 저장하고 솔루션으로 돌아갑니다.

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

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

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

mpdev를 사용하여 배포 패키지를 만들려면 Producer Portal 또는 파트너 포털을 사용하여 Google Cloud Marketplace에 제품을 통합했는지 여부에 따라 다음 안내를 따르세요.

Producer Portal

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

  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 버킷을 만들고 다음 방식으로 버킷을 구성해야 합니다.

  • 배포 패키지를 삭제하거나 덮어쓰지 않으려면 버킷에 객체 버전 관리를 사용 설정해야 합니다.
  • marketplace-ops@cloud.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:marketplace-ops@cloud.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입니다.

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

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

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

  2. 제품에 필요한 경우 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

파트너 포털

Autogen 사양 만들기

marketplace-tools 저장소에서 single VM example를 사용하여 초기 Autogen 사양을 만드는 것이 좋습니다. single VM example에서 사양을 만들려면 다음 명령어를 실행합니다.

mpdev pkg get https://github.com/GoogleCloudPlatform/marketplace-tools.git/examples/deployment-manager/autogen/singlevm MY_PACKAGE

다운로드한 예시의 README.md 파일에 설명된 다음 단계를 수행합니다. 이 단계에는 제품에 해당하는 configurations.yaml 파일의 필드를 수정하는 작업이 포함됩니다. 이러한 단계를 완료하면 편집한 mpdev 구성에서 mpdev apply를 실행하여 Deployment Manager 패키지를 생성합니다.

configurations.yamlDeploymentSpec 아래에 있는 필드에 대한 자세한 내용은 Autogen 참조 문서를 확인하세요.

또한, examples 폴더에서 다른 샘플 구성을 확인할 수 있습니다.

승인 사용자 인증 정보 만들기

configurations.yamlDeploymentSpec에 여러 passwords를 지정할 수 있습니다. 인스턴스 메타데이터 서버에서 비밀번호를 검색하고 배포 후 인터페이스에서 이를 확인할 수 있습니다.

배포 패키지 생성

다음은 MY_PACKAGE/configurations.yaml의 사양을 읽고 MY_PACKAGE/configurations.yaml에 지정된 위치로 ZIP 파일을 출력하는 샘플 명령어입니다.

mpdev apply -f MY_PACKAGE/configurations.yaml

배포 패키지가 생성되면 다음 안내에 따라 배포 패키지를 파트너 포털에 업로드합니다.

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

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

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

가이드 방식 구성

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

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

  3. 이미 오픈소스 규정 준수 검토를 제출한 경우에는 오픈소스 라이선스 사용을 변경하지 않았음을 확인하는 라디오 버튼을 클릭합니다.

수동 구성

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

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

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

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

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

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

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

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

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

  8. 이미 오픈소스 규정 준수 검토를 제출한 경우에는 오픈소스 라이선스 사용을 변경하지 않았음을 확인하는 라디오 버튼을 클릭합니다.

고객 뷰의 배포 패키지

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

패키지 배포의 고객 뷰

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

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

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

배포된 패키지의 고객 뷰

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

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