Menyiapkan App Hub untuk project host

Dokumen ini memberikan petunjuk untuk menyiapkan App Hub menggunakan project host untuk membangun, mengoperasikan, dan mengelola aplikasi di Google Cloud. Project host adalah project yang dapat menghosting project layanan yang mencakup resource yang ingin Anda kelola menggunakan aplikasi App Hub. Google Cloud Dokumen ini ditujukan bagi orang yang menyiapkan dan mengelola App Hub.

Sebaiknya gunakan folder yang kompatibel dengan aplikasi untuk menyiapkan App Hub dan mengelola aplikasi Anda. Folder yang mendukung aplikasi menyediakan pengelolaan aplikasi di semua project dalam folder dan akses ke fitur seperti Application Design Center dan Gemini Cloud Assist. Untuk informasi selengkapnya, lihat Menyiapkan App Hub untuk folder yang mendukung aplikasi.

Layanan dan workload

Dengan App Hub, resource dari project layanan yang terlampir ke project host tersedia bagi Anda sebagai layanan dan workload. Mendaftarkan layanan dan beban kerja Anda ke aplikasi memungkinkan Anda mengamati dan memantau resource. App Hub mendukung resource global dan regional. Untuk mengetahui informasi selengkapnya, lihat Resource yang didukung App Hub.

Proses penyiapan secara keseluruhan

Daftar berikut merangkum langkah-langkah untuk menyiapkan App Hub:

  1. Tentukan resource yang ada untuk disertakan dalam aplikasi Anda dan project yang memilikinya.
  2. Buat project host App Hub atau gunakan project yang ada sebagai project host Anda. Opsional, berdasarkan struktur organisasi bisnis Anda, buat lebih dari satu project host.
    • Jika Anda berencana memiliki lebih dari satu project host, sebaiknya buat project tersebut dalam folder yang sama.
    • Project host tidak dapat menjadi project layanan selain untuk dirinya sendiri.
  3. Aktifkan App Hub API di project host.
  4. Tentukan pengguna App Hub sebagai Admin App Hub, Editor App Hub, atau Pelihat App Hub.
  5. Lampirkan project layanan. Setelah mengonfigurasi project host, lampirkan project layanan dengan resource pokok yang dibutuhkan aplikasi Anda, ke project host. Perhatikan hal berikut:
    1. Project layanan harus berada dalam organisasi yang sama dengan project host. Setelah melampirkan project layanan ke project host, Anda tidak dapat memindahkannya ke organisasi lain. Untuk memindahkan project layanan ke organisasi lain, Anda harus mengikuti petunjuk dalam dokumen ini untuk menghapus atau melepaskan lampiran project layanan ke project host. Kemudian, Anda dapat melampirkan project layanan ke organisasi lain.
    2. Project layanan tidak dapat dilampirkan ke lebih dari satu project host.
    3. Project host dapat menjadi project layanannya sendiri, tetapi tidak dapat menjadi project layanan untuk project host lainnya.
    4. Setelah Anda melampirkan project layanan ke project host, kueri project host untuk layanan atau beban kerja akan otomatis menampilkan semua layanan dan beban kerja di semua project layanan.
  6. Buat aplikasi untuk mengatur beberapa workload dan layanan. Perhatikan hal berikut:
    1. Pastikan aplikasi memiliki nama yang unik di project host dan lokasi.
    2. Project layanan dapat dilampirkan ke project host dengan beberapa aplikasi, tetapi setiap resourcenya hanya dapat didaftarkan ke satu aplikasi.
  7. Kueri layanan dan workload serta daftarkan ke aplikasi Anda. Setelah membuat aplikasi, Anda akan membuat kueri project host untuk layanan dan beban kerja yang tersedia. Kueri dijalankan terhadap project host dan semua project layanan yang ditautkan ke project host. API ini juga menampilkan semua layanan dan workload dalam project tersebut. Perhatikan hal berikut:
    1. Anda hanya dapat mendaftarkan layanan atau beban kerja ke satu aplikasi.
    2. Anda harus mendaftarkan layanan dan beban kerja dari region tertentu ke aplikasi regional di region yang sama atau ke aplikasi global. Petunjuk dan perintah yang akan diberikan mengasumsikan bahwa semua resource berada di region yang sama. Untuk mengetahui informasi tentang region yang dapat Anda tetapkan, lihat Lokasi.
    3. Layanan dan workload terdaftar tidak terpengaruh oleh update pada resource infrastruktur yang mendasarinya. Dengan kata lain, jika Anda menghapus resource pokok yang berfungsi sebagai layanan dan beban kerja, App Hub tidak akan menghapus beban kerja dan layanan terkait dari aplikasi Anda. Anda harus membatalkan pendaftaran beban kerja atau layanan secara terpisah.

Prasyarat

Sebelum Anda menyiapkan App Hub, selesaikan tugas berikut.

  1. Tentukan project yang sudah ada yang akan menjadi project host atau buat project baru untuk menjadi project host. Sebaiknya Anda membuat project baru.
  2. Pastikan Anda telah memutuskan individu mana yang memegang peran Identity and Access Management (IAM) untuk App Hub: Admin App Hub, Editor App Hub, dan Pelihat App Hub.

