Menyiapkan Pusat Aplikasi

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

Jika Anda menyiapkan Pusat Aplikasi, tugas utamanya adalah berikut ini:

  1. Tentukan apakah akan membuat project host App Hub baru atau menggunakan project yang ada sebagai project host Anda.
    • Jika Anda berencana untuk memiliki lebih dari satu project host, sebaiknya Anda membuatnya 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 App Hub. Di sini dokumen ini, semua referensi ke project host berasal dari Pusat Aplikasi project host.
    • 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 untuk project layanan adalah untuk Project layanan Pusat Aplikasi.
  4. Menetapkan pengguna Pusat Aplikasi sebagai Pusat Aplikasi Admin, Editor Pusat Aplikasi, atau Pusat Aplikasi Pelihat.
  5. Membuat aplikasi.
  6. Daftarkan layanan dan workload ke aplikasi.

Layanan dan workload

Dengan menggunakan Pusat Aplikasi, resource dari project layanan yang dilampirkan project host tersedia untuk Anda sebagai layanan dan workload. Mendaftarkan layanan dan beban kerja Anda ke aplikasi memungkinkan Anda untuk mengamati dan memantau resource tersebut. 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 dapat menetapkan VM individual, workload dan mendaftarkannya ke aplikasi Pusat Aplikasi.

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

Workload dan layanan yang Anda daftarkan harus berada di region yang sama dengan permohonan; maka instruksi dan perintah yang mengikutinya menganggap bahwa semua resource berada di region yang sama. Untuk informasi tentang wilayah mana Anda dapat tentukan, lihat Lokasi.

Proses penyiapan keseluruhan

Daftar berikut meringkas langkah-langkah untuk menyiapkan Pusat Aplikasi:

  1. Tentukan sumber daya yang ada yang akan disertakan dalam aplikasi dan project mana yang mencakupnya.
  2. Buat project host App Hub dan aktifkan App Hub API dalam project. Secara opsional, berdasarkan struktur organisasi bisnis, membuat lebih dari satu project {i>host<i}. 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 dibutuhkan aplikasi Anda, atau project host. Perhatikan hal berikut:
    1. Project layanan harus berada di organisasi yang sama sebagai project host. Setelah Anda memasang project layanan ke host project lain, Anda tidak dapat memindahkannya ke organisasi lain. Untuk memindahkan ke organisasi lain, Anda harus mengikuti petunjuk dalam dokumen ini untuk hapus atau lepaskan lampiran project layanan ke project host. Kemudian, Anda dapat melampirkan proyek 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 untuk project host lainnya.
    4. Setelah Anda melampirkan project layanan ke project host, membuat kueri host untuk layanan atau workload secara otomatis mengembalikan semua layanan dan workload di semua project layanan.
  4. Buat aplikasi untuk mengatur beberapa workload dan layanan. Catatan hal berikut:
    1. Pastikan aplikasi memiliki nama yang unik dalam project host dan lokasi.
    2. Project layanan dapat dilampirkan ke project host dengan beberapa aplikasi, tetapi setiap sumber daya hanya dapat didaftarkan ke satu aplikasi.
  5. Buat kueri untuk layanan dan workload serta daftarkan ke aplikasi Anda. Setelah membuat aplikasi, Anda mengkueri project host untuk mengetahui layanan IT dan workload. Kueri yang dijalankan terhadap proyek {i>host<i} dan semua project layanan yang dilampirkan ke project host. Properti tersebut juga menampilkan semua layanan IT 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 sebagai aplikasi.
    3. Layanan dan workload yang terdaftar tidak terpengaruh oleh update resource infrastruktur yang mendasarinya. Dengan kata lain, jika Anda menghapus resource dasar yang berfungsi sebagai layanan dan workload, App Hub tidak menghapus workload terkait dan layanan Google dari aplikasi Anda. Anda harus membatalkan pendaftaran secara terpisah workload atau layanan tertentu.

Prasyarat

Sebelum menyiapkan Pusat Aplikasi, selesaikan tugas-tugas berikut.

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

Perhatikan 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 di kedua layanan project dan project host. Untuk informasi selengkapnya, lihat Peran dan izin App Hub.

Menyiapkan Pusat Aplikasi

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

Dalam contoh, sebuah organisasi memiliki tiga project layanan, dengan resource infrastruktur yang 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, Layanan 3, Workload 1, dan Workload 2.
  • Project Layanan 3 memiliki tiga resource infrastruktur, yaitu Service 4, Workload 3, dan Workload 4.

Pastikan proyek yang Anda pilih untuk membuat contoh berisi referensi yang dijelaskan dalam bagian ini, atau bersiaplah untuk Anda mengikuti petunjuk yang ada.

