Mengelola aplikasi App Hub

Saat Anda memilih model penyiapan aplikasi, Anda akan menentukan batas pengelolaan aplikasi untuk aplikasi App Hub di project pengelolaan. Kemudian, Anda dapat mendaftarkan layanan dan workload di aplikasi dalam batas ini.

Untuk mengetahui kasus penggunaan yang direkomendasikan untuk 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 informasi 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 mengupdate setelan seperti detail aplikasi dan komponen.

    Buka Application Design Center

  • Untuk aplikasi yang dibuat dengan mendaftarkan resource yang ada di App Hub: Kelola aplikasi, layanan, dan workload langsung di App Hub.

    Buka App Hub

Halaman ini menjelaskan cara mengelola aplikasi yang didaftarkan langsung di App Hub. Anda dapat melakukan tindakan ini menggunakan konsol atau Google Cloud CLI.Google Cloud Untuk aplikasi yang di-deploy dari a template, lihat dokumentasi Application Design Center.

Sebelum memulai

Dokumen ini mengasumsikan bahwa Anda memiliki aplikasi dengan resource yang didukung dan 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 :

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.

Mencantumkan aplikasi

Ikuti langkah-langkah berikut untuk mencantumkan dan memfilter semua aplikasi dalam batas pengelolaan aplikasi Anda:

Konsol

  1. Di Google Cloud konsol, gunakan pemilih project untuk memilih project pengelolaan Anda.

  2. Buka halaman Applications dari App Hub:

    Buka Applications

    Halaman ini menampilkan daftar aplikasi Anda.

  3. Untuk memfilter daftar, gunakan kolom Filter. Anda dapat memfilter berdasarkan atribut seperti Criticality atau Environment.

gcloud

  1. Temukan project ID project pengelolaan Anda.

  2. Tampilkan daftar aplikasi Anda menggunakan salah satu opsi berikut:

    • Mencantumkan semua aplikasi:

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

      Ganti kode berikut:

      • PROJECT_ID: ID project pengelolaan Anda.
      • LOCATION: lokasi aplikasi Anda. Gunakan global untuk aplikasi global atau region tertentu, seperti us-east1, untuk aplikasi regional.
    • Filter daftar aplikasi berdasarkan atribut, menggunakan the --filter flag:

      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. Gunakan global untuk aplikasi global atau region tertentu, seperti us-east1, untuk aplikasi regional.
      • FILTER_EXPRESSION: ekspresi filter untuk menentukan atribut. Misalnya, untuk mencantumkan semua aplikasi dengan jenis lingkungan PRODUCTION, gunakan attributes.environment.type=PRODUCTION.

Melihat detail aplikasi

Ikuti langkah-langkah berikut untuk melihat informasi mendetail tentang aplikasi tertentu, termasuk atribut dan metadatanya:

Konsol

  1. Di Google Cloud konsol, gunakan pemilih project untuk memilih project pengelolaan Anda.

  2. Buka halaman Applications dari App Hub:

    Buka Applications

    Halaman ini menampilkan daftar aplikasi Anda.

  3. Klik nama aplikasi yang ingin Anda lihat.

    Tab Details aplikasi akan ditampilkan.

gcloud

  1. Temukan project ID project pengelolaan Anda.

  2. Deskripsikan aplikasi:

    gcloud apphub applications describe APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION
    

    Ganti kode berikut:

    • APPLICATION_NAME: nama aplikasi Anda. Anda menentukan nilai ini saat membuat aplikasi.
    • PROJECT_ID: ID project pengelolaan Anda.
    • LOCATION: lokasi aplikasi Anda. Gunakan global untuk aplikasi global atau region tertentu, seperti us-east1, untuk aplikasi regional.

Mengupdate atribut aplikasi

Untuk mengubah atribut dari aplikasi setelah dibuat, ikuti langkah-langkah berikut. Layanan dan workload juga dapat menggunakan atribut aplikasi yang sama selama pendaftaran.

Konsol

  1. Di Google Cloud konsol, gunakan pemilih project untuk memilih project pengelolaan Anda.

  2. Buka halaman Applications dari App Hub:

    Buka Applications

    Halaman ini menampilkan daftar aplikasi Anda.

  3. Untuk aplikasi yang ingin Anda update, klik Edit.

  4. Di panel Edit application, ubah kolom sesuai kebutuhan.

  5. Klik Save.

gcloud

  1. Temukan project ID project pengelolaan Anda.

  2. Update atribut aplikasi. Anda dapat mengupdate 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_EMAIL
    

    Ganti 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. Gunakan global untuk aplikasi global atau region tertentu, seperti us-east1, untuk aplikasi regional.
    • Opsional: DISPLAY_NAME: nama tampilan aplikasi Anda.
    • Opsional: CRITICALITY_LEVEL: tingkat kepentingan aplikasi. 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.

Terraform

Untuk mengupdate atribut aplikasi dengan Terraform, ubah argumen dalam blok google_apphub_application resource di file konfigurasi Anda. Saat Anda menerapkan perubahan, Terraform akan mengupdate aplikasi agar sesuai dengan konfigurasi baru.

Contoh berikut mengupdate atribut criticality dan environment 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 terlebih dahulu membatalkan pendaftaran semua layanan dan workload-nya. Kemudian, ikuti langkah-langkah berikut untuk menghapus aplikasi:

Konsol

  1. Di Google Cloud konsol, gunakan pemilih project untuk memilih project pengelolaan Anda.

  2. Buka halaman Applications dari App Hub:

    Buka Applications

    Halaman ini menampilkan daftar aplikasi Anda.

  3. Klik nama aplikasi yang ingin Anda hapus.

  4. Buka tab Services and workloads dan pastikan Anda telah membatalkan pendaftaran semua komponen aplikasi. Untuk mengetahui informasi selengkapnya, lihat Membatalkan pendaftaran layanan dan workload.

  5. Setelah semua layanan dan workload dibatalkan pendaftarannya, kembali ke detail aplikasi dan klik Delete.

gcloud

  1. Temukan project ID project pengelolaan Anda.

  2. Pastikan Anda telah membatalkan pendaftaran semua komponen aplikasi. Untuk mengetahui informasi selengkapnya, lihat Membatalkan pendaftaran layanan dan workload.

  3. Setelah aplikasi tidak memiliki komponen terdaftar, hapus aplikasi:

    gcloud apphub applications delete APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION
    

    Ganti kode berikut:

    • APPLICATION_NAME: nama aplikasi Anda. Anda menentukan nilai ini saat membuat aplikasi.
    • PROJECT_ID: ID project pengelolaan Anda.
    • LOCATION: lokasi aplikasi Anda. Gunakan global untuk aplikasi global atau region tertentu, seperti us-east1, untuk aplikasi regional.

Terraform

Untuk menghapus aplikasi yang dikelola oleh Terraform, Anda memiliki opsi berikut:

  • Menghapus resource dari konfigurasi: Hapus blok resource google_apphub_application dari file Terraform Anda, lalu jalankan terraform apply. Terraform akan mengenali bahwa resource tidak lagi ada dalam konfigurasi dan menghapusnya dari project Anda.
  • Menghentikan semua resource: Jalankan perintah terraform destroy untuk menghentikan semua resource yang dikelola oleh konfigurasi Terraform Anda, termasuk aplikasi.

Langkah berikutnya