Perhatikan bahwa orang yang melampirkan project layanan ke project host harus memiliki peran IAM App Hub Admin di project layanan dan project host. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin App Hub.

Menyiapkan App Hub

Di bagian ini, Anda akan membuat contoh arsitektur App Hub.

Dalam contoh ini, organisasi memiliki tiga project layanan, dengan resource infrastrukturnya di-deploy dalam project sebagai berikut:

  • Project Layanan 1 memiliki dua resource infrastruktur, Layanan 1 dan Layanan 2.
  • Project Layanan 2 memiliki tiga resource infrastruktur, Service 3, Workload 1, dan Workload 2.
  • Service Project 3 memiliki tiga resource infrastruktur, Service 4, Workload 3, dan Workload 4.

Pastikan project yang Anda pilih untuk membuat contoh berisi resource yang dijelaskan di bagian ini, atau bersiaplah untuk menyesuaikan contoh saat Anda mengikuti petunjuk.

Bagian berikut berisi petunjuk untuk membuat contoh App Hub. Anda membuat project host dan menambahkan project layanan ke project host, lalu membuat aplikasi dan melampirkan layanan dan beban kerja ke aplikasi. Contoh ini memiliki tiga project layanan, tetapi Anda dapat menambahkan lebih sedikit atau lebih banyak.

Contoh ini mengasumsikan bahwa project layanan yang Anda tambahkan sudah ada dan berisi layanan dan workload yang Anda tambahkan ke aplikasi Anda. Sebelum Anda membuat contoh, tentukan project layanan mana yang berisi layanan dan beban kerja yang ingin Anda sertakan dalam aplikasi.

Mengaktifkan App Hub

Di bagian ini, Anda memilih atau membuat project host baru, mengaktifkan App Hub API, dan memberikan peran serta izin yang sesuai kepada individu di organisasi Anda. Anda juga melampirkan project layanan ke project host.

Konsol

  1. Di konsol Google Cloud , buka halaman pemilih project.

    Buka pemilih project

  2. Pilih atau buat Google Cloud project, untuk menjadi project host App Hub Anda.

  3. Enable the required API.

    Enable the API

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Pastikan Google Cloud CLI versi terbaru telah diinstal. Jalankan perintah berikut dari Cloud Shell:

    gcloud components update

  3. Buat atau pilih project baru, HOST_PROJECT_ID, untuk menjadi project host bagi App Hub.

    • Buat Google Cloud project: 
      gcloud projects create HOST_PROJECT_ID
    • Pilih project Google Cloud yang Anda buat: 
      gcloud config set project HOST_PROJECT_ID

  4. Aktifkan App Hub API di project host yang baru saja Anda buat.

    gcloud services enable apphub.googleapis.com \
    --project=HOST_PROJECT_ID

Menetapkan pengguna App Hub

Jika Anda adalah project creator, Anda diberi peran Pemilik dasar (roles/owner). Secara default, peran IAM ini mencakup izin yang diperlukan untuk akses penuh ke sebagian besar resource Google Cloud .

Jika Anda bukan project creator, izin yang diperlukan harus diberikan pada project kepada akun utama yang sesuai. Misalnya, akun utama dapat berupa Akun Google (untuk pengguna akhir) atau akun layanan (untuk aplikasi dan workload komputasi). Untuk mendapatkan izin yang Anda perlukan untuk menyelesaikan tutorial ini, minta administrator Anda untuk memberi Anda peran IAM berikut di project Anda:

Konsol

  1. Di konsol Google Cloud , buka halaman IAM.

    Buka IAM

  2. Klik Berikan akses. Panel Berikan akses akan terbuka.

  3. Di kolom New principals, masukkan alamat email individu yang akan mengelola App Hub, peran Admin App Hub di project host.

  4. Klik Pilih peran, lalu di kolom Filter, masukkan App Hub.

  5. Pilih peran Admin Hub Aplikasi, lalu klik Simpan.

  6. Di setiap project layanan App Hub, berikan peran Admin App Hub kepada pengguna yang sama.

gcloud

  1. Secara opsional, berikan peran administrator App Hub di project host kepada individu yang akan mengelola App Hub. Ulangi perintah berikut untuk setiap administrator.

    gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'

    Ganti HOST_PROJECT_ADMIN dengan pengguna yang memiliki peran Admin App Hub di project host. Nilai ini memiliki format username@yourdomain, misalnya, robert.smith@example.com.

  2. Berikan peran Admin App Hub di project layanan kepada individu yang mengelola App Hub. Mereka harus memiliki peran Admin App Hub untuk menambahkan project layanan ke project host. Anda memerlukan setidaknya satu orang dengan peran ini untuk setiap project layanan. Satu orang dapat memiliki peran di beberapa project layanan.

    gcloud projects add-iam-policy-binding SERVICE_PROJECT_1 \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'

    gcloud projects add-iam-policy-binding SERVICE_PROJECT_2 \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'

    gcloud projects add-iam-policy-binding SERVICE_PROJECT_3 \
    --member='user:HOST_PROJECT_ADMIN' \
    --role='roles/apphub.admin'

    Ganti kode berikut:

    • SERVICE_PROJECT_1: project layanan pertama dari tiga project layanan dalam contoh ini.
    • SERVICE_PROJECT_2: project layanan kedua dari tiga project layanan dalam contoh ini.
    • SERVICE_PROJECT_3: project layanan ketiga dari tiga project layanan dalam contoh ini.

