Mendaftarkan resource yang ada ke aplikasi

Dengan mendaftarkan layanan dan workload yang sudah ada ke dalam aplikasi, Anda dapat 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 layanan dan workload yang sudah ada yang berjalan di Google Cloud yang belum ditentukan 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-langkah berikut:

• Untuk administrator:

  1. Siapkan pengelolaan aplikasi. Konfigurasi folder yang mendukung aplikasi atau project host untuk bertindak sebagai batas administratif bagi aplikasi Anda.
  2. Aktifkan API yang diperlukan. Aktifkan API untuk semua resource yang ingin Anda gunakan.
  3. Memberikan akses kepada pengguna. Tetapkan peran IAM yang sesuai berdasarkan tanggung jawab pengguna dalam siklus proses aplikasi.

• Untuk developer dan operator:

  1. Konfirmasi dengan administrator Anda bahwa penyiapan awal telah selesai.
  2. Pastikan Anda memiliki peran IAM yang diperlukan untuk tugas yang ingin Anda lakukan.
  3. Buka folder atau project host yang mendukung aplikasi, bergantung pada model penyiapan Anda.

Membuat aplikasi

Buat aplikasi di App Hub untuk bertindak sebagai penampung logis bagi layanan dan workload yang ada:

Konsol

1. Di konsol Google Cloud , gunakan pemilih project untuk memilih project host atau project pengelolaan folder yang mendukung aplikasi, bergantung pada model penyiapan Anda.

2. Buka halaman Aplikasi dari Pusat Aplikasi:

   Buka Aplikasi

3. Klik Create application.

4. Di panel Pilih region dan nama aplikasi, pilih lokasi terbaik untuk aplikasi Anda berdasarkan persyaratan distribusi geografis Anda:

   • Pilih Regional untuk membuat aplikasi regional. Kemudian, pilih region tertentu untuk aplikasi Anda berdasarkan region yang didukung App Hub.
   • Pilih Global untuk membuat aplikasi global.

   Untuk mengetahui informasi selengkapnya tentang lokasi terbaik untuk aplikasi Anda, lihat Aplikasi global dan regional.

   Penting: Setelah membuat aplikasi, Anda tidak dapat mengubah lokasinya.

5. Masukkan Nama aplikasi, lalu klik Lanjutkan.

6. Opsional: Tentukan atribut tingkat teratas aplikasi untuk mendukung penemuan dan tata kelola:

   • Di bagian Tambahkan atribut, masukkan Nama tampilan.
   • Dalam daftar Kekritisan, pilih nilai untuk menunjukkan pentingnya aplikasi.
   • Dalam daftar Lingkungan, pilih nilai untuk menunjukkan tahap siklus proses software.
   • Tambahkan detail informasi kontak untuk pemilik, termasuk nama tampilan dan alamat email mereka. Perhatikan bahwa alamat email harus memiliki format username@yourdomain, misalnya, [e-mail].

7. Klik Buat.

gcloud

