Menyiapkan Cloud Number Registry

Halaman ini menjelaskan cara menyiapkan Cloud Number Registry di organisasi Anda.

Sebelum memulai

  1. Tentukan project yang akan digunakan untuk Cloud Number Registry di organisasi ini.
  2. Pilih project yang ditentukan untuk melakukan langkah-langkah dalam panduan ini.
  3. Pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menyiapkan dan mengelola Cloud Number Registry, minta administrator untuk memberi Anda peran IAM Cloud Number Registry IPAM Admin (roles/cloudnumberregistry.ipamAdmin) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat cakupan admin IPAM

Saat Anda membuat cakupan admin IPAM, Cloud Number Registry akan melakukan tugas penyiapan dan mengidentifikasi resource Compute Engine yang didukung di organisasi Anda, lalu menambahkannya ke buku pendaftaran default.

Diperlukan waktu hingga 24 jam agar semua resource di organisasi ditemukan. Anda dapat melihat status cakupan admin IPAM untuk memeriksa apakah penemuan resource telah selesai.

Anda dapat mengelola Cloud Number Registry melalui buku pendaftaran default ini, atau Anda dapat membuat buku pendaftaran tambahan untuk mengatur resource Anda.

Jika Anda mendapatkan error saat mencoba membuat cakupan admin IPAM, lihat Pemecahan masalah.

Konsol

  1. Di konsol Google Cloud , buka halaman Cloud Number Registry.

    Buka Cloud Number Registry

  2. Klik tab Kelola.

  3. Di panel Kelola cakupan admin IPAM, klik Buat cakupan admin IPAM.

Proses pembuatan cakupan admin IPAM dimulai. Untuk memeriksa progres penyiapan, lihat status cakupan admin IPAM.

gcloud

Buat cakupan admin IPAM menggunakan perintah gcloud alpha number-registry ipam-admin-scopes create.

Untuk memeriksa progres penyiapan Cloud Number Registry, lihat status cakupan admin IPAM.

gcloud alpha number-registry ipam-admin-scopes create SCOPE_NAME \
    --enabled-addon-platforms=COMPUTE_ENGINE \
    --scopes=organizations/ORGANIZATION_ID \
    --location=global

Ganti kode berikut:

  • SCOPE_NAME: nama untuk cakupan admin IPAM
  • ORGANIZATION_ID: nomor ID organisasi yang ingin Anda kelola.

Melihat status cakupan admin IPAM

Cakupan admin dapat memiliki status berikut selama penyiapan:

  • SETUP_IN_PROGRESS: penyiapan telah dimulai, tetapi proses penemuan belum selesai. Diperlukan waktu hingga 24 jam agar semua resource yang ada di organisasi ditemukan. Namun, semua resource baru yang dibuat di organisasi akan ditemukan dalam beberapa menit.

  • READY_TO_USE: proses penemuan selesai dan Cloud Number Registry siap digunakan.

Konsol

  1. Di konsol Google Cloud , buka halaman Cloud Number Registry.

    Buka Cloud Number Registry

  2. Klik tab Kelola.

  3. Di panel Manage IPAM admin scope, lihat kolom State.

gcloud

Lihat detail tentang cakupan admin IPAM menggunakan perintah gcloud alpha number-registry ipam-admin-scopes describe.

gcloud alpha number-registry ipam-admin-scopes describe SCOPE_NAME \
    --location=global

Ganti SCOPE_NAME dengan nama cakupan admin IPAM.

Pemecahan masalah

Bagian berikut menjelaskan cara menyelesaikan masalah yang mungkin Anda alami saat menyiapkan Cloud Number Registry.

Pembuatan cakupan admin IPAM gagal dengan error ALREADY_EXISTS atau INVALID_ARGUMENT

Jika pembuatan cakupan admin IPAM gagal karena salah satu error ini, hal ini disebabkan karena cakupan admin IPAM sudah ada di project.

  • Cakupan admin IPAM dengan nama yang sama sudah ada di project ini:

    ALREADY_EXISTS: Resource 'projects/PROJECT_ID/locations/global/ipamAdminScopes/SCOPE_NAME'
already exists.

  • Cakupan admin IPAM dengan nama yang berbeda sudah ada di project ini:

    INVALID_ARGUMENT: Violation in ipam_admin_scope.scopes: Scope
organizations/ORGANIZATION_ID is already administered by another ipam admin scope
'projects/PROJECT_ID/locations/global/ipamAdminScopes/EXISTING_SCOPE_NAME'

Pembuatan cakupan admin IPAM gagal dengan error FAILED_PRECONDITION

Jika pembuatan cakupan admin IPAM gagal dengan pesan error berikut, berarti project ini belum ditetapkan untuk digunakan bagi Cloud Number Registry untuk organisasi ini.

FAILED_PRECONDITION: There is no existing registry for 'projects/PROJECT_ID in scope
organizations/ORGANIZATION_ID'

Untuk mengatasi masalah ini, lakukan langkah berikut:

  1. Periksa apakah Cloud Number Registry sudah disiapkan untuk organisasi ini di project lain.

  2. Jika Cloud Number Registry belum disiapkan untuk organisasi ini, periksa apakah project sudah ditetapkan untuk Cloud Number Registry di organisasi ini.

  3. Jika tidak ada project yang ditetapkan, minta administrator organisasi Anda untuk menetapkan project yang akan digunakan dengan Cloud Number Registry atau memberi Anda akses untuk melakukannya.

Langkah berikutnya