Mengubah resource App Hub di folder yang mengaktifkan aplikasi

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

Prasyarat

Sebelum mengubah resource App Hub, selesaikan tugas berikut:

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

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna Mengubah resource App Hub, minta administrator untuk memberi Anda peran IAM berikut pada folder yang mengaktifkan 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: App Hub Viewer (roles/apphub.viewer)
  • Untuk melihat aplikasi, layanan, dan beban kerja, serta atributnya di seluruh Google Cloud layanan yang mendukung pengelolaan aplikasi: App Hub Management Viewer (roles/apphub.appManagementViewer)

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 mengaktifkan aplikasi.

Konsol

  1. Untuk melihat aplikasi dalam folder yang mengaktifkan aplikasi, di konsol Google Cloud, buka halaman Aplikasi App Hub.

    Buka Applications

    Anda akan melihat daftar aplikasi.

  2. Untuk memfilter aplikasi:

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

gcloud

  1. Untuk melihat aplikasi di folder yang mengaktifkan aplikasi:

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

    Ganti kode berikut:

    • MANAGEMENT_PROJECT_ID: ID project manajemen Anda. Anda dapat menemukan project ID pengelolaan di halaman Settings Identity and Access Management (IAM) & Admin di konsol Google Cloud. Jika tidak dapat menemukan project ID Pengelolaan, Anda mungkin tidak berada di folder yang mengaktifkan aplikasi. Dari pemilih cakupan (atau pemilih project), pilih folder yang mengaktifkan aplikasi. Untuk 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 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 mengaktifkan aplikasi.

Konsol

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

    Buka Applications

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

  3. Klik tab Details 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 dalam huruf kecil tanpa spasi.

Mengupdate aplikasi App Hub

Anda dapat memperbarui atribut aplikasi setelah aplikasi dibuat.

Konsol

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

    Buka Applications

  2. Dari daftar aplikasi, klik Edit untuk aplikasi yang ingin diperbarui.

  3. Edit kolom sesuai kebutuhan.

  4. Klik Simpan.

gcloud

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

    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 berisi karakter alfanumerik dalam huruf kecil tanpa spasi.
    • REGION: region aplikasi.

    Anda dapat memperbarui salah satu dari hal berikut:

    • APPLICATION_DISPLAY_NAME: menunjukkan nama tampilan aplikasi.
    • CRITICALITY_LEVEL: menunjukkan seberapa penting aplikasi, layanan, atau beban kerja 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: masing-masing 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 beban kerja dalam aplikasi.

Konsol

  1. Untuk mencantumkan layanan dan beban kerja:

    1. Di konsol Google Cloud, buka halaman Layanan dan Workload App Hub.

      Buka Layanan dan Workload

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

  2. Untuk memfilter layanan atau beban kerja:

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

gcloud

Mencantumkan layanan yang ditemukan

Layanan yang ditemukan tersedia untuk 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 mengaktifkan 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

    Layanan yang terdaftar, tetapi terpisah ditunjukkan dengan nilai kosong di kolom SERVICE_REFERENCE.

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

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

Mencantumkan beban kerja yang ditemukan

Workload yang ditemukan tersedia untuk 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 menyertakan 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: Filter daftar workload yang ditemukan. Misalnya, untuk memfilter daftar beban kerja yang ditemukan dengan resource komputasi di folder yang mengaktifkan aplikasi:

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

Mencantumkan beban kerja 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 terpisah 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 beban kerja di aplikasi dengan atribut environment-type 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 beban kerja

Anda dapat memperbarui layanan dan beban kerja yang terdaftar ke aplikasi.

Konsol

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

    Buka Applications

  2. Klik nama aplikasi Anda.
    Tab Layanan dan beban kerja ditampilkan dengan daftar layanan dan beban kerja terdaftar yang ada di project layanan Anda.

  3. Untuk setiap layanan atau beban kerja yang ingin Anda perbarui, lakukan hal berikut:

    1. Pada tab Layanan dan beban kerja, untuk layanan atau beban kerja yang ingin Anda perbarui, klik more_vert, lalu klik Edit layanan atau Edit beban kerja.
    2. Di panel Edit service atau Edit workload, edit kolom sesuai yang diperlukan, lalu klik Save.

gcloud

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

    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 dari hal berikut:

    • SERVICE_DISPLAY_NAME: menunjukkan nama tampilan untuk layanan.
    • CRITICALITY_LEVEL: menunjukkan seberapa penting aplikasi, layanan, atau beban kerja 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: masing-masing 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 beban kerja Anda dengan atribut jenis pemilik, criticality-type, dan environment-type:

    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 beban kerja App Hub.

    Anda dapat memperbarui salah satu dari hal berikut:

    • WORKLOAD_DISPLAY_NAME: menunjukkan nama tampilan untuk layanan.
    • CRITICALITY_LEVEL: menunjukkan seberapa penting aplikasi, layanan, atau beban kerja 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: masing-masing 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 beban kerja

Hapus aplikasi yang ada untuk menghapus resource terdaftar yang terkait dengan folder yang mengaktifkan 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 Aplikasi App Hub.

    Buka Applications

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

  3. Batalkan pendaftaran layanan atau beban kerja.

    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 beban kerja terdaftar yang terbuka, klik Batalkan pendaftaran untuk memperbarui layanan atau beban kerja sebagai resource Ditemukan. Di tab Layanan dan beban kerja, pemberitahuan akan memberi tahu bahwa beban kerja tidak terdaftar.
    3. Ulangi petunjuk ini untuk setiap layanan dan beban kerja.

  4. Buka halaman Aplikasi App Hub.

    Buka Applications

  5. Klik nama aplikasi.

  6. Di halaman yang berisi detail aplikasi, klik Hapus.

gcloud

  1. Cantumkan 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 kini menjadi layanan yang ditemukan yang dapat didaftarkan ke aplikasi.

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

  4. Cantumkan workload yang terdaftar di aplikasi:

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

  5. Batalkan 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