Mengelola aplikasi dalam folder

Anda dapat menyiapkan folder khusus aplikasi untuk membangun, mengoperasikan, dan mengelola aplikasi App Hub. Dokumen ini ditujukan bagi administrator dan developer yang mengonfigurasi dan mengelola aplikasi ini.

Ringkasan

Google Cloud menyediakan pendekatan yang berfokus pada aplikasi untuk men-deploy dan mengelola resource Anda. Alih-alih berfokus pada komponen infrastruktur individual, Anda dapat mengelola aplikasi secara keseluruhan. Untuk mengetahui informasi selengkapnya tentang model yang berfokus pada aplikasi dan pengaturan resource-nya, lihat Google Cloud yang berfokus pada aplikasi.

Inti dari pengalaman yang berfokus pada aplikasi adalah aplikasi App Hub. Aplikasi adalah pengelompokan logis resource yang bekerja sama untuk menyediakan fungsi bisnis tertentu. Referensi ini mencakup:

• Layanan: Antarmuka jaringan atau API yang mengekspos fungsionalitas ke klien, seperti aturan penerusan load balancer.
• Workload: Resource komputasi yang menjalankan deployment biner yang menjalankan fungsi bisnis yang berbeda, seperti grup instance terkelola (MIG) atau deployment Google Kubernetes Engine (GKE).

Apa yang dimaksud dengan folder khusus aplikasi?

Folder khusus aplikasi adalah folder dalam hierarki resource Google Cloud yang telah dikonfigurasi secara khusus untuk pengelolaan aplikasi. Folder ini berfungsi sebagai batas pengelolaan aplikasi untuk aplikasi Anda dan mencakup project pengelolaan untuk menyimpan metadata dan konfigurasi aplikasi. Anda dapat mendesain, mengonfigurasi, menguji, memvalidasi, dan men-deploy aplikasi App Hub dalam satu atau beberapa project dalam folder.

Folder khusus aplikasi menyederhanakan pengelolaan aplikasi dengan cara berikut:

• Mengatur komponen: Komponen mengelompokkan layanan dan workload terkait, yang ditentukan dalam App Hub, ke dalam satu aplikasi.
• Menyediakan pemantauan dan pengelolaan terpusat: Alih-alih melacak komponen individual di berbagai project atau produk, Anda dapat memantau dan mengelola keseluruhan kondisi dan performa aplikasi di tingkat folder.
• Menyederhanakan administrasi: Dengan menetapkan folder sebagai diaktifkan untuk aplikasi, Anda membuat batas tingkat folder yang menyederhanakan pembuatan dan pengelolaan aplikasi dalam organisasi Anda.
• Memberikan tampilan yang berfokus pada aplikasi: Alat ini mengalihkan fokus dari resource individual ke aplikasi itu sendiri, sehingga memberikan tampilan menyeluruh tentang performanya.

Untuk mengetahui informasi selengkapnya tentang batas level folder dan perbandingan antara project dan folder untuk batas pengelolaan aplikasi Anda, lihat Memilih model penyiapan aplikasi.

Ringkasan project pengelolaan

Project pengelolaan adalah projectGoogle Cloud di folder khusus aplikasi yang bertindak sebagai repositori pusat untuk semua metadata yang berfokus pada aplikasi. Setiap folder hanya berisi satu project pengelolaan. Project pengelolaan menyediakan infrastruktur untuk library aplikasi dan API, termasuk penagihan, kuota, dan kontrol akses. Untuk informasi selengkapnya tentang API ini, lihat Mengaktifkan API di project pengelolaan.

Project pengelolaan menyimpan model aplikasi lengkap, yang mencakup hal berikut:

• Data App Hub: Model logis aplikasi Anda, termasuk hubungannya dengan layanan dan workload, serta metadata seperti pemilik dan tingkat kekritisan.
• Data Application Design Center: Resource seperti template, katalog, dan ruang yang digunakan untuk mendesain dan men-deploy aplikasi baru.

Project pengelolaan juga dapat menemukan resource dalam hierarki resource folder khusus aplikasi. Jika project pengelolaan dihapus, semua data model aplikasi ini akan hilang secara permanen. Meskipun infrastruktur yang mendasarinya, seperti cluster GKE atau load balancer, tetap utuh, grup logisnya dalam App Hub akan dihapus secara permanen.

Mengonfigurasi folder untuk pengelolaan aplikasi

