技術コンポーネントの設定

このページでは、コンテナ イメージ プロダクトを Google Cloud Marketplace で配布するために必要な主要技術コンポーネントを作成する方法について説明します。

オンボーディング プロセスの間の質問については、担当の Cloud arketplace パートナー エンジニアにお問い合わせください。担当のパートナー エンジニアがわからない場合は、Partner Support Deskbにサポートを依頼し、説明に「マーケットプレイス」という言葉を含めます。Partner Support Desk の詳細については、Cloud Marketplace のサポートをリクエストするをご覧ください。

Artifact Registry と IAM の設定

Producer Portal でプロダクトを作成する前に、ステージング Artifact Registry リポジトリを作成し、プロダクトで配布するイメージをそのリポジトリに push する必要があります。プロジェクトでは、プロジェクト編集者のロールを cloud-commerce-marketplace-onboarding@twosync-src.google.com に付与する必要があります。

Container Registry を使ってみる

タグ付きコンテナ イメージを Container Registry に push するには、Artifact Registry ドキュメントの「始める前に」に記載されている手順に従います。次に、以下の手順に従って Artifact Analysis API を有効にします。

gcloud と Docker をインストールしたら、[API ライブラリ] ページで次の API を有効にする必要があります。

  • Artifact Registry API
  • Artifact Analysis API

Artifact Registry API により Artifact Registry への push が可能になり、Artifact Analysis API によりセキュリティ スキャンが可能になります。

これらの API のいずれかにアクセスできない場合は、パートナー エンジニアにお問い合わせください。

イメージにタグを付けて push する

  1. Artifact Registry ステージング リポジトリのパスを選択します。リポジトリは us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID の構造に従うことをおすすめします。

    • ステージング リポジトリは us-docker.pkg.dev または gcr.io 内に配置する必要があります(europe-docker.pkg.deveu.gcr.io などの他のリージョンはまだサポートされていません)。
    • Producer Portal でプロダクトを作成するために、ステージング リポジトリのパスを保存またはコピーします。
  2. Artifact Registry ステージング リポジトリに push するイメージをビルドします。

  3. Docker を使用してイメージに latest タグを付けます。

    docker tag image_name staging_repo_path:tag

    例: docker tag test-image us-docker.pkg.dev/testpartner/testsolution:latest

    ユーザーがタグを指定しない場合、latest というタグが付いたイメージが pull されることに注意してください。

  4. gcloud を使用してイメージを push します。

    gcloud docker push staging_repo_path:tag

  5. ステージング リポジトリに追加するタグやイメージについてこの手順を繰り返します。1 つのイメージに複数のタグを含めることができます。

    • イメージをステージング リポジトリにプッシュしても、ユーザーに自動的に表示されないことに注意してください。これは、公開後に、選択したタグの画像でのみ発生します。
    • リポジトリの範囲は、そのパスが指定するフォルダのレベルのみです。リポジトリ内の別のフォルダにあるイメージは、実際にはそのリポジトリには存在しません。つまり、イメージが 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. [Product name] でプロダクトに名前を付け、[プロダクト ID] を確認します。プロダクト ID は、Cloud Marketplace リスティングの URL で使用されます。

  5. [作成] をクリックします。プロダクトの作成には数秒かかる場合があります。

プロダクトの詳細の追加

プロダクトの詳細には、Cloud Marketplace のプロダクト リスト、マーケティング情報、ドキュメントへのリンクが含まれます。

プロダクトの詳細を追加するには:

  1. プロダクトのリストで、プロダクト ID をクリックします。

  2. プロダクトの [概要] ページで [プロダクトの詳細] セクションに移動し、[編集] をクリックします。

  3. [プロダクトの詳細] セクションの [プロダクト情報] タブを入力します。プロダクト情報 を入力する際に、カテゴリ ID を追加できます。カテゴリ ID を使用すると、Cloud Marketplace の検索時に、選択したカテゴリやフィルタでお客様がプロダクトを見つけられます。

  4. チュートリアル、ドキュメントのほか、必要に応じてその他のライセンス契約を追加するには、[商品の詳細] セクションの [ドキュメント] タブに必要な情報を入力してください。 ドキュメントはユーザーガイドの要件を満たしている必要があります。

  5. 検索メタデータやキーワードを追加したり、プロダクトの詳細ページの URL をカスタマイズしたりするには、[プロダクトの詳細] セクションの [PRODUCT METADATA] タブに必要な情報を入力します。

  6. プロダクトの詳細を送信して処理をする準備ができたら、[送信] をクリックします。

パートナー エンジニアリング チームがプロダクトの詳細を審査して承認するまで、約 2~5 日ほどかかります。今の時点で詳細を編集しておき、審査のために後で送信できます

コンテナ イメージの追加

Container Registry タグ latest に対応するバージョンを 1 つ作成する必要があります(大文字と小文字を区別)。これは、プロダクトページのデフォルトのバージョンです。

コンテナ イメージを追加する手順は次のとおりです。

  1. プロダクトのリストで、プロダクト ID をクリックします。

  2. プロダクトの [概要] ページで [コンテナ イメージ] に移動し、[編集] をクリックします。

  3. [コンテナ イメージ] セクションで、ステージング Artifact Registry リポジトリの URL を入力します。

  4. [Specify Release] をクリックします。リポジトリを読み取り、タグを読み込むまで、数秒かかることがあります。

  5. プロダクトに含めるリリースの表示タグを選択します。プロダクトには latest リリースを含める必要がありますが、ほかにもバージョンを追加できます。ユーザーの便宜上、プロダクトで利用可能なリリース数を制限することをおすすめします。

  6. 必要に応じて、バージョン タイトルとリリースの簡単な説明を追加します。これは、ユーザーが必要なバージョンをデプロイするのに役立ちます。

  7. このリリースでサポートされているオペレーティング システムを入力します。必要に応じて、オペレーティング システムのバージョンを指定できます。

  8. リリースの情報をすべて追加したら、[完了] をクリックします。

  9. 別のバージョンを追加するには、[リリースを追加] をクリックして、そのリリースの情報を入力します。

  10. サポートされているリリースをプロダクトに追加したら、[保存と検証] をクリックします。イメージが公開リポジトリにコピーされた後、イメージに対して一連のテストが実行されます。

  11. [送信] をクリックして、審査のためにコンテナ イメージを送信します。

コンテナ イメージ プロダクトをプレビューする

ユーザーに表示する前に、Cloud Marketplace リスティングをプレビューするには:

  1. プロダクトのリストで、プロダクト ID をクリックします。

  2. プロダクトの [概要] ページで [フルプレビュー] をクリックします。

Producer Portal でコンテナ イメージを検証した後にステージング リポジトリのタグを変更した場合、プレビューで参照されるイメージが不正確になる場合があります。

コンテナ イメージ プロダクトを公開する

Cloud Marketplace でプロダクトを公開するには、次のことを行う必要があります。

すべての審査が承認されたら、数分以内にプロダクトを公開してリリースできます。 プロダクトを公開するには:

  1. プロダクトのリストで、プロダクト ID をクリックします。

  2. プロダクトの [概要] ページで [公開] をクリックします。