Menyiapkan satu project

Untuk mengelola aplikasi saat semua komponen berada dalam satu projectGoogle Cloud , Anda dapat mengonfigurasi project pengelolaan mandiri di App Hub. Batas satu project ini memungkinkan App Hub menemukan resource yang didukung secara otomatis dalam project sehingga Anda dapat mengaturnya ke dalam aplikasi.

Batasan

Batas project tunggal memiliki dukungan fitur yang berbeda dibandingkan dengan batas tingkat folder. App Hub, Application Design Center, dan Application Monitoring sepenuhnya mendukung satu project, tetapi layanan Google Cloud yang berfokus pada Aplikasi lainnya, seperti Cloud Hub dan Gemini Cloud Assist, memerlukan batas tingkat folder.

Untuk perbandingan dukungan fitur antara model project tunggal dan level folder, lihat Dukungan fitur berdasarkan jenis batas.

Sebelum memulai

Pilih project Google Cloud yang ingin Anda gunakan untuk mengelola aplikasi. Project ini akan berfungsi sebagai project pengelolaan mandiri. Anda dapat menggunakan project yang sudah ada atau membuat project baru.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengonfigurasi satu project untuk pengelolaan aplikasi, minta administrator untuk memberi Anda peran IAM berikut pada project yang ingin Anda konfigurasi sebagai project pengelolaan mandiri:

  • Mengelola resource, izin, dan penagihan pada project: Project Owner (roles/owner)
  • Mengelola semua komponen aplikasi di project: App Hub Admin (roles/apphub.admin)

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 di project

Tindakan ini mengonfigurasi project sebagai project pengelolaan mandiri dan mengaktifkan API yang diperlukan untuk metadata dan konfigurasi aplikasi. Project tersebut kemudian disebut project yang mendukung aplikasi.

Untuk mengaktifkan pengelolaan aplikasi di satu project, ikuti langkah-langkah berikut:

Konsol

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

  2. Buka halaman Overview dari App Hub:

    Buka Ringkasan

  3. Klik Set up App Hub.

    Jika project Anda sudah berada di dalam folder khusus aplikasi, halaman tidak akan menampilkan opsi Set up App Hub. Sebagai gantinya, Anda akan diminta untuk memilih folder khusus aplikasi atau menggunakan project saat ini dari menu. Pilih project saat ini untuk melanjutkan penyiapan project tunggal. Untuk mempelajari lebih lanjut pertimbangan hierarki resource untuk pengelolaan aplikasi, lihat Merencanakan hierarki resource untuk pengelolaan aplikasi.

  4. Di halaman Enable App Hub, pilih salah satu opsi berikut:

    • Penyiapan cepat: mengelola konfigurasi default untuk resource dalam project ini dan menentukan aplikasi pertama Anda untuk adopsi awal.
    • Penyiapan lengkap: mengelola konfigurasi kustom untuk aplikasi Anda, termasuk menyiapkan kontrol akses di awal dan, secara opsional, menambahkan lebih banyak project untuk batas beberapa project.
  5. Catat nama dan ID project. Informasi ini mengidentifikasi project pengelolaan dan Anda akan menggunakan nilai ini untuk memberikan akses.

  6. Tinjau daftar API yang diaktifkan. Beberapa API memiliki biaya terkait. Pelajari lebih lanjut biaya API atau klik setiap API untuk melihat biaya terkait.

  7. Klik Lanjutkan.

  8. Selesaikan penyiapan berdasarkan pilihan Anda:

    • Jika Anda memilih Penyiapan cepat, tab Tentukan aplikasi memungkinkan Anda menentukan aplikasi sekarang atau menyelesaikan penyiapan tanpa membuatnya. Sekarang Anda siap untuk membuat aplikasi dan mendaftarkan resource ke aplikasi tersebut. Anda juga dapat memulai dengan panduan memulai untuk aplikasi.

    • Jika Anda memilih Penyiapan penuh, berikan akses kustom yang berfokus pada aplikasi untuk administrator Anda:

      1. Di tab Tentukan batas, verifikasi informasi project Anda. Tabel Projects in your boundary hanya menampilkan project yang menentukan batas project tunggal Anda. Untuk penyiapan batas satu project, jangan tambahkan project tambahan.

      2. Klik Lanjutkan.

      3. Di tab Grant access, pilih peran dan izin IAM yang sesuai untuk administrator dalam project. Untuk mengetahui daftar peran yang berfokus pada aplikasi yang direkomendasikan di seluruh produkGoogle Cloud , lihat Memberikan peran yang berfokus pada aplikasi kepada pengguna.

      4. Di kotak New principals, masukkan pengguna, grup, atau akun layanan yang harus memiliki akses administrator ke tugas yang berfokus pada aplikasi dalam project.

      5. Klik Grant roles, lalu klik Complete.

      Sekarang Anda dapat mendaftarkan resource yang ada ke aplikasi atau membuat template aplikasi dengan Application Design Center.