Anda dapat mengaktifkan pengelolaan aplikasi di folder baru dan yang sudah ada. Sebaiknya uji pengelolaan aplikasi dalam folder khusus yang baru dibuat. Hal ini memungkinkan eksperimen yang aman sebelum menerapkannya ke folder penting yang ada.

Dalam folder khusus aplikasi, pengguna yang diberi otorisasi dapat menggabungkan workload dan layanan dari project mana pun dalam aplikasi langsung di dalam folder tersebut.

Pertimbangkan hierarki resource dengan struktur berikut:

Folder F1 berisi tiga item berikut:

• Project P10 dan P11
• Folder F2

Folder F2 berisi dua item berikut:

• Project P20 dan P21

Aktifkan pengelolaan aplikasi di folder F1 untuk membuat aplikasi yang mencakup resource dari beberapa level folder. Misalnya, aplikasi dapat menyertakan resource dari project P10 dan P20.

Jika Anda mengaktifkan pengelolaan aplikasi hanya di folder F2, project P10 tidak akan tersedia untuk membuat aplikasi. Untuk membuat aplikasi di project P10, pindahkan project P10 ke folder F2.

Pertimbangkan struktur organisasi, tanggung jawab tim, dan resource Anda saat merencanakan strategi pengelolaan aplikasi. Cara tim dan resource Anda disusun berdampak langsung pada cara Anda menggunakan folder khusus aplikasi.

Peran yang diperlukan

Berdasarkan tanggung jawab yang diidentifikasi selama siklus proses aplikasi, Anda dan pengguna akan memerlukan berbagai peran untuk mengonfigurasi berbagai aspek proses pengelolaan aplikasi.

Untuk mendapatkan izin yang Anda perlukan untuk mengonfigurasi folder khusus aplikasi, minta administrator untuk memberi Anda peran IAM berikut:

• Mengaktifkan pengelolaan aplikasi: Folder Admin (roles/resourcemanager.folderAdmin) pada resource induk untuk folder
• Mengaktifkan API: Service Usage Admin (roles/serviceusage.serviceUsageAdmin) di folder target (untuk mengaktifkan API yang diperlukan dan direkomendasikan)
• Tautkan akun penagihan ke project pengelolaan:
  • Project Billing Manager (roles/billing.projectManager) di project pengelolaan
  • Billing Account User (roles/billing.user) di akun penagihan target
• Memberikan peran yang berfokus pada aplikasi kepada pengguna: Project IAM Admin (roles/resourcemanager.projectIamAdmin) pada project pengelolaan
• Konfigurasi cakupan kemampuan observasi:
  • Observability Editor (roles/observability.editor) pada project pengelolaan
  • Logs Configuration Writer (roles/logging.configWriter) di project pengelolaan
  • Monitoring Admin (roles/monitoring.admin) pada project pengelolaan dan pada setiap project yang ingin Anda tambahkan ke cakupan metrik
  • Cloud Trace User (roles/cloudtrace.user) pada project pengelolaan
  • App Hub Viewer (roles/apphub.viewer) pada project pengelolaan
• Melihat data tingkat aplikasi dan tingkat project di Cloud Hub: Cloud Hub Operator (roles/cloudhub.operator) di folder khusus 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.

Mengaktifkan pengelolaan aplikasi

Pengelolaan aplikasi memungkinkan Anda mengalihkan fokus dari komponen infrastruktur individual ke aplikasi secara keseluruhan.

Saat Anda mengaktifkan pengelolaan aplikasi di folder, folder tersebut disebut folder khusus aplikasi dan hal berikut akan terjadi:

• Project didefinisikan sebagai project pengelolaan dalam folder.
• Sistem akan mengaktifkan API yang diperlukan di project pengelolaan.
• Project pengelolaan menyimpan data aplikasi, termasuk API yang diaktifkan, penagihan, kuota, dan kontrol akses.

Untuk mengaktifkan pengelolaan aplikasi di folder, lakukan hal berikut:

Konsol

1. Pilih atau buat folder Google Cloud yang ingin Anda konfigurasi sebagai folder khusus aplikasi. Untuk membuat folder baru, lihat Membuat folder.

2. Di konsol Google Cloud , buka halaman Manage resources.

   Buka Kelola resource