Menambahkan project layanan ke project host

Tambahkan project layanan Anda dengan resource pokok yang ingin Anda kelola ke project host App Hub.

Konsol

  1. Di konsol Google Cloud , buka halaman Setelan App Hub.

    Buka Setelan

  2. Di halaman Setelan, klik Lampirkan project.

  3. Lakukan salah satu hal berikut:

    • Dari daftar project, pilih kotak centang untuk project yang ingin Anda tambahkan sebagai project layanan.
    • Telusuri project, lalu pilih project yang akan ditambahkan sebagai project layanan.

  4. Klik Pilih. Tabel Project Layanan yang Terlampir menampilkan project layanan yang dipilih.

  5. Klik Close.

gcloud

gcloud apphub service-projects add SERVICE_PROJECT_1 \
    --project=HOST_PROJECT_ID

gcloud apphub service-projects add SERVICE_PROJECT_2 \
    --project=HOST_PROJECT_ID

gcloud apphub service-projects add SERVICE_PROJECT_3 \
    --project=HOST_PROJECT_ID

Opsional: Menambahkan project layanan ke cakupan metrik project host

Anda dapat melihat metrik sistem untuk aplikasi di project host dengan menambahkan project layanan sebagai penampung resource ke cakupan metrik project host. Project host App Hub berfungsi sebagai project cakupan yang menghosting cakupan metrik. Cakupan metrik dari projectGoogle Cloud menentukan kumpulan penampung resource yang data deret waktunya dapat dibuatkan diagram dan dipantau oleh project host. Untuk mengetahui informasi selengkapnya tentang penampung resource, cakupan metrik, dan project yang dicakup, lihat Cloud Monitoring: Model data. Untuk mengetahui informasi selengkapnya tentang resource infrastruktur yang tersedia dengan dukungan metrik sistem aplikasi App Hub dan label metadata sistem, lihat resource yang didukung.

Untuk melihat metrik sistem aplikasi, Anda harus menambahkan atau menghapus project layanan yang dipantau secara manual, sesuai kebutuhan, dari project host. Namun, jika Anda menggunakan project host sebagai project layanannya sendiri, karena aplikasi App Hub berada dalam project yang sama, jangan tambahkan project ke cakupan metrik.

Pastikan Anda memiliki peran IAM berikut:

  • Untuk mendapatkan izin yang diperlukan untuk melihat metrik aplikasi App Hub, minta administrator untuk memberikan peran IAM Monitoring Viewer (roles/monitoring.viewer) pada pokok. Untuk mengetahui informasi selengkapnya, lihat Memberikan akses ke Monitoring.

  • Untuk mendapatkan izin yang diperlukan guna mengonfigurasi cakupan metrik, minta administrator untuk memberi Anda peran IAM Monitoring Admin (roles/monitoring.admin) di project pencakupan dan di setiap penampung resource yang ingin Anda tambahkan ke cakupan metrik. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

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

Konsol

  1. Di konsol Google Cloud , buka halaman  Setelan:

    Buka Setelan

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Pilih Cakupan Metrik.

    Tab Cakupan Metrik mencantumkan resource yang dipantau oleh Google Cloud project saat ini. Tabel ini juga mencantumkan Google Cloud project yang cakupan metriknya menyertakan project Google Cloud saat ini.

  3. Untuk menambahkan Google Cloud project ke cakupan metrik:

    1. Di panel Google Cloud Projects, klik Add Projects.
    2. Pada dialog Tambahkan project Google Cloud, klik Pilih Project, lalu centang kotak untuk project layanan yang ingin Anda pantau.

    3. Untuk menyimpan perubahan, klik Tambahkan Proyek.

      Halaman Setelan ditampilkan dengan tabel di halaman tersebut yang diperbarui untuk mencantumkan pilihan Anda.

Setelah Anda menambahkan project ke cakupan metrik, perlu waktu sekitar 60 detik agar perubahan diterapkan di semua sistem Monitoring.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi cakupan metrik menggunakan Google Cloud konsol, lihat Mengonfigurasi cakupan metrik.

gcloud

Untuk menambahkan project layanan Anda sebagai penampung resource yang dipantau ke project host App Hub:

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_1 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_2 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_3 \
    --project=HOST_PROJECT_ID

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi cakupan metrik menggunakan Google Cloud CLI, lihat Mengonfigurasi cakupan metrik menggunakan API.

Membuat aplikasi

Jika Anda belum memilikinya, buat aplikasi untuk menjadi penampung layanan dan workload Anda. Berdasarkan cakupan layanan dan beban kerja di project layanan, buat aplikasi global atau regional.

  • Aplikasi global memungkinkan Anda mendaftarkan layanan dan beban kerja yang ditemukan dari resource regional dan global. Google Cloud
  • Aplikasi regional memungkinkan Anda mendaftarkan layanan dan workload yang ditemukan dari resource regional Google Cloud .

