Mengubah resource App Hub

Anda dapat mencantumkan, melihat, memperbarui, dan menghapus resource App Hub di folder yang mendukung aplikasi menggunakan Google Cloud konsol atau Google Cloud CLI di terminal atau Cloud Shell.

Prasyarat

Sebelum Anda mengubah resource App Hub, selesaikan tugas berikut:

  1. Ikuti prasyarat untuk menyiapkan App Hub.
  2. Bergantung pada jenis resource yang ingin Anda ubah, pastikan Anda telah menjalankan langkah-langkah untuk menyiapkan App Hub. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan App Hub.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk Mengubah resource App Hub, minta administrator Anda untuk memberi Anda peran IAM berikut pada folder yang mendukung aplikasi:

  • Untuk membuat dan memperbarui aplikasi, mendaftarkan dan membatalkan pendaftaran layanan dan workload, serta memperbarui atribut terkait:
  • Untuk melihat aplikasi, layanan, dan beban kerja, serta atributnya: Pelihat App Hub (roles/apphub.viewer)
  • Untuk melihat data tingkat aplikasi dan tingkat project di Cloud Hub: Operator Cloud Hub (roles/cloudhub.operator)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Mencantumkan aplikasi

Anda dapat mencantumkan dan memfilter aplikasi di folder yang mendukung aplikasi.

Konsol

  1. Untuk melihat aplikasi di folder yang mendukung aplikasi, di konsol Google Cloud , buka halaman App Hub Applications.

    Buka Aplikasi

    Anda akan melihat daftar aplikasi.

  2. Untuk memfilter aplikasi:

    1. Di kolom Filter, pilih filter seperti Kekritisan.
    2. Tentukan nilai untuk filter. Misalnya, untuk menampilkan aplikasi dengan tingkat kekritisan tinggi, pilih Tinggi sebagai nilai.
      Daftar aplikasi yang cocok dengan filter yang ditentukan akan muncul.

gcloud

  1. Untuk melihat aplikasi di folder khusus aplikasi:

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

    Ganti kode berikut:

    • MANAGEMENT_PROJECT_ID: ID project pengelolaan Anda. Anda dapat menemukan project ID pengelolaan di halaman Identity and Access Management (IAM) & Admin Settings di konsol Google Cloud . Jika Anda tidak dapat menemukan ID project Pengelolaan, Anda mungkin tidak berada di folder yang mendukung aplikasi. Dari pemilih cakupan (atau pemilih project), pilih folder yang mendukung aplikasi. Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan folder untuk pengelolaan aplikasi, lihat Mengaktifkan pengelolaan aplikasi.
    • REGION: region aplikasi. Bergantung pada --scope-type aplikasi, berikan nilai global atau wilayah aplikasi, misalnya us-east1. Untuk mengetahui informasi selengkapnya tentang cara menetapkan --scope-type untuk aplikasi, lihat Membuat aplikasi.

  2. Untuk memfilter aplikasi berdasarkan atribut variabel, gunakan flag --filter. Misalnya, untuk mencantumkan semua aplikasi yang atribut environment-type-nya ditetapkan ke PRODUCTION:

    gcloud apphub applications list \
    --filter='attributes.environment.type=PRODUCTION' \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

Melihat aplikasi

Anda dapat mendeskripsikan aplikasi di folder yang mendukung aplikasi.

Konsol

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

    Buka Aplikasi

  2. Dari daftar aplikasi, klik aplikasi yang detailnya ingin Anda ketahui.

  3. Klik tab Detail untuk menampilkan detail aplikasi.

gcloud

gcloud apphub applications describe APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

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

Memperbarui aplikasi App Hub

Anda dapat memperbarui atribut aplikasi setelah aplikasi dibuat.

Konsol

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

    Buka Aplikasi

  2. Dari daftar aplikasi, klik Edit untuk aplikasi yang ingin Anda perbarui.

  3. Edit kolom sesuai kebutuhan.

  4. Klik Simpan.

gcloud

  1. Perbarui aplikasi Anda dengan atribut criticality-type, environment-type, dan 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=MANAGEMENT_PROJECT_ID \
    --location=REGION

    Ganti kode berikut:

    • APPLICATION_NAME: nama aplikasi Anda. Nama hanya boleh menyertakan karakter alfanumerik huruf kecil tanpa spasi.
    • REGION: region aplikasi.

    Anda dapat memperbarui salah satu hal berikut:

    • APPLICATION_DISPLAY_NAME: menunjukkan nama tampilan aplikasi.
    • CRITICALITY_LEVEL: menunjukkan seberapa penting aplikasi, layanan, atau workload 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: 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, 222larabrown@gmail.com.

    Contoh:

    gcloud apphub applications update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1

