Menyiapkan Pusat Aplikasi

Dokumen ini memberikan petunjuk cara menyiapkan Pusat Aplikasi untuk membangun, mengoperasikan, dan mengelola aplikasi di Google Cloud. Ini ditujukan bagi orang yang menyiapkan dan mengelola Pusat Aplikasi.

Jika Anda menyiapkan App Hub, tugas utamanya adalah sebagai berikut:

  1. Tentukan apakah akan membuat project host App Hub baru atau menggunakan project yang ada sebagai project host.
    • Jika Anda berencana memiliki lebih dari satu project host, sebaiknya buat project tersebut di folder yang sama.
    • Project host di Pusat Aplikasi tidak sama dengan project host VPC Bersama dan tidak memiliki persyaratan yang sama. Misalnya, Anda tidak memerlukan Jaringan VPC Bersama untuk menggunakan App Hub. Dalam dokumen ini, semua referensi untuk project host adalah ke project host App Hub.
    • Project host tidak boleh berupa project layanan selain untuk dirinya sendiri.
  2. Aktifkan App Hub API di project host.
  3. Tambahkan satu atau beberapa project layanan Pusat Aplikasi ke project host.
    • Project layanan di Pusat Aplikasi tidak sama dengan project layanan VPC Bersama dan tidak memiliki persyaratan yang sama. Dalam dokumen ini, semua referensi ke project layanan adalah project layanan App Hub.
  4. Tetapkan pengguna Pusat Aplikasi sebagai Admin Pusat Aplikasi, Editor Pusat Aplikasi, atau Pelihat Pusat Aplikasi.
  5. Membuat aplikasi.
  6. Daftarkan layanan dan workload ke aplikasi.

Layanan dan workload

Dengan menggunakan Pusat Aplikasi, resource dari project layanan yang dilampirkan ke project host tersedia untuk Anda sebagai layanan dan workload. Dengan mendaftarkan layanan dan workload ke aplikasi, Anda dapat mengamati dan memantau resource. Anda dapat menetapkan resource berikut sebagai layanan App Hub dan mendaftarkannya ke aplikasi App Hub:

  • Aturan penerusan
  • Peta URL
  • Layanan backend

Anda dapat menetapkan grup instance terkelola (MIG), tetapi tidak untuk masing-masing VM, sebagai beban kerja dan mendaftarkannya ke aplikasi App Hub.

App Hub mendukung load balancer Aplikasi eksternal dan internal L7 regional dengan traffic HTTP atau HTTPS.

Beban kerja dan layanan yang Anda daftarkan harus berada di region yang sama dengan aplikasi. Oleh karena itu, petunjuk dan perintah yang mengikutinya mengasumsikan bahwa semua resource berada di region yang sama. Untuk mengetahui informasi tentang region yang dapat Anda tetapkan, lihat Lokasi.

Proses penyiapan keseluruhan