Perhatikan bahwa setelah membuat aplikasi, Anda tidak dapat mengubah cakupan aplikasi. Untuk mengetahui informasi selengkapnya tentang aplikasi global dan regional, lihat Aplikasi App Hub global dan regional.

Konsol

  1. Pastikan Anda berada di project host.

  2. Di konsol Google Cloud , buka halaman Aplikasi App Hub.

    Buka Aplikasi

  3. Klik Create application.

  4. Di halaman Create application, di panel Choose application region and name, berdasarkan cakupan layanan dan beban kerja yang ingin Anda daftarkan ke aplikasi, lakukan salah satu hal berikut:

    • Untuk membuat aplikasi yang memungkinkan Anda mendaftarkan layanan dan beban kerja dari lokasi global, pilih Global.

    • Untuk membuat aplikasi yang memungkinkan Anda mendaftarkan layanan dan workload dari satu lokasi:

      1. Pilih Regional.
      2. Pilih Region.

  5. Masukkan Nama aplikasi, lalu klik Lanjutkan.

  6. Jika perlu, tambahkan detail selengkapnya untuk aplikasi di kolom berikutnya. Untuk mengetahui informasi selengkapnya, lihat Memperbarui aplikasi Hub Aplikasi yang ada dalam dokumen ini.

  7. Klik Buat.

gcloud

  1. Buat aplikasi baru bernama APPLICATION_NAME dan beri nama tampilan, APPLICATION_DISPLAY_NAME.

    gcloud apphub applications create APPLICATION_NAME \
  --scope-type=SCOPE_TYPE \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Ganti kode berikut:

    • APPLICATION_NAME: nama aplikasi Anda. Nama hanya boleh menyertakan karakter alfanumerik huruf kecil tanpa spasi.
    • SCOPE_TYPE: cakupan aplikasi Anda yang menentukan layanan dan beban kerja mana yang tersedia bagi Anda untuk mendaftar ke aplikasi. Gunakan salah satu nilai berikut:
      • REGIONAL
      • GLOBAL
    • REGION: region aplikasi. Bergantung pada --scope-type, berikan nilai us-east1 atau global.

  2. Buat daftar aplikasi di project host Anda.

    gcloud apphub applications list \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Outputnya mirip dengan hal berikut ini:

    ID                DISPLAY_NAME              CREATE_TIME
APPLICATION_NAME  APPLICATION_DISPLAY_NAME  2023-10-31T18:33:48

  3. Dapatkan detail untuk aplikasi yang Anda buat.

    gcloud apphub applications describe APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Perintah ini menampilkan informasi dalam format YAML, mirip dengan berikut ini.

    createTime: '2023-10-31T18:33:48.199394108Z'
displayName: APPLICATION_DISPLAY_NAME
name: projects/HOST_PROJECT_ID/locations/REGION/applications/APPLICATION_NAME
scope:
  type: SCOPE_TYPE
state: ACTIVE
uid: [APPLICATION_UID]
updateTime: '2023-10-31T18:33:48.343303819Z'

Memperbarui aplikasi App Hub yang ada

Anda juga dapat memperbarui atribut aplikasi setelah aplikasi dibuat.

Konsol

  1. Di konsol Google Cloud , buka halaman Aplikasi App Hub.

    Buka Aplikasi

  2. Dari daftar aplikasi, klik Edit untuk aplikasi yang ingin Anda perbarui.

  3. Edit kolom sesuai kebutuhan, lalu klik Simpan.

  4. Opsional: Di daftar Kekritisan, untuk menunjukkan pentingnya aplikasi, pilih salah satu opsi berikut:

    • Misi penting
    • Tinggi
    • Sedang
    • Rendah

  5. Opsional: Di daftar Lingkungan, untuk menunjukkan tahap siklus proses software, pilih salah satu opsi berikut:

    • Produksi
    • Staging
    • Pengembangan
    • Pengujian

  6. Opsional: Tambahkan detail berikut sesuai kebutuhan untuk Pemilik Developer, Pemilik Operator, dan Pemilik Bisnis. Perhatikan bahwa Anda harus memasukkan alamat email pemilik jika menambahkan nama tampilan.

    1. Masukkan nama tampilan pemilik.
    2. Masukkan alamat email pemilik. Nilai ini harus memiliki format username@yourdomain, misalnya, 222larabrown@gmail.com.

  7. Ulangi langkah-langkah ini untuk setiap developer, operator, dan pemilik bisnis.

  8. Klik Simpan.

gcloud

  1. Perbarui aplikasi Anda dengan atribut criticality-type, environment-type, dan jenis pemilik:

    gcloud apphub applications update APPLICATION_NAME \
  --display-name='APPLICATION_DISPLAY_NAME' \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
  --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
  --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Ganti kode berikut:

    • APPLICATION_DISPLAY_NAME: nama tampilan aplikasi Anda.
    • CRITICALITY_LEVEL: menunjukkan seberapa penting aplikasi, layanan, atau workload bagi operasi bisnis Anda. Berikan salah satu nilai berikut:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: menunjukkan tahap siklus proses software. Berikan salah satu nilai berikut:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR, dan DISPLAY-NAME-BUSINESS: nama tampilan developer, operator, dan pemilik bisnis.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR, dan EMAIL-NAME-BUSINESS: alamat email developer, operator, dan pemilik bisnis. Nilai ini harus memiliki format username@yourdomain, misalnya, 222larabrown@gmail.com.

  2. Mencantumkan aplikasi tempat atribut environment-type memiliki nilai PRODUCTION.

    gcloud apphub applications list \
    --filter='attributes.environment.type=PRODUCTION' \
    --project=HOST_PROJECT_ID \
    --location=REGION

    Outputnya mirip dengan hal berikut ini:

    ID                DISPLAY_NAME              CREATE_TIME
