Halaman ini diterjemahkan oleh Cloud Translation API.

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 Hub Aplikasi (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:

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.
Pastikan Google Cloud CLI versi terbaru telah diinstal:
```
gcloud components update
```
Temukan project ID.
Tetapkan project sebagai project default untuk perintah:
```
gcloud config set project PROJECT_ID
```
Ganti PROJECT_ID dengan ID project.

Aktifkan App Hub API:

gcloud services enable apphub.googleapis.com \
    --project PROJECT_ID

Lampirkan project ke dirinya sendiri untuk membuat batas pengelolaan aplikasi:
```
gcloud alpha apphub boundary update \
    --crm-node="projects/$(gcloud projects describe PROJECT_ID --format='value(projectNumber)')" \
    --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.

Konfirmasi status lampiran:

gcloud alpha 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_NUMBER
createTime: 2025-08-28T19:04:47Z
updateTime: 2025-08-28T19:04:47Z
type: AUTOMATIC

PROJECT_NUMBER adalah nomor project yang sesuai dengan project ID Anda.

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. Anda juga dapat meninjau 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

Di konsol Google Cloud , gunakan pemilih project untuk memilih project pengelolaan.
Buka halaman IAM:

Buka IAM
Klik Grant access. Panel Berikan akses akan terbuka.
Di kolom New principals, masukkan alamat email principal yang ingin Anda beri akses ke App Hub.
Klik Pilih peran, lalu masukkan App Hub di kolom Filter.
Pilih peran IAM App Hub yang ingin Anda tetapkan ke akun utama, lalu klik Simpan.

gcloud

Memberikan 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 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 kompatibel dengan 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 beban kerja Anda serta memperbarui status pendaftaran jika resource pokok masih ada.

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

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.
Pastikan Google Cloud CLI versi terbaru telah diinstal:
```
gcloud components update
```
Temukan project ID.
Tetapkan project sebagai project default untuk perintah:
```
gcloud config set project PROJECT_ID
```
Ganti PROJECT_ID dengan ID project.
Lepaskan project dari batasnya untuk menonaktifkan pengelolaan aplikasi:
```
gcloud alpha apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --clear-crm-node
```
Perintah ini memperbarui resource batas dan menghapus lampiran, sehingga menonaktifkan pengelolaan aplikasi untuk project.
Konfirmasi pelepasan dengan menjelaskan batas:
```
gcloud alpha apphub boundary describe \
    --project=PROJECT_ID \
    --location=global
```
Output tidak berisi kolom crmNode, yang mengonfirmasi bahwa pengelolaan aplikasi dinonaktifkan di project.
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
```

Menyiapkan satu project Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.