Mengelola layanan dan workload

Saat memilih model penyiapan aplikasi, Anda menentukan batas pengelolaan aplikasi untuk aplikasi App Hub di project pengelolaan. Kemudian, Anda dapat mendaftarkan layanan dan workload di aplikasi dalam batas ini. Untuk kasus penggunaan yang direkomendasikan dalam memperkenalkan praktik pengelolaan aplikasi, lihat Mempersiapkan pengelolaan siklus proses aplikasi.

Untuk menghindari penyimpangan konfigurasi dan mempertahankan sumber tepercaya yang jelas, sebaiknya Anda mengelola komponen aplikasi di lingkungan tempat komponen 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 yang ada di App Hub: Kelola aplikasi, layanan, dan workload langsung di App Hub.

  Buka Hub Aplikasi

Halaman ini menjelaskan cara mengelola layanan dan beban kerja yang ditemukan atau didaftarkan langsung dalam App Hub. 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

Dokumen ini mengasumsikan bahwa Anda memiliki aplikasi dengan resource yang didukung dan terdaftar di dalamnya.

Peran yang diperlukan

Agar mendapatkan izin yang diperlukan untuk mengelola layanan dan workload di App Hub, minta administrator untuk memberi Anda peran IAM berikut pada project pengelolaan yang menentukan batas pengelolaan aplikasi Anda :

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

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat 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 workload, termasuk lokasi, status pendaftaran ke aplikasi, atribut, dan propertinya, dalam batas pengelolaan aplikasi Anda. Untuk mengetahui informasi selengkapnya tentang detail ini, lihat Konsep dan model data App Hub.

Konsol

Melihat detail dari layanan dan workload aplikasi dengan nilai status pendaftaran terdaftar atau dilepas:

1. Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.

2. Buka halaman Aplikasi dari App Hub:

   Buka Applications

   Halaman ini menampilkan daftar aplikasi Anda.

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

4. Di tab Services and workloads, klik nama layanan atau workload yang ingin Anda lihat.

5. Di halaman Detail komponen, Anda dapat melihat informasi seperti nama tampilan, lokasi, status pendaftaran, properti, dan atribut.

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

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

   Buka Layanan dan workload

   Halaman ini menampilkan daftar semua layanan dan workload yang ditemukan dan terdaftar.

2. Gunakan kolom Filter untuk mempersempit hasil menurut properti, atribut, atau status, menggunakan nilai seperti Lingkungan, Pemilik, atau Status pendaftaran.

gcloud

Melihat detail dari layanan dan workload aplikasi dengan nilai status pendaftaran terdaftar atau dilepas:

1. Temukan project ID project pengelolaan Anda.

2. Jelaskan layanan atau beban kerja dari aplikasi untuk meninjau detailnya, termasuk properti dan atribut:

   • 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 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 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 komponen, seperti nama tampilan, lokasi, dan status pendaftaran. Respons ini juga mencakup properti dan atribut, jika ada di resource.

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

Menemukan

Resource Google Cloud yang ditemukan dalam batas pengelolaan aplikasi Anda dapat didaftarkan sebagai layanan atau beban kerja dalam 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 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
   

Terdaftar

Layanan dan workload terdaftar adalah bagian dari aplikasi. Ikuti langkah-langkah berikut untuk mencantumkan komponen 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 pengelolaan Anda.
   • LOCATION: lokasi komponen. Gunakan global untuk komponen global atau region tertentu, seperti us-east1, untuk komponen regional.
   • Opsional: FILTER_EXPRESSION: ekspresi filter untuk menentukan atribut. Misalnya, untuk mencantumkan komponen 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 dalam aplikasi dapat berubah menjadi dilepas jika Anda memindahkan project atau folder keluar dari batas pengelolaan aplikasi atau menghapus resource pokok. Layanan dan workload 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 beban kerja ke aplikasi, Anda harus mendaftarkannya lagi.

Memperbarui atribut layanan dan workload

Untuk mengubah atribut layanan dan beban kerja yang terdaftar dalam aplikasi, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.

2. Buka halaman Aplikasi dari App Hub:

   Buka Applications

   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 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 workload 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 pengelolaan Anda.
     • Wajib: LOCATION: lokasi komponen Anda. Gunakan global untuk komponen global atau region tertentu, seperti us-east1, untuk komponen regional.
     • Opsional: DISPLAY_NAME: nama tampilan komponen Anda.

     • Opsional: CRITICALITY_LEVEL: tingkat kepentingan komponen. 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. Jika masih berada dalam batas pengelolaan aplikasi Anda, aplikasi tersebut akan menjadi resource dengan nilai status pendaftaran ditemukan, yang tersedia untuk didaftarkan ke aplikasi lain.

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

Konsol

1. Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.

2. Buka halaman Aplikasi dari App Hub:

   Buka Applications

   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 komponen, klik Batalkan pendaftaran.

gcloud

1. Temukan project ID project pengelolaan 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 pengelolaan Anda.
     • LOCATION: lokasi komponen. Gunakan global untuk komponen global atau region tertentu, seperti us-east1, untuk komponen 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