Mendaftarkan resource Google Cloud yang ada sebagai layanan dan workload dalam aplikasi App Hub memungkinkan Anda menyederhanakan pengelolaan dengan mengatur resource berdasarkan tujuan bisnisnya. Pendekatan ini memberikan visibilitas, pemantauan, tata kelola, dan kontrol operasional yang terpadu.
Panduan ini menunjukkan cara mengelompokkan resource Google Cloud yang ada yang belum didefinisikan secara formal sebagai aplikasi.
Sebelum memulai
Anda harus menyelesaikan penyiapan awal untuk pengelolaan aplikasi sebelum mengatur resource ke dalam aplikasi. Proses ini biasanya melibatkan peran dan langkah berikut:
Untuk administrator:
- Pilih model penyiapan aplikasi Anda. Anda harus mengonfigurasi project pengelolaan dan menentukan batas pengelolaan aplikasi yang mencakup resource Google Cloud yang ingin Anda atur.
- Aktifkan API yang diperlukan untuk semua resource Google Cloud yang ingin Anda gunakan.
- Memberikan akses kepada pengguna. Tetapkan peran IAM yang sesuai berdasarkan tanggung jawab pengguna dalam siklus proses aplikasi.
Untuk developer dan operator:
- Konfirmasi dengan administrator Anda bahwa penyiapan awal telah selesai.
- Pastikan Anda memiliki peran IAM yang diperlukan untuk tugas yang ingin Anda lakukan.
- Buka project pengelolaan Anda di konsol Google Cloud atau temukan project ID project pengelolaan untuk interaksi Terraform atau Google Cloud CLI.
Membuat aplikasi
Buat aplikasi di App Hub untuk bertindak sebagai container logis untuk resource Google Cloud yang ada:
Konsol
Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.
Buka halaman Applications dari App Hub:
Klik Create application.
Di tab Application details, pilih lokasi terbaik untuk aplikasi Anda berdasarkan persyaratan distribusi geografis Anda:
- Pilih Global untuk membuat aplikasi global.
- Pilih Multi-regional untuk membuat aplikasi multi-regional.
Kemudian, pilih multi-region yang didukung (
usataueu) untuk aplikasi Anda. - Pilih Regional untuk membuat aplikasi regional. Kemudian, pilih region tertentu untuk aplikasi Anda berdasarkan wilayah yang didukung App Hub.
Untuk mengetahui informasi selengkapnya tentang lokasi terbaik untuk aplikasi Anda, lihat Aplikasi global, multi-regional, dan regional.
Masukkan nama untuk aplikasi Anda.
Nama ini adalah ID unik yang hanya boleh berisi huruf kecil, angka, atau tanda hubung. Anda tidak dapat mengubah nama ini setelah membuat aplikasi.
Jika perlu, tambahkan nama tampilan dan deskripsi untuk aplikasi.
ID ini bukan ID unik, dan Anda dapat mengubahnya setelah membuat aplikasi.
Klik Lanjutkan.
Di tab Application resources, jelajahi resource infrastruktur dan centang kotak resource yang ingin Anda daftarkan sebagai layanan dan workload aplikasi.
Anda dapat memilih hingga 10 fasilitas sekaligus.
Klik Lanjutkan.
Di tab Attributes and owners, Anda dapat menambahkan atribut untuk aplikasi, seperti kekritisan, lingkungan, dan pemilik aplikasi.
Anda dapat memilih untuk menggunakan atribut dan pemilik yang sama untuk resource yang Anda daftarkan ke aplikasi atau menentukannya nanti.
Klik Create.
Saat aplikasi dibuat, halaman Applications akan menampilkan detailnya, termasuk resource yang Anda daftarkan sebagai layanan dan workload. Setelah membuat aplikasi, Anda dapat mendaftarkan lebih banyak layanan dan workload ke aplikasi tersebut.
gcloud
Gunakan Google Cloud CLI untuk membuat aplikasi dari terminal atau Cloud Shell:
gcloud apphub applications create APPLICATION_NAME \ --project=PROJECT_ID \ --scope-type=SCOPE_TYPE \ --location=LOCATION \ --display-name=DISPLAY_NAME \ --criticality-type=CRITICALITY \ --environment-type=ENVIRONMENT \ --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \ --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \ --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAILGanti
APPLICATION_NAMEdengan nama aplikasi Anda. Nama ini adalah ID unik yang hanya boleh berisi huruf kecil, angka, atau tanda hubung.Gunakan flag opsional seperti
--criticality-typeuntuk menentukan atribut tingkat teratas aplikasi dan mendukung visibilitas dan tata kelola.Untuk flag wajib dan opsional, ganti kode berikut:
- Wajib:
PROJECT_ID: ID project pengelolaan. Wajib:
SCOPE_TYPE: lokasi untuk aplikasi Anda berdasarkan persyaratan distribusi geografis Anda. Gunakan salah satu nilai berikut:REGIONALuntuk aplikasi regional.MULTI_REGIONALuntuk aplikasi multi-regional.GLOBALuntuk aplikasi global.
Untuk mengetahui informasi selengkapnya tentang lokasi terbaik untuk aplikasi Anda, lihat Aplikasi global, multi-regional, dan regional.
Wajib:
LOCATION: lokasi spesifik untuk aplikasi Anda. Gunakan salah satu nilai berikut:- Jika
--scope-typelokasi untuk aplikasi Anda ditetapkan keREGIONAL, tentukan nama wilayah yang didukung App Hub. - Jika lokasi
--scope-typeuntuk aplikasi Anda ditetapkan keMULTI_REGIONAL, tentukanusataueu. - Jika lokasi
--scope-typeuntuk aplikasi Anda ditetapkan keGLOBAL, gunakanglobal.
- Jika
Opsional:
DISPLAY_NAME: nama tampilan aplikasi Anda. Nama tampilan bukan ID unik dan Anda dapat mengubahnya setelah membuat aplikasi.Opsional:
CRITICALITY: tingkat kepentingan aplikasi untuk operasi Anda. Gunakan salah satu nilai berikut:MISSION_CRITICALHIGHMEDIUMLOW
Opsional:
ENVIRONMENT: tahap siklus proses software. Gunakan salah satu nilai berikut:PRODUCTIONSTAGINGDEVELOPMENTTEST
Opsional:
DEV_NAMEdanDEV_EMAIL: nama tampilan dan alamat email pemilik developer.Opsional:
OPERATOR_NAMEdanOPERATOR_EMAIL: nama tampilan dan alamat email pemilik operator.Opsional:
BUSINESS_NAMEdanBUSINESS_EMAIL: nama tampilan dan alamat email pemilik bisnis.
- Wajib:
Cantumkan aplikasi dalam project Anda:
gcloud apphub applications list \ --project=PROJECT_ID \ --location=LOCATIONAnda akan mendapatkan output yang mirip dengan berikut ini:
ID DISPLAY_NAME CREATE_TIME APPLICATION_NAME DISPLAY_NAME 2023-10-31T18:33:48
Terraform
Untuk membuat aplikasi dengan Terraform, gunakan
resource google_apphub_application.
Resource ini memungkinkan Anda menentukan properti aplikasi, termasuk nama, lokasi, dan atributnya.
Contoh berikut membuat aplikasi regional di us-central1 dengan
atribut kekritisan, lingkungan, dan pemilik yang ditentukan:
resource "google_apphub_application" "example" {
project = "my-project-id"
location = "us-central1"
application_id = "my-application"
display_name = "My Application"
description = "This application represents our platform."
scope {
type = "REGIONAL"
}
attributes {
criticality {
type = "MISSION_CRITICAL"
}
environment {
type = "PRODUCTION"
}
business_owners {
display_name = "Alice"
email = "alice@example.com"
}
developer_owners {
display_name = "Bob"
email = "bob@example.com"
}
operator_owners {
display_name = "Charlie"
email = "charlie@example.com"
}
}
}
Mendaftarkan layanan dan workload
App Hub memungkinkan Anda memilih resource yang didukung yang berada dalam batas pengelolaan aplikasi untuk mendaftarkannya sebagai layanan dan workload. Setelah membuat aplikasi, Anda dapat mendaftarkan resource Google Cloud sebagai layanan dan workload di dalamnya.
Anda hanya dapat mendaftarkan layanan eksklusif ke satu aplikasi. Namun, layanan bersama dapat didaftarkan ke lebih dari satu aplikasi. App Hub akan menemukan layanan bersama saat Anda mendaftarkannya ke aplikasi, meskipun layanan tersebut sudah terdaftar ke aplikasi lain, tetapi Anda mungkin tidak dapat mengubah atributnya.
Konsol
Setelah membuat aplikasi, Anda dapat mendaftarkan beberapa resource ke aplikasi tersebut:
Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.
Buka halaman Applications dari App Hub:
Klik nama aplikasi yang ingin Anda daftarkan resourceGoogle Cloud .
Dari halaman aplikasi, pilih tab Services and workloads.
Klik Register services or workloads.
Di tab Services and workloads, jelajahi resource infrastruktur dan centang kotak resource yang ingin Anda daftarkan sebagai layanan atau workload aplikasi.
Anda dapat memilih hingga 10 fasilitas sekaligus.
Klik Lanjutkan.
Di tab Attributes and owners, Anda dapat menambahkan atribut untuk resource ini, seperti kekritisan, lingkungan, dan pemilik resource.
Anda dapat memilih untuk menggunakan atribut dan pemilik yang sama dari aplikasi atau menentukan atribut yang berbeda nanti.
Klik Daftar.
Tab Services and workloads menampilkan semua layanan dan workload aplikasi yang terdaftar.
gcloud
App Hub memungkinkan Anda memilih resource yang didukung yang berada dalam batas pengelolaan aplikasi sebagai layanan atau workload. Gunakan Google Cloud CLI untuk mencantumkan layanan atau workload yang dapat Anda daftarkan ke aplikasi dari terminal atau Cloud Shell. Perintah sedikit berbeda untuk layanan dan workload:
Mendaftar layanan
Cantumkan layanan yang tersedia yang dapat Anda daftarkan ke aplikasi:
gcloud apphub discovered-services list \ --project=PROJECT_ID \ --location=REGION \ --filter=FILTER_EXPRESSIONUntuk flag wajib dan opsional, ganti kode berikut:
- Wajib:
PROJECT_ID: ID project pengelolaan. Wajib:
REGION: lokasi spesifik layanan Anda berdasarkan distribusi geografis Anda. Gunakan salah satu nilai berikut:- Jika layanan bersifat regional, tentukan nama wilayah yang didukung App Hub.
- Jika layanan bersifat multi-regional, tentukan
usataueu. - Jika layanannya global, gunakan
global.
Opsional:
FILTER_EXPRESSION: ekspresi filter untuk flag--filteragar hanya menampilkan layanan dari project tertentu dalam batas pengelolaan aplikasi atau dengan properti tertentu, misalnya:service_properties.gcp_project=projects/PROJECT_IDservice_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules"
Outputnya mirip dengan contoh berikut:
ID SERVICE_REFERENCE SERVICE_PROPERTIES SERVICE_ID {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'} {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}- Wajib:
Salin ID layanan,
SERVICE_ID, dari output.Daftarkan layanan ke aplikasi Anda:
gcloud apphub applications services create SERVICE_NAME \ --project=PROJECT_ID \ --location=APPLICATION_LOCATION \ --application=APPLICATION_NAME \ --discovered-service=projects/PROJECT_ID/locations/REGION/discoveredServices/SERVICE_ID \ --display-name=SERVICE_DISPLAY_NAME \ --criticality-type=CRITICALITY \ --environment-type=ENVIRONMENT \ --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \ --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \ --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAILGanti
SERVICE_NAMEdengan nama yang ingin Anda gunakan untuk mendaftarkan layanan ke aplikasi.Gunakan flag opsional seperti
--criticality-typeuntuk menentukan atribut tingkat teratas layanan dan mendukung visibilitas dan tata kelola.Untuk flag wajib dan opsional, ganti kode berikut:
- Wajib:
PROJECT_ID: ID project pengelolaan. Wajib:
APPLICATION_LOCATION: lokasi aplikasi Anda. Gunakan salah satu nilai berikut:- Jika aplikasi bersifat regional, tentukan nama wilayah yang didukung App Hub.
- Jika aplikasi bersifat multi-regional, tentukan
usataueu. - Jika aplikasi bersifat global, gunakan
global.
Wajib:
APPLICATION_NAME: nama aplikasi yang ingin Anda daftarkan layanannya.Wajib:
REGION: lokasi layanan yang ditemukan dari output sebelumnya.Wajib:
SERVICE_ID: ID layanan yang Anda salin dari output sebelumnya.Opsional:
SERVICE_DISPLAY_NAME: nama tampilan layanan Anda.Opsional:
CRITICALITY: tingkat kepentingan layanan untuk operasi Anda. Gunakan salah satu nilai berikut:MISSION_CRITICALHIGHMEDIUMLOW
Opsional:
ENVIRONMENT: tahap siklus proses software. Gunakan salah satu nilai berikut:PRODUCTIONSTAGINGDEVELOPMENTTEST
Opsional:
DEV_NAMEdanDEV_EMAIL: nama tampilan dan alamat email pemilik developer.Opsional:
OPERATOR_NAMEdanOPERATOR_EMAIL: nama tampilan dan alamat email pemilik operator.Opsional:
BUSINESS_NAMEdanBUSINESS_EMAIL: nama tampilan dan alamat email pemilik bisnis.
- Wajib:
Cantumkan layanan terdaftar di aplikasi Anda:
gcloud apphub applications services list \ --application=APPLICATION_NAME \ --project=PROJECT_ID \ --location=APPLICATION_LOCATIONAnda harus mendapatkan output yang mirip dengan berikut ini untuk setiap layanan yang terdaftar:
ID DISPLAY_NAME SERVICE_REFERENCE CREATE_TIME SERVICE_NAME SERVICE_DISPLAY_NAME {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'} 2023-11-01T21:38:08
Mendaftarkan workload
Cantumkan workload yang tersedia yang dapat Anda daftarkan ke aplikasi:
gcloud apphub discovered-workloads list \ --project=PROJECT_ID \ --location=REGION \ --filter=FILTER_EXPRESSIONUntuk flag wajib dan opsional, ganti kode berikut:
- Wajib:
PROJECT_ID: ID project pengelolaan. Wajib:
REGION: lokasi spesifik workload Anda berdasarkan distribusi geografis Anda. Gunakan salah satu nilai berikut:- Jika beban kerja bersifat regional, tentukan nama wilayah yang didukung App Hub.
- Jika workload bersifat multi-region, tentukan
usataueu. - Jika workload bersifat global, gunakan
global.
Opsional:
FILTER_EXPRESSION: ekspresi filter untuk flag--filteragar hanya menampilkan workload dari project tertentu dalam batas pengelolaan aplikasi atau dengan properti tertentu, misalnya,workload_properties.gcp_project=projects/PROJECT_ID.
Outputnya mirip dengan contoh berikut:
ID WORKLOAD_REFERENCE WORKLOAD_PROPERTIES WORKLOAD_ID {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'} {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}- Wajib:
Salin ID workload,
WORKLOAD_ID, dari output.Daftarkan workload ke aplikasi Anda:
gcloud apphub applications workloads create WORKLOAD_NAME \ --project=PROJECT_ID \ --location=APPLICATION_LOCATION \ --application=APPLICATION_NAME \ --discovered-workload=projects/PROJECT_ID/locations/REGION/discoveredWorkloads/WORKLOAD_ID \ --display-name=WORKLOAD_DISPLAY_NAME \ --criticality-type=CRITICALITY \ --environment-type=ENVIRONMENT \ --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \ --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \ --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAILGanti
WORKLOAD_NAMEdengan nama yang ingin Anda gunakan untuk mendaftarkan workload ke aplikasi.Gunakan flag opsional seperti
--criticality-typeuntuk menentukan atribut tingkat teratas workload dan mendukung visibilitas dan tata kelola.Untuk flag wajib dan opsional, ganti kode berikut:
- Wajib:
PROJECT_ID: ID project pengelolaan. Wajib:
APPLICATION_LOCATION: lokasi aplikasi Anda. Gunakan salah satu nilai berikut:- Jika aplikasi bersifat regional, tentukan nama wilayah yang didukung App Hub.
- Jika aplikasi bersifat multi-regional, tentukan
usataueu. - Jika aplikasi bersifat global, gunakan
global.
Wajib:
APPLICATION_NAME: nama aplikasi yang ingin Anda daftarkan workload-nya.Wajib:
REGION: lokasi workload yang ditemukan dari output sebelumnya.Wajib diisi:
WORKLOAD_ID: ID workload yang Anda salin dari output sebelumnya.Opsional:
WORKLOAD_DISPLAY_NAME: nama tampilan workload Anda.Opsional:
CRITICALITY: tingkat kepentingan workload untuk operasi Anda. Gunakan salah satu nilai berikut:MISSION_CRITICALHIGHMEDIUMLOW
Opsional:
ENVIRONMENT: tahap siklus proses software. Gunakan salah satu nilai berikut:PRODUCTIONSTAGINGDEVELOPMENTTEST
Opsional:
DEV_NAMEdanDEV_EMAIL: nama tampilan dan alamat email pemilik developer.Opsional:
OPERATOR_NAMEdanOPERATOR_EMAIL: nama tampilan dan alamat email pemilik operator.Opsional:
BUSINESS_NAMEdanBUSINESS_EMAIL: nama tampilan dan alamat email pemilik bisnis.
- Wajib:
Mencantumkan workload yang terdaftar di aplikasi Anda:
gcloud apphub applications workloads list \ --application=APPLICATION_NAME \ --project=PROJECT_ID \ --location=APPLICATION_LOCATIONAnda harus mendapatkan output yang mirip dengan berikut ini untuk setiap workload yang terdaftar:
ID DISPLAY_NAME WORKLOAD_REFERENCE CREATE_TIME WORKLOAD_NAME WORKLOAD_DISPLAY_NAME {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'} 2023-11-01T21:38:08
Terraform
Untuk menggunakan Terraform guna mendaftarkan resource Google Cloud dalam
batas pengelolaan aplikasi Anda sebagai layanan atau workload dalam aplikasi, gunakan
sumber data
google_apphub_discovered_service
dan
google_apphub_discovered_workload
untuk mengambil informasi secara dinamis tentang resource yang ingin Anda daftarkan.
Kemudian, gunakan resource
google_apphub_service
atau
google_apphub_workload
untuk mendaftarkan layanan atau workload.
Mendaftar layanan
Mendapatkan informasi tentang layanan menggunakan URI-nya:
data "google_apphub_discovered_service" "my-service" { location = "LOCATION" service_uri = "SERVICE_URI" }Daftarkan layanan yang ditemukan ke aplikasi Anda, misalnya:
resource "google_apphub_service" "example" { project = "my-project-id" location = "us-central1" application_id = google_apphub_application.example.application_id service_id = "frontend-load-balancer" discovered_service = data.google_apphub_discovered_service.my-forwarding-rule.name display_name = "Frontend Load Balancer" description = "The primary load balancer for the frontend." }
Mendaftarkan workload
Mendapatkan informasi tentang workload menggunakan URI-nya:
data "google_apphub_discovered_workload" "my-workload" { location = "LOCATION" workload_uri = "WORKLOAD_URI" }Daftarkan workload yang ditemukan ke aplikasi Anda, misalnya:
resource "google_apphub_workload" "example" { project = "my-project-id" location = "us-central1" application_id = google_apphub_application.example.application_id workload_id = "frontend-instance-group" discovered_workload = data.google_apphub_discovered_workload.my-mig.name display_name = "Frontend Instance Group" description = "The managed instance group for the frontend." }
Status pendaftaran layanan dan workload yang terdaftar ke aplikasi dapat berubah menjadi terlepas jika Anda memindahkan project atau folder keluar dari batas pengelolaan aplikasi atau menghapus resource yang mendasarinya. Layanan dan workload yang dilepas tetap berada di aplikasi hingga Anda membatalkan pendaftarannya, tetapi App Hub tidak dapat lagi mengelola atau memantaunya. Untuk mengetahui informasi selengkapnya, lihat Status pendaftaran layanan dan workload.
Untuk memasang kembali layanan atau workload ke aplikasi, Anda harus mendaftarkannya lagi.
Memberikan izin dan memulai operasi
Setelah membuat aplikasi dan mendaftarkan layanan serta workload di App Hub, Anda harus memberikan akses pengguna berdasarkan tanggung jawab siklus proses untuk mengelola grup logis ini sebagai satu unit:
- Bergantung pada kebutuhan akses, Anda dapat memberikan izin ke setiap aplikasi atau semua aplikasi. Untuk mengetahui daftar peran yang direkomendasikan, lihat Memberikan peran yang berfokus pada aplikasi kepada pengguna.
- Atau, buka Cloud Hub untuk melihat dasbor operasional terpadu untuk aplikasi yang Anda tentukan, termasuk data kesehatan, performa, dan biayanya.