APPLICATION_NAME  APPLICATION_DISPLAY_NAME  2023-10-31T18:33:48

Mendaftarkan layanan dan workload

Saat Anda mendaftarkan layanan dan workload infrastruktur ke aplikasi, layanan dan workload tersebut akan didaftarkan sebagai resource App Hub. Gunakan aplikasi global untuk mendaftarkan resource yang bersifat global atau tersebar di beberapa region. Gunakan aplikasi regional untuk mendaftarkan resource dari region yang sama dengan aplikasi.

Konsol

  1. Di konsol Google Cloud , buka halaman Aplikasi App Hub.

    Buka Aplikasi

  2. Klik nama aplikasi Anda. Tab Services and workloads ditampilkan dengan daftar layanan dan workload terdaftar yang ada di project layanan Anda.

  3. Untuk setiap layanan atau workload yang ingin Anda daftarkan, lakukan hal berikut:

    1. Di tab Services and workloads, klik Register service/workload.
    2. Di halaman Register service or workload, di panel Select resource, klik Browse untuk memilih layanan atau beban kerja sebagai Resource.
    3. Di panel Pilih resource, pilih layanan atau beban kerja, lalu klik Pilih.
    4. Di panel Select resource, masukkan Name untuk layanan atau beban kerja, lalu klik Continue.
    5. Secara opsional, di panel Tambahkan atribut, tambahkan detail selengkapnya untuk layanan atau beban kerja di kolom berikutnya. Untuk mengetahui informasi selengkapnya, lihat Memperbarui aplikasi Hub Aplikasi yang ada dalam dokumen ini. Perhatikan bahwa Anda dapat memilih nilai untuk kolom Kekritisan dan Lingkungan yang berbeda dari nilai yang Anda tetapkan saat membuat aplikasi.
    6. Klik Lanjutkan.
    7. Opsional, di bagian Tambahkan pemilik, tambahkan detail selengkapnya tentang pemilik layanan atau beban kerja di kolom berikutnya. Untuk mengetahui informasi selengkapnya, dalam dokumen ini, lihat Memperbarui aplikasi Hub Aplikasi yang ada.
    8. Klik Daftar.

Tab Layanan dan beban kerja menampilkan layanan atau beban kerja yang terdaftar. Untuk mengetahui informasi selengkapnya tentang status pendaftaran, lihat properti dan atribut App Hub.

gcloud

  1. Tambahkan individu dengan izin Editor App Hub.

    gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
  --member='user:APP_HUB_EDITOR' \
  --role='roles/apphub.editor'

    Ganti APP_HUB_EDITOR dengan pengguna yang memiliki peran Editor App Hub di project host. Nilai ini memiliki format username@yourdomain, misalnya, robert.smith@example.com.

  2. Mencantumkan beban kerja yang ditemukan dari project layanan 2, yang dilampirkan ke project host. Perintah ini menampilkan beban kerja yang tersedia untuk didaftarkan ke aplikasi.

    gcloud apphub discovered-workloads list \
  --filter='workload_properties.gcp_project=projects/SERVICE_PROJECT_2' \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Outputnya mirip dengan berikut ini, yang mencakup MIG yang tidak terdaftar:

    ID                           WORKLOAD_REFERENCE                                                                                                      WORKLOAD_PROPERTIES
[DISCOVERED_WORKLOAD_ID_1]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
[DISCOVERED_WORKLOAD_ID_2]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}     {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}

    Salin ID beban kerja dari output untuk digunakan di langkah berikutnya.

  3. Daftarkan beban kerja dari langkah sebelumnya ke aplikasi Anda.

    gcloud apphub applications workloads create WORKLOAD_NAME \
  --discovered-workload='projects/HOST_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID_2' \
  --display-name='mywebserver-deployment1' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Ganti kode berikut:

    • WORKLOAD_NAME: nama untuk mendaftarkan workload.
    • DISCOVERED_WORKLOAD_ID_2: ID workload dari output langkah sebelumnya.

  4. Ulangi dua langkah sebelumnya untuk memfilter dan mendaftarkan beban kerja yang Anda inginkan dari Project Layanan 3.

  5. Opsional: Anda dapat memperbarui beban kerja dengan atribut criticality-type, environment-type, dan pemilik.

    gcloud apphub applications workloads update WORKLOAD_NAME \
  --application=APPLICATION_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
  --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
  --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Perhatikan bahwa Anda harus memberikan salah satu nilai yang ditentukan untuk criticality-type dan environment-type, tetapi nilainya dapat berbeda dari nilai yang Anda tetapkan saat membuat aplikasi.

  6. Mencantumkan workload terdaftar di aplikasi.

    gcloud apphub applications workloads list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Outputnya mirip dengan hal berikut ini:

    ID                DISPLAY_NAME                 WORKLOAD_REFERENCE                                                                                                    CREATE_TIME