3. Dari daftar project dan folder, temukan folder yang ingin Anda konfigurasi.

   Jika folder memiliki ikon folder khusus aplikasi , pengelolaan aplikasi sudah diaktifkan.

4. Di baris folder, buka menu Actions, lalu klik Settings.

   Jika pengelolaan aplikasi belum diaktifkan di folder, setelan Application management akan menampilkan Not enabled.

5. Di area Enable application management, klik Create project.

   Panel Create management project and enable required APIs akan terbuka.

6. Tinjau daftar API yang diperlukan. API ini mengelola siklus proses aplikasi Anda. Untuk API yang memiliki biaya terkait, klik nama API untuk mempelajari lebih lanjut harga.

7. Untuk mengaktifkan pengelolaan aplikasi, klik Create project and enable APIs.

   Sistem akan membuat project pengelolaan di folder.

   Peringatan: Jika pengaktifan API gagal, Anda harus memulai ulang proses pengaktifan pengelolaan aplikasi. Error ditampilkan di Notifikasi.

8. Catat nama project dan ID project pengelolaan. Anda akan menggunakan nilai ini untuk memberikan akses.

   Atau, untuk mendapatkan ID project pengelolaan, Anda dapat menggunakan perintah Google Cloud CLI berikut:

   gcloud resource-manager folders describe FOLDER_ID
       --format="value(managementProject.split('/').slice(-1))"
   

   Ganti FOLDER_ID dengan ID folder khusus aplikasi.

   Untuk mengetahui informasi selengkapnya, lihat Menemukan nama, nomor, dan ID project.

gcloud

1. Di konsol Google Cloud , aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan terbuka dan menampilkan prompt command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

2. Pastikan Google Cloud CLI versi terbaru telah diinstal:

   gcloud components update
   

3. Untuk mengaktifkan pengelolaan aplikasi di folder tertentu, gunakan perintah gcloud resource-manager capabilities update dengan flag --enable.

   gcloud resource-manager capabilities update folders/FOLDER_ID/capabilities/app-management \
      --enable
   

   Ganti FOLDER_ID dengan ID folder.

   Perintah ini mengaktifkan kemampuan pengelolaan aplikasi pada folder yang ditentukan dan otomatis menyediakan project Google Cloud baru dalam folder tersebut untuk berfungsi sebagai project pengelolaan.

4. Secara opsional, untuk mengaktifkan API yang direkomendasikan di project pengelolaan, ikuti petunjuk untuk mengaktifkan layanan Google Cloud di project.

Terraform

Untuk mengaktifkan pengelolaan aplikasi di folder menggunakan Terraform, gunakan resource google_resource_manager_capability, misalnya:

resource "google_folder" "folder" {
  display_name     = "my-folder"
  parent           = "organizations/123456789"
  deletion_protection = false
}
resource "time_sleep" "wait_60s" {
  depends_on = [google_folder.folder]
  create_duration = "60s"
}
resource "google_resource_manager_capability" "capability" {
  value            = true
  parent           = "${google_folder.folder.name}"
  capability_name  = "app-management"
  depends_on = [time_sleep.wait_60s]
}

Perintah ini mengaktifkan kemampuan pengelolaan aplikasi pada folder yang ditentukan dan secara otomatis menyediakan project Google Cloud baru dalam folder tersebut untuk berfungsi sebagai project pengelolaan. Untuk mengaktifkan daftar API yang direkomendasikan di project pengelolaan, ikuti petunjuk untuk mengaktifkan layanan API di project Google Cloud .

Penting: Saat Anda membuat folder khusus aplikasi, penting untuk memahami hierarki resource dalam folder tersebut. Jika project turunan atau subfolder yang berisi layanan dan workload dipindahkan dari folder khusus aplikasi setelah aplikasi dibuat, aplikasi akan tetap berada di folder khusus aplikasi. Namun, status pendaftaran layanan dan workload berubah menjadi terlepas.

Setelah membuat project pengelolaan dan mengaktifkan API yang diperlukan, Anda dapat mulai menggunakan App Hub untuk mengelompokkan layanan dan workload yang ada dalam aplikasi. Namun, kami sangat menyarankan untuk menautkan akun penagihan ke project pengelolaan dan memberikan peran yang berfokus pada aplikasi kepada pengguna Anda untuk membuka fitur lanjutan dari produk Google Cloud yang berfokus pada Aplikasi lainnya. Tindakan ini memungkinkan pengguna Anda mengelola berbagai aspek proses dan operasi deployment aplikasi, yang mungkin memerlukan peran yang berbeda.