Melihat layanan dan beban kerja

Anda dapat melihat, mencantumkan, dan memfilter layanan dan workload dalam aplikasi.

Konsol

  1. Untuk mencantumkan layanan dan workload:

    1. Di konsol Google Cloud , buka halaman App Hub Services and Workloads.

      Buka Services and Workloads

    2. Di daftar Region, pilih region tempat Anda ingin melihat layanan dan workload. Misalnya, pilih us-east1.
      Halaman Services and Workloads menampilkan semua layanan dan workload dari project layanan terlampir yang terkait dengan us-east1.

  2. Untuk memfilter layanan atau workload:

    1. Di kolom Filter, pilih filter seperti Environment.
    2. Tentukan nilai untuk filter. Misalnya, untuk melihat layanan dan workload dalam produksi, pilih Produksi sebagai nilai.
      Daftar layanan dan workload yang cocok dengan filter yang ditentukan akan muncul.

gcloud

Mencantumkan layanan yang ditemukan

Layanan yang ditemukan dapat didaftarkan ke aplikasi.

  1. Untuk mencantumkan layanan yang ditemukan:

    gcloud apphub discovered-services list \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    Anda akan melihat output yang mirip dengan berikut ini:

    ID                      SERVICE_REFERENCE                                                                                                                   SERVICE_PROPERTIES
[DISCOVERED_SERVICE_ID] {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}

  2. Opsional: Memfilter daftar layanan yang ditemukan. Misalnya, untuk memfilter layanan yang ditemukan dengan aturan penerusan di folder yang mendukung aplikasi:

    gcloud apphub discovered-services list \
    --filter='service_reference.uri~"forwardingRules"' \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

Mencantumkan layanan terdaftar

Mencantumkan dan memfilter layanan App Hub terdaftar dari aplikasi.

  1. Untuk mencantumkan layanan terdaftar dalam aplikasi:

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

    Anda akan melihat output yang mirip dengan berikut ini:

    ID             DISPLAY_NAME            SERVICE_REFERENCE                                                                                                                CREATE_TIME
SERVICE_NAME   mywebserver-service1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule'}   2023-11-01T21:38:08

    Terdaftar, tetapi layanan yang dilepas ditandai dengan nilai kosong di kolom SERVICE_REFERENCE.

  2. Opsional: Memfilter daftar layanan terdaftar. Misalnya, untuk memfilter layanan terdaftar dalam aplikasi yang atribut environment-type-nya ditetapkan ke PRODUCTION:

    gcloud apphub applications services list \
    --filter='attributes.environment.type=PRODUCTION' \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

Mencantumkan workload yang ditemukan

Workload yang ditemukan dapat didaftarkan ke aplikasi.

  1. Untuk mencantumkan workload yang ditemukan:

    gcloud apphub discovered-workloads list \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    Anda akan melihat output yang mirip dengan berikut ini, yang mencakup MIG yang tidak terdaftar:

    ID                        WORKLOAD_REFERENCE                                                                                                   WORKLOAD_PROPERTIES
[DISCOVERED_WORKLOAD_ID]  {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}

  2. Opsional: Memfilter daftar workload yang ditemukan. Misalnya, untuk memfilter daftar beban kerja yang ditemukan dengan resource komputasi di folder yang mendukung aplikasi:

    gcloud apphub discovered-workloads list \
    --filter='workload_reference.uri~"compute"'
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

Mencantumkan workload terdaftar

Mencantumkan dan memfilter beban kerja App Hub terdaftar dari aplikasi.

  1. Untuk mencantumkan workload terdaftar dalam aplikasi:

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

    Anda akan melihat output yang mirip dengan berikut ini:

    ID               DISPLAY_NAME               WORKLOAD_REFERENCE                                                                                                     CREATE_TIME
WORKLOAD_NAME    mywebserver-deployment1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    2023-10-31T18:34:23

    Workload yang terdaftar, tetapi tidak terlampir ditandai dengan nilai kosong di kolom WORKLOAD_REFERENCE. Untuk mengetahui informasi selengkapnya tentang status pendaftaran, lihat properti dan atribut App Hub.

  2. Opsional: Filter daftar beban kerja terdaftar. Misalnya, untuk memfilter workload dalam aplikasi dengan atribut environment-type yang ditetapkan ke PRODUCTION:

    gcloud apphub applications workloads list \
    --filter='attributes.environment.type=PRODUCTION' \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

