Mengelola aplikasi dalam folder

Dokumen ini menjelaskan cara menyiapkan folder yang kompatibel dengan aplikasi untuk membangun, mengoperasikan, dan mengelola aplikasi App Hub diGoogle Cloud. Dokumen ini ditujukan bagi orang yang menyiapkan dan mengelola aplikasi App Hub.

Ringkasan

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

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

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

Apa yang dimaksud dengan folder khusus aplikasi?

Folder yang mendukung aplikasi adalah folder dalam Google Cloud hierarki resource 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 di 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 dapat digunakan untuk aplikasi, Anda membuat batas tingkat folder yang menyederhanakan pembuatan dan pengelolaan aplikasi dalam organisasi Anda.
• Menyediakan tampilan yang berfokus pada aplikasi: Alat ini mengalihkan fokus dari masing-masing resource ke aplikasi itu sendiri, sehingga memberikan tampilan menyeluruh performa aplikasi.

Untuk mengetahui informasi selengkapnya tentang batas tingkat 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 API dan library aplikasi, termasuk penagihan, kuota, dan kontrol akses. Untuk mengetahui 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 hubungan 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 tingkat folder. Misalnya, aplikasi dapat mencakup resource dari project P10 dan P20.

Jika Anda mengaktifkan pengelolaan aplikasi hanya di folder F2, project P10 tidak 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 diperlukan untuk mengonfigurasi folder yang mendukung 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
• Memberi peran yang berfokus pada aplikasi kepada pengguna: Admin IAM Project (roles/resourcemanager.projectIamAdmin) di project pengelolaan
• Konfigurasi cakupan kemampuan observasi:
  • Observability Editor (roles/observability.editor) di project pengelolaan
  • Logs Configuration Writer (roles/logging.configWriter) di project pengelolaan
  • Admin Monitoring (roles/monitoring.admin) di project pengelolaan dan di setiap project yang ingin Anda tambahkan ke cakupan metrik
  • Pengguna Cloud Trace (roles/cloudtrace.user) di project pengelolaan
  • Pusat Aplikasi Viewer (roles/apphub.viewer) di 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 sebagai folder khusus aplikasi dan hal berikut akan terjadi:

• Project ditentukan sebagai project pengelolaan di folder.
• Sistem 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 Google Cloud folder yang ingin Anda konfigurasi sebagai folder yang mendukung 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 yang mendukung aplikasi , pengelolaan aplikasi sudah diaktifkan.

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

   Jika pengelolaan aplikasi belum diaktifkan di folder, setelan Pengelolaan aplikasi akan menampilkan Tidak diaktifkan.

5. Di area Aktifkan pengelolaan aplikasi, klik Buat 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 dan ID project pengelolaan. Anda akan menggunakan nilai ini untuk memberikan akses.

   Atau, untuk mendapatkan project ID 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 yang kompatibel dengan 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 dimulai 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 Google Cloud layanan 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 di 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 yang kompatibel dengan aplikasi, penting untuk memahami hierarki resource dalam folder. Jika project atau subfolder turunan yang berisi layanan dan beban kerja dipindahkan dari folder yang mendukung aplikasi setelah aplikasi dibuat, aplikasi akan tetap berada di folder yang mendukung aplikasi. Namun, status pendaftaran layanan dan workload akan 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, sebaiknya tautkan akun penagihan ke project pengelolaan dan berikan peran yang berfokus pada aplikasi kepada pengguna Anda untuk mengakses fitur lanjutan dari produk Google Cloud lainnya yang berfokus pada aplikasi. Tindakan ini memungkinkan pengguna Anda mengelola berbagai aspek proses dan operasi deployment aplikasi, yang mungkin memerlukan peran yang berbeda.

Opsional: Tautkan akun penagihan ke project pengelolaan

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