Opsional: Menautkan akun penagihan ke project pengelolaan

Untuk menggunakan fitur Google Cloud lanjutan yang berfokus pada aplikasi, Anda harus menautkan akun penagihan aktif ke project pengelolaan. Misalnya, akun penagihan tertaut membantu Anda melakukan hal berikut:

• Mengelola workload yang melebihi kuota resource App Hub.
• Menggunakan Application Design Center untuk membuat template dan men-deploy aplikasi.

Untuk ringkasan potensi biaya yang terkait dengan pengelolaan aplikasi dan API yang diaktifkan, lihat Memahami biaya.

Catatan: Jika tidak menautkan akun penagihan, Anda masih dapat menggunakan App Hub dan Application Monitoring. Anda dapat membuat model aplikasi dengan layanan dan workload yang mendasarinya tanpa biaya, serta menggunakan alokasi penggunaan data gratis untuk penggunaan Google Cloud Observability dalam project pengelolaan.

Ikuti langkah-langkah berikut untuk menautkan akun penagihan aktif ke project pengelolaan Anda:

Konsol

1. Pastikan akun penagihan yang ingin Anda gunakan untuk pengelolaan aplikasi sudah ada. Untuk membuat akun penagihan, lihat Membuat akun Penagihan Cloud layanan mandiri baru.

2. Di konsol Google Cloud , buka halaman Penagihan.

   Buka Penagihan

3. Di tab My projects, cari project pengelolaan.

4. Di baris project, buka menu Actions, pilih Change billing, lalu pilih akun Penagihan Cloud.

Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan penagihan untuk project, lihat Mengaktifkan penagihan untuk project.

gcloud

gcloud billing projects link PROJECT_ID \
    --billing-account ACCOUNT_ID

Ganti kode berikut:

• PROJECT_ID: ID project pengelolaan.
• ACCOUNT_ID: ID akun penagihan. ID akun penagihan menggunakan format 0X0X0X-0X0X0X-0X0X0X.

Opsional: Mengaktifkan API yang direkomendasikan

Selain API yang diaktifkan secara otomatis di project pengelolaan, Anda dapat mengaktifkan API yang direkomendasikan untuk mendukung pembuatan aplikasi. Tinjau API yang direkomendasikan untuk memahami manfaat dan biaya terkaitnya.

Memberikan peran yang berfokus pada aplikasi kepada pengguna Anda

Anda dapat memberikan akses kepada pengguna bergantung pada tanggung jawab mereka selama siklus proses aplikasi. Untuk mempelajari cara memberikan izin untuk berbagai tingkat akses aplikasi, lihat Memberikan izin ke aplikasi.

Tabel berikut memberikan panduan umum dan peran IAM yang direkomendasikan untuk memberikan berbagai tanggung jawab pengguna yang berfokus pada aplikasi di level project atau folder. Tabel ini mencakup peran untuk mengelola aplikasi dengan App Hub dan App Design Center, serta melihat data di Cloud Hub.

Untuk mengetahui informasi selengkapnya tentang peran ini dan peran khusus produk lainnya, lihat dokumentasinya.

Tanggung jawab pengguna	Peran IAM	Tempat untuk memberikan peran
Administrator platform Melakukan tugas administrator untuk project pengelolaan.	Project IAM Admin (roles/resourcemanager.projectIamAdmin)	project pengelolaan
Insinyur platform Melakukan tugas administrator untuk App Hub dan App Design Center.	App Hub Admin (roles/apphub.admin) App Design Center Admin (roles/designcenter.admin)	project pengelolaan
Developer aplikasi Mengembangkan aplikasi.	Editor App Hub (roles/apphub.editor) App Design Center User (roles/designcenter.user)	project pengelolaan
SRE, operator, dan pengguna Cloud Hub Melihat data tingkat aplikasi dan tingkat project di Cloud Hub.	Cloud Hub Operator (roles/cloudhub.operator)	folder khusus aplikasi

Mengonfigurasi cakupan kemampuan observasi

Cakupan kemampuan observasi menentukan tempat konsol Google Cloud menelusuri data telemetri untuk ditampilkan. Setiap project Google Cloud memiliki satu cakupan kemampuan observasi, yang mengidentifikasi cakupan log dan trace default. Untuk data metrik, cakupan metrik project menentukan tempat konsolGoogle Cloud menelusuri data.