Daftar berikut meringkas langkah-langkah untuk menyiapkan Pusat Aplikasi:

  1. Tentukan resource yang ada yang akan disertakan dalam aplikasi Anda dan project mana yang mencakup resource tersebut.
  2. Buat project host App Hub dan aktifkan App Hub API dalam project. Anda juga dapat membuat lebih dari satu project host berdasarkan struktur organisasi bisnis Anda. Jika Anda membuat beberapa project, sebaiknya buat project di folder baru.
  3. Melampirkan project layanan. Setelah mengonfigurasi project host, lampirkan project layanan dengan resource pokok yang diperlukan aplikasi Anda, ke project host. Perhatikan hal berikut:
    1. Project layanan harus berada di organisasi yang sama dengan project host. Setelah memasang 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 melepas lampiran project layanan ke project host. Selanjutnya, Anda dapat memasang project layanan ke organisasi lain.
    2. Project layanan tidak dapat dilampirkan ke lebih dari satu project host.
    3. Project host dapat berupa project layanannya sendiri, tetapi tidak boleh berupa project layanan untuk project host lainnya.
    4. Setelah Anda melampirkan project layanan ke project host, pembuatan kueri project host untuk layanan atau workload akan otomatis menampilkan semua layanan dan beban kerja di semua project layanan.
  4. Buat aplikasi untuk mengatur beberapa workload dan layanan. Perhatikan hal berikut:
    1. Pastikan aplikasi tersebut memiliki nama yang unik di lokasi dan project host.
    2. Project layanan dapat dilampirkan ke project host dengan beberapa aplikasi, tetapi resource individualnya hanya dapat didaftarkan ke satu aplikasi.
  5. Buat kueri untuk layanan dan workload serta daftarkan ke aplikasi Anda. Setelah membuat aplikasi, Anda membuat kueri project host untuk layanan dan workload yang tersedia. Kueri yang dijalankan terhadap project host dan semua project layanan yang disertakan ke project host. Layanan ini juga akan menampilkan semua layanan dan workload dalam project tersebut. Perhatikan hal berikut:
    1. Anda hanya dapat mendaftarkan layanan atau beban kerja ke satu aplikasi.
    2. Setiap workload dan layanan yang Anda daftarkan harus berada di region yang sama dengan aplikasi.
    3. Layanan dan workload yang terdaftar tidak terpengaruh oleh update pada resource infrastruktur yang mendasarinya. Dengan kata lain, jika Anda menghapus resource dasar yang berfungsi sebagai layanan dan workload, App Hub tidak akan menghapus workload dan layanan terkait dari aplikasi Anda. Anda harus membatalkan pendaftaran beban kerja atau layanan secara terpisah.

Prasyarat

Sebelum menyiapkan Pusat Aplikasi, selesaikan tugas-tugas berikut.

  1. Tentukan project yang sudah ada yang merupakan project host atau buat project baru untuk menjadi project host. Sebaiknya Anda membuat project baru.
  2. Pastikan Anda telah menentukan individu yang memiliki peran Identity and Access Management (IAM) untuk Pusat Aplikasi: Admin Pusat Aplikasi, Editor Pusat Aplikasi, dan Viewer App Hub.

Perhatikan hal-hal berikut:

  • Project host dapat memiliki satu atau beberapa project layanan yang dilampirkan.
  • Project layanan tidak dapat dilampirkan ke lebih dari satu project host.
  • Orang yang melampirkan project layanan ke project host harus memiliki peran IAM Admin App Hub dalam project layanan dan project host. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin App Hub.

Menyiapkan Pusat Aplikasi

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

Dalam contoh ini, sebuah 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, yaitu Layanan 3, Workload 1, dan Workload 2.
  • Project Layanan 3 memiliki tiga resource infrastruktur, yaitu Layanan 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 Pusat Aplikasi. Anda membuat project host dan menambahkan project layanan ke project host, lalu membuat aplikasi dan melampirkan layanan serta beban kerja ke aplikasi tersebut. Contoh ini memiliki tiga project layanan, tetapi Anda dapat menambahkan lebih sedikit atau lebih banyak.

Contoh ini mengasumsikan bahwa setiap project layanan yang Anda tambahkan sudah ada dan berisi layanan serta workload yang ditambahkan ke aplikasi Anda. Sebelum 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 akan memilih atau membuat project host baru, mengaktifkan App Hub API, serta memberikan peran dan 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 project Google Cloud, untuk menjadi project host App Hub Anda.

  3. Enable the required API.

    Enable the API

  4. Jika Anda adalah pembuat project, Anda diberi peran Pemilik dasar (roles/owner). Secara default, peran Identity and Access Management (IAM) ini menyertakan izin yang diperlukan untuk akses penuh ke sebagian besar resource Google Cloud.

    Jika Anda bukan pembuat project, 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 diperlukan guna menyelesaikan tutorial ini, mintalah administrator untuk memberi Anda peran IAM berikut pada project Anda:

    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 App Hub Admin di project host.

    4. Klik Select a role dan di kolom Filter, masukkan App Hub.

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

    6. Di setiap project layanan Pusat Aplikasi, berikan peran Admin Pusat Aplikasi kepada pengguna yang sama.

  5. Di konsol Google Cloud, buka halaman Settings App Hub.

    Buka Settings

  6. Di halaman Setelan, klik Lampirkan project.

  7. 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 untuk ditambahkan sebagai project layanan.

  8. Klik Select. Tabel Attached Service Project(s) menampilkan project layanan yang dipilih.

  9. Klik Close.