Nanti, Anda dapat memberikan peran IAM tambahan kepada akun utama dari halaman IAM. Untuk mengetahui informasi selengkapnya, lihat Memberikan peran IAM menggunakan konsol Google Cloud .

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. Temukan project ID.

  4. Tetapkan project sebagai project default untuk perintah:

    gcloud config set project PROJECT_ID
    

    Ganti PROJECT_ID dengan ID project.

  5. Aktifkan App Hub API:

    gcloud services enable apphub.googleapis.com \
        --project PROJECT_ID
    
  6. Lampirkan project ke project itu sendiri untuk membuat batas pengelolaan aplikasi:

    gcloud apphub boundary update \
        --crm-node=projects/PROJECT_ID \
        --project=PROJECT_ID \
        --location=global
    

    Perintah ini mengonfigurasi project sebagai project pengelolaannya sendiri, sehingga App Hub dapat otomatis menemukan semua resource yang didukung di dalamnya.

  7. Konfirmasi status lampiran:

    gcloud apphub boundary describe \
        --project=PROJECT_ID \
        --location=global
    

    Anda akan mendapatkan output yang mirip dengan contoh berikut:

    name: projects/PROJECT_ID/locations/LOCATION/boundary
    crmNode: projects/PROJECT_ID
    createTime: 2025-08-28T19:04:47Z
    updateTime: 2025-08-28T19:04:47Z
    type: AUTOMATIC
    

Setelah Anda selesai mengonfigurasi project pengelolaan, API yang diperlukan untuk pengelolaan aplikasi akan diaktifkan, dan Anda dapat mulai menggunakan App Hub untuk mengelompokkan layanan dan workload dalam aplikasi. Secara opsional, tinjau API yang direkomendasikan untuk mendapatkan akses ke fitur lanjutan.

Menetapkan peran dan izin App Hub

Agar pengguna dapat menemukan, mendaftarkan, dan mengelola komponen aplikasi dalam project ini menggunakan App Hub, Anda harus memberi mereka peran dan izin App Hub yang sesuai.

Ikuti langkah-langkah berikut:

Konsol

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

  2. Buka halaman IAM:

    Buka IAM

  3. Klik Grant access. Panel Berikan akses akan terbuka.

  4. Di kolom New principals, masukkan alamat email akun utama yang ingin Anda beri akses ke App Hub.

  5. Klik Select a role dan masukkan App Hub di kolom Filter.

  6. Pilih peran IAM App Hub yang ingin Anda tetapkan ke akun utama, lalu klik Save.

gcloud

  1. Berikan akses ke akun utama di project pengelolaan:

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member='user:EMAIL_ADDRESS' \
        --role='ROLE_NAME'
    

    Ganti kode berikut:

    • PROJECT_ID: ID project pengelolaan.
    • EMAIL_ADDRESS: alamat email akun utama yang harus mendapatkan akses App Hub. Nilai ini harus memiliki format username@yourdomain, misalnya, my.user@example.com.
    • ROLE_NAME: peran IAM App Hub yang ingin Anda tetapkan ke akun utama, misalnya, roles/apphub.admin.

Mengubah batas pengelolaan aplikasi

Jika Anda ingin mengubah project yang menentukan batas project tunggal, nonaktifkan pengelolaan aplikasi di project lama dan aktifkan di project baru. Data aplikasi Anda tidak dimigrasikan, dan Anda harus membuat ulang aplikasi di project baru.

Untuk beralih dari batas satu project ke batas tingkat folder, siapkan folder khusus aplikasi. Tindakan ini akan mengonfigurasi project pengelolaan baru di folder. Anda harus membuat ulang aplikasi di project pengelolaan baru ini.

Menonaktifkan pengelolaan aplikasi di project

Anda dapat menonaktifkan pengelolaan aplikasi pada project jika tidak ingin lagi mengelola resource-nya di aplikasi App Hub.

Saat Anda menonaktifkan pengelolaan aplikasi pada project, project akan dilepaskan dari batas pengelolaan aplikasi. Layanan dan workload dalam aplikasi Anda tetap ada, tetapi status pendaftarannya berubah menjadi terlepas. Jika Anda memutuskan untuk mengaktifkan kembali pengelolaan aplikasi di project, App Hub dapat menemukan kembali aplikasi, layanan, dan workload Anda serta memperbarui status pendaftaran jika resource yang mendasarinya masih ada.

Untuk menonaktifkan pengelolaan aplikasi pada satu project, ikuti langkah-langkah berikut:

Konsol

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

    Buka Selamat Datang

  2. Buka halaman Boundary settings dari App Hub:

    Buka Setelan batas

  3. Centang kotak project untuk melepaskannya dari batas dan menonaktifkan pengelolaan aplikasi.

  4. Klik Detach projects.

    Tabel Projects in your boundary akan dimuat ulang dan tidak lagi menampilkan informasi project Anda.

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. Temukan project ID.

  4. Tetapkan project sebagai project default untuk perintah:

    gcloud config set project PROJECT_ID
    

    Ganti PROJECT_ID dengan ID project.

  5. Lepaskan project dari batasnya untuk menonaktifkan pengelolaan aplikasi:

    gcloud apphub boundary update \
        --project=PROJECT_ID \
        --location=global \
        --crm-node=""
    

    Perintah ini akan memperbarui resource batas dan menghapus lampiran, sehingga menonaktifkan pengelolaan aplikasi untuk project.

  6. Konfirmasi pelepasan dengan mendeskripsikan batas:

    gcloud apphub boundary describe \
        --project=PROJECT_ID \
        --location=global
    

    Output tidak berisi kolom crmNode, yang mengonfirmasi bahwa pengelolaan aplikasi dinonaktifkan pada project.

  7. Secara opsional, hapus semua aplikasi dalam project, lalu nonaktifkan App Hub API jika Anda tidak akan menggunakan fitur aplikasi dalam project ini lagi:

    gcloud services disable apphub.googleapis.com \
        --project=PROJECT_ID
    

Langkah berikutnya