Memperbarui layanan dan workload

Anda dapat memperbarui layanan dan workload yang terdaftar ke aplikasi.

Konsol

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

    Buka Aplikasi

  2. Klik nama aplikasi Anda.
    Tab Services and workloads ditampilkan dengan daftar layanan dan workload terdaftar yang ada di project layanan Anda.

  3. Untuk setiap layanan atau workload yang ingin Anda update, lakukan hal berikut:

    1. Di tab Services and workloads, untuk layanan atau workload yang ingin Anda perbarui, klik more_vert, lalu klik Edit service atau Edit workload.
    2. Di panel Edit layanan atau Edit beban kerja, edit kolom sesuai kebutuhan, lalu klik Simpan.

gcloud

  1. Perbarui layanan Anda dengan atribut criticality-type, environment-type, dan jenis pemilik:

    gcloud apphub applications services update SERVICE_NAME \
    --application=APPLICATION_NAME \
    --display-name='SERVICE_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=MANAGEMENT_PROJECT_ID \
    --location=REGION

    Ganti SERVICE_NAME dengan nama layanan App Hub.

    Anda dapat memperbarui salah satu hal berikut:

    • SERVICE_DISPLAY_NAME: menunjukkan nama tampilan untuk layanan.
    • CRITICALITY_LEVEL: menunjukkan seberapa penting aplikasi, layanan, atau workload 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: 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, 222larabrown@gmail.com.

    Contoh:

    gcloud apphub applications workloads update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1

  2. Perbarui workload Anda dengan atribut criticality-type, environment-type, dan jenis pemilik:

    gcloud apphub applications workloads update WORKLOAD_NAME \
    --application=APPLICATION_NAME \
    --display-name='WORKLOAD_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=MANAGEMENT_PROJECT_ID \
    --location=REGION

    Ganti WORKLOAD_NAME dengan nama workload App Hub.

    Anda dapat memperbarui salah satu hal berikut:

    • WORKLOAD_DISPLAY_NAME: menunjukkan nama tampilan untuk layanan.
    • CRITICALITY_LEVEL: menunjukkan seberapa penting aplikasi, layanan, atau workload 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: 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, 222larabrown@gmail.com.

    Contoh:

    gcloud apphub applications workloads update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1

Menghapus aplikasi, layanan, dan workload

Hapus aplikasi yang ada untuk menghapus resource terdaftar yang terkait dengan folder yang mendukung aplikasi. Untuk melakukannya, Anda harus membatalkan pendaftaran beban kerja dan layanan yang terdaftar ke aplikasi terlebih dahulu.

Konsol

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

    Buka Aplikasi

  2. Klik nama aplikasi. Daftar layanan dan beban kerja yang terdaftar ke aplikasi akan muncul.

  3. Membatalkan pendaftaran layanan atau workload.

    1. Di tab Layanan dan beban kerja, dari bagian Layanan dan beban kerja terdaftar, klik nama layanan atau beban kerja yang ingin Anda batalkan pendaftarannya.
    2. Di halaman untuk layanan atau workload terdaftar yang terbuka, klik Batalkan pendaftaran untuk memperbarui layanan atau workload sebagai resource Ditemukan. Di tab Layanan dan beban kerja, pemberitahuan akan muncul bahwa beban kerja tidak terdaftar.
    3. Ulangi petunjuk ini untuk setiap layanan dan workload.

  4. Buka halaman Aplikasi di Hub Aplikasi.

    Buka Aplikasi

  5. Klik nama aplikasi.

  6. Di halaman dengan detail aplikasi, klik Hapus.

gcloud

  1. Mencantumkan layanan terdaftar di aplikasi:

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

  2. Batalkan pendaftaran layanan dari aplikasi:

    gcloud apphub applications services delete SERVICE_NAME \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    Layanan ini sekarang menjadi layanan yang ditemukan dan dapat didaftarkan ke aplikasi.

  3. Ulangi perintah sebelumnya untuk membatalkan pendaftaran layanan terdaftar yang tersisa dari aplikasi.

  4. Mencantumkan workload terdaftar di aplikasi:

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

  5. Membatalkan pendaftaran workload dari aplikasi:

    gcloud apphub applications workloads delete WORKLOAD_NAME \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    Workload kini menjadi workload yang ditemukan dan dapat didaftarkan ke aplikasi.

  6. Ulangi perintah sebelumnya untuk menghapus beban kerja terdaftar yang tersisa dari aplikasi.

  7. Hapus aplikasi:

    gcloud apphub applications delete APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

Langkah berikutnya