gcloud

  1. Di konsol Google Cloud, aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

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

    gcloud components update

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

    • Buat project Google Cloud: 
      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

  5. Jika Anda adalah pembuat project, Anda diberi peran Pemilik dasar (roles/owner). Secara default, peran Identity and Access Management (IAM) ini menyertakan izin yang diperlukan untuk akses penuh ke sebagian besar resource Google Cloud.

    Jika Anda bukan pembuat project, 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 diperlukan guna menyelesaikan tutorial ini, mintalah administrator untuk memberi Anda peran IAM berikut pada project Anda:

    1. Secara opsional, berikan peran administrator App Hub kepada individu yang akan mengelola App Hub di project host. 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 Pusat Aplikasi dalam project host. Nilai ini memiliki format username@yourdomain, misalnya, robert.smith@example.com.

    2. Berikan peran Admin Pusat Aplikasi dalam project layanan kepada individu yang mengelola Pusat Aplikasi. Mereka harus memiliki peran Admin Pusat Aplikasi untuk menambahkan project layanan ke project host. Anda memerlukan minimal satu orang dengan peran ini untuk setiap project layanan. Satu orang dapat memiliki peran dalam 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: bagian pertama dari tiga project layanan dalam contoh ini.
      • SERVICE_PROJECT_2: bagian kedua dari tiga project layanan dalam contoh ini.
      • SERVICE_PROJECT_3: yang ketiga dari tiga project layanan dalam contoh ini.

  6. Tambahkan project layanan Anda ke project host App Hub.

    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

Membuat aplikasi

Jika Anda belum memilikinya, buat aplikasi sebagai container bagi layanan dan workload Anda.

Konsol

  1. Pastikan Anda berada dalam project host.

  2. Di konsol Google Cloud, buka halaman Applications di App Hub.

    Buka Aplikasi

  3. Klik Create application. Panel Create application akan ditampilkan.

  4. Pilih Region.

  5. Masukkan Application name dan klik Continue.

  6. Di bagian Tambahkan atribut, masukkan Nama tampilan.

  7. Secara opsional, tambahkan detail selengkapnya untuk aplikasi di kolom berikutnya. Untuk mengetahui informasi selengkapnya, dalam dokumen ini, lihat Mengupdate aplikasi Pusat Aplikasi yang ada.

  8. Klik Create.

gcloud

  1. Buat aplikasi baru bernama APPLICATION_NAME, lalu beri nama tampilan, APPLICATION_DISPLAY_NAME. Flag --scope-type menentukan layanan dan beban kerja yang dapat didaftarkan ke aplikasi. Hanya REGIONAL yang didukung, yang berarti hanya layanan dan workload dari region yang sama dengan aplikasi yang dapat didaftarkan.

    gcloud apphub applications create APPLICATION_NAME \
  --display-name='APPLICATION_DISPLAY_NAME' \
  --scope-type=REGIONAL \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Ganti kode berikut:

    • APPLICATION_NAME: nama aplikasi Anda. Nama hanya boleh berisi karakter alfanumerik huruf kecil tanpa spasi.
    • APPLICATION_DISPLAY_NAME: nama tampilan aplikasi Anda.
    • REGION: region aplikasi. Beri nilai ini us-east1.

  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: APPLICATION_NAME
DISPLAY_NAME: APPLICATION_DISPLAY_NAME
CREATE_TIME: 2023-10-31T18:33:48

  3. Mendapatkan detail untuk aplikasi yang Anda buat.

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

    Perintah tersebut 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: REGIONAL
state: ACTIVE
uid: [APPLICATION_UID]
updateTime: '2023-10-31T18:33:48.343303819Z'

Mengupdate aplikasi Pusat Aplikasi yang ada

Anda juga dapat memperbarui atribut aplikasi setelah aplikasi dibuat.

