Menyiapkan Pusat Aplikasi

Dokumen ini memberikan petunjuk untuk menyiapkan Pusat Aplikasi guna 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 Pusat Aplikasi baru atau menggunakan project yang ada sebagai project host Anda.
    • Jika Anda berencana untuk memiliki lebih dari satu project host, sebaiknya buat project host di folder yang sama.
    • Project host di App Hub tidak sama dengan project host VPC Bersama dan tidak memiliki persyaratan yang sama. Misalnya, Anda tidak memerlukan jaringan VPC Bersama untuk menggunakan Pusat Aplikasi. Dalam dokumen ini, semua referensi untuk project host adalah project host Pusat Aplikasi.
    • Project host tidak boleh berupa project layanan selain project itu sendiri.
  2. Aktifkan App Hub API di project host.
  3. Tambahkan satu atau beberapa project layanan Pusat Aplikasi ke project host.
    • Project layanan di App Hub tidak sama dengan project layanan VPC Bersama dan tidak memiliki persyaratan yang sama. Dalam dokumen ini, semua referensi untuk project layanan ditujukan untuk project layanan App Hub.
  4. Tetapkan pengguna Pusat Aplikasi sebagai Admin Pusat Aplikasi, Editor Pusat Aplikasi, atau Pelihat Pusat Aplikasi.
  5. Membuat aplikasi.
  6. Mendaftarkan layanan dan beban kerja ke aplikasi.

Layanan dan workload

Dengan Pusat Aplikasi, resource dari project layanan yang terpasang ke project host tersedia untuk Anda sebagai layanan dan beban kerja. Dengan mendaftarkan layanan dan beban kerja ke aplikasi, Anda dapat mengamati dan memantau resource. Anda dapat menetapkan resource berikut sebagai layanan Pusat Aplikasi dan mendaftarkannya ke aplikasi Pusat Aplikasi:

  • Aturan penerusan
  • Peta URL
  • Layanan backend

Anda dapat menetapkan grup instance terkelola (MIG), tetapi tidak untuk setiap VM, sebagai beban kerja dan mendaftarkannya ke aplikasi Pusat Aplikasi.

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

Workload 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 wilayah yang dapat Anda tetapkan, lihat Lokasi.

Keseluruhan proses penyiapan

Daftar berikut merangkum langkah-langkah untuk menyiapkan Pusat Aplikasi:

  1. Menentukan resource yang sudah ada yang akan disertakan dalam aplikasi Anda dan project mana yang mencakupnya.
  2. Buat project host App Hub dan aktifkan App Hub API di project. Atau, buat lebih dari satu project host berdasarkan struktur organisasi bisnis Anda. Jika Anda membuat beberapa project, sebaiknya buat project tersebut di folder baru.
  3. Melampirkan project layanan. Setelah mengonfigurasi project host, tambahkan project layanan dengan resource pokok yang diperlukan 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 melepas lampiran project layanan ke project host. Kemudian, Anda dapat menambahkan project layanan ke organisasi yang berbeda.
    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, kueri project host untuk layanan atau beban kerja akan otomatis menampilkan semua layanan dan beban kerja di semua project layanan tersebut.
  4. Buat aplikasi untuk mengatur beberapa workload dan layanan. Perhatikan hal berikut:
    1. Pastikan aplikasi memiliki nama yang unik dalam project dan lokasi host.
    2. Project layanan dapat dilampirkan ke project host dengan beberapa aplikasi, tetapi setiap resource-nya hanya dapat didaftarkan ke satu aplikasi.
  5. Buat kueri untuk layanan dan beban kerja serta daftarkan layanan dan aplikasi Anda. Setelah membuat aplikasi, Anda akan mengkueri project host untuk layanan dan workload yang tersedia. Kueri dijalankan terhadap project host dan semua project layanan yang terpasang ke project host tersebut. Objek 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. Workload dan layanan apa pun yang Anda daftarkan harus berada di region yang sama dengan aplikasi.
    3. Layanan dan beban kerja terdaftar tidak terpengaruh oleh update pada resource infrastruktur dasar. 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 berikut.

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

Perhatikan hal-hal berikut:

  • Project host dapat memiliki satu atau beberapa project layanan terlampir.
  • Project layanan tidak dapat dilampirkan ke lebih dari satu project host.
  • Orang yang menambahkan project layanan ke project host harus memiliki peran IAM Admin Hub Aplikasi 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.

