Menyiapkan lingkungan Google Cloud Anda

Halaman ini menjelaskan langkah-langkah untuk menyiapkan lingkungan Google Cloud agar Anda dapat mendistribusikan aplikasi Kubernetes Anda.

Membuat ruang kerja

Sebaiknya buat project baru di Konsol Google Cloud terutama untuk produk Cloud Marketplace.

Untuk mengelola produk yang dikirimkan ke Cloud Marketplace, sebaiknya buat project baru dengan project ID yang diakhiri dengan -public. Untuk membuat project bagi produk Anda, lihat Membuat dan mengelola project.

Jika Anda sudah menyiapkan project untuk dijual di Cloud Marketplace yang ingin digunakan, pastikan bahwa peran Identity and Access Management (IAM) diberikan dengan benar untuk Kubernetes, lalu lanjutkan ke bagian Menyiapkan container registry.

Memberikan peran untuk project Anda

Untuk menyelesaikan penyiapan project Anda, selesaikan langkah-langkah berikut:

1. Setelah Anda membuat project, berikan peran berikut pada level project:

   • Editor Project, kepada [e-mail]
   • Administrator Pengelolaan Layanan (roles/servicemanagement.serviceAdmin), untuk [e-mail] dan [e-mail]
   • Config Editor (roles/servicemanagement.configEditor), untuk [e-mail]

   Untuk memberikan akses ke project Anda, lihat Memberikan, mengubah, dan mencabut akses ke resource.

2. Berikan peran berikut di tingkat layanan, ke [e-mail]:

   • Konsumen Layanan (roles/servicemanagement.serviceConsumer)
   • Pengontrol Layanan (roles/servicemanagement.serviceController)

   Untuk mengetahui langkah-langkah dalam memberikan akses pada tingkat layanan, lihat Memberikan dan mencabut akses ke API.

3. Setel kontak keamanan. Untuk informasi selengkapnya, lihat Mengelola kontak untuk notifikasi.

4. Isi formulir Info Project yang diberikan oleh tim Cloud Marketplace.

Menyiapkan container registry

Anda memerlukan repositori Container Registry untuk menghosting image container aplikasi Anda. Analisis Artefak terus memindai image aplikasi untuk mendeteksi kerentanan sehingga Anda dapat meninjau dan mengatasi masalah sebelum mengirimkan produk Anda ke Cloud Marketplace.

Untuk menyiapkan Container Registry, Docker, dan Google Cloud SDK, ikuti panduan memulai Container Registry.

Setelah Anda menyiapkan Container Registry, dalam project yang berisi registry Anda, berikan peran Project Viewer ke [e-mail].

Mengaktifkan Container Analysis API

Anda harus mengaktifkan Artifact Analysis API, yang memindai image container Anda di Container Registry untuk mencari kerentanan. Untuk ringkasan tentang pemindaian kerentanan di Analisis Artefak, lihat Dokumentasi Container Registry.

Tambahkan produk Anda ke Cloud Marketplace

Untuk membuat dan memublikasikan produk di Cloud Marketplace, gunakan prod Portal. Partner Engineer akan mengaktifkannya setelah Anda mengisi Formulir Info Project Cloud Marketplace.

Untuk memublikasikan produk di PD Portal, buat entri untuk produk, lalu kirimkan informasi berikut untuk ditinjau:

• Detail produk: Tambahkan informasi listingan dan pemasaran tentang produk Anda.
• Harga: Pilih dan tentukan model harga untuk menentukan cara pelanggan membayar produk Anda.
• Image container: Sediakan repositori Google Container Registry yang menyertakan image container Anda.
• Kepatuhan Open Source: Pastikan produk Anda mematuhi kebijakan Google untuk software open source.

Anda dapat mengirimkan ulasan ini kapan saja dan dalam urutan apa pun. Beberapa ulasan mungkin memerlukan waktu hingga dua minggu untuk disetujui, jadi sebaiknya tinjau persyaratannya dan mulai sedini mungkin.

Untuk membuat entri Cloud Marketplace produk Anda:

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

   Catatan: Jika Anda tidak melihat link, atau tidak dapat mengakses URL, pastikan Anda telah memilih project yang benar dan memiliki peran Editor (roles/editor) untuk project tersebut. Jika Anda tetap tidak dapat mengakses URL, 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 terkait Cloud Marketplace.

2. Di bagian atas halaman, klik Tambahkan produk.

3. Pilih Kubernetes.

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

   Perhatian: ID Produk dan tipe produk tidak dapat diubah setelah produk dibuat. Anda dapat mengubah nama produk sebelum mengirimkannya.

5. Klik Create. Mungkin diperlukan waktu beberapa detik untuk membuat produk.

Anda akan menambahkan model harga dan informasi pemasaran untuk solusi Anda di langkah-langkah berikutnya.

Membuat cluster pengembangan di Kubernetes Engine

Anda akan menggunakan Google Kubernetes Engine untuk mengelola dan menskalakan cluster Kubernetes. Untuk membuat cluster pengujian dan men-deploy aplikasi dasar ke cluster tersebut, ikuti panduan memulai Google Kubernetes Engine.