Bagian berikut berisi petunjuk untuk membuat Contoh Pusat Aplikasi. Anda membuat project host dan menambahkan layanan project ke project host, lalu membuat aplikasi dan memasang layanan serta workload 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 project tersebut berisi layanan dan beban kerja yang Anda tambahkan ke aplikasi. Sebelum Anda buat contoh, tentukan project layanan mana yang berisi layanan dan workload yang ingin Anda masukkan ke 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 host proyek.

Konsol

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

    Buka pemilih project

  2. Memilih atau membuat project Google Cloud, menjadi project host App Hub Anda.

  3. Aktifkan API yang diperlukan.

    Mengaktifkan API

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

    Jika Anda bukan pembuat project, izin yang diperlukan harus diberikan pada project kepada akun utama yang sesuai. Sebagai contoh, akun utama dapat berupa Akun Google (untuk pengguna akhir) atau akun layanan (untuk aplikasi dan workload komputasi). Untuk mendapatkan izin yang Anda perlukan guna menyelesaikan tutorial ini, tanyakan kepada 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 Pusat Aplikasi, peran App Hub Admin dalam project host.

    4. Klik Pilih peran dan di kolom Filter, masukkan Pusat Aplikasi.

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

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

  5. Di konsol Google Cloud, buka Settings di App Hub kami.

    Buka Setelan

  6. Di halaman Setelan, klik Lampirkan project.

  7. Lakukan salah satu hal berikut:

    • Dari daftar proyek, centang kotak untuk proyek yang tambahkan project sebagai layanan.
    • Telusuri project, lalu pilih project untuk ditambahkan sebagai layanan project secara terprogram.

  8. Klik Pilih. Tabel Attached Service Project(s) menampilkan layanan yang dipilih project secara terprogram.

  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. Lari perintah berikut dari Cloud Shell:

    gcloud components update

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

    • Membuat 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 dibuat.

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

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

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

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

    2. Berikan peran Admin Pusat Aplikasi dalam project layanan ke individu yang mengelola Pusat Aplikasi. Aplikasi tersebut harus memiliki Peran Admin Pusat Aplikasi untuk menambahkan project layanan ke host proyek. Anda memerlukan minimal satu orang dengan peran ini untuk setiap layanan proyek. 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 beberapa project layanan dalam contoh ini.
      • SERVICE_PROJECT_2: yang kedua dari tiga beberapa project layanan dalam contoh ini.
      • SERVICE_PROJECT_3: yang ketiga dari tiga beberapa 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 yang akan menjadi penampung bagi layanan IT dan workload.

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.

  4. Di halaman Create application, di Choose application region and name, pilih Region.

  5. Masukkan Application name dan klik Continue.

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

  7. Klik Create.

gcloud

  1. Membuat aplikasi baru bernama APPLICATION_NAME dan memberinya nama tampilan, APPLICATION_DISPLAY_NAME. Flag --scope-type menentukan layanan dan dapat didaftarkan ke aplikasi. Hanya REGIONAL yang didukung, Artinya, hanya layanan dan workload dari region yang sama dengan aplikasi dapat didaftarkan.

    gcloud apphub applications create APPLICATION_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.
    • REGION: region aplikasi. Berikan ini nilai 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 perbarui.

  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 daftar Lingkungan, untuk menunjukkan tahap siklus hidup perangkat lunak, pilih salah satu dari berikut ini:

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

gcloud

  1. Update aplikasi Anda dengan criticality-type, environment-type, dan atribut 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 beban kerja untuk operasi bisnis Anda. Berikan salah satu nilai berikut:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: menunjukkan tahapan siklus hidup perangkat lunak. 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-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 suatu aplikasi, dan workload terdaftar sebagai resource App Hub. Jika Anda menggunakan {i>placeholder<i} untuk membuat aplikasi dengan gcloud CLI, layanan dan workload dalam tiga project layanan adalah sebagai berikut:

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

  • Project Layanan 3 memiliki tiga resource infrastruktur, yaitu Service 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 ditampilkan dengan daftar layanan IT dan workload yang ada di project layanan Anda.

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

    1. Pada tab Services and workload, klik Daftarkan layanan/beban kerja.
    2. Pada halaman Register service or workload, di bagian Panel Select resource, klik Browse untuk memilih layanan atau workload sebagai Resource.
    3. Di panel Select resource, pilih layanan atau workload, klik Select.
    4. Di panel Select resource, masukkan Name untuk layanan atau workload dan klik Lanjutkan.
    5. Secara opsional, di panel Add attribute, tambahkan detail lainnya untuk layanan atau beban kerja di kolom yang mengikutinya. Untuk informasi selengkapnya, dalam dokumen ini, lihat Mengupdate aplikasi Pusat Aplikasi yang ada. Perhatikan bahwa Anda dapat memilih nilai untuk Kekritisan dan Kolom Environment yang berbeda dari nilai yang Anda tetapkan saat Anda membuat aplikasi.
    6. Klik Lanjutkan.
    7. Atau, di bagian Tambahkan pemilik, tambahkan detail lebih lanjut tentang pemilik layanan atau beban kerja di kolom yang mengikutinya. Untuk selengkapnya dalam dokumen ini, lihat Mengupdate aplikasi Pusat Aplikasi yang ada.
    8. Klik Daftar.

