Mengelola layanan dan workload

App Hub memungkinkan Anda mengelola layanan dan workload yang terdaftar dan ditemukan secara langsung, sehingga Anda dapat menjaga keakuratan metadata aplikasi. Seiring perubahan infrastruktur, Anda dapat melihat detail komponen, memperbarui atribut, atau membatalkan pendaftaran komponen dari aplikasi.

Untuk aplikasi yang di-deploy dari template, update komponen di Application Design Center.

Ringkasan

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

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

• Untuk aplikasi yang di-deploy dari template Application Design Center: Gunakan Application Design Center untuk mengelola dan mengupdate 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 dalam App Hub.

  Buka App Hub

Sebelum memulai

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

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan 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 :

• Mengupdate dan membatalkan pendaftaran layanan dan workload: App Hub Editor (roles/apphub.editor)
• Melihat layanan, workload, 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 dalam batas pengelolaan aplikasi Anda, termasuk hal berikut:

• Location
• Status pendaftaran ke aplikasi
• Properti dan atribut

Untuk mengetahui informasi selengkapnya tentang detail ini, lihat Konsep dan model data App Hub.

Konsol

Lihat detail dari layanan dan workload aplikasi dengan nilai status pendaftaran registered atau detached:

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

2. Buka halaman Applications 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 Details komponen, Anda dapat melihat informasi seperti nama tampilan, lokasi, status pendaftaran, properti, dan atribut.

Atau, lihat daftar semua layanan dan workload dengan nilai status pendaftaran discovered atau registered:

1. Buka halaman Services and workloads dari App Hub:

   Buka Services and workloads

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

2. Gunakan kolom Filter untuk mempersempit hasil berdasarkan properti, atribut, atau status, menggunakan nilai seperti Environment, Owners, atau Registration status.

gcloud

Lihat detail dari layanan dan workload aplikasi dengan nilai status pendaftaran registered atau detached:

1. Temukan project ID project pengelolaan Anda.

2. Deskripsikan layanan atau workload 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 didaftarkan.
     • LOCATION: lokasi layanan. Gunakan global untuk resource global atau region tertentu, seperti us-east1, untuk resource regional.

   • Menjelaskan 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 didaftarkan.
     • LOCATION: lokasi workload. Gunakan global untuk resource global atau region tertentu, seperti us-east1, untuk resource regional.

Output menampilkan detail dari komponen, seperti nama tampilan, lokasi, dan status pendaftaran. Template ini juga menyertakan properti dan atribut, jika ada di resource.

Atau, lihat daftar semua layanan dan workload dengan nilai status pendaftaran discovered atau registered:

Menemukan

Resource Google Cloud yang ditemukan dalam batas pengelolaan aplikasi Anda tersedia untuk didaftarkan sebagai layanan atau workload dalam aplikasi. Ikuti langkah-langkah berikut untuk mencantumkan resource yang ditemukan:

1. Melihat daftar 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 yang 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 workload dalam aplikasi dapat berubah menjadi terlepas jika Anda memindahkan project atau folder keluar dari batas pengelolaan aplikasi atau menghapus resource yang mendasarinya. 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 memasang kembali layanan atau workload ke aplikasi, Anda harus mendaftarkannya lagi.

Melihat skema metadata yang diperluas

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

App Hub memperkaya layanan dan workload Anda dengan metadata untuk meningkatkan kemudahan penemuan, tata kelola, dan integrasi dengan sistem lain. Anda dapat menelusuri skema metadata yang tersedia dan melihat definisinya menggunakan App Hub API.

Ikuti langkah-langkah berikut untuk melihat definisi skema properti metadata yang diperluas, mencantumkan semua skema yang tersedia, atau mendapatkan detail skema tertentu jika tersedia.

Untuk mengetahui informasi selengkapnya tentang properti metadata yang diperluas, lihat Properti dan atribut. Untuk mengetahui daftar jenis metadata yang didukung dan skemanya, lihat Skema metadata yang diperluas.

gcloud

• Mencantumkan semua skema metadata yang diperluas yang tersedia dalam project dan lokasi:

  gcloud alpha apphub extended-metadata-schemas list \
      --project=PROJECT_ID \
      --location=LOCATION \
  

  Ganti kode berikut:

  • PROJECT_ID: ID project pengelolaan Anda.
  • LOCATION: lokasi komponen. Gunakan global untuk komponen global atau region tertentu, seperti us-east1, untuk komponen regional.

• Melihat detail skema tertentu:

  gcloud alpha apphub extended-metadata-schemas describe SCHEMA_NAME \
      --project=PROJECT_ID \
      --location=LOCATION \
  

  Ganti SCHEMA_NAME dengan nama lengkap skema, misalnya, apphub.googleapis.com/AgentProperties.

Terraform

Anda dapat menggunakan sumber data di Terraform untuk mengambil detail skema tertentu. Contoh berikut memungkinkan Anda melihat detail skema apphub.googleapis.com/AgentProperties untuk workload dengan jenis fungsional AGENT di project my-project-id di lokasi us-central1.

data "google_apphub_extended_metadata_schema" "agent_properties" {
  project  = "my-project-id"
  location = "us-central1"
  name     = "apphub.googleapis.com/AgentProperties"
}

Memperbarui atribut layanan dan workload

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

Catatan: Anda tidak dapat mengubah atribut untuk layanan bersama.

Konsol

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

2. Buka halaman Applications dari App Hub:

   Buka Applications

   Halaman ini menampilkan daftar aplikasi Anda.

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

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

5. Klik more_vert More, lalu klik Edit service atau Edit workload.

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

gcloud

1. Temukan project ID project pengelolaan Anda.

2. Memperbarui atribut layanan atau workload:

   • Memperbarui 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 update.

   • 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 update.

     Ganti flag wajib dan opsional berikut:

     • Wajib diisi: 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 workload dengan Terraform, ubah argumen dalam blok resource google_apphub_service atau google_apphub_workload yang sesuai di file konfigurasi Anda. Saat Anda menerapkan perubahan, Terraform akan memperbarui resource agar sesuai dengan konfigurasi baru.

Contoh berikut memperbarui atribut kekritisan dan lingkungan layanan serta workload aplikasi regional:

• Memperbarui 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 workload

Membatalkan pendaftaran layanan atau workload akan menghapusnya dari aplikasi. Resource yang mendasarinya tidak akan dihapus. Jika masih berada dalam batas pengelolaan aplikasi Anda, resource 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 workload:

Konsol

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

2. Buka halaman Applications dari App Hub:

   Buka Applications

   Halaman ini menampilkan daftar aplikasi Anda.

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

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

5. Di halaman detail komponen, klik Unregister.

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 workload yang ingin Anda batalkan pendaftarannya.

Terraform

Untuk membatalkan pendaftaran layanan atau workload 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 workload, Anda dapat menghapus aplikasi.

Langkah berikutnya

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