Siklus proses deployment marketplace

Dokumen ini menjelaskan cara menginstal, mengupgrade, dan meng-uninstal paket software Marketplace Google Distributed Cloud (GDC) dengan air gap menggunakan konsol GDC. Anda juga dapat menginstal paket software menggunakan gdcloud marketplace CLI atau Marketplace API.

Dokumen ini ditujukan untuk audiens dalam grup operator aplikasi yang mengelola siklus proses deployment Marketplace dalam project GDC. Untuk mengetahui informasi selengkapnya, lihat Audiens untuk dokumentasi GDC dengan air gap.

Sebelum memulai

Sebelum dapat menginstal, mengupgrade, atau meng-uninstal paket software Marketplace, Anda harus memiliki izin yang diperlukan dan menyiapkan lingkungan Anda.

Meminta peran IAM

Hubungi IAM Org Admin atau IAM Project Admin Anda untuk meminta peran berikut berdasarkan tugas yang perlu Anda lakukan dalam project:

• Editor Marketplace (marketplace-editor): menginstal, mengupgrade, dan meng-uninstal paket software Marketplace.
• Project Viewer (project-viewer): melihat project yang ada dan resource-nya.

IAM Org Admin dapat memberikan peran ini untuk project apa pun dalam organisasi. IAM Project Admin dapat memberikan peran ini dalam cakupan project spesifik mereka.

Menyiapkan lingkungan Anda

Tugas di halaman ini terutama menggunakan konsol GDC. Jika Anda berencana menggunakan alternatif command line, selesaikan langkah-langkah berikut:

• Download dan instal gdcloud CLI, jika Anda belum melakukannya.
• Untuk menggunakan API dengan kubectl, diperlukan penyiapan tambahan:
  • Instal kubectl CLI.
  • Buat file kubeconfig.

Menginstal paket software marketplace Distributed Cloud

Untuk menginstal paket software dari marketplace Distributed Cloud, selesaikan langkah-langkah berikut:

Konsol

1. Di pemilih project konsol GDC, pilih project tempat Anda ingin menginstal paket software.
2. Di marketplace Distributed Cloud, buka halaman listingan untuk produk yang ingin Anda instal. Dari halaman ini, Anda dapat meninjau detail produk dan mengikuti link ke dokumentasi, harga, dan persyaratan layanannya.
3. Jika ini pertama kalinya Anda menginstal produk ini, klik Instal. Atau, buka tab Management dan klik New Instance.
4. Dalam dialog, pilih cluster pengguna tempat Anda ingin menginstal paket software. Jika Anda ingin menyesuaikan konfigurasinya, klik Berikutnya. Jika Anda ingin menggunakan konfigurasi default, klik Install.
5. Jika mengklik Next, Anda kini dapat memeriksa konfigurasi default. Klik Konfigurasi kustom untuk memasukkan parameter Anda sendiri, dengan mengikuti dokumentasi vendor. Setelah selesai, klik Install untuk melanjutkan penginstalan. Untuk paket software Kubernetes, parameter yang Anda konfigurasi di sini akan menggantikan nilai default yang disediakan oleh vendor dalam file nilai Helm mereka.

6. Tunggu beberapa menit hingga instance baru Anda ditandai sebagai Ready di tab Management halaman.

   

7. Lihat dokumentasi vendor software yang relevan untuk mempelajari cara menggunakan solusi mereka setelah diinstal.

gdcloud

1. Pilih project tempat Anda ingin menginstal paket software:

   gdcloud config set project PROJECT_NAME
   

   Ganti PROJECT_NAME dengan nama project tempat Anda ingin menginstal paket software.

2. Buat daftar aplikasi Marketplace yang tersedia:

   gdcloud marketplace services list
   

3. Instal aplikasi yang dipilih dari daftar, dengan menentukan cluster target:

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME
   

   Untuk memberikan penggantian konfigurasi kustom selama penginstalan, gunakan flag --parameters-file:

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME \
     --parameters-file=PATH_TO_PARAMETERS_FILE
   

   Ganti kode berikut:

   • SERVICE_NAME: nama layanan Marketplace yang akan diinstal (misalnya, dataproc)
   • CLUSTER_NAME: nama cluster pengguna target tempat Anda ingin menginstal aplikasi
   • PATH_TO_PARAMETERS_FILE: jalur ke file YAML yang berisi parameter penggantian konfigurasi untuk instance layanan

4. Verifikasi penginstalannya:

   gdcloud marketplace services list
   

   Pastikan aplikasi yang baru diinstal muncul dalam daftar dengan status READY atau INSTALLED.

API

1. Cantumkan resource ServiceVersion yang tersedia untuk menemukan layanan dan versi tertentu yang ingin Anda instal:

   kubectl get serviceversions -n mkt-system
   

2. Buat manifes YAML untuk resource ServiceInstance (misalnya, service-instance.yaml):

   apiVersion: marketplace.gdc.goog/v1
   kind: ServiceInstance
   metadata:
     name: INSTANCE_NAME
   spec:
     clusterRef:
       name: CLUSTER_NAME
       namespace: CLUSTER_NAMESPACE
     serviceVersionRef:
       name: SERVICE_VERSION_NAME
       namespace: mkt-system
     parameters:
       KEY: VALUE
   

   Ganti kode berikut:

   • INSTANCE_NAME: nama untuk instance aplikasi baru Anda
   • CLUSTER_NAME: nama cluster pengguna target tempat Anda ingin menginstal aplikasi
   • CLUSTER_NAMESPACE: namespace cluster (misalnya, production-cluster)
   • SERVICE_VERSION_NAME: nama ServiceVersion yang akan diinstal (misalnya, dataproc-1.0.0)
   • KEY: nama parameter penggantian konfigurasi, mengikuti skema nilai Helm vendor
   • VALUE: nilai untuk parameter penggantian konfigurasi

   Untuk mengetahui informasi selengkapnya dan contoh manifes, lihat Ringkasan Marketplace API.