Tab Layanan dan beban kerja menampilkan layanan atau beban kerja yang terdaftar sebagian besar workload standar dan berbasis cloud. Untuk informasi selengkapnya 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. Mencantumkan workload yang ditemukan dari project layanan 2, yang dilampirkan ke atau project host. Perintah ini menampilkan workload yang tersedia untuk terdaftar untuk suatu 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 beban kerja dari output untuk digunakan dalam langkah selanjutnya.

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

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

  5. Opsional: Anda dapat memperbarui beban kerja dengan criticality-type, environment-type, dan atribut 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 dari nilai yang ditentukan untuk criticality-type dan environment-type tetapi nilainya dapat berupa 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 terlepas dilambangkan dengan nilai kosong di Kolom WORKLOAD_REFERENCE. Untuk informasi selengkapnya tentang status pendaftaran, lihat properti dan atribut Pusat Aplikasi.

  7. Mencantumkan layanan yang ditemukan dengan aturan penerusan di Project Layanan 1 yang terpasang pada project host. Perintah ini menampilkan layanan yang 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 yang akan digunakan di sebelum menuju langkah selanjutnya.

  8. Daftarkan aturan penerusan, testing-forwarding-rule-2 dalam layanan project 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 sebagai.
    • DISCOVERED_SERVICE_ID_2: ID layanan dari output dari langkah sebelumnya.

  9. Ulangi langkah sebelumnya yang menampilkan 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 APPLICATION_NAME aplikasi dan HOST_PROJECT_ID project host.

    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 APPLICATION_NAME aplikasi dan HOST_PROJECT_ID project host ke project yang atribut environment-type disetel 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 untuk membuat infrastruktur yang berbeda sumber daya yang tersedia untuk dikelompokkan ke dalam sebuah aplikasi.

Konsol

Untuk menambahkan project layanan ke project host:

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

    Buka Setelan

  2. Di halaman Setelan, klik Lampirkan project.

  3. Pada panel yang terbuka, cari project dari daftar yang ditampilkan dan pilih kotak centang untuk project yang ingin Anda tambahkan sebagai layanan project secara terprogram.

  4. Klik Pilih. 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 App Hub.

    Buka Setelan

  2. Di halaman Setelan, pilih kotak centang untuk setiap project yang Anda inginkan untuk menghapus project as service.

  3. Klik Lepaskan project. Tabel Attached Service Project(s) diperbarui untuk hanya menampilkan yang tetap melekat 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 project, serta membuat daftar layanan dan workload di aplikasi.

Konsol

  • Untuk melihat aplikasi dalam suatu project, di konsol Google Cloud, buka Halaman Aplikasi di Pusat Aplikasi.

    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 beban kerja yang didaftarkan ke aplikasi 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 beban kerja dengan kekritisan tinggi yang yang terdaftar di aplikasi.

    Layanan dan Workload

    1. Di konsol Google Cloud, buka App Hub Layanan dan Beban Kerja.

      Buka Layanan dan Workloads

    2. Dalam daftar Region, pilih wilayah tempat Anda ingin melihat layanan dan workload. Misalnya, pilih us-east1.
      Halaman Layanan dan Beban Kerja menampilkan semua layanan dan workload 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 beban kerja di lingkungan produksi yang terdaftar untuk sebuah aplikasi.

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 proyek layanan dari project host untuk menghapus resource yang terkait dengan project. Tindakan ini akan menghentikan penemuan resource secara otomatis dalam project layanan.

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

Konsol

  1. Di Konsol Google Cloud, buka Halaman Aplikasi di Pusat Aplikasi.

    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 Layanan dan beban kerja, dari Registered services and workload, klik nama layanan atau beban kerja yang ingin Anda batalkan pendaftarannya.
    2. Di tab Details, klik Batalkan Pendaftaran untuk mengupdate layanan atau workload sebagai resource Discover.
      Pada tab Layanan dan beban kerja, pemberitahuan akan memberi tahu bahwa tidak terdaftar.
    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 di Tambahkan atau hapus project layanan untuk menghapusnya 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 yang dapat didaftarkan ke aplikasi.

  3. Ulangi perintah sebelumnya untuk menghapus sisa beban kerja 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 ini sekarang menjadi layanan yang ditemukan yang dapat didaftarkan ke aplikasi.

  6. Ulangi perintah sebelumnya untuk membatalkan pendaftaran sisa pendaftaran 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 host proyek.

Langkah selanjutnya