Halaman ini menjelaskan cara membuat komponen teknis utama yang diperlukan untuk mendistribusikan produk image container dengan Google Cloud Marketplace.
Jika ada pertanyaan selama proses orientasi, hubungi Partner Engineer Cloud Marketplace Anda. Jika tidak tahu siapa Partner Engineer yang Anda tetapkan, gunakan Partner Support Desk untuk meminta bantuan, dan sertakan kata "Marketplace" dalam deskripsi Anda. Untuk mengetahui informasi selengkapnya tentang Partner Support Desk, buka Meminta bantuan dengan Cloud Marketplace.
Penyiapan Container Registry dan IAM
Sebelum dapat membuat produk di Producer Portal, Anda harus membuat repositori Container Registry staging dan mengirim gambar yang ingin didistribusikan dalam produk Anda ke repositori tersebut. Dalam
project, Anda harus memberikan peran Project Editor kepada
cloud-commerce-marketplace-onboarding@twosync-src.google.com.
Memulai Container Registry
Untuk mengirim image container yang diberi tag ke Container Registry, ikuti langkah-langkah di bagian Sebelum memulai di dokumentasi Container Registry. Kemudian, gunakan langkah-langkah di bawah untuk mengaktifkan Artifact Analysis API.
Setelah menginstal gcloud dan Docker, Anda harus mengaktifkan API berikut dari halaman Library API:
- Container Registry API
- Artifact Analysis API
Container Registry API memungkinkan Anda mengirim ke Container Registry, dan Artifact Analysis API memungkinkan Anda melakukan pemindaian keamanan.
Jika Anda mengalami masalah saat mengakses salah satu API ini, hubungi Partner Engineer Anda.
Memberi tag dan mengirim gambar
Pilih jalur repositori staging Container Registry Anda. Sebaiknya repositori Anda mengikuti struktur
gcr.io/YOUR-PARTNER-ID/YOUR-SOLUTION-ID.- Repositori staging harus berada dalam
gcr.io(region lain, sepertieu.gcr.io, belum didukung). - Simpan atau salin jalur repositori staging untuk pembuatan produk di Producer Portal.
- Repositori staging harus berada dalam
Build image yang ingin Anda kirim ke repositori staging Container Registry Anda.
Beri tag pada image melalui Docker dengan
latest.docker tag image_name staging_repo_path:tagMisalnya,
docker tag test-image gcr.io/testpartner/testsolution:latestPerhatikan bahwa gambar yang diberi tag
latestakan ditarik jika pengguna tidak menentukan tag.Kirim gambar Anda menggunakan
gcloud:gcloud docker push staging_repo_path:tagUlangi untuk setiap tag atau gambar tambahan yang ingin Anda tambahkan ke repositori staging. Satu gambar mungkin memiliki beberapa tag.
- Ingat bahwa mengirim image ke repositori staging tidak akan otomatis membuatnya terlihat oleh pengguna; ini hanya terjadi pada image tag yang Anda pilih, setelah dipublikasikan.
- Cakupan repositori adalah satu tingkat folder yang ditentukan
oleh jalurnya. Setiap image yang ada di dalam folder lain di repositori
sebenarnya tidak ada di repositori itu sendiri. Dengan kata lain, jika gambar
berada di
gcr.io/testpartner/testsolution/1.0, gambar tersebut TIDAK ada di repositorigcr.io/testpartner/testsolution.gcr.io/testpartner/testsolution/1.0adalah repositori terpisah.
Membuat produk Anda di Producer Portal
Bagian ini menjelaskan cara membuat dan memublikasikan produk image container di Prod Portal.
Untuk memublikasikan produk di Producer Portal, buat entri untuk produk, lalu kirimkan informasi berikut untuk ditinjau:
- Detail produk: Tambahkan informasi listingan dan pemasaran tentang produk Anda.
- Image container: Berikan repositori Google Container Registry yang menyertakan image container Anda.
Anda dapat mengirimkan ulasan ini kapan saja dan dalam urutan apa pun.
Untuk membuat entri Cloud Marketplace produk Anda:
Buka Producer Portal di Konsol Google Cloud:
https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
Ganti YOUR_PUBLIC_PROJECT_ID dengan ID untuk project publik yang Anda buat untuk Cloud Marketplace—misalnya,
my-organization-public.Di bagian atas halaman, klik Tambahkan produk.
Pilih Image container.
Di bagian Nama produk, beri nama produk Anda dan periksa ID Produk. ID Produk digunakan di URL untuk listingan Cloud Marketplace Anda.
Klik Create. Mungkin diperlukan waktu beberapa detik untuk membuat produk Anda.
Menambahkan detail produk
Detail produk mencakup listingan produk Anda di Cloud Marketplace, informasi pemasaran, dan link ke dokumentasi.
Untuk menambahkan detail produk:
Dalam daftar produk, klik ID produk.
Di halaman Overview produk Anda, buka Detail produk, dan klik Edit.
Lengkapi tab INFO PRODUK di bagian Detail produk. Saat menyelesaikan INFO PRODUK, Anda dapat menambahkan ID Kategori. ID Kategori memungkinkan pelanggan menemukan produk Anda di bagian kategori atau filter tertentu saat menelusuri Cloud Marketplace.
Untuk menambahkan tutorial, dokumentasi, dan, jika perlu, perjanjian lisensi tambahan, lengkapi tab DOKUMEN di bagian Detail produk. Dokumentasi Anda harus memenuhi persyaratan untuk panduan pengguna.
Untuk menambahkan metadata atau kata kunci penelusuran, atau menyesuaikan URL halaman detail produk Anda, lengkapi tab METADATA PRODUK di bagian Detail produk.
Jika Anda sudah siap untuk mengirimkan detail produk untuk diproses, klik Submit.
Perlu waktu sekitar 2-5 hari bagi tim Partner Engineering untuk meninjau dan menyetujui detail produk Anda. Anda dapat mulai mengedit detail sekarang dan mengirimkan ulasan nanti.
Menambahkan gambar container Anda
Anda harus membuat satu versi yang sesuai dengan tag Container Registry latest (peka huruf besar/kecil). Ini adalah versi default di halaman produk.
Untuk menambahkan image container:
Dalam daftar produk, klik ID produk.
Di halaman Overview produk Anda, buka Gambar penampung, dan klik Edit.
Di bagian Image container, masukkan URL untuk repositori Container Registry staging Anda.
Klik Tentukan Rilis. Mungkin perlu waktu beberapa detik untuk membaca repositori dan memuat tag Anda.
Pilih Tag Display untuk rilis yang ingin disertakan dalam produk Anda. Anda harus menyertakan rilis
latestdalam produk, tetapi Anda dapat menambahkan versi lainnya. Sebaiknya batasi jumlah rilis yang tersedia untuk produk Anda demi kenyamanan pengguna.Anda juga dapat menambahkan Judul versi dan deskripsi singkat rilis. Hal ini membantu pengguna men-deploy versi yang mereka inginkan.
Masukkan sistem operasi yang didukung rilis ini. Anda dapat menentukan versi sistem operasi, jika perlu.
Setelah menambahkan semua informasi untuk rilis, klik Selesai.
Untuk menambahkan versi lain, klik Add Release, dan masukkan informasi untuk rilis tersebut.
Setelah selesai menambahkan rilis yang didukung ke produk Anda, klik Save and Validasi. Image tersebut disalin ke repositori publik, lalu kami menjalankan serangkaian pengujian terhadap image tersebut.
Klik Kirim untuk mengirimkan image penampung untuk ditinjau.
Melihat pratinjau produk image container Anda
Untuk melihat pratinjau listingan Cloud Marketplace sebelum terlihat oleh pengguna:
Dalam daftar produk, klik ID produk.
Pada halaman Ringkasan produk Anda, klik Pratinjau lengkap.
Jika Anda telah mengubah tag di repositori staging sejak memvalidasi gambar penampung di Producer Portal, gambar yang dirujuk dalam pratinjau mungkin tidak akurat.
Memublikasikan produk image container
Untuk memublikasikan produk di Cloud Marketplace, Anda harus:
Lengkapi peninjauan Detail produk dan Gambar container.
Disetujui sebagai partner Google Cloud Build.
Setelah semua peninjauan disetujui, Anda dapat memublikasikan dan meluncurkan produk dalam beberapa menit. Untuk memublikasikan produk Anda:
Dalam daftar produk, klik ID produk.
Di halaman Ringkasan produk Anda, klik Publikasikan.