3. Terapkan manifes ke project:

   kubectl apply -f service-instance.yaml -n PROJECT_NAME
   

   Ganti PROJECT_NAME dengan nama project tempat Anda ingin menginstal paket software.

4. Verifikasi penginstalan dengan memeriksa status objek ServiceInstance:

   kubectl get serviceinstance INSTANCE_NAME -n PROJECT_NAME -o yaml
   

   Pastikan status.conditions berisi kondisi jenis Ready dengan status "True", dan status.installedVersion menampilkan versi yang diinstal.

Catatan: Jika Anda perlu mengetahui image container yang tersedia di GDC, lihat daftar image Marketplace yang disertakan dalam versi GDC Anda. Image yang disertakan dalam versi GDC sebelumnya tetap tersedia untuk digunakan, bahkan setelah upgrade GDC.

Mengonfigurasi ulang instance paket software marketplace Distributed Cloud

Peringatan: Meskipun Anda dapat mengonfigurasi ulang instance yang berjalan dari paket software Distributed Cloud Marketplace, proses konfigurasi ulang diterapkan oleh vendor yang memublikasikan produk tersebut. Oleh karena itu, proses konfigurasi ulang bervariasi dari satu paket software ke paket software lainnya. Sebaiknya tinjau dokumentasi vendor yang relevan dengan cermat sebelum melanjutkan konfigurasi ulang. Bergantung pada cara vendor menerapkan proses konfigurasi ulang, Anda mungkin mengalami periode nonaktif dalam layanan yang diberikan.

Beberapa paket software marketplace Distributed Cloud dapat dikonfigurasi ulang saat sudah berjalan. Untuk layanan berbasis Kubernetes, hal ini setara dengan menerapkan nilai baru ke diagram Helm vendor.

Untuk mengonfigurasi ulang instance yang berjalan dari paket software marketplace Distributed Cloud, lakukan langkah-langkah berikut:

1. Di pemilih project konsol GDC, pilih project tempat Anda ingin mengupgrade paket software.
2. Di halaman marketplace Distributed Cloud, buka halaman listingan untuk produk yang ingin Anda upgrade.
3. Klik tab Management.
4. Klik file konfigurasi untuk instance yang ingin Anda konfigurasi ulang.
5. Di panel yang terbuka, masukkan parameter kustom Anda, dengan mengikuti dokumentasi vendor.
6. Klik Save untuk menerapkan parameter baru. Konfigurasi ulang akan selesai dalam beberapa menit.

Mengupgrade paket software marketplace Distributed Cloud

Peringatan: Meskipun Anda dapat memicu upgrade paket software menggunakan Distributed Cloud Marketplace, proses upgrade diterapkan oleh vendor yang memublikasikan produk. Oleh karena itu, proses upgrade bervariasi dari satu paket software ke paket software lainnya. Sebaiknya tinjau dengan cermat catatan rilis dan dokumentasi upgrade dari vendor yang relevan sebelum melanjutkan upgrade. Bergantung pada cara vendor menerapkan proses upgrade, Anda mungkin mengalami periode nonaktif dalam layanan yang diberikan, atau masalah kompatibilitas antara versi lama dan baru.

Beberapa paket software marketplace Distributed Cloud dapat diupgrade ke versi baru melalui marketplace Google Distributed Cloud setelah Operator Infrastruktur menyediakan versi baru tersebut untuk Anda.

Untuk mengupgrade paket software marketplace Distributed Cloud, lakukan langkah-langkah berikut:

1. Di pemilih project konsol GDC, pilih project tempat Anda ingin mengupgrade paket software.
2. Di halaman marketplace Distributed Cloud, buka halaman listingan untuk produk yang ingin Anda upgrade.
3. Klik tab Management.
4. Klik Upgrade pada instance yang ingin Anda upgrade. Upgrade akan selesai dalam beberapa menit.

Catatan: Mengupgrade paket software melalui konsol Distributed Cloud akan menyebabkan versi software berikutnya yang tersedia diinstal. Jika ada beberapa versi baru software yang tersedia, Anda harus mengulangi proses untuk setiap versi. Jika diperlukan, gunakan Marketplace API untuk mengupgrade ke versi tertentu.

Meng-uninstal paket software Distributed Cloud Marketplace

Peringatan: Meng-uninstal paket software Distributed Cloud Marketplace adalah tindakan yang merusak, dan dapat menyebabkan hilangnya data atau periode nonaktif sistem yang bergantung pada software ini. Pastikan Anda telah mencadangkan semua data penting dan tidak ada sistem penting yang bergantung pada software yang ingin Anda uninstal sebelum melanjutkan. Lihat dokumentasi vendor yang relevan untuk mempelajari cara mencadangkan data yang dikelola oleh software mereka.

Untuk meng-uninstal paket software marketplace Distributed Cloud, selesaikan langkah-langkah berikut:

1. Di pemilih project konsol GDC, pilih project tempat Anda ingin meng-uninstal paket software.
2. Di halaman marketplace Distributed Cloud, buka halaman listingan untuk produk yang ingin Anda uninstal.
3. Klik tab Management.
4. Klik Uninstall untuk instance yang ingin Anda uninstal. Paket software akan di-uninstal dalam beberapa menit.