Misalnya, sebuah organisasi memiliki tiga project layanan, dengan resource infrastruktur yang di-deploy dalam project sebagai berikut:

  • Project Layanan 1 memiliki dua sumber daya 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 referensi yang dijelaskan di bagian ini, atau bersiaplah untuk menyesuaikan contoh tersebut saat Anda mengikuti petunjuk.

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

Contoh ini mengasumsikan bahwa project layanan yang Anda tambahkan sudah ada dan project tersebut berisi layanan dan workload yang Anda tambahkan ke aplikasi. 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 Pusat Aplikasi 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 mencakup izin yang diperlukan untuk mendapatkan akses penuh ke sebagian besar resource Google Cloud.

    Jika Anda bukan pembuat project, izin yang diperlukan harus diberikan pada project ke 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, minta administrator untuk memberi Anda peran IAM berikut di 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, yaitu 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 Pusat Aplikasi.

    Buka Settings

  6. Di halaman Settings, klik Attach projects.

  7. Lakukan salah satu hal berikut:

    • Dari daftar project, centang kotak 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 Google Cloud CLI versi terbaru sudah diinstal. Jalankan perintah berikut dari Cloud Shell:

    gcloud components update

  3. Buat atau pilih project baru, HOST_PROJECT_ID, untuk menjadi project host untuk 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 mencakup izin yang diperlukan untuk mendapatkan akses penuh ke sebagian besar resource Google Cloud.

    Jika Anda bukan pembuat project, izin yang diperlukan harus diberikan pada project ke 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, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

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

    2. Berikan peran App Hub Admin dalam project layanan kepada individu yang mengelola App Hub. Mereka harus memiliki peran Admin Pusat Aplikasi untuk menambahkan project layanan ke project host. Anda memerlukan setidaknya 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: yang pertama dari tiga project layanan dalam contoh ini.
      • SERVICE_PROJECT_2: yang 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 agar menjadi container untuk layanan dan workload Anda.

Konsol

  1. Pastikan Anda berada di project host.

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

    Buka Aplikasi

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

  4. Pilih Region.

  5. Masukkan Application name lalu klik Continue.

  6. Di bagian Tambahkan atribut, masukkan Nama tampilan.

  7. Anda juga dapat menambahkan detail lainnya untuk aplikasi di kolom berikutnya. Untuk informasi selengkapnya, dalam dokumen ini, lihat Mengupdate aplikasi Pusat Aplikasi yang ada.

  8. Klik Create.

gcloud

  1. Buat aplikasi baru bernama APPLICATION_NAME dan 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 beban kerja 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 harus menyertakan karakter alfanumerik huruf kecil tanpa spasi.
    • APPLICATION_DISPLAY_NAME: nama tampilan aplikasi Anda.
    • REGION: region aplikasi. Berikan 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. Dapatkan 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'

Memperbarui aplikasi Pusat Aplikasi yang ada

Anda juga dapat memperbarui atribut aplikasi setelah aplikasi dibuat.

Konsol

  1. Di konsol Google Cloud, buka halaman Applications 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 hal berikut:

    • Misi penting
    • Tinggi
    • Sedang
    • Rendah

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

    • Produksi
    • Staging
    • Pengembangan
    • Pengujian

  6. Opsional: Tambahkan detail berikut seperti yang diwajibkan 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, robert.smith@example.com.

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

  8. Klik Save.

