기술 구성요소 설정

이 페이지에서는 Google Cloud Marketplace로 컨테이너 이미지 제품을 배포하는 데 필요한 주요 기술 구성요소를 만드는 방법을 설명합니다.

온보딩 프로세스 중에 질문이 있으면 Cloud Marketplace 파트너 엔지니어에게 문의하세요. 배정된 파트너 엔지니어를 모르면 Partner Support Desk를 사용하여 지원을 요청하고 설명에 'Marketplace'라는 단어를 포함합니다. Partner Support Desk에 대한 자세한 내용은 Cloud Marketplace 지원 요청을 참조하세요.

Artifact Registry 및 IAM 설정

Producer Portal에서 제품을 만들려면 먼저 스테이징 Artifact Registry 저장소를 만들고 제품에 배포하려는 이미지를 해당 저장소에 푸시해야 합니다. 프로젝트에서 프로젝트 뷰어 역할을 cloud-commerce-marketplace-onboarding@twosync-src.google.com에 부여해야 합니다.

Container Registry 시작하기

태그가 지정된 컨테이너 이미지를 Container Registry로 푸시하려면 Artifact Registry 문서에서 시작하기 전에의 단계를 따르세요. 그런 다음 아래 단계에 따라 Artifact Analysis API를 사용 설정합니다.

gcloud 및 Docker를 설치한 후 API 라이브러리 페이지에서 다음 API를 사용 설정해야 합니다.

  • Artifact Registry API
  • Artifact Analysis API

Artifact Registry API는 Artifact Registry에 대한 푸시를 지원하고, Artifact Analysis API는 보안 스캔을 허용합니다.

이 API 중 어느 하나라도 액세스하는 데 문제가 있으면 파트너 엔지니어에게 문의하십시오.

이미지 태그 지정 및 푸시

  1. Artifact Registry 스테이징 저장소 경로를 선택합니다. 저장소가 us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID 구조를 사용하는 것이 좋습니다.

    • 스테이징 저장소는 us-docker.pkg.dev 또는 gcr.io 내에 있어야 하며 europe-docker.pkg.dev 또는 eu.gcr.io 등의 다른 리전은 아직 지원되지 않습니다.
    • Producer Portal에서 솔루션을 만들기 위해 스테이징 저장소 경로를 저장 또는 복사합니다.
  2. Artifact Registry 스테이징 저장소에 푸시하려는 이미지를 빌드합니다.

  3. Docker를 통해 이미지에 latest 태그를 지정합니다.

    docker tag image_name staging_repo_path:tag

    예를 들면 docker tag test-image us-docker.pkg.dev/testpartner/testsolution:latest입니다.

    사용자가 태그를 지정하지 않은 경우 latest로 태그 지정된 이미지를 가져옵니다.

  4. gcloud를 사용하여 이미지를 푸시합니다.

    gcloud docker push staging_repo_path:tag

  5. 스테이징 저장소에 추가하려는 태그 또는 이미지에 대해 작업을 반복합니다. 단일 이미지는 여러 태그를 포함할 수 있습니다.

    • 스테이징 저장소로 이미지를 푸시한다고 해서 사용자에게 이미지가 자동으로 표시되지는 않습니다. 선택한 태그의 이미지가 게시된 후에만 발생합니다.
    • 저장소 범위는 해당 경로에 지정된 폴더의 단일 수준입니다. 저장소의 다른 폴더 내에 있는 이미지는 실제로 저장소 자체에 포함된 것이 아닙니다. 즉, 이미지가 us-docker.pkg.dev/testpartner/testsolution/1.0에 있으면 us-docker.pkg.dev/testpartner/testsolution 저장소에는 없습니다. us-docker.pkg.dev/testpartner/testsolution/1.0은 별개의 저장소입니다.

Producer Portal에서 제품 만들기

이 섹션에서는 Producer Portal에서 컨테이너 이미지 제품을 만들고 게시하는 방법을 설명합니다.

Producer Portal에서 제품을 게시하려면 제품 항목을 만든 후 다음 정보를 검토용으로 제출합니다.

  • 제품 세부정보: 제품의 목록 정보 및 마케팅 정보를 추가합니다.
  • 컨테이너 이미지: 컨테이너 이미지가 포함된 Google Container Registry 저장소를 제공합니다.

이러한 검토는 언제든지 원하는 순서로 제출할 수 있습니다.

제품의 Cloud Marketplace 항목을 만들려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔에서 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. 제품 이름 아래에서 제품 이름을 지정하고 제품 ID를 확인합니다. 제품 ID는 Cloud Marketplace 목록의 URL에 사용됩니다.

  5. 만들기를 클릭합니다. 제품을 만들려면 몇 초 정도 걸릴 수 있습니다.

