Menyiapkan satu project

Dokumen ini menjelaskan cara menyiapkan satu project untuk mengelola aplikasi. Google Cloud Konfigurasi ini juga dikenal sebagai batas satu project.

Dalam penyiapan ini, Google Cloud project dikonfigurasi untuk mengelola aplikasi dan komponennya sendiri, yang bertindak sebagai project pengelolaan mandiri. Pendekatan ini adalah cara tercepat untuk mulai mengelola aplikasi jika semua komponen aplikasi Anda berada dalam satu project ini. App Hub secara otomatis menemukan semua resource yang didukung dalam project, sehingga resource tersebut siap diatur ke dalam aplikasi.

Batasan

Batas satu project memiliki dukungan fitur yang berbeda dibandingkan dengan batas tingkat folder. App Hub, Pusat Desain Aplikasi, dan Pemantauan Aplikasi mendukung sepenuhnya project tunggal, 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 tingkat folder dan satu project, lihat Dukungan fitur menurut jenis batas.

Sebelum memulai

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

Peran yang diperlukan

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

  • Mengelola resource, izin, dan penagihan di project: Project Owner (roles/owner)
  • Mengelola semua komponen aplikasi di project: Admin App Hub (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 Ringkasan dari App Hub:

    Buka Ringkasan

  3. Klik Siapkan Hub Aplikasi.

    Jika project Anda sudah berada di dalam folder yang mendukung aplikasi, halaman tidak akan menampilkan opsi Siapkan App Hub. Sebagai gantinya, Anda akan diminta untuk memilih folder yang mendukung 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 Aktifkan App Hub, pilih salah satu opsi berikut:

    • Penyiapan cepat: kelola konfigurasi default untuk resource dalam project ini dan tentukan 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 sedang 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 Project dalam batas Anda hanya menampilkan project yang menentukan batas project tunggal Anda. Untuk penyiapan batas satu project, jangan menambahkan project lain.

      2. Klik Lanjutkan.

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

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

      5. Klik Berikan peran, lalu klik Selesai.

      Sekarang Anda dapat mendaftarkan resource yang ada ke aplikasi atau membuat template aplikasi dengan Pusat Desain Aplikasi.

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

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  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 dirinya 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 menemukan semua resource yang didukung di dalamnya secara otomatis.

  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 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. Atau, 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 principal yang ingin Anda beri akses ke App Hub.

  5. Klik Pilih peran, lalu masukkan App Hub di kolom Filter.

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

gcloud

  1. Memberikan akses ke akun utama dalam 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 kepala sekolah 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 yang mendukung aplikasi. Tindakan ini 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 di project jika tidak ingin lagi mengelola resource-nya di aplikasi App Hub.

Jika Anda menonaktifkan pengelolaan aplikasi di project, project akan dilepaskan dari batas pengelolaan aplikasi. Layanan dan workload di aplikasi Anda akan tetap ada, tetapi status pendaftarannya akan berubah menjadi tidak terikat. 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 pokok masih ada.

Untuk menonaktifkan pengelolaan aplikasi di 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 Setelan batas dari App Hub:

    Buka setelan Batas

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

  4. Klik Lepaskan project.

    Tabel Project dalam batas wilayah Anda diperbarui dan tidak lagi menampilkan informasi project Anda.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  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 memperbarui resource batas dan menghapus lampiran, sehingga menonaktifkan pengelolaan aplikasi untuk project.

  6. Konfirmasi pelepasan dengan menjelaskan batas:

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

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

  7. Secara opsional, Anda dapat menghapus semua aplikasi dalam project lalu menonaktifkan 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