WORKLOAD_NAME     mywebserver-deployment1      {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}   2023-10-31T18:34:23

    Workload yang terdaftar, tetapi tidak terlampir ditandai dengan nilai kosong di kolom WORKLOAD_REFERENCE. Untuk mengetahui informasi selengkapnya tentang status pendaftaran, lihat properti dan atribut App Hub.

  7. Mencantumkan layanan yang ditemukan dengan aturan penerusan di Project Layanan 1 yang dilampirkan ke project host. Perintah ini menampilkan layanan yang tersedia untuk didaftarkan ke aplikasi.

    gcloud apphub discovered-services list \
  --filter='service_properties.gcp_project=projects/SERVICE_PROJECT_1 AND service_reference.uri~"forwardingRules"' \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Outputnya mirip dengan hal berikut ini:

    ID                           SERVICE_REFERENCE                                                                                                                    SERVICE_PROPERTIES
[DISCOVERED_SERVICE_ID_1]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
[DISCOVERED_SERVICE_ID_2]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}     {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}

    Salin ID layanan, DISCOVERED_SERVICE_ID_2 dari output untuk digunakan di langkah berikutnya.

  8. Daftarkan aturan penerusan, testing-forwarding-rule-2 di project layanan 1 sebagai layanan.

    gcloud apphub applications services create SERVICE_NAME \
  --discovered-service='projects/HOST_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE_ID_2' \
  --display-name='mywebserver-service1' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Ganti kode berikut:

    • SERVICE_NAME: nama untuk mendaftarkan layanan.
    • DISCOVERED_SERVICE_ID_2: ID layanan dari output langkah sebelumnya.

  9. Ulangi langkah-langkah sebelumnya yang mencantumkan layanan, memfilter layanan tersebut, dan mendaftarkan layanan di project layanan 1, 2, dan 3.

  10. Perbarui layanan dengan atribut criticality-type dan atribut environment-type.

    gcloud apphub applications services update SERVICE_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID  \
  --location=REGION

  11. Mencantumkan layanan terdaftar di aplikasi APPLICATION_NAME dan project host HOST_PROJECT_ID.

    gcloud apphub applications services list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Outputnya mirip dengan berikut ini untuk setiap layanan:

    ID                DISPLAY_NAME                 SERVICE_REFERENCE                                                                                                                  CREATE_TIME
SERVICE_NAME      mywebserver-service1         {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}   2023-11-01T21:38:08

    Terdaftar, tetapi layanan yang dilepas ditandai dengan nilai kosong di kolom SERVICE_REFERENCE.

  12. Filter layanan di aplikasi APPLICATION_NAME dan project host HOST_PROJECT_ID ke layanan yang memiliki atribut environment-type yang disetel ke PRODUCTION.

    gcloud apphub applications services list \
  --filter='attributes.environment.type=PRODUCTION' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

Proses penyiapan App Hub selesai.

Menambahkan atau menghapus project layanan

Anda dapat mengubah lampiran project layanan untuk menyediakan berbagai resource infrastruktur yang akan dikelompokkan ke dalam aplikasi.

Untuk melihat metrik sistem aplikasi di project host Anda, setelah menambahkan project layanan ke project host, tambahkan project layanan sebagai penampung resource ke cakupan metrik project host. Untuk mengetahui informasi selengkapnya, lihat Menambahkan project layanan ke cakupan metrik project host dalam dokumen ini. Saat Anda menghapus project layanan dari project host, pertimbangkan untuk menghapus project layanan sebagai penampung resource dari cakupan metrik project host (jika sebelumnya Anda memilih untuk melihat metrik sistem aplikasi di project host). Untuk mengetahui informasi selengkapnya, dalam dokumen ini, lihat langkah-langkah untuk menghapus project layanan dari cakupan metrik project host.

Konsol

Untuk menambahkan project layanan ke project host:

  1. Di konsol Google Cloud , buka halaman Setelan App Hub.

    Buka Setelan

  2. Di halaman Setelan, klik Lampirkan project.

  3. Di panel yang terbuka, telusuri project dari daftar yang ditampilkan dan pilih kotak centang untuk project yang ingin Anda tambahkan sebagai project layanan.

  4. Klik Pilih. Tabel Project Layanan yang Dilampirkan menampilkan project yang dipilih sebagai project layanan untuk project host.

  5. Klik Close.

Untuk menghapus project layanan dari project host:

  1. Di konsol Google Cloud , buka halaman Setelan App Hub.

    Buka Setelan

  2. Di halaman Settings, centang kotak untuk project yang ingin Anda hapus sebagai project layanan.

  3. Klik Lepaskan project. Tabel Project Layanan yang Terlampir diperbarui untuk menampilkan hanya project yang tetap dilampirkan ke project host.

gcloud

Untuk menambahkan project layanan ke project host:

gcloud apphub service-projects add SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID
Ganti SERVICE_PROJECT_ID dengan nama project layanan yang ingin Anda tambahkan ke project host.
Untuk menghapus project layanan dari project host: 
gcloud apphub service-projects remove SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Melihat aplikasi, layanan, dan beban kerja yang ada

Anda dapat melihat aplikasi dalam project, dan mencantumkan layanan dan workload dalam aplikasi.

Konsol

  • Untuk melihat aplikasi dalam project:

    1. Di konsol Google Cloud , buka halaman App Hub Applications.

      Buka Aplikasi

    2. Opsional: Untuk memfilter aplikasi:

      1. Di kolom Filter, pilih filter seperti Kekritisan.
      2. Pilih Tinggi sebagai nilai.
        Daftar aplikasi dengan tingkat kekritisan tinggi yang dibuat di project host akan muncul.

  • Untuk mencantumkan layanan dan workload:

    Aplikasi

    1. Di konsol Google Cloud , buka halaman Aplikasi App Hub.

      Buka Aplikasi

    2. Klik nama aplikasi. Halaman dengan daftar layanan dan beban kerja yang terdaftar ke aplikasi Anda akan muncul.

    3. Opsional: Untuk memfilter layanan atau beban kerja:

      1. Di kolom Filter, pilih filter seperti Kekritisan.
      2. Pilih Tinggi sebagai nilai.
        Daftar layanan dan workload dengan tingkat kekritisan tinggi yang terdaftar ke aplikasi akan muncul.

    Layanan dan Workload

    1. Di konsol Google Cloud , buka halaman App Hub Services and Workloads.

      Buka Services and Workloads

    2. Di daftar Region, pilih region tempat Anda ingin melihat layanan dan workload. Misalnya, pilih us-east1.
      Halaman Services and Workloads menampilkan semua layanan dan workload dari project layanan terlampir yang terkait dengan us-east1.

    3. Opsional: Untuk memfilter layanan atau beban kerja:

      1. Di kolom Filter, pilih filter seperti Environment.
      2. Pilih Production sebagai nilai.
        Daftar layanan dan beban kerja di lingkungan produksi yang terdaftar ke aplikasi akan muncul.

gcloud

  • Untuk melihat aplikasi dalam project:

    gcloud apphub applications list \
  --project=HOST_PROJECT_ID \
  --location=REGION

  • Untuk mencantumkan layanan terdaftar dalam aplikasi:

    gcloud apphub applications services list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

  • Untuk mencantumkan workload terdaftar dalam aplikasi:

    gcloud apphub applications workloads list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

  • Opsional: Untuk memfilter resource berdasarkan atribut variabel, tambahkan flag perintah filter ke perintah sebelumnya. Misalnya, untuk mencantumkan semua workload terdaftar dengan atribut criticality-type yang ditetapkan ke HIGH:

    gcloud apphub applications workloads list \
  --application=APPLICATION_NAME \
  --filter='attributes.criticality.type=HIGH' \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Untuk mengetahui informasi selengkapnya tentang atribut yang dapat Anda gunakan untuk memfilter, lihat Memperbarui aplikasi App Hub yang sudah ada di halaman ini.

Opsional: Melihat metrik aplikasi

Anda dapat melihat metrik sistem untuk aplikasi yang dibuat di project host App Hub. Metrik ini sesuai dengan sinyal keemasan—traffic, error, latensi, dan saturasi—yang membantu memantau performa dan kondisi aplikasi.

  1. Di konsol Google Cloud , buka halaman Aplikasi App Hub.

    Buka Aplikasi

  2. Klik nama aplikasi.

    Tab Services and workloads ditampilkan dengan metadata layanan dan beban kerja yang terdaftar ke aplikasi Anda.

  3. Opsional: Untuk mengubah jangka waktu tampilan metrik, gunakan pemilih rentang waktu. Rentang waktu default adalah 1 jam.

  4. Untuk melihat metrik sistem layanan dan workload terdaftar, klik bar_chart Metrik.

    Tabel akan ditampilkan dengan sinyal keemasan berikut:

    • Traffic: Tingkat permintaan masuk pada resource selama jangka waktu yang dipilih.
    • Tingkat error server: Persentase rata-rata permintaan masuk yang menghasilkan kode error HTTP seri 5xx selama periode waktu yang dipilih.
    • Latensi P95: Persentil ke-95 latensi untuk permintaan layanan yang digabungkan selama periode waktu yang dipilih, dalam milidetik.
    • Penggunaan CPU: Persentase rata-rata penggunaan CPU untuk beban kerja, yang diagregasi selama jangka waktu yang ditentukan. Nilai biasanya berupa angka antara 0,0 dan 100,0, tetapi dapat melebihi 100,0.
    • Penggunaan memori: Rata-rata persentase penggunaan memori untuk workload, yang diagregasi selama jangka waktu yang ditentukan.

Opsional: Jelajahi metrik menggunakan diagram

Untuk membuat diagram metrik untuk project App Hub, gunakan Metrics Explorer. Anda dapat membatasi data yang di-diagram dengan menerapkan filter, yang didasarkan pada label. Untuk informasi selengkapnya, lihat Membuat diagram dengan Metrics Explorer.

Label metadata sistem App Hub berikut tersedia untuk Anda filter (Pratinjau):

  • apphub_application_host_project_id
  • apphub_application_id
  • apphub_application_location
  • apphub_workload_criticality_type
  • apphub_workload_environment_type
  • apphub_workload_id

Untuk memvisualisasikan label metadata App Hub pada diagram, ikuti petunjuk ini. Anda dapat mengikuti prosedur yang sama untuk label metadata sistem lainnya dan metrik App Hub.

  1. Di konsol Google Cloud , buka halaman  Metrics explorer:

    Buka Metrics explorer

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
  3. Pada elemen Metrik, luaskan menu Pilih metrik, masukkan VM Instance di panel filter, lalu gunakan submenu untuk memilih jenis dan metrik resource tertentu:
    1. Di menu Active resources, pilih VM Instance.
    2. Di menu Active metric categories, pilih Popular metrics.
    3. Di menu Active metrics, pilih CPU utilization.
    4. Klik Terapkan.
    Nama yang sepenuhnya memenuhi syarat untuk metrik ini adalah compute.googleapis.com/instance/cpu/utilization.
  4. Konfigurasi cara data dilihat. Untuk menampilkan hanya metrik untuk label tertentu, ikuti langkah-langkah berikut:
    1. Di elemen Filter, klik Tambahkan filter, lalu pilih apphub_application_id. Untuk nilai, masukkan nama App Hub tertentu.
    2. Di entri Aggregation, tetapkan menu pertama ke Unaggregated.

    Untuk informasi selengkapnya tentang cara mengonfigurasi diagram, lihat Memilih metrik saat menggunakan Metrics Explorer.

Pembersihan

Bersihkan aplikasi yang ada dan hapus lampiran project layanan dari project host untuk menghapus resource yang terkait dengan project. Tindakan ini akan menghentikan penemuan resource otomatis di project layanan.

Untuk melakukannya, Anda harus menghapus beban kerja dan layanan yang terdaftar ke aplikasi terlebih dahulu.

Konsol

  1. Di konsol Google Cloud , buka halaman App Hub Applications.

    Buka Aplikasi

  2. Klik nama aplikasi. Daftar layanan dan beban kerja yang terdaftar ke aplikasi akan muncul.

  3. Membatalkan pendaftaran layanan atau workload.

    1. Di tab Layanan dan beban kerja, dari bagian Layanan dan beban kerja terdaftar, klik nama layanan atau beban kerja yang ingin Anda batalkan pendaftarannya.
    2. Di tab Detail, klik Batalkan pendaftaran untuk memperbarui layanan atau beban kerja sebagai resource Ditemukan.
      Di tab Layanan dan beban kerja, pemberitahuan akan muncul bahwa beban kerja tidak terdaftar.
    3. Ulangi petunjuk ini untuk setiap layanan dan workload.

  4. Buka halaman Aplikasi di Hub Aplikasi.

    Buka Aplikasi

  5. Klik nama aplikasi.

  6. Di halaman dengan detail aplikasi, klik Hapus.

  7. Untuk menghapus project layanan dari project host Anda, lihat bagian Menambahkan atau menghapus project layanan dalam dokumen ini.

  8. Untuk menghapus project layanan dari cakupan metrik project host:

    1. Di konsol Google Cloud , buka halaman  Setelan:

      Buka Setelan

      Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

    2. Pilih Cakupan Metrik.
    3. Di panel Project Google Cloud, klik Hapus project, lalu selesaikan dialog konfirmasi.

gcloud

  1. Mencantumkan workload terdaftar di aplikasi:

    gcloud apphub applications workloads list \
  --application=APPLICATION_NAME --project=HOST_PROJECT_ID \
  --location=REGION

  2. Membatalkan pendaftaran workload dari aplikasi:

    gcloud apphub applications workloads delete WORKLOAD_NAME \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Workload kini menjadi workload yang ditemukan dan dapat didaftarkan ke aplikasi.

  3. Ulangi perintah sebelumnya untuk menghapus beban kerja terdaftar yang tersisa dari aplikasi.

  4. Mencantumkan layanan terdaftar di aplikasi:

    gcloud apphub applications services list \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

  5. Batalkan pendaftaran layanan dari aplikasi:

    gcloud apphub applications services delete SERVICE_NAME \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Layanan ini sekarang menjadi layanan yang ditemukan dan dapat didaftarkan ke aplikasi.

  6. Ulangi perintah sebelumnya untuk membatalkan pendaftaran layanan terdaftar yang tersisa dari aplikasi.

  7. Hapus aplikasi:

    gcloud apphub applications delete APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

  8. Menghapus project layanan dari project host:

    gcloud apphub service-projects remove SERVICE_PROJECT_ID \
  --project=HOST_PROJECT_ID

  9. Ulangi perintah sebelumnya untuk menghapus semua project layanan dari project host.

  10. Hapus project layanan dari cakupan metrik project host (Pratinjau):

    gcloud beta monitoring metrics-scopes delete projects/SERVICE_PROJECT_ID \
  --project=HOST_PROJECT_ID

  11. Ulangi perintah sebelumnya untuk menghapus semua project layanan dari project host cakupan metrik.

Langkah berikutnya