1. Gunakan Google Cloud CLI untuk membuat aplikasi dari terminal atau Cloud Shell:

   gcloud apphub applications create APPLICATION_NAME \
     --project=PROJECT_ID \
     --scope-type=LOCATION \
     --location=REGION \
     --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_EMAIL
   

   Ganti APPLICATION_NAME dengan nama aplikasi Anda. Nama hanya boleh menyertakan karakter alfanumerik huruf kecil tanpa spasi.

   Gunakan tanda opsional seperti --criticality-type untuk menentukan atribut tingkat teratas aplikasi dan mendukung penemuan dan tata kelola.

   Untuk flag wajib dan opsional, ganti opsi berikut:

   • Wajib: PROJECT_ID: ID project host atau project pengelolaan, bergantung pada model penyiapan Anda.

   • Wajib: LOCATION: lokasi untuk aplikasi Anda berdasarkan persyaratan distribusi geografis Anda. Gunakan salah satu nilai berikut:

     • REGIONAL untuk aplikasi regional.
     • GLOBAL untuk aplikasi global.

     Untuk mengetahui informasi selengkapnya tentang lokasi terbaik untuk aplikasi Anda, lihat Aplikasi global dan regional.

   • Wajib: REGION: wilayah tertentu untuk aplikasi Anda. Gunakan salah satu nilai berikut:

     • Jika lokasi --scope-type untuk aplikasi Anda ditetapkan ke REGIONAL, tentukan nama wilayah yang didukung App Hub.
     • Jika lokasi --scope-type untuk aplikasi Anda ditetapkan ke GLOBAL, gunakan global.

   • Opsional: DISPLAY_NAME: nama tampilan aplikasi Anda.

   • Opsional: CRITICALITY: tingkat kepentingan aplikasi untuk operasi Anda. Gunakan salah satu nilai berikut:

     • MISSION_CRITICAL
     • HIGH
     • MEDIUM
     • LOW

   • Opsional: ENVIRONMENT: tahap siklus proses software. Gunakan salah satu nilai berikut:

     • PRODUCTION
     • STAGING
     • DEVELOPMENT
     • TEST

   • Opsional: DEV_NAME dan DEV_EMAIL: nama tampilan dan alamat email pemilik developer.

   • Opsional: OPERATOR_NAME dan OPERATOR_EMAIL: nama tampilan dan alamat email pemilik operator.

   • Opsional: BUSINESS_NAME dan BUSINESS_EMAIL: nama tampilan dan alamat email pemilik bisnis.

   Catatan: Alamat email harus memiliki format username@yourdomain, misalnya, [e-mail].

2. Mencantumkan aplikasi dalam project Anda:

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

   Anda harus mendapatkan output yang mirip dengan berikut ini:

   ID                 DISPLAY_NAME   CREATE_TIME
   APPLICATION_NAME   DISPLAY_NAME   2023-10-31T18:33:48
   

Mendaftarkan layanan dan workload

Setelah membuat aplikasi, daftarkan layanan dan workload yang ada ke aplikasi tersebut:

Konsol

1. Di konsol Google Cloud , gunakan pemilih project untuk memilih project host atau project pengelolaan folder yang mendukung aplikasi, bergantung pada model penyiapan Anda.

2. Buka halaman Aplikasi dari Pusat Aplikasi:

   Buka Aplikasi

3. Klik nama aplikasi yang ingin Anda daftarkan layanan dan workload yang ada.

4. Dari halaman detail aplikasi, pilih tab Layanan dan beban kerja. Tab ini menampilkan daftar resource yang ada yang dapat Anda daftarkan ke aplikasi. App Hub memungkinkan Anda memilih resource yang didukung yang berada dalam hierarki resource Anda sebagai layanan dan workload.

5. Untuk setiap layanan atau workload yang ingin Anda daftarkan, lakukan hal berikut:

   1. Di tab Services and workloads, klik Register service/workload.
   2. Buka panel Pilih resource, lalu klik Jelajahi untuk menemukan layanan atau beban kerja yang ingin Anda daftarkan.
   3. Pilih layanan atau workload, lalu klik Pilih.
   4. Di panel Select resource, masukkan nama untuk layanan atau beban kerja, lalu klik Continue.

   5. Opsional: Di panel Tambahkan atribut, tentukan atribut tingkat teratas resource untuk mendukung penemuan dan tata kelola.

      Catatan: Anda dapat memilih nilai yang berbeda untuk tingkat kekritisan dan lingkungan layanan atau workload daripada nilai yang Anda tetapkan untuk aplikasi.

   6. Klik Lanjutkan.

   7. Opsional: Di bagian Tambahkan pemilik, tambahkan detail selengkapnya tentang pemilik layanan atau beban kerja.

   8. Klik Daftar.

Tab Layanan dan beban kerja menampilkan layanan atau beban kerja yang terdaftar.

