Mengelola layanan dan workload

Saat menyiapkan App Hub, Anda membuat batas administratif untuk aplikasi Anda. Batas ini adalah project pengelolaan atau kumpulan project host dan layanan yang Anda konfigurasi untuk pengelolaan aplikasi, bergantung pada model penyiapan Anda. Layanan dan beban kerja terdaftar sebagai aplikasi di dalam batas administratif ini.

Untuk menghindari penyimpangan konfigurasi dan mempertahankan sumber tepercaya yang jelas, sebaiknya kelola resource aplikasi di lingkungan tempat resource tersebut ditentukan awalnya:

• Untuk aplikasi yang di-deploy dari template Application Design Center: Gunakan Application Design Center untuk mengelola dan memperbarui aplikasi. Anda dapat merevisi template untuk perubahan desain aplikasi atau membuat revisi aplikasi untuk memperbarui setelan seperti detail aplikasi dan komponen.

  Buka Application Design Center

• Untuk aplikasi yang dibuat dengan mendaftarkan resource di App Hub: Kelola aplikasi, layanan, dan workload-nya langsung di dalam App Hub.

  Buka Hub Aplikasi

Halaman ini menjelaskan cara mengelola layanan dan beban kerja yang ditemukan atau didaftarkan langsung dalam App Hub sebagai aplikasi. Anda dapat melakukan tindakan ini menggunakan konsol Google Cloud atau Google Cloud CLI. Untuk aplikasi yang di-deploy dari template, lihat dokumentasi Application Design Center.

Sebelum memulai

Sebelum Anda dapat melihat, memperbarui, dan membatalkan pendaftaran layanan dan beban kerja di App Hub, selesaikan langkah-langkah berikut:

1. Siapkan App Hub menggunakan salah satu model penyiapan yang didukung.
2. Mendaftarkan resource yang didukung ke aplikasi.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengelola layanan dan beban kerja di App Hub, minta administrator untuk memberi Anda peran IAM berikut pada batas administratif aplikasi dari model penyiapan Anda (project pengelolaan atau project host dan layanan) :

• Memperbarui dan membatalkan pendaftaran layanan dan beban kerja: Editor App Hub (roles/apphub.editor)
• Melihat layanan dan beban kerja: App Hub Viewer (roles/apphub.viewer)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, baca artikel Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi selengkapnya tentang peran App Hub, lihat Peran dan izin IAM App Hub.

Melihat detail layanan dan workload

Ikuti langkah-langkah berikut untuk melihat detail layanan dan beban kerja, termasuk lokasi dan status pendaftarannya ke aplikasi, dalam batas administratif App Hub Anda:

Konsol

Melihat detail dari layanan dan workload yang terdaftar atau dilepas dari aplikasi:

1. Di halaman Welcome di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan atau project host Anda:

   Buka Selamat Datang

2. Buka halaman Aplikasi di App Hub:

   Buka Aplikasi

   Halaman ini menampilkan daftar aplikasi Anda.

3. Klik nama aplikasi yang ingin Anda lihat layanan atau workload-nya.

4. Di tab Layanan dan workload, klik nama layanan atau workload yang ingin Anda lihat.

5. Di halaman Detail untuk resource, Anda dapat melihat detail seperti nama tampilan, lokasi, status pendaftaran, dan atribut.

Atau, lihat daftar semua layanan dan beban kerja dengan nilai status pendaftaran ditemukan atau terdaftar:

1. Buka halaman Layanan dan beban kerja di App Hub:

   Buka Layanan dan workload

   Halaman ini menampilkan daftar semua layanan dan beban kerja yang ditemukan dan terdaftar.

2. Gunakan kolom Filter untuk mempersempit hasil menurut atribut seperti Lingkungan atau Status pendaftaran.

gcloud

Melihat detail dari layanan dan workload yang terdaftar atau dilepas dari aplikasi:

1. Temukan project ID project pengelolaan atau project host Anda.

2. Mendeskripsikan layanan atau beban kerja dari aplikasi untuk meninjau detailnya:

   • Mendeskripsikan layanan:

     gcloud apphub applications services describe SERVICE \
         --project=PROJECT_ID \
         --application=APPLICATION \
         --location=LOCATION
     

     Ganti kode berikut:

     • SERVICE: ID layanan.
     • PROJECT_ID: ID project host atau project pengelolaan Anda.
     • APPLICATION: ID aplikasi tempat layanan terdaftar.
     • LOCATION: lokasi layanan. Gunakan global untuk resource global atau wilayah tertentu, seperti us-east1, untuk resource regional.

   • Mendeskripsikan workload:

     gcloud apphub applications workloads describe WORKLOAD \
         --project=PROJECT_ID \
         --application=APPLICATION \
         --location=LOCATION
     

     Ganti kode berikut:

     • WORKLOAD: ID workload.
     • PROJECT_ID: ID project host atau project pengelolaan Anda.
     • APPLICATION: ID aplikasi tempat workload terdaftar.
     • LOCATION: lokasi workload. Gunakan global untuk resource global atau wilayah tertentu, seperti us-east1, untuk resource regional.

