Mengelola aplikasi App Hub

Saat memilih model penyiapan aplikasi, Anda menentukan batas pengelolaan aplikasi untuk aplikasi App Hub di project pengelolaan. Kemudian, Anda dapat mendaftarkan layanan dan workload di aplikasi dalam batas ini. Untuk kasus penggunaan yang direkomendasikan dalam memperkenalkan praktik pengelolaan aplikasi, lihat Mempersiapkan pengelolaan siklus proses aplikasi.

Untuk menghindari penyimpangan konfigurasi dan mempertahankan sumber tepercaya yang jelas, sebaiknya Anda mengelola komponen aplikasi di lingkungan tempat komponen tersebut ditentukan awalnya:

  • Untuk aplikasi yang di-deploy dari template Application Design Center: Gunakan Application Design Center untuk mengelola dan memperbarui aplikasi. Anda dapat merevisi template untuk perubahan desain aplikasi atau membuat revisi aplikasi untuk memperbarui 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 Hub Aplikasi

Halaman ini menjelaskan cara mengelola aplikasi yang didaftarkan langsung dalam 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 dan terdaftar di dalamnya.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengelola aplikasi di App Hub, minta administrator untuk memberi Anda peran IAM berikut pada project pengelolaan yang menentukan batas pengelolaan aplikasi Anda :

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 konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.

  2. Buka halaman Aplikasi dari App Hub:

    Buka Applications

    Halaman ini menampilkan daftar aplikasi Anda.

  3. Untuk memfilter daftar, gunakan kolom Filter. Anda dapat memfilter menurut atribut seperti Kekritisan atau Lingkungan.

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 wilayah tertentu, seperti us-east1, untuk aplikasi regional.
    • Memfilter 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. 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 aplikasi tertentu, termasuk atribut dan metadatanya:

Konsol

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

  2. Buka halaman Aplikasi dari App Hub:

    Buka Applications

    Halaman ini menampilkan daftar aplikasi Anda.

  3. Klik nama aplikasi yang ingin Anda lihat.

    Tab Detail aplikasi akan ditampilkan.

gcloud

  1. Temukan project ID project pengelolaan Anda.

  2. Mendeskripsikan 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.

Memperbarui atribut aplikasi

Untuk mengubah atribut aplikasi setelah dibuat, ikuti langkah-langkah berikut:

Konsol

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

  2. Buka halaman Aplikasi dari App Hub:

    Buka Applications

    Halaman ini menampilkan daftar aplikasi Anda.

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

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

  5. Klik Simpan.

gcloud

  1. Temukan project ID project pengelolaan Anda.

  2. Perbarui 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_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 memperbarui atribut aplikasi dengan Terraform, ubah argumen dalam blok resource google_apphub_application dalam file konfigurasi Anda. Saat Anda menerapkan perubahan, Terraform akan memperbarui aplikasi agar sesuai dengan konfigurasi baru.

Contoh berikut mengupdate atribut tingkat kepentingan 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 beban kerjanya terlebih dahulu. Kemudian, ikuti langkah-langkah berikut untuk menghapus aplikasi:

Konsol

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

  2. Buka halaman Aplikasi 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 beban kerja dibatalkan pendaftarannya, kembali ke detail aplikasi, lalu klik Hapus.

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:

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

Langkah berikutnya