gcloud

App Hub memungkinkan Anda memilih resource yang didukung yang berada dalam hierarki resource Anda sebagai layanan dan workload. Gunakan Google Cloud CLI untuk mencantumkan layanan atau beban kerja yang dapat Anda daftarkan ke aplikasi dari terminal atau Cloud Shell. Perintah sedikit berbeda untuk layanan dan beban kerja:

Mendaftar layanan

1. Mencantumkan layanan yang tersedia yang dapat Anda daftarkan ke aplikasi:

   gcloud apphub discovered-services list \
     --project=PROJECT_ID \
     --location=REGION \
     --filter=FILTER_EXPRESSION
   

   Untuk flag wajib dan opsional, ganti opsi berikut:

   • Wajib: PROJECT_ID: ID project host atau project pengelolaan, bergantung pada model penyiapan Anda.

   • Wajib: REGION: wilayah spesifik layanan Anda berdasarkan distribusi geografis Anda. Gunakan salah satu nilai berikut:

     • Jika layanan bersifat regional, tentukan nama region yang didukung App Hub.
     • Jika layanan bersifat global, gunakan global.

   • Opsional: FILTER_EXPRESSION: ekspresi filter untuk tanda --filter agar hanya menampilkan layanan dari project tertentu atau dengan properti tertentu, misalnya:

     • service_properties.gcp_project=projects/PROJECT_ID
     • service_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'}
   

2. Salin ID layanan, SERVICE_ID, dari output.

3. Daftarkan layanan ke aplikasi Anda:

   gcloud apphub applications services create SERVICE_NAME \
     --project=PROJECT_ID \
     --location=REGION \
     --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_EMAIL
   

   Ganti SERVICE_NAME dengan nama yang ingin Anda gunakan untuk mendaftarkan layanan ke aplikasi.

   Gunakan tanda opsional seperti --criticality-type untuk menentukan atribut tingkat teratas layanan dan mendukung penemuan dan tata kelola.

   Catatan: Anda dapat memilih nilai yang berbeda untuk tingkat kekritisan dan lingkungan layanan atau workload daripada nilai yang Anda tetapkan untuk aplikasi.

   Untuk flag wajib dan opsional, ganti opsi berikut:

   • Wajib: PROJECT_ID: ID project host atau project pengelolaan, bergantung pada model penyiapan Anda.

   • Wajib: REGION: wilayah spesifik layanan Anda berdasarkan distribusi geografis Anda. Gunakan salah satu nilai berikut:

     • Jika layanan bersifat regional, tentukan nama region yang didukung App Hub.
     • Jika layanan bersifat global, gunakan global.

   • Wajib: APPLICATION_NAME: nama aplikasi yang ingin Anda daftarkan layanannya.

   • 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_CRITICAL
     • HIGH
     • MEDIUM
     • LOW

   • Opsional: ENVIRONMENT: tahap siklus proses software. Gunakan salah satu nilai berikut:

     • PRODUCTION
     • STAGING
     • DEVELOPMENT
     • TEST

   • Opsional: DEV_NAME dan DEV_EMAIL: nama tampilan dan alamat email pemilik developer.

   • Opsional: OPERATOR_NAME dan OPERATOR_EMAIL: nama tampilan dan alamat email pemilik operator.

   • Opsional: BUSINESS_NAME dan BUSINESS_EMAIL: nama tampilan dan alamat email pemilik bisnis.

   Catatan: Alamat email harus memiliki format username@yourdomain, misalnya, [e-mail].

4. Mencantumkan layanan terdaftar di aplikasi Anda:

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

   Anda harus mendapatkan output yang mirip dengan berikut untuk setiap layanan 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