제품 세부정보 추가

제품 세부정보에는 Cloud Marketplace의 제품 목록, 마케팅 정보, 문서 링크가 포함됩니다.

제품 세부정보를 추가하려면 다음 안내를 따르세요.

  1. 제품 목록에서 제품 ID를 클릭합니다.

  2. 제품의 개요 페이지에서 제품 세부정보 섹션으로 이동하여 수정을 클릭합니다.

  3. 제품 세부정보 섹션의 제품 정보 탭을 작성합니다. PRODUCT INFO를 완료하는 동안 카테고리 ID를 추가할 수 있습니다. 카테고리 ID를 사용하면 고객이 Cloud Marketplace를 검색할 때 특정 카테고리나 필터에서 제품을 찾을 수 있습니다.

  4. 튜토리얼, 문서, 추가 라이선스 계약(선택사항)을 추가하려면 제품 세부정보 섹션의 문서 탭을 작성합니다. 문서는 사용자 가이드 요구사항을 충족해야 합니다.

  5. 검색 메타데이터 또는 키워드를 추가하거나 제품의 세부정보 페이지 URL을 맞춤설정하려면 제품 세부정보 섹션의 제품 메타데이터 탭을 작성합니다.

  6. 처리를 위해 제품 세부정보를 제출할 준비가 되면 제출을 클릭합니다.

파트너 엔지니어링팀에서 제품 세부정보를 검토하고 승인하는 데에는 약 2~5일이 걸립니다. 이제 세부정보를 수정하고 나중에 리뷰를 제출할 수 있습니다.

컨테이너 이미지 추가

Container Registry 태그 latest(대소문자 구분)에 따라 하나의 버전을 만들어야 합니다. 이 버전은 제품 페이지의 기본 버전입니다.

컨테이너 이미지를 추가하려면 다음 안내를 따르세요.

  1. 제품 목록에서 제품 ID를 클릭합니다.

  2. 제품의 개요 페이지에서 컨테이너 이미지로 이동하고 수정을 클릭합니다.

  3. 컨테이너 이미지 섹션에서 스테이징 Artifact Registry 저장소의 URL을 입력합니다.

  4. 출시 버전 지정을 클릭합니다. 저장소를 읽고 태그를 로드하는 데 몇 초 정도 걸릴 수 있습니다.

  5. 제품에 포함할 출시 버전의 표시 태그를 선택합니다. 제품에 latest 출시 버전을 포함해야 하지만 버전을 더 추가할 수 있습니다. 사용자의 편의를 위해 제품에 제공되는 출시 버전 수를 제한하는 것이 좋습니다.

  6. 필요한 경우 버전 제목과 출시 버전에 대한 간단한 설명을 추가합니다. 이렇게 하면 사용자가 원하는 버전을 배포하는 데 도움이 됩니다.

  7. 이 출시 버전에서 지원하는 운영체제를 입력합니다. 필요한 경우 운영체제 버전을 지정할 수 있습니다.

  8. 출시 버전에 대한 모든 정보를 추가한 후 완료를 클릭합니다.

  9. 다른 버전을 추가하려면 출시 버전 추가를 클릭하고 해당 출시 버전에 대한 정보를 입력합니다.

  10. 제품에 지원되는 출시 버전 추가를 완료했으면 저장 및 검증을 클릭합니다. 이미지가 공개 저장소에 복사되고 이미지에 대해 일련의 테스트를 실행합니다.

  11. 제출을 클릭하여 검토할 컨테이너 이미지를 제출합니다.

컨테이너 이미지 제품 미리보기

Cloud Marketplace 등록정보를 사용자에게 표시하기 전에 미리 보려면 다음 안내를 따르세요.

  1. 제품 목록에서 제품 ID를 클릭합니다.

  2. 제품의 개요 페이지에서 전체 미리보기를 클릭합니다.

Producer Portal에서 컨테이너 이미지의 유효성을 검사한 후 스테이징 저장소에서 태그를 변경한 경우 미리보기에서 참조되는 이미지가 정확하지 않을 수 있습니다.

컨테이너 이미지 제품 게시

Cloud Marketplace에 제품을 게시하려면 다음을 수행해야 합니다.

  • 제품 세부정보컨테이너 이미지 검토를 완료해야 합니다.

  • Google Cloud Build 파트너로 승인을 받아야 합니다.

모든 검토가 승인되면 몇 분 내에 제품을 게시하여 시작할 수 있습니다. 제품을 게시하려면 다음 안내를 따르세요.

  1. 제품 목록에서 제품 ID를 클릭합니다.

  2. 제품의 개요 페이지에서 게시를 클릭합니다.