gcloud

  1. Update aplikasi Anda dengan atribut criticality-type, environment-type, dan jenis 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 tahap siklus proses software. Berikan salah satu nilai berikut:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR, dan DISPLAY-NAME-BUSINESS: masing-masing 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 robert.smith@example.com.

  2. Buat daftar aplikasi yang atribut environment-type-nya 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 beban kerja ke aplikasi, layanan dan beban kerja akan terdaftar sebagai resource App Hub. Jika Anda menggunakan placeholder untuk membuat aplikasi dengan gcloud CLI, layanan dan beban kerja dalam ketiga project layanan tersebut adalah sebagai berikut:

  • Project Layanan 1 memiliki dua sumber daya 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 App Hub.

    Buka Aplikasi

  2. Klik nama aplikasi Anda. Tab Layanan dan beban kerja ditampilkan dengan daftar layanan dan beban kerja terdaftar yang ada dalam project layanan Anda.

  3. Untuk setiap layanan atau beban kerja yang ingin Anda daftarkan, lakukan hal 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 dan klik Continue.
    3. Di bagian Add attributes, masukkan Name untuk layanan atau beban kerja.
    4. Atau, tambahkan detail lainnya untuk layanan atau beban kerja di kolom berikutnya. Untuk informasi selengkapnya, dalam dokumen ini, lihat Mengupdate aplikasi Pusat Aplikasi yang ada. Perhatikan bahwa Anda harus memberikan salah satu nilai yang ditentukan untuk kolom Kekritisan dan Lingkungan, tetapi nilainya dapat berbeda dari nilai yang ditetapkan saat Anda membuat aplikasi.
    5. Klik Daftar.
    6. Muat ulang halaman untuk melihat Status pendaftaran layanan atau beban kerja yang diperbarui menjadi Terdaftar. Untuk mengetahui informasi selengkapnya tentang status pendaftaran, lihat properti dan atribut Pusat Aplikasi.

gcloud

  1. Tambahkan individu dengan 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 di project host. Nilai ini memiliki format username@yourdomain, misalnya, robert.smith@example.com.

  2. Membuat daftar workload 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

    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 pada 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 beban kerja.
    • DISCOVERED_WORKLOAD_ID_2: ID beban kerja 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 mengupdate 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 beban kerja 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 terlepas dilambangkan dengan nilai kosong di kolom WORKLOAD_REFERENCE. Untuk mengetahui informasi selengkapnya tentang status pendaftaran, lihat properti dan atribut Pusat Aplikasi.

  7. Membuat daftar layanan yang ditemukan dengan aturan penerusan pada 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 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 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: 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, ditandai dengan nilai kosong di kolom SERVICE_REFERENCE.

  12. Filter layanan dalam aplikasi APPLICATION_NAME dan project host HOST_PROJECT_ID menjadi aplikasi dengan atribut environment-type yang 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 mengubah lampiran project layanan agar resource infrastruktur berbeda tersedia untuk dikelompokkan ke dalam aplikasi.

Konsol

Untuk menambahkan project layanan ke project host:

  1. Di konsol Google Cloud, buka halaman Settings Pusat Aplikasi.

    Buka Settings

  2. Di halaman Settings, klik Attach projects.

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

  4. Klik Select. Tabel Attached Service Project(s) 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 Pusat Aplikasi.

    Buka Settings

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

  3. Klik Lepaskan project. Tabel Attached Service Project(s) akan diperbarui untuk hanya menampilkan project yang tetap terpasang pada 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 sebuah project, serta membuat daftar layanan dan beban kerja dalam sebuah aplikasi.

Konsol

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

    Buka Aplikasi

  • Untuk mencantumkan layanan dan workload:

    Aplikasi

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

      Buka Aplikasi

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

    3. Opsional: Untuk memfilter layanan atau beban kerja:

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

    Layanan dan Beban Kerja

    1. Di Konsol Google Cloud, buka halaman Layanan dan Beban Kerja di Pusat Aplikasi.

      Buka Services and Workloads

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

    3. Opsional: Untuk memfilter layanan atau beban kerja:

      1. Di kolom Filter, pilih filter seperti Lingkungan.
      2. Pilih Produksi sebagai nilai.
        Daftar layanan dan beban kerja 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 beban kerja 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 menghapus workload dan layanan yang terdaftar ke aplikasi terlebih dahulu.

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 workspace, klik nama layanan atau beban kerja yang ingin Anda batalkan pendaftarannya.
    2. Di halaman yang terbuka untuk layanan atau beban kerja terdaftar, klik Batalkan pendaftaran untuk memperbarui layanan atau beban kerja sebagai resource Ditemukan.
      Pada tab Layanan dan beban kerja, akan ada pemberitahuan bahwa beban kerja dibatalkan pendaftarannya.
    3. Ulangi petunjuk ini untuk setiap layanan dan beban kerja.

  4. Buka halaman Applications App Hub.

    Buka Aplikasi

  5. Klik nama aplikasi.

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

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

gcloud

  1. Buat daftar beban kerja 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

    Sekarang, workload menjadi beban kerja yang ditemukan dan dapat didaftarkan ke aplikasi.

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

  4. Tampilkan daftar layanan terdaftar dalam 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 tersebut 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. 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