• Mengelola workload yang melebihi kuota resource Pusat Aplikasi.
• Gunakan 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 memodelkan aplikasi dengan layanan dan workload yang mendasarinya tanpa biaya dan menggunakan alokasi penggunaan data gratis untuk penggunaan Google Cloud Observability di project pengelolaan.

Ikuti langkah-langkah berikut untuk menautkan akun penagihan yang 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 Tindakan, pilih Ubah penagihan, 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 Pusat Desain Aplikasi, serta melihat data di Cloud Hub.

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

Tanggung jawab pengguna	Peran IAM	Tempat untuk memberikan peran
Administrator platform Lakukan tugas administrator untuk project pengelolaan.	Project IAM Admin (roles/resourcemanager.projectIamAdmin)	project pengelolaan
Platform engineer Melakukan tugas administrator untuk App Hub dan App Design Center.	Admin App Hub (roles/apphub.admin) Admin Pusat Desain Aplikasi (roles/designcenter.admin)	project pengelolaan
Developer aplikasi Mengembangkan aplikasi.	Editor App Hub (roles/apphub.editor) Pengguna App Design Center (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 pengamatan menentukan tempat Google Cloud konsol menelusuri data telemetri untuk ditampilkan. Setiap project Google Cloud memiliki satu cakupan pengamatan, 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, konfigurasi cakupan kemampuan pengamatan dan cakupan metrik untuk project pengelolaan. Dengan mengonfigurasi cakupan ini, Cloud Hub dan layanan lainnya dapat menemukan dan menampilkan data log, metrik, dan rekaman aktivitas 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. Konfigurasi cakupan log default di project pengelolaan untuk menyertakan tampilan log.
	Anda tidak memiliki sink gabungan tingkat organisasi, dan folder yang diaktifkan untuk aplikasi tidak memiliki folder bertingkat.	Konfigurasi sink gabungan untuk merutekan log aplikasi ke bucket log _Default project pengelolaan. Pastikan cakupan log bernama _Default adalah cakupan log default.
	Anda tidak ingin menggunakan sink gabungan.	Konfigurasi cakupan log default di project pengelolaan untuk mencantumkan lokasi penyimpanan data log aplikasi Anda.
Cakupan metrik	Anda mengonfigurasi folder yang mendukung aplikasi yang berisi semua project yang menyimpan data metrik yang ingin Anda lihat.	Google Cloud Observability mencoba menyinkronkan daftar project di folder yang mendukung aplikasi dengan daftar project pada cakupan metrik. Selama jumlah project di folder yang mendukung aplikasi tidak melebihi kuota cakupan metrik Anda, Google Cloud Observability dapat memperbarui daftar project dalam cakupan metrik saat Anda menambahkan atau menghapus project di folder yang mendukung aplikasi.
Cakupan rekaman aktivitas	Anda ingin memantau data trace aplikasi di beberapa project.	Buat cakupan rekaman aktivitas kustom di project pengelolaan yang mencantumkan project yang menyimpan data rekaman aktivitas aplikasi Anda. Tetapkan cakupan trace kustom Anda sebagai cakupan trace default.

Menonaktifkan pengelolaan aplikasi

Peringatan: Menonaktifkan pengelolaan aplikasi dalam folder secara otomatis dan menghapus project pengelolaan secara permanen serta 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 ada lien yang melindungi project pengelolaan di folder yang mendukung aplikasi agar tidak dihapus, Anda harus menghapus lien tersebut. Untuk mengetahui informasi selengkapnya, lihat Melindungi project dengan lien.

2. Pilih Google Cloud folder 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 yang mendukung aplikasi.

5. Di baris folder, buka menu Tindakan dan klik Setelan.

   Folder dengan ikon folder yang diaktifkan aplikasi dikonfigurasi untuk pengelolaan aplikasi.

6. Klik Disable 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 lebih lanjut App Hub
• Membuat aplikasi Anda
• Pelajari cara mendesain dan men-deploy aplikasi di Pusat Desain Aplikasi