Siklus proses deployment marketplace

Dokumen ini menjelaskan cara menginstal, mengupgrade, dan meng-uninstal paket software Marketplace yang terisolasi dari internet Google Distributed Cloud (GDC) menggunakan konsol GDC. Anda juga dapat menginstal paket software menggunakan CLI gdcloud marketplace 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 Admin IAM Organisasi atau Admin IAM Project Anda untuk meminta peran berikut berdasarkan tugas yang perlu Anda lakukan dalam project Anda:

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

Admin IAM Organisasi dapat memberikan peran ini untuk project apa pun dalam organisasi. Admin IAM Project dapat memberikan peran ini dalam cakupan project tertentu.

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, penyiapan tambahan diperlukan:
  • 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 membuka link ke dokumentasi, harga, dan persyaratan layanannya.
3. Jika Anda menginstal produk ini untuk pertama kalinya, klik Instal. Atau, buka tab Pengelolaan, lalu klik Instance Baru.
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 Instal.
5. Jika Anda mengklik Berikutnya, Anda kini dapat memeriksa konfigurasi default. Klik Konfigurasi kustom untuk memasukkan parameter Anda sendiri, dengan mengikuti dokumentasi vendor. Setelah selesai, klik Instal 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 Siap di tab Pengelolaan halaman.

   

7. Lihat dokumentasi vendor software yang relevan untuk mempelajari cara menggunakan solusinya 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. Mencantumkan 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. Buat daftar 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 mana yang tersedia di GDC, lihat daftar image Marketplace yang disertakan dalam versi GDC Anda. Gambar 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 paket software marketplace Distributed Cloud yang sedang berjalan, proses konfigurasi ulang diterapkan oleh vendor yang memublikasikan produk. Oleh karena itu, proses konfigurasi ulang bervariasi dari satu paket software ke paket software lainnya. Sebaiknya tinjau dengan cermat dokumentasi vendor yang relevan sebelum melanjutkan konfigurasi ulang. Bergantung pada cara vendor menerapkan proses rekonfigurasi, Anda mungkin mengalami periode nonaktif pada 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 paket software marketplace Distributed Cloud yang sedang berjalan, ikuti langkah-langkah berikut:

1. Di pemilih project pada 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 Simpan untuk menerapkan parameter baru. Rekonfigurasi akan selesai dalam beberapa menit.

Mengupgrade paket software marketplace Distributed Cloud

Peringatan: Meskipun Anda dapat memicu upgrade paket software menggunakan marketplace Distributed Cloud, proses upgrade diimplementasikan oleh vendor yang memublikasikan produk. Oleh karena itu, proses upgrade bervariasi dari satu paket software ke paket software lainnya. Sebaiknya tinjau catatan rilis dan dokumentasi upgrade vendor terkait dengan cermat sebelum melanjutkan upgrade. Bergantung pada cara vendor menerapkan proses upgrade, Anda mungkin mengalami periode nonaktif pada 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 Anda menyediakan versi baru tersebut untuk Anda.

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

1. Di pemilih project pada 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 Pengelolaan.
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 penginstalan software versi berikutnya yang tersedia. Jika ada beberapa versi baru software yang tersedia, Anda harus mengulangi proses ini 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 marketplace Distributed Cloud adalah tindakan yang merusak, dan dapat mengakibatkan 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 hapus 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 menghapus paket software.
2. Di halaman marketplace Distributed Cloud, buka halaman listingan untuk produk yang ingin Anda hapus instalasinya.
3. Klik tab Management.
4. Klik Uninstal untuk instance yang ingin Anda uninstal. Paket software akan di-uninstal dalam beberapa menit.