Untuk melihat atau menganalisis semua data telemetri aplikasi Anda, konfigurasikan cakupan kemampuan observasi dan cakupan metrik untuk project pengelolaan. Dengan mengonfigurasi cakupan ini, Cloud Hub dan layanan lainnya dapat menemukan dan menampilkan data log, metrik, dan trace aplikasi Anda, meskipun data tersebut disimpan di beberapa project.

Bagian ini merangkum konfigurasi yang diperlukan. Untuk mengetahui petunjuk mendetail, lihat Menyiapkan pemantauan aplikasi. Tabel berikut menunjukkan cakupan konfigurasi yang diperlukan.

Komponen cakupan	Skenario konfigurasi	Tindakan dan pertimbangan utama
Cakupan log	Anda menggunakan sink gabungan untuk merutekan semua log dalam organisasi ke bucket log pusat.	Buat tampilan log yang hanya menyertakan log aplikasi yang disimpan di bucket. Konfigurasikan cakupan log default di project pengelolaan untuk menyertakan tampilan log.
	Anda tidak memiliki sink gabungan tingkat organisasi, dan folder khusus aplikasi tidak memiliki folder bertingkat.	Konfigurasikan sink gabungan untuk merutekan log aplikasi ke bucket log _Default dari project pengelolaan. Pastikan cakupan log bernama _Default adalah cakupan log default.
	Anda tidak ingin menggunakan sink gabungan.	Konfigurasikan cakupan log default pada project pengelolaan untuk mencantumkan lokasi penyimpanan data log aplikasi Anda.
Cakupan metrik	Anda mengonfigurasi folder khusus aplikasi yang berisi semua project yang menyimpan data metrik yang ingin Anda lihat.	Google Cloud Observability berupaya menyinkronkan daftar project di folder khusus aplikasi Anda dengan daftar project dalam cakupan metrik. Selama jumlah project di folder khusus aplikasi tidak melebihi kuota cakupan metrik, Google Cloud Observability dapat terus memperbarui daftar project dalam cakupan metrik saat Anda menambahkan atau menghapus project di folder khusus aplikasi.
Cakupan trace	Anda ingin memantau data trace aplikasi di beberapa project.	Buat cakupan trace kustom di project pengelolaan yang mencantumkan project yang menyimpan data trace aplikasi Anda. Tetapkan cakupan trace kustom Anda sebagai cakupan trace default.

Menonaktifkan pengelolaan aplikasi

Peringatan: Menonaktifkan pengelolaan aplikasi dalam folder akan otomatis dan permanen menghapus project pengelolaan dan menonaktifkan semua API yang diaktifkan selama penyiapan pengelolaan aplikasi. Anda tidak dapat memulihkan project pengelolaan setelah dihapus, dan log serta metrik Anda juga akan hilang secara permanen.

Jika Anda tidak ingin lagi folder Google Cloud menjadi folder khusus aplikasi, ikuti langkah-langkah berikut untuk menonaktifkan pengelolaan aplikasi:

1. Jika lien melindungi project pengelolaan di folder khusus aplikasi dari penghapusan project, Anda harus menghapus lien tersebut. Untuk mengetahui informasi selengkapnya, lihat Melindungi project dengan lien.

2. Pilih folder Google Cloud tempat Anda ingin menonaktifkan pengelolaan aplikasi.

3. Di konsol Google Cloud , buka halaman Manage resources.

   Buka Kelola resource

4. Dalam daftar project dan folder, temukan folder khusus aplikasi.

5. Di baris folder, buka menu Actions dan klik Settings.

   Folder dengan ikon folder khusus aplikasi dikonfigurasi untuk pengelolaan aplikasi.

6. Klik Nonaktifkan untuk menonaktifkan pengelolaan aplikasi di folder.

7. Dalam dialog konfirmasi, masukkan Disable di kolom Disable.

8. Jika Anda siap menonaktifkan pengelolaan aplikasi, klik Nonaktifkan.

Sistem akan menghapus project pengelolaan di folder. Seluruh model aplikasi juga akan dihapus, termasuk API dan kontrol akses.

Langkah berikutnya

• Pelajari App Hub lebih lanjut
• Membuat aplikasi
• Mempelajari cara mendesain dan men-deploy aplikasi di App Design Center