1. Mencantumkan workload yang tersedia yang dapat Anda daftarkan ke aplikasi:

   gcloud apphub discovered-workloads list \
     --project=PROJECT_ID \
     --location=REGION \
     --filter=FILTER_EXPRESSION
   

   Untuk flag wajib dan opsional, ganti opsi berikut:

   • Wajib: PROJECT_ID: ID project host atau project pengelolaan, bergantung pada model penyiapan Anda.

   • Wajib: REGION: wilayah spesifik workload Anda berdasarkan distribusi geografis Anda. Gunakan salah satu nilai berikut:

     • Jika workload bersifat regional, tentukan nama region yang didukung App Hub.
     • Jika workload bersifat global, gunakan global.

   • Opsional: FILTER_EXPRESSION: ekspresi filter untuk flag --filter agar hanya menampilkan beban kerja dari project tertentu 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'}
   

2. Salin ID beban kerja, WORKLOAD_ID, dari output.

3. Daftarkan workload ke aplikasi Anda:

   gcloud apphub applications workloads create WORKLOAD_NAME \
     --project=PROJECT_ID \
     --location=REGION \
     --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_EMAIL
   

   Ganti WORKLOAD_NAME dengan nama yang ingin Anda gunakan untuk mendaftarkan workload ke aplikasi.

   Gunakan tanda opsional seperti --criticality-type untuk menentukan atribut tingkat teratas workload dan mendukung penemuan dan tata kelola.

   Catatan: Anda dapat memilih nilai yang berbeda untuk tingkat kekritisan dan lingkungan layanan atau workload daripada nilai yang Anda tetapkan untuk aplikasi.

   Untuk flag wajib dan opsional, ganti opsi berikut:

   • Wajib: PROJECT_ID: ID project host atau project pengelolaan, bergantung pada model penyiapan Anda.

   • Wajib: REGION: wilayah spesifik workload Anda berdasarkan distribusi geografis Anda. Gunakan salah satu nilai berikut:

     • Jika workload bersifat regional, tentukan nama region yang didukung App Hub.
     • Jika workload bersifat global, gunakan global.

   • Wajib: APPLICATION_NAME: nama aplikasi yang ingin Anda daftarkan beban kerjanya.

   • Wajib: WORKLOAD_ID: ID workload yang Anda salin dari output sebelumnya.

   • Opsional: WORKLOAD_DISPLAY_NAME: nama tampilan workload Anda.

   • Opsional: CRITICALITY: tingkat kepentingan beban kerja untuk operasi Anda. Gunakan salah satu nilai berikut:

     • MISSION_CRITICAL
     • HIGH
     • MEDIUM
     • LOW

   • Opsional: ENVIRONMENT: tahap siklus proses software. Gunakan salah satu nilai berikut:

     • PRODUCTION
     • STAGING
     • DEVELOPMENT
     • TEST

   • Opsional: DEV_NAME dan DEV_EMAIL: nama tampilan dan alamat email pemilik developer.

   • Opsional: OPERATOR_NAME dan OPERATOR_EMAIL: nama tampilan dan alamat email pemilik operator.

   • Opsional: BUSINESS_NAME dan BUSINESS_EMAIL: nama tampilan dan alamat email pemilik bisnis.

   Catatan: Alamat email harus memiliki format username@yourdomain, misalnya, [e-mail].

4. Mencantumkan workload terdaftar di aplikasi Anda:

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

   Anda harus mendapatkan output yang mirip dengan berikut untuk setiap workload 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
   

Memberikan izin dan memulai operasi

Setelah membuat aplikasi dan mendaftarkan resource di App Hub, Anda memberikan akses pengguna berdasarkan tanggung jawab dan mengelola pengelompokan logika ini sebagai satu unit:

1. Bergantung pada kebutuhan akses Anda, Anda dapat memberikan izin ke aplikasi Anda. Untuk mengetahui daftar peran yang direkomendasikan, lihat Memberikan peran yang berfokus pada aplikasi kepada pengguna Anda.
2. Buka Cloud Hub untuk melihat dasbor operasional terpadu untuk aplikasi yang Anda tentukan, termasuk data kesehatan, performa, dan biayanya.