Output menampilkan detail dari resource, seperti nama tampilan, lokasi, status pendaftaran, dan atribut.

Atau, lihat daftar semua layanan dan beban kerja dengan nilai status pendaftaran ditemukan atau terdaftar:

Resource yang ditemukan

Resource yang ditemukan dapat didaftarkan ke aplikasi. Ikuti langkah-langkah berikut untuk mencantumkan resource yang ditemukan:

1. Mencantumkan layanan yang ditemukan:

   gcloud apphub discovered-services list \
       --project=PROJECT_ID \
       --location=LOCATION
   

   Ganti kode berikut:

   • PROJECT_ID: ID project host atau project pengelolaan Anda.
   • LOCATION: lokasi tempat Anda ingin menemukan resource. Gunakan global untuk resource global atau region tertentu, seperti us-east1, untuk resource regional.

2. Mencantumkan workload yang ditemukan:

   gcloud apphub discovered-workloads list \
       --project=PROJECT_ID \
       --location=LOCATION
   

Resource terdaftar

Resource terdaftar adalah bagian dari aplikasi. Ikuti langkah-langkah berikut untuk mencantumkan resource terdaftar dari aplikasi tertentu. Anda dapat memfilter daftar berdasarkan atribut, menggunakan flag --filter:

1. Mencantumkan layanan terdaftar dalam aplikasi:

   gcloud apphub applications services list \
       --application=APPLICATION_NAME \
       --project=PROJECT_ID \
       --location=LOCATION \
       --filter=FILTER_EXPRESSION
   

   Ganti kode berikut:

   • APPLICATION_NAME: nama aplikasi Anda. Anda menentukan nilai ini saat membuat aplikasi.
   • PROJECT_ID: ID project host atau project pengelolaan Anda.
   • LOCATION: lokasi resource. Gunakan global untuk resource global atau wilayah tertentu, seperti us-east1, untuk resource regional.
   • Opsional: FILTER_EXPRESSION: ekspresi filter untuk menentukan atribut. Misalnya, untuk mencantumkan resource dengan jenis lingkungan PRODUCTION, gunakan attributes.environment.type=PRODUCTION.

2. Mencantumkan workload terdaftar dalam aplikasi:

   gcloud apphub applications workloads list \
       --application=APPLICATION_NAME \
       --project=PROJECT_ID \
       --location=LOCATION \
       --filter=FILTER_EXPRESSION
   

Status pendaftaran layanan dan beban kerja dari aplikasi dapat berubah menjadi dilepas jika Anda mengubah struktur organisasi resource Google Cloudatau menghapus resource pokok. Layanan dan beban kerja yang dilepas tetap berada di aplikasi hingga Anda membatalkan pendaftarannya, tetapi App Hub tidak dapat lagi mengelola atau memantaunya. Untuk mengetahui informasi selengkapnya, lihat Status pendaftaran layanan dan workload.

Untuk melampirkan kembali layanan atau workload ke aplikasi, Anda harus mendaftarkannya lagi berdasarkan hierarki resource dari model penyiapan Anda.

Memperbarui atribut layanan dan workload

Ikuti langkah-langkah berikut untuk mengubah atribut yang ditentukan pengguna dari layanan dan beban kerja yang terdaftar ke aplikasi:

Konsol

1. Di halaman Welcome di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan atau project host Anda:

   Buka Selamat Datang

2. Buka halaman Aplikasi di App Hub:

   Buka Aplikasi

   Halaman ini menampilkan daftar aplikasi Anda.

3. Klik nama aplikasi yang atribut layanan atau workload-nya ingin Anda perbarui.

4. Di tab Services and workloads, temukan nama layanan atau workload yang ingin Anda perbarui.

5. Klik more_vert Lainnya, lalu klik Edit layanan atau Edit beban kerja.

6. Di panel yang terbuka, edit kolom sesuai kebutuhan, lalu klik Simpan.

gcloud

1. Temukan project ID project pengelolaan atau project host Anda.

