App Hub memungkinkan Anda melihat aplikasi yang terdaftar, memperbarui atributnya, dan menghapus aplikasi agar inventaris aplikasi Anda tetap akurat. Untuk menghindari penyimpangan konfigurasi, hanya gunakan App Hub untuk mengupdate atau menghapus aplikasi yang Anda daftarkan secara langsung, dan kelola aplikasi berdasarkan template di Application Design Center.
Ringkasan
Saat memilih model penyiapan aplikasi, Anda menentukan batas pengelolaan aplikasi untuk aplikasi App Hub Anda dalam project pengelolaan. Kemudian, Anda dapat mendaftarkan layanan dan workload dalam aplikasi di dalam batas ini.
Untuk mengetahui kasus penggunaan yang direkomendasikan guna memperkenalkan praktik pengelolaan aplikasi, lihat Mempersiapkan pengelolaan aplikasi. Untuk membuat aplikasi dan mendaftarkan resource, lihat Mendaftarkan resource yang ada ke aplikasi.
Untuk menghindari penyimpangan konfigurasi dan mempertahankan sumber tepercaya yang jelas, sebaiknya kelola komponen aplikasi di lingkungan tempat komponen tersebut awalnya ditentukan:
Untuk aplikasi yang di-deploy dari template Application Design Center: Gunakan Application Design Center untuk mengelola dan mengupdate aplikasi. Anda dapat merevisi template untuk perubahan desain aplikasi atau membuat revisi aplikasi untuk memperbarui setelan seperti detail aplikasi dan komponen.
Untuk aplikasi yang dibuat dengan mendaftarkan resource yang ada di App Hub: Kelola aplikasi, layanan, dan workload langsung di dalam App Hub.
Di App Hub, Anda dapat melakukan tindakan ini menggunakan konsolGoogle Cloud atau Google Cloud CLI. Untuk aplikasi yang di-deploy dari template, lihat dokumentasi Application Design Center.
Sebelum memulai
Dokumen ini mengasumsikan bahwa Anda memiliki aplikasi dengan resource yang didukung yang terdaftar di dalamnya.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk mengelola aplikasi di App Hub, minta administrator untuk memberi Anda peran IAM berikut pada project pengelolaan yang menentukan batas pengelolaan aplikasi Anda :
-
Mengupdate dan menghapus aplikasi:
Editor App Hub (
roles/apphub.editor) -
Melihat aplikasi:
App Hub Viewer (
roles/apphub.viewer)
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Untuk mengetahui informasi selengkapnya tentang peran App Hub, lihat Peran dan izin IAM App Hub.
Membuat daftar aplikasi
Ikuti langkah-langkah berikut untuk mencantumkan dan memfilter semua aplikasi dalam batas pengelolaan aplikasi Anda:
Konsol
Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.
Buka halaman Applications dari App Hub:
Halaman ini menampilkan daftar aplikasi Anda.
Untuk memfilter daftar, gunakan kolom Filter. Anda dapat memfilter berdasarkan atribut seperti Criticality atau Environment.
gcloud
Temukan project ID project pengelolaan Anda.
Tampilkan daftar aplikasi Anda menggunakan salah satu opsi berikut:
Mencantumkan semua aplikasi:
gcloud apphub applications list \ --project=PROJECT_ID \ --location=LOCATIONGanti kode berikut:
PROJECT_ID: ID project pengelolaan Anda.LOCATION: lokasi aplikasi Anda. Gunakanglobaluntuk aplikasi global, multi-region (usataueu) untuk aplikasi multi-regional, atau region tertentu, sepertius-east1, untuk aplikasi regional.
Filter daftar aplikasi berdasarkan atribut, menggunakan flag
--filter:gcloud apphub applications list \ --project=PROJECT_ID \ --location=LOCATION \ --filter=FILTER_EXPRESSION \Ganti kode berikut:
PROJECT_ID: ID project pengelolaan Anda.LOCATION: lokasi aplikasi Anda. Gunakanglobaluntuk aplikasi global, multi-region (usataueu) untuk aplikasi multi-regional, atau region tertentu, sepertius-east1, untuk aplikasi regional.FILTER_EXPRESSION: ekspresi filter untuk menentukan atribut. Misalnya, untuk mencantumkan semua aplikasi dengan jenis lingkunganPRODUCTION, gunakanattributes.environment.type=PRODUCTION.
Melihat detail aplikasi
Ikuti langkah-langkah berikut untuk melihat informasi mendetail tentang aplikasi tertentu, termasuk atribut dan metadatanya:
Konsol
Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.
Buka halaman Applications dari App Hub:
Halaman ini menampilkan daftar aplikasi Anda.
Klik nama aplikasi yang ingin Anda lihat.
Tab Details aplikasi akan ditampilkan.
gcloud
Temukan project ID project pengelolaan Anda.
Menjelaskan aplikasi:
gcloud apphub applications describe APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATIONGanti kode berikut:
APPLICATION_NAME: nama aplikasi Anda. Anda menentukan nilai ini saat membuat aplikasi.PROJECT_ID: ID project pengelolaan Anda.LOCATION: lokasi aplikasi Anda. Gunakanglobaluntuk aplikasi global, multi-region (usataueu) untuk aplikasi multi-regional, atau region tertentu, sepertius-east1, untuk aplikasi regional.
Memperbarui atribut aplikasi
Untuk mengubah atribut aplikasi setelah dibuat, ikuti langkah-langkah berikut. Layanan dan workload juga dapat menggunakan atribut aplikasi yang sama selama pendaftaran.
Konsol
Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.
Buka halaman Applications dari App Hub:
Halaman ini menampilkan daftar aplikasi Anda.
Untuk aplikasi yang ingin Anda perbarui, klik Edit.
Di panel Edit application, ubah kolom sesuai kebutuhan.
Klik Simpan.
gcloud
Temukan project ID project pengelolaan Anda.
Memperbarui atribut aplikasi. Anda dapat memperbarui atribut yang dapat diubah, seperti
display-name,criticality-type,environment-type, dan pemilik:gcloud apphub applications update APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION \ --display-name=DISPLAY_NAME \ --criticality-type=CRITICALITY_LEVEL \ --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 kode berikut:
- Wajib:
APPLICATION_NAME: nama aplikasi Anda. Anda menentukan nilai ini saat membuat aplikasi. - Wajib:
PROJECT_ID: ID project pengelolaan Anda. - Wajib:
LOCATION: lokasi aplikasi Anda. Gunakanglobaluntuk aplikasi global, multi-region (usataueu) untuk aplikasi multi-regional, atau region tertentu, sepertius-east1, untuk aplikasi regional. - Opsional:
DISPLAY_NAME: nama tampilan aplikasi Anda. Opsional:
CRITICALITY_LEVEL: tingkat kepentingan aplikasi. 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:
Terraform
Untuk memperbarui atribut aplikasi dengan Terraform, ubah argumen dalam
blok resource google_apphub_application
di file konfigurasi Anda. Saat Anda menerapkan perubahan, Terraform akan memperbarui aplikasi agar sesuai dengan konfigurasi baru.
Contoh berikut mengupdate atribut kekritisan dan lingkungan aplikasi regional di us-central1:
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."
attributes {
criticality {
type = "HIGH" # Updated criticality
}
environment {
type = "PRODUCTION"
}
# ... other attributes
}
}
Menghapus aplikasi
Sebelum dapat menghapus aplikasi, Anda harus membatalkan pendaftaran semua layanan dan workload-nya terlebih dahulu. Kemudian, ikuti langkah-langkah berikut untuk menghapus aplikasi:
Konsol
Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.
Buka halaman Applications dari App Hub:
Halaman ini menampilkan daftar aplikasi Anda.
Klik nama aplikasi yang ingin Anda hapus.
Buka tab Services and workloads dan pastikan Anda telah membatalkan pendaftaran semua komponen aplikasi. Untuk mengetahui informasi selengkapnya, lihat Membatalkan pendaftaran layanan dan workload.
Setelah semua layanan dan workload dibatalkan pendaftarannya, buka kembali detail aplikasi dan klik Delete.
gcloud
Temukan project ID project pengelolaan Anda.
Pastikan Anda telah membatalkan pendaftaran semua komponen aplikasi. Untuk mengetahui informasi selengkapnya, lihat Membatalkan pendaftaran layanan dan workload.
Setelah aplikasi tidak memiliki komponen terdaftar, hapus aplikasi:
gcloud apphub applications delete APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATIONGanti kode berikut:
APPLICATION_NAME: nama aplikasi Anda. Anda menentukan nilai ini saat membuat aplikasi.PROJECT_ID: ID project pengelolaan Anda.LOCATION: lokasi aplikasi Anda. Gunakanglobaluntuk aplikasi global, multi-region (usataueu) untuk aplikasi multi-regional, atau region tertentu, sepertius-east1, untuk aplikasi regional.
Terraform
Untuk menghapus aplikasi yang dikelola oleh Terraform, Anda memiliki opsi berikut:
- Hapus resource dari konfigurasi Anda: Hapus
resource
google_apphub_applicationdari file Terraform Anda, lalu jalankanterraform apply. Terraform mengenali bahwa resource tidak lagi ada dalam konfigurasi dan menghapusnya dari project Anda. - Hentikan semua resource: Jalankan perintah
terraform destroyuntuk menghentikan semua resource yang dikelola oleh konfigurasi Terraform Anda, termasuk aplikasi.