Catatan: Jika Anda tidak menggunakan cluster secara aktif untuk pengujian, sebaiknya hapus cluster tersebut. Jika ingin mempertahankan cluster dan menghemat biaya, Anda dapat mengubah ukuran cluster dan mengubah jumlah node menjadi nol. Untuk mengetahui langkah-langkah dalam mengubah ukuran cluster, lihat dokumentasi Google Kubernetes Engine.

Menginstal alat pengembangan mpdev

Alat mpdev adalah penampung yang menggabungkan utilitas untuk menguji dan memublikasikan image aplikasi. Meskipun menginstal mpdev tidak diperlukan untuk mengirimkan aplikasi untuk dirilis, Anda dapat menjalankan mpdev untuk memverifikasi lingkungan pengembangan, dan menguji apakah aplikasi Anda diinstal dengan benar di cluster pengembangan.

Instal mpdev dari repositori GitHub alat Cloud Marketplace.

Untuk mengetahui informasi tentang cara menggunakan mpdev dalam memeriksa lingkungan dan menguji aplikasi, lihat referensi mpdev di GitHub.

Mengatur rilis

Secara umum, setiap versi aplikasi Anda harus mengadopsi Versi Semantik 2.0, yang mengikuti konvensi penomoran MAJOR.MINOR.PATCH. Setiap versi harus memiliki nomor versi unik, seperti 1.0.1, 1.0.2, 1.3.1, dan seterusnya. Secara opsional, tambahkan tanda hubung setelah nomor versi untuk menambahkan pengubah pra-rilis, seperti 1.3.1-alpha201910. Pengubah pra-rilis dapat digunakan untuk menyimpan dan menyoroti informasi tambahan yang dianggap berguna, seperti tanggal build yang menunjukkan kapan versi dibuat.

Sebaiknya rilis software di jalur. Setiap jalur adalah serangkaian versi dengan update yang kompatibel dengan versi lama. Jalur rilis Anda harus didasarkan pada versi minor, seperti 4.1.x. Sebagai praktik terbaik, hindari penggunaan nama versi generik seperti latest.

Misalnya, jika Anda merilis versi 2.0 software di Cloud Marketplace, dan memperkirakan bahwa versi 2.0.1, 2.0.5, dan seterusnya akan kompatibel dengan versi lama 2.0, atur rilis ini di bagian jalur rilis 2.0.

Saat Anda merilis versi aplikasi yang tidak kompatibel dengan versi sebelumnya, atau versi yang mengharuskan pengguna melakukan langkah-langkah migrasi manual, rilis aplikasi di jalur baru agar pengguna dapat merencanakan update mereka.

Pilih kode produk Anda

Anda harus memilih ID berikut untuk gambar perusahaan, produk, dan penampung Anda, yang digunakan untuk membuat URL Cloud Marketplace, dan URI untuk gambar container Anda:

• Nama perusahaan Anda. Misalnya, jika nama perusahaan Anda adalah Examplesoft Inc., Anda dapat menggunakan ID examplesoft.

• Nama produk Anda. Misalnya, jika nama produk adalah Example Pro, gunakan ID example-pro.

• Jalur rilis produk Anda, seperti 4.0.

  Lihat persyaratan untuk mengatur rilis Anda.

• Image container Anda. Pilih ID unik untuk setiap image container di aplikasi Anda. ID berikut diperlukan untuk semua aplikasi:

  • Gambar utama: Image container ini adalah gambar utama untuk produk Anda, dan menggunakan ID yang sama dengan produk tersebut. Misalnya, jika kode produk Anda adalah example-pro, gambar utama akan menggunakan ID yang sama.
  • deployer: Image container deployment untuk jalur. Penampung deployment berjalan saat pengguna men-deploy aplikasi Anda dari Konsol Google Cloud. Anda membuat image deployment saat membuat paket aplikasi.

Perhatian: ID yang Anda pilih akan muncul di URL produk dan URI image penampung. ID ini sulit diubah setelah produk Anda dipublikasikan ke pelanggan Cloud Marketplace.

Misalnya, perusahaan Examplesoft Inc. memilih ID berikut untuk produknya, Example Pro:

	Nama	ID
Perusahaan	Examplesoft Inc	{i>examplesoft<i}
Produk	Contoh Pro	contoh-pro
Gambar [1] (utama)	Contoh server Pro	t/a
Gambar [2]	Contoh Antrean	contoh-antrean
Gambar [deployer]	t/a	deployer
Jalur rilis [1]	Versi 4.x.x	4.0
Jalur rilis [2]	Versi 5.x.x	5,0

Untuk ID ini, informasi berikut dibuat secara otomatis:

• URL produk di Cloud Marketplace: https://console.cloud.google.com/marketplace/details/examplesoft/example-pro

• URI gambar container:

  • marketplace.gcr.io/examplesoft/example-pro:4.0
  • marketplace.gcr.io/examplesoft/example-pro/example-queue:4.0
  • marketplace.gcr.io/examplesoft/example-pro/deployer:4.0
  • marketplace.gcr.io/examplesoft/example-pro:5.0
  • marketplace.gcr.io/examplesoft/example-pro/example-queue:5.0
  • marketplace.gcr.io/examplesoft/example-pro/deployer:5.0