2. Memperbarui atribut layanan atau workload:

   • Perbarui atribut layanan:

     gcloud apphub applications services update SERVICE_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION \
         --display-name=DISPLAY_NAME \
         --criticality-type=CRITICALITY_LEVEL \
         --environment-type=ENVIRONMENT \
         --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
         --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
         --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
     

     Ganti SERVICE_NAME dengan nama layanan yang ingin Anda perbarui.

   • Perbarui atribut workload:

     gcloud apphub applications workloads update WORKLOAD_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION \
         --display-name=DISPLAY_NAME \
         --criticality-type=CRITICALITY_LEVEL \
         --environment-type=ENVIRONMENT \
         --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
         --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
         --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
     

     Ganti WORKLOAD_NAME dengan nama beban kerja yang ingin Anda perbarui.

     Ganti flag wajib dan opsional berikut:

     • Wajib: APPLICATION_NAME: nama aplikasi Anda. Anda menentukan nilai ini saat membuat aplikasi.
     • Wajib: PROJECT_ID: ID project host atau project pengelolaan Anda.
     • Wajib: LOCATION: lokasi resource Anda. Gunakan global untuk resource global atau region tertentu, seperti us-east1, untuk resource regional.
     • Opsional: DISPLAY_NAME: nama tampilan resource Anda.

     • Opsional: CRITICALITY_LEVEL: tingkat kepentingan resource. Gunakan salah satu nilai berikut:

       • MISSION_CRITICAL
       • HIGH
       • MEDIUM
       • LOW

     • Opsional: ENVIRONMENT: tahap siklus proses software. Gunakan salah satu nilai berikut:

       • PRODUCTION
       • STAGING
       • DEVELOPMENT
       • TEST

     • Opsional: DEV_NAME dan DEV_EMAIL: nama tampilan dan alamat email pemilik developer.

     • Opsional: OPERATOR_NAME dan OPERATOR_EMAIL: nama tampilan dan alamat email pemilik operator.

     • Opsional: BUSINESS_NAME dan BUSINESS_EMAIL: nama tampilan dan alamat email pemilik bisnis.

     Catatan: Alamat email harus memiliki format username@yourdomain, misalnya, [e-mail].

Terraform

Untuk memperbarui atribut layanan atau beban kerja dengan Terraform, ubah argumen dalam blok resource google_apphub_service atau google_apphub_workload yang sesuai dalam file konfigurasi Anda. Saat Anda menerapkan perubahan, Terraform akan memperbarui resource agar sesuai dengan konfigurasi baru.

Contoh berikut memperbarui atribut tingkat keparahan dan lingkungan layanan dan workload aplikasi regional:

• Perbarui atribut layanan:

  resource "google_apphub_service" "example" {
      # ... other arguments
      attributes {
          criticality {
              type = "HIGH" # Updated criticality
          }
          environment {
              type = "PRODUCTION"
          }
          # ... other attributes
      }
  }
  

• Perbarui atribut workload:

  resource "google_apphub_workload" "example" {
      # ... other arguments
      attributes {
          criticality {
              type = "HIGH" # Updated criticality
          }
          environment {
              type = "PRODUCTION"
          }
          # ... other attributes
      }
  }
  

Membatalkan pendaftaran layanan dan beban kerja

Membatalkan pendaftaran layanan atau beban kerja akan menghapusnya dari aplikasi. Resource yang mendasarinya tidak dihapus dan menjadi resource ditemukan lagi, tersedia untuk pendaftaran ke aplikasi lain.

Ikuti langkah-langkah berikut untuk membatalkan pendaftaran layanan dan beban kerja:

Konsol

1. Di halaman Welcome di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan atau project host Anda:

   Buka Selamat Datang

2. Buka halaman Aplikasi di App Hub:

   Buka Aplikasi

   Halaman ini menampilkan daftar aplikasi Anda.

3. Klik nama aplikasi yang layanan atau workload-nya ingin Anda batalkan pendaftarannya.

4. Di tab Layanan dan beban kerja, klik nama layanan atau beban kerja yang ingin Anda batalkan pendaftarannya.

5. Di halaman detail untuk resource, klik Batalkan pendaftaran.

gcloud

1. Temukan project ID project pengelolaan atau project host Anda.

2. Membatalkan pendaftaran layanan atau workload:

   • Membatalkan pendaftaran layanan:

     gcloud apphub applications services delete SERVICE_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION
     

     Ganti kode berikut:

     • SERVICE_NAME: nama layanan yang ingin Anda batalkan pendaftarannya.
     • APPLICATION_NAME: nama aplikasi Anda. Anda menentukan nilai ini saat membuat aplikasi.
     • PROJECT_ID: ID project host atau project pengelolaan Anda.
     • LOCATION: lokasi resource. Gunakan global untuk resource global atau wilayah tertentu, seperti us-east1, untuk resource regional.

   • Membatalkan pendaftaran workload:

     gcloud apphub applications workloads delete WORKLOAD_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION
     

     Ganti WORKLOAD_NAME dengan nama beban kerja yang ingin Anda batalkan pendaftarannya.

Terraform

Untuk membatalkan pendaftaran layanan atau beban kerja yang dikelola oleh Terraform, hapus blok resource google_apphub_service atau google_apphub_workload yang sesuai dari file konfigurasi Anda dan jalankan terraform apply. Saat Anda menerapkan perubahan, Terraform akan menghapus pendaftaran dari App Hub.

Setelah membatalkan pendaftaran semua layanan dan beban kerja, Anda dapat menghapus aplikasi.

Langkah berikutnya

• Mengelola aplikasi Anda
• Mengoptimalkan aplikasi dengan rekomendasi desain
• Memantau aplikasi Anda