Halaman ini diterjemahkan oleh Cloud Translation API.

Mendaftarkan resource yang ada ke aplikasi

Mendaftarkan resource Google Cloud yang ada sebagai layanan dan workload di aplikasi App Hub memungkinkan Anda 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 resource Google Cloud yang sudah ada 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. Pilih model penyiapan aplikasi Anda. Anda harus mengonfigurasi project pengelolaan dan menentukan batas pengelolaan aplikasi yang mencakup Google Cloud resource yang ingin Anda atur.
2. Aktifkan API yang diperlukan untuk semua Google Cloud 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 project pengelolaan di konsol Google Cloud atau temukan project ID project pengelolaan untuk interaksi Terraform atau Google Cloud CLI.

Membuat aplikasi

Buat aplikasi di App Hub untuk bertindak sebagai penampung logis bagi resource Google Cloud yang ada:

Konsol

Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.
Buka halaman Aplikasi dari Hub Aplikasi:

Buka Applications
Klik Create application.
Di tab Detail aplikasi, pilih lokasi terbaik untuk aplikasi Anda berdasarkan persyaratan distribusi geografis Anda:
- Pilih Global untuk membuat aplikasi global.
- Pilih Regional untuk membuat aplikasi regional. Kemudian, pilih region tertentu untuk aplikasi Anda berdasarkan wilayah yang didukung App Hub.
Untuk mengetahui informasi selengkapnya tentang lokasi terbaik untuk aplikasi Anda, lihat Aplikasi global dan regional.

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

Nama ini adalah ID unik yang hanya dapat berisi huruf kecil, angka, atau tanda hubung. Anda tidak dapat mengubah nama ini setelah Anda membuat aplikasi.
Secara opsional, tambahkan nama tampilan dan deskripsi untuk aplikasi.

Ini bukan ID unik, dan Anda dapat mengubahnya setelah membuat aplikasi.
Klik Lanjutkan.
Di tab Application resources, jelajahi resource infrastruktur dan centang kotak resource yang ingin Anda daftarkan sebagai layanan dan beban kerja aplikasi.

Anda dapat memilih hingga 10 referensi sekaligus.
Klik Lanjutkan.
Di tab Atribut dan pemilik, Anda dapat menambahkan atribut untuk aplikasi, seperti kekritisan, lingkungan, dan pemilik aplikasi.

Anda dapat memilih untuk menggunakan atribut dan pemilik yang sama untuk resource yang Anda daftarkan ke aplikasi atau menentukannya nanti.

Catatan: Jika Anda mendaftarkan layanan bersama yang sedang digunakan oleh aplikasi lain, atribut dan informasi pemilik dari aplikasi baru tidak diterapkan padanya karena layanan bersama tidak memiliki atribut.
Klik Create.

Saat aplikasi dibuat, halaman Aplikasi akan menampilkan detailnya, termasuk resource yang Anda daftarkan sebagai layanan dan beban kerja. Setelah membuat aplikasi, Anda dapat mendaftarkan lebih banyak layanan dan workload ke aplikasi tersebut.

gcloud

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 ini adalah ID unik yang hanya dapat berisi huruf kecil, angka, atau tanda hubung.

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 pengelolaan.
- 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. Nama tampilan bukan ID unik dan Anda dapat mengubahnya setelah membuat aplikasi.
- 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, [email protected].

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

Terraform

Untuk membuat aplikasi dengan Terraform, gunakan resource google_apphub_application. Resource ini memungkinkan Anda menentukan properti aplikasi, termasuk nama, lokasi, dan atributnya.

Contoh berikut membuat aplikasi regional di us-central1 dengan atribut yang ditentukan untuk tingkat kekritisan, lingkungan, dan pemilik:

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."
    scope {
        type = "REGIONAL"
    }
    attributes {
        criticality {
            type = "MISSION_CRITICAL"
        }
        environment {
            type = "PRODUCTION"
        }
        business_owners {
            display_name = "Alice"
            email        = "[email protected]"
        }
        developer_owners {
            display_name = "Bob"
            email        = "[email protected]"
        }
        operator_owners {
            display_name = "Charlie"
            email        = "[email protected]"
        }
    }
}

Mendaftarkan layanan dan workload

App Hub memungkinkan Anda memilih resource yang didukung yang berada dalam batas pengelolaan aplikasi untuk mendaftarkannya sebagai layanan dan workload. Setelah membuat aplikasi, Anda dapat mendaftarkan Google Cloud resource sebagai layanan dan workload di dalamnya.

Anda hanya dapat mendaftarkan layanan eksklusif ke satu aplikasi. Namun, layanan bersama dapat didaftarkan ke lebih dari satu aplikasi. Hub Aplikasi akan menemukan layanan bersama saat Anda mendaftarkannya ke aplikasi meskipun layanan tersebut sudah terdaftar ke aplikasi lain, tetapi Anda mungkin tidak dapat mengubah atributnya.

Konsol

Setelah membuat aplikasi, Anda dapat mendaftarkan beberapa resource ke aplikasi tersebut:

Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan Anda.
Buka halaman Aplikasi dari Hub Aplikasi:

Buka Applications
Klik nama aplikasi yang ingin Anda daftarkan Google Cloud resourcenya.
Dari halaman aplikasi, pilih tab Layanan dan beban kerja.
Klik Daftarkan layanan atau beban kerja.
Di tab Services and workloads, jelajahi resource infrastruktur dan centang kotak resource yang ingin Anda daftarkan sebagai layanan atau workload aplikasi.

Anda dapat memilih hingga 10 referensi sekaligus.
Klik Lanjutkan.
Di tab Atribut dan pemilik, Anda dapat menambahkan atribut untuk resource ini, seperti tingkat kekritisan, lingkungan, dan pemilik resource.

Anda dapat memilih untuk menggunakan atribut dan pemilik yang sama dari aplikasi atau menentukan atribut yang berbeda nanti.

Catatan: Saat Anda memilih layanan bersama untuk pendaftaran, atribut dan informasi pemilik dari aplikasi tidak diterapkan karena layanan bersama tidak memiliki atribut.
Klik Daftar.

Tab Layanan dan beban kerja menampilkan semua layanan dan beban kerja aplikasi yang terdaftar.

gcloud

App Hub memungkinkan Anda memilih resource yang didukung yang berada dalam batas pengelolaan aplikasi Anda sebagai layanan atau 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

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 pengelolaan.
- 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 flag --filter agar hanya menampilkan layanan dari project tertentu dalam batas pengelolaan aplikasi 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'}
```
Salin ID layanan, SERVICE_ID, dari output.
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 pengelolaan.
- 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, [email protected].

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

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 pengelolaan.
- 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 tanda --filter agar hanya menampilkan beban kerja dari project tertentu dalam batas pengelolaan aplikasi 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'}
```
Salin ID beban kerja, WORKLOAD_ID, dari output.
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 beban kerja 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 pengelolaan.
- 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, [email protected].

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

Terraform

Untuk menggunakan Terraform guna mendaftarkan resource Google Cloud dalam batas pengelolaan aplikasi Anda sebagai layanan atau beban kerja dalam aplikasi, gunakan sumber data google_apphub_discovered_service dan google_apphub_discovered_workload untuk mengambil informasi secara dinamis tentang resource yang ingin Anda daftarkan.

Kemudian, gunakan resource google_apphub_service atau google_apphub_workload untuk mendaftarkan layanan atau workload.

Mendaftar layanan

Mendapatkan informasi tentang layanan menggunakan URI-nya:

data "google_apphub_discovered_service" "my-service" {
    location = "REGION"
    service_uri = "SERVICE_URI"
}

Daftarkan layanan yang ditemukan ke aplikasi Anda, misalnya:

resource "google_apphub_service" "example" {
    project            = "my-project-id"
    location           = "us-central1"
    application_id     = google_apphub_application.example.application_id
    service_id         = "frontend-load-balancer"
    discovered_service = data.google_apphub_discovered_service.my-forwarding-rule.name
    display_name       = "Frontend Load Balancer"
    description        = "The primary load balancer for the frontend."
}

Mendaftarkan workload

Mendapatkan informasi tentang workload menggunakan URI-nya:

data "google_apphub_discovered_workload" "my-workload" {
    location = "REGION"
    workload_uri = "WORKLOAD_URI"
}

Daftarkan workload yang ditemukan ke aplikasi Anda, misalnya:

resource "google_apphub_workload" "example" {
    project             = "my-project-id"
    location            = "us-central1"
    application_id      = google_apphub_application.example.application_id
    workload_id         = "frontend-instance-group"
    discovered_workload = data.google_apphub_discovered_workload.my-mig.name
    display_name        = "Frontend Instance Group"
    description         = "The managed instance group for the frontend."
}

Status pendaftaran layanan dan beban kerja yang terdaftar ke aplikasi dapat berubah menjadi dilepas jika Anda memindahkan project atau folder keluar dari batas pengelolaan aplikasi atau menghapus resource yang mendasarinya. Layanan dan beban kerja yang dilepas tetap berada di aplikasi hingga Anda membatalkan pendaftarannya, tetapi App Hub tidak dapat lagi mengelola atau memantaunya. Untuk mengetahui informasi selengkapnya, lihat Status pendaftaran layanan dan workload.

Untuk melampirkan kembali layanan atau beban kerja ke aplikasi, Anda harus mendaftarkannya lagi.

Memberikan izin dan memulai operasi

Setelah membuat aplikasi dan mendaftarkan layanan serta workload di App Hub, Anda harus memberikan akses pengguna berdasarkan tanggung jawab siklus proses untuk mengelola pengelompokan logika ini sebagai satu unit:

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

Mendaftarkan resource yang ada ke aplikasi Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Membuat aplikasi

Konsol

gcloud

Terraform

Mendaftarkan layanan dan workload

Konsol

gcloud

Mendaftar layanan

Mendaftarkan workload

Terraform

Mendaftar layanan

Mendaftarkan workload

Memberikan izin dan memulai operasi

Mendaftarkan resource yang ada ke aplikasi