Menyiapkan komponen teknis

Halaman ini menguraikan cara membuat komponen teknis utama yang diperlukan untuk mendistribusikan produk image container Anda dengan Google Cloud Marketplace.

Jika ada pertanyaan selama proses orientasi, hubungi Cloud Marketplace Partner Engineer Anda. Jika Anda tidak tahu siapa Partner Engineer yang ditetapkan, gunakan Partner Support Desk untuk meminta bantuan, dan sertakan kata "Marketplace" dalam deskripsi Anda. Untuk informasi selengkapnya tentang Partner Support Desk, buka Meminta bantuan terkait Cloud Marketplace.

Penyiapan Artifact Registry dan IAM

Sebelum dapat membuat produk di Producer Portal, Anda harus membuat repositori Artifact Registry staging dan mengirim image yang ingin didistribusikan dalam produk ke repositori tersebut. Dalam project, Anda harus memberikan peran Project Editor kepada cloud-commerce-marketplace-onboarding@twosync-src.google.com.

Mulai menggunakan Container Registry

Untuk mengirim image container yang diberi tag ke Container Registry, ikuti langkah-langkah di bagian Sebelum memulai dalam dokumentasi Artifact 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:

  • Artifact Registry API
  • Artifact Analysis API

Artifact Registry API memungkinkan Anda melakukan push ke Artifact Registry, dan Artifact Analysis API memungkinkan pemindaian keamanan.

Jika Anda mengalami masalah saat mengakses salah satu API ini, hubungi Partner Engineer Anda.

Memberi tag dan mendorong gambar

  1. Pilih jalur repositori staging Artifact Registry Anda. Sebaiknya repositori Anda mengikuti struktur us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID.

    • Repositori staging harus berada dalam us-docker.pkg.dev atau gcr.io (wilayah lain, seperti europe-docker.pkg.dev atau eu.gcr.io, belum didukung).
    • Simpan atau salin jalur repositori staging Anda untuk pembuatan produk di Producer Portal.

  2. Build image yang ingin Anda kirim ke repositori staging Artifact Registry.

  3. Beri tag pada image melalui Docker dengan latest.

    docker tag image_name staging_repo_path:tag

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

    Perhatikan bahwa gambar yang diberi tag latest akan diambil jika pengguna tidak menentukan tag.

  4. Kirim gambar Anda menggunakan gcloud:

    gcloud docker push staging_repo_path:tag

  5. Ulangi untuk tag atau gambar tambahan yang ingin ditambahkan ke repositori staging Anda. Satu gambar dapat memiliki beberapa tag.

    • Ingat bahwa mendorong image ke repositori staging tidak akan otomatis membuatnya terlihat oleh pengguna; hal ini hanya terjadi pada image tag yang Anda pilih, setelah dipublikasikan.
    • Cakupan repositori adalah satu tingkat folder yang ditentukan oleh jalurnya. Setiap gambar yang berada dalam folder lain di repositori tidak benar-benar berada di repositori itu sendiri. Dengan kata lain, jika image ada di us-docker.pkg.dev/testpartner/testsolution/1.0, image tersebut BUKAN berada di repositori us-docker.pkg.dev/testpartner/testsolution. us-docker.pkg.dev/testpartner/testsolution/1.0 adalah repositori terpisah.

Membuat produk di Producer Portal

Bagian ini menjelaskan cara membuat dan memublikasikan produk image container di Portal Produsen.

Untuk memublikasikan produk di Producer Portal, Anda harus membuat entri untuk produk, lalu mengirimkan 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:

  1. 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.

  2. Di bagian atas halaman, klik Tambahkan produk.

  3. Pilih Image container.

  4. Di bagian Nama produk, beri nama produk Anda dan periksa ID Produk. ID Produk digunakan di URL untuk listingan Cloud Marketplace Anda.

  5. Klik Create. Mungkin perlu 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:

  1. Di daftar produk, klik ID produk.

  2. Di halaman Ringkasan produk Anda, buka Detail produk, lalu klik Edit.

  3. Lengkapi tab INFO PRODUK di bagian Detail produk. Saat menyelesaikan INFO PRODUK, Anda dapat menambahkan ID Kategori. ID kategori memungkinkan pelanggan menemukan produk Anda dalam kategori atau filter tertentu saat mereka menelusuri Cloud Marketplace.

  4. Untuk menambahkan tutorial, dokumentasi, dan, jika perlu, perjanjian lisensi tambahan, lengkapi tab DOKUMENTASI di bagian Detail produk. Dokumentasi Anda harus memenuhi persyaratan untuk panduan pengguna.

  5. Untuk menambahkan metadata atau kata kunci penelusuran, atau untuk menyesuaikan URL halaman detail untuk produk Anda, lengkapi tab METADATA PRODUK di bagian Detail produk.

  6. Jika Anda sudah siap mengirimkan detail produk untuk diproses, klik Kirim.

Diperlukan 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 image container

Anda harus membuat satu versi yang sesuai dengan tag Pendaftaran Penampung latest (peka huruf besar/kecil). Ini adalah versi default di halaman produk.

Untuk menambahkan image container:

  1. Di daftar produk, klik ID produk.

  2. Di halaman Ringkasan produk Anda, buka Image penampung, lalu klik Edit.

  3. Di bagian Container images, masukkan URL untuk repositori Artifact Registry staging Anda.

  4. Klik Tetapkan Rilis. Mungkin perlu waktu beberapa detik untuk membaca repositori dan memuat tag Anda.

  5. Pilih Tag tampilan untuk rilis yang ingin Anda sertakan dalam produk. Anda harus menyertakan rilis latest dalam produk, tetapi Anda dapat menambahkan versi tambahan. Sebaiknya batasi jumlah rilis yang tersedia untuk produk Anda demi kemudahan pengguna.

  6. Secara opsional, tambahkan Judul versi dan deskripsi singkat rilis. Hal ini membantu pengguna men-deploy versi yang mereka inginkan.

  7. Masukkan sistem operasi yang didukung rilis ini. Anda dapat menentukan versi sistem operasi, jika diperlukan.

  8. Setelah menambahkan semua informasi untuk rilis, klik Selesai.

  9. Untuk menambahkan versi lain, klik Tambahkan Rilis, lalu masukkan informasi untuk rilis tersebut.

  10. Setelah selesai menambahkan rilis yang didukung ke produk, klik Simpan dan Validasi. Gambar disalin ke repositori publik, lalu kami menjalankan serangkaian pengujian terhadap gambar.

  11. Klik Kirim untuk mengirimkan image container untuk ditinjau.

Melihat pratinjau produk image container

Untuk melihat pratinjau listingan Cloud Marketplace sebelum terlihat oleh pengguna:

  1. Di daftar produk, klik ID produk.

  2. Di halaman Ringkasan produk Anda, klik Pratinjau lengkap.

Jika Anda telah mengubah tag apa pun di repositori staging sejak memvalidasi image container di Producer Portal, gambar yang dirujuk dalam pratinjau mungkin tidak akurat.

Memublikasikan produk image container

Untuk memublikasikan produk di Cloud Marketplace, Anda harus:

Setelah semua peninjauan disetujui, Anda dapat memublikasikan dan meluncurkan produk dalam beberapa menit. Untuk memublikasikan produk Anda:

  1. Di daftar produk, klik ID produk.

  2. Di halaman Ringkasan produk Anda, klik Publikasikan.

Sebelumnya
Menawarkan produk image container
Berikutnya
Memperbarui, menghentikan penggunaan, dan menghapus produk image container