Konsol

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

    Buka Aplikasi

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

  3. Edit kolom sesuai kebutuhan, lalu klik Simpan.

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

    • Misi penting
    • Tinggi
    • Sedang
    • Rendah

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

    • Produksi
    • Tahapan
    • Pengembangan
    • Pengujian

  6. Opsional: Tambahkan detail berikut sebagaimana diwajibkan untuk Pemilik Developer, Pemilik Operator, dan Pemilik Bisnis. Perhatikan bahwa Anda harus memasukkan alamat email pemilik jika Anda 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 Save.

gcloud

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

    gcloud apphub applications update 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

    Ganti kode berikut:

    • CRITICALITY_LEVEL: menunjukkan seberapa penting aplikasi, layanan, atau beban kerja bagi operasi bisnis Anda. Berikan salah satu nilai berikut:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: menunjukkan tahapan 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. Cantumkan aplikasi yang 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: APPLICATION_NAME
DISPLAY_NAME: APPLICATION_DISPLAY_NAME
CREATE_TIME: 2023-10-31T18:33:48

Mendaftarkan layanan dan workload

Saat Anda mendaftarkan layanan infrastruktur dan workload ke aplikasi, layanan dan workload akan didaftarkan sebagai resource App Hub. Jika Anda menggunakan placeholder untuk membuat aplikasi dengan gcloud CLI, layanan dan workload di ketiga project layanan tersebut adalah sebagai berikut:

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

  • Project Layanan 3 memiliki tiga resource infrastruktur, yaitu Layanan 4, Workload 3, dan Workload 4.

Konsol

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

    Buka Aplikasi

  2. Klik nama permohonan Anda. Tab Layanan dan workload akan ditampilkan berisi daftar layanan dan workload terdaftar yang ada dalam project layanan Anda.

  3. Untuk setiap layanan atau beban kerja yang ingin Anda daftarkan, lakukan tindakan berikut:

    1. Pada tab Services and workload, klik Register service/workload.
    2. Di panel Register service or workload, di bagian Choose service or workload, pilih layanan atau workload, lalu klik Continue.
    3. Di bagian Add attributes, masukkan Name untuk layanan atau beban kerja.
    4. Secara opsional, tambahkan detail lebih lanjut untuk layanan atau workload di kolom berikutnya. Untuk mengetahui informasi selengkapnya, dalam dokumen ini, lihat Mengupdate aplikasi App Hub yang ada. Perhatikan bahwa Anda harus memberikan salah satu nilai yang ditetapkan untuk kolom Criticality dan Environment, tetapi nilainya bisa berbeda dari nilai yang ditetapkan saat membuat aplikasi.
    5. Klik Daftar. Tab Layanan dan workload menampilkan layanan atau beban kerja yang terdaftar. Untuk mengetahui informasi lebih lanjut tentang status pendaftaran, lihat properti dan atribut Pusat Aplikasi.

gcloud

  1. Menambahkan individu yang memiliki izin Editor Pusat Aplikasi.

    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 App Hub Editor dalam project host. Nilai ini memiliki format username@yourdomain, misalnya, robert.smith@example.com.

  2. Menampilkan daftar workload yang ditemukan dari project layanan 2, yang dilampirkan ke project host. Perintah ini menampilkan workload 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

    Output-nya mirip dengan berikut ini, yang mencakup MIG yang tidak terdaftar:

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

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

    Salin ID workload dari output untuk digunakan di langkah berikutnya.

  3. Daftarkan workload 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 beban kerja.
    • DISCOVERED_WORKLOAD_ID_2: ID workload dari output langkah sebelumnya.

  4. Ulangi dua langkah sebelumnya untuk memfilter dan mendaftarkan workload 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

    Perlu diperhatikan 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 yang terdaftar dalam aplikasi.

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

    Outputnya mirip dengan hal berikut ini:

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

    Workload terdaftar, tetapi terpisah dilambangkan dengan nilai kosong di kolom WORKLOAD_REFERENCE. Untuk mengetahui informasi lebih lanjut tentang status pendaftaran, lihat properti dan atribut Pusat Aplikasi.

  7. Buat daftar 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: [DISCOVERED_SERVICE_ID_1]
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}

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

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

  8. Daftarkan aturan penerusan, testing-forwarding-rule-2 dalam 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 sebelumnya yang mencantumkan layanan, memfilter layanan tersebut, dan mendaftarkan layanan dalam project layanan 1, 2, dan 3.

  10. Update 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. Cantumkan 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 serupa dengan berikut ini untuk setiap layanan:

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

    Layanan terdaftar, tetapi terpisah dilambangkan dengan nilai kosong di kolom SERVICE_REFERENCE.

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

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

Proses penyiapan Pusat Aplikasi selesai.

Menambahkan atau menghapus project layanan

Anda dapat memodifikasi lampiran project layanan agar tersedia resource infrastruktur berbeda untuk dikelompokkan ke dalam aplikasi.

Konsol

Untuk menambahkan project layanan ke project host:

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

    Buka Settings

  2. Di halaman Setelan, klik Lampirkan project.

  3. Pada panel yang terbuka, telusuri project dari daftar yang ditampilkan, lalu centang kotak untuk project yang ingin Anda tambahkan sebagai project layanan.

  4. Klik Select. Tabel Attached Service Project 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 Settings App Hub.

    Buka Settings

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

  3. Klik Lepaskan project. Tabel Melampirkan Project Layanan diperbarui untuk hanya menampilkan project yang tetap disertakan 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 workload yang ada

Anda dapat melihat aplikasi dalam project, serta membuat daftar layanan dan workload di sebuah aplikasi.

Konsol

  • Untuk melihat aplikasi dalam suatu project, di Konsol Google Cloud, buka halaman Applications App Hub.

    Buka Aplikasi

  • Untuk membuat daftar layanan dan workload:

    Aplikasi

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

      Buka Aplikasi

    2. Klik nama aplikasi. Halaman yang berisi daftar layanan dan workload yang terdaftar ke aplikasi Anda akan muncul.

    3. Opsional: Untuk memfilter layanan atau workload:

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

    Layanan dan Workload

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

      Buka Layanan dan Workloads

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

    3. Opsional: Untuk memfilter layanan atau workload:

      1. Di kolom Filter, pilih filter seperti Lingkungan.
      2. Pilih Produksi sebagai nilai.
        Daftar layanan dan workload di lingkungan produksi yang terdaftar ke aplikasi akan muncul.

gcloud

Untuk melihat aplikasi dalam sebuah project:

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

Untuk menampilkan daftar layanan terdaftar di aplikasi:

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

Untuk menampilkan daftar workload terdaftar dalam aplikasi:

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

Pembersihan

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

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

Konsol

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

    Buka Aplikasi

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

  3. Membatalkan pendaftaran layanan atau beban kerja.

    1. Pada tab Services and workload, dari bagian Registered services and workload, klik nama layanan atau workload yang ingin Anda batalkan pendaftarannya.
    2. Pada tab Details, klik Batalkan pendaftaran layanan atau Batalkan pendaftaran workload untuk memperbarui layanan atau workload sebagai resource Discovered.
      Pada tab Services and workload, pemberitahuan akan memberi tahu bahwa workload dibatalkan pendaftarannya.
    3. Ulangi petunjuk ini untuk setiap layanan dan workload.

  4. Buka halaman Aplikasi di Pusat Aplikasi.

    Buka Aplikasi

  5. Klik nama aplikasi.

  6. Di halaman yang berisi detail aplikasi, klik Delete.

  7. Dalam dokumen ini, gunakan petunjuk dalam artikel Menambahkan atau menghapus project layanan untuk menghapus project layanan dari project host Anda.

gcloud

  1. Buat daftar workload yang terdaftar dalam aplikasi:

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

  2. Batalkan pendaftaran beban kerja dari aplikasi:

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

    Beban kerja sekarang menjadi workload yang ditemukan dan dapat didaftarkan ke aplikasi.

  3. Ulangi perintah sebelumnya untuk menghapus sisa workload terdaftar dari aplikasi.

  4. Cantumkan layanan terdaftar dalam aplikasi:

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

  5. Membatalkan pendaftaran layanan dari aplikasi:

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

    Layanan kini 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. Hapus 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.

Langkah selanjutnya