Membuat project

Project adalah unit operasi dasar dalam hierarki Google Cloud resource. Project berada di antara folder (atau organisasi) dan resource seperti mesin virtual dan penyimpanan. Halaman ini menjelaskan cara membuat projectGoogle Cloud menggunakan Cloud Resource Manager API dan konsol Google Cloud .

Karakteristik utama project meliputi hal-hal berikut:

• Kontainer layanan utama: Project adalah tingkat dasar tempat semua Google Cloud layanan (API) diaktifkan dan tempat resource seperti instance Compute Engine atau set data BigQuery dibuat.

• Batas kepercayaan: Project berfungsi sebagai lapisan isolasi. Secara default, resource dalam satu project tidak memiliki akses ke resource di project lain, sehingga membuat perimeter yang aman untuk berbagai aplikasi atau lingkungan.

• Unit penagihan: Project adalah cara utama bagi bisnis untuk melacak, mengatur, dan memisahkan biaya di seluruh organisasi mereka.

• Titik lampiran kebijakan: Meskipun kebijakan sering diwarisi dari folder, tingkat project adalah tempat paling umum di mana izin tertentu (Identity and Access Management (IAM)) diberikan kepada developer dan akun layanan untuk tugas sehari-hari.

Sebelum memulai

Baca tentang resource project di ringkasan hierarki resource. Untuk panduan tentang cara menyiapkan hierarki resource, lihat artikel Menentukan hierarki resource untuk Google Cloud zona landing.

ID berikut digunakan untuk project Anda:

• Nama project: Nama project yang dapat dibaca manusia.

  Nama project tidak digunakan oleh Google API mana pun. Anda dapat mengedit nama project kapan saja selama atau setelah pembuatan project. Nama project tidak harus unik.

• Project ID: ID unik global untuk project Anda.

  Project ID adalah string unik yang membedakan project Anda dari semua project lain di Google Cloud. Setelah Anda memasukkan nama project, konsolGoogle Cloud akan membuat project ID unik yang dapat berupa kombinasi huruf, angka, dan tanda hubung. Gunakan project ID yang dihasilkan, tetapi Anda dapat mengeditnya selama pembuatan project. Setelah project dibuat, ID project bersifat permanen.

  ID project memiliki persyaratan berikut:

  • Panjangnya harus 6 hingga 30 karakter.
  • Hanya boleh berisi huruf kecil, angka, dan tanda hubung.
  • Nama harus diawali dengan huruf.
  • Tidak boleh diakhiri dengan tanda hubung.
  • Project tidak boleh sedang digunakan atau pernah digunakan; hal ini mencakup project yang dihapus.
  • Tidak boleh berisi string yang dibatasi seperti google dan ssl. Hindari penggunaan string seperti undefined dan null di project ID.

• Nomor project: Nomor project adalah ID unik yang dibuat secara otomatis untuk project Anda.

Jangan sertakan informasi sensitif, misalnya, informasi identitas pribadi atau data keamanan, dalam nama project, project ID, atau nama resource lainnya. Project ID muncul di nama banyak resource Google Cloud lainnya. Mereferensikan project atau resource-nya akan mengekspos ID project dan nama resource.

Membuat project

Untuk membuat project, Anda harus memiliki izin resourcemanager.projects.create. Izin ini disertakan dalam peran seperti peran Project Creator (roles/resourcemanager.projectCreator).

Peran Project Creator diberikan secara default kepada seluruh domain resource organisasi baru dan kepada pengguna uji coba gratis.

Untuk mengetahui informasi tentang cara memberikan peran kepada individu dan membatasi akses di seluruh resource organisasi, lihat halaman Mengelola Peran Organisasi Default.

Jika Anda tidak menentukan resource induk, resource induk akan dipilih secara otomatis jika berlaku berdasarkan domain akun pengguna.

Anda dapat membuat project baru menggunakan konsol Google Cloud , Google Cloud CLI, atau metode projects.create().

Konsol

Untuk membuat project baru, lakukan langkah-langkah berikut:

1. Buka halaman Manage resources di konsol Google Cloud .

   Buka Kelola Resource

   Langkah-langkah selanjutnya akan muncul di konsol Google Cloud .

2. Pada daftar drop-down Pilih organisasi di bagian atas halaman, pilih resource organisasi tempat Anda ingin membuat project. Jika Anda adalah pengguna uji coba gratis, lewati langkah ini karena daftar ini tidak muncul.
3. Klik Create Project.
4. Di jendela Project Baru yang muncul, masukkan nama project dan pilih akun penagihan yang berlaku. Nama project hanya boleh berisi huruf, angka, tanda kutip tunggal, tanda hubung, spasi, atau tanda seru, serta harus memiliki 4 hingga 30 karakter.
5. Masukkan resource folder atau organisasi induk di kotak Location. Resource tersebut akan menjadi induk hierarkis dari project baru. Jika opsi No organization tersedia, Anda dapat memilihnya untuk membuat project baru sebagai tingkat teratas dari hierarki resource-nya sendiri.
6. Setelah selesai memasukkan detail project baru, klik Buat.

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 perintah 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. Untuk membuat project baru, gunakan perintah gcloud projects create:

   gcloud projects create PROJECT_ID
   

   Dengan PROJECT_ID adalah ID project yang ingin Anda buat. ID project harus diawali dengan huruf kecil, dan hanya boleh berisi huruf ASCII, angka, dan tanda hubung, serta harus terdiri dari 6 hingga 30 karakter.

   Untuk membuat project dengan resource organisasi atau folder sebagai induk, gunakan flag --organization atau --folder. Karena resource hanya dapat memiliki satu induk, hanya satu dari flag ini yang dapat digunakan:

   gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID
   

   gcloud projects create PROJECT_ID --folder=FOLDER_ID
   

REST

Anda tidak dapat menggunakan kata-kata tertentu di ID project saat membuat project baru dengan metode projects.create(). Beberapa contohnya meliputi google, null, undefined, dan ssl. Saat Anda menggunakan kata yang dilarang, permintaan akan ditampilkan dengan error INVALID_ARGUMENT.

Permintaan berikut hanya membuat project, dan tidak mengaitkannya secara otomatis dengan akun penagihan. Gunakan metode projects.updateBillingInfo untuk menetapkan atau memperbarui akun penagihan yang terkait dengan project.

Buat Permintaan Project:

POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json

{
    "projectId": "our-project-123",
    "name": "my project",
    "labels": {
      "mylabel": "prod"
    }
}

Buat Respons Project:

{
    "name": "operations/pc.123456789",
}

Permintaan Mendapatkan Operasi:

GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json

Mendapatkan Respons Operasi:

{
    "name": "operations/pc.123456789",
    "done": true,
    "response": {
        "@type": "type.googleapis.com/google.cloudresourcemanager.v3.Project",
        "projectNumber": "464036093014",
        "projectId": "our-project-123",
        "lifecycleState": "ACTIVE",
        "name": "my project",
        "labels": {
        "mylabel": "prod"
        },
    "createTime": "2016-01-07T21:59:43.314Z"
    }
}

Menambahkan tag selama pembuatan project

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Tag memberikan cara untuk membuat anotasi untuk resource. Anda dapat menambahkan tag saat membuat project. Anda harus menetapkan peran Pengguna Tag saat menambahkan tag. Untuk mengetahui informasi selengkapnya tentang izin yang ditetapkan ke peran ini, lihat Mengelola tag pada resource. Anda hanya dapat menambahkan namespace untuk pasangan nilai kunci tag dengan salah satu cara berikut:

gcloud

Untuk menambahkan tag selama pembuatan project, jalankan perintah berikut:

gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS

Ganti kode berikut:

• PROJECT_ID adalah ID unik project.
• ORGANIZATION_ID adalah ID unik organisasi.
• KEY_VALUE_PAIRS adalah daftar pasangan nilai kunci yang dipisahkan koma yang dapat Anda tetapkan ke resource. Contoh pasangan nilai kunci yang dipisahkan koma adalah 123/environment=production, 456/create=testresource.

REST

Cuplikan berikut adalah permintaan JSON tempat Anda membuat project dan menambahkan tag ke project tersebut.

  POST https://cloudresourcemanager.googleapis.com/v3/projects/
  Authorization: *************
  Content-Type: application/json

  {
    "projectId": "our-project-456",
    "name": "my project",
    "parent": "organizations/123",
    "tags": {
      "key": "123/environment"
      "value": "production"
    },
"tags": {
      "key": "123/costCenter"
      "value": "marketing"
  }
}

Menetapkan lingkungan project dengan tag

Anda dapat menggunakan tag untuk membedakan project secara visual berdasarkan lingkungannya, seperti produksi, staging, atau pengembangan. Tindakan ini membantu mencegah error dan meningkatkan kewaspadaan saat Anda bekerja di lingkungan yang sensitif. Google menambahkan indikator visual ke project di pemilih project konsol Google Cloud saat project dengan pasangan nilai kunci tag tertentu dipilih. Indikator ini mengingatkan Anda bahwa perubahan apa pun dapat memengaruhi aplikasi produksi atau non-produksi terkait. Tag dapat diwarisi oleh project atau ditetapkan langsung di project.

Untuk menggunakan fitur ini, lakukan hal berikut:

1. Buat kunci tag bernama environment.
2. Buat nilai tag untuk kategori lingkungan yang Anda gunakan. Nilai berikut didukung dan dipetakan ke badge yang sesuai di pemilih project konsol:
   • Prod: Prod, prod, Production, production
   • Dev: Dev, dev, Development, development
   • Pengujian: Test, test, Testing, testing, QA, qa, Quality assurance, quality assurance
   • Staging: Staging, staging, Stage, stage
3. Lampirkan tag yang sesuai ke project Anda dengan membuat pengikatan tag.

Jika project memiliki beberapa tag lingkungan (misalnya, satu diwarisi dari folder dan satu langsung di project), tag yang paling spesifik akan digunakan untuk menentukan badge.

Catatan: Untuk melihat badge lingkungan di pemilih project, pengguna harus memiliki peran Tag Viewer (roles/resourcemanager.tagViewer) di tingkat organisasi atau folder.

Membuat project menggunakan akun layanan

Anda dapat menggunakan akun layanan untuk mengotomatiskan pembuatan project. Seperti akun pengguna, akun layanan dapat diberi izin untuk membuat project dalam resource organisasi. Akun layanan tidak diizinkan untuk membuat project di luar resource organisasi dan harus menentukan resource induk saat membuat project. Akun layanan dapat membuat project baru menggunakan gcloud CLI atau metode projects.create().

Mengelola kuota project

Jika Anda memiliki kurang dari 30 project yang tersisa dalam kuota, notifikasi akan menampilkan jumlah project yang tersisa dalam kuota Anda di halaman Project Baru. Setelah mencapai batas project, untuk membuat lebih banyak project, Anda harus meminta peningkatan batas project. Atau, Anda dapat menjadwalkan penghapusan beberapa project setelah 30 hari di halaman Kelola Resource. Project yang telah dihapus sementara oleh pengguna akan mengurangi kuota Anda. Project ini akan dihapus sepenuhnya setelah 30 hari.

Untuk meminta kapasitas tambahan bagi project dalam kuota organisasi Anda, lakukan hal berikut:

1. Buka halaman Quotas & System Limits.

   Buka Quotas & System Limits

2. Dari pemilih resource, pilih organisasi yang ingin Anda tingkatkan kuota project-nya.

3. Di opsi Filter, pilih Metrik dan masukkan cloudresourcemanager.googleapis.com/projects_count.

4. Pilih Cloud Resource Manager API, klik Tindakan lainnya, lalu pilih Edit kuota.

5. Dalam dialog Perubahan kuota, masukkan nilai kuota baru dan deskripsi, lalu klik Berikutnya.

6. Masukkan detail kontak Anda, lalu klik Kirim permintaan.

Anda akan menerima email yang mengonfirmasi penerimaan permintaan Anda. Jika Anda memerlukan bantuan lebih lanjut, balas email ini. Setelah peninjauan, Anda akan menerima email notifikasi yang menunjukkan apakah permintaan Anda disetujui.

Jika Anda tidak memiliki organisasi dan ingin meminta kapasitas tambahan untuk project dalam kuota Anda, gunakan formulir Minta Peningkatan Kuota Project.

Untuk mengetahui informasi selengkapnya tentang kuota dan alasan penggunaannya, lihat halaman dukungan Permintaan Kuota Project Uji Coba Gratis. Untuk mengetahui informasi selengkapnya tentang laporan penagihan, lihat halaman dukungan Laporan Penagihan.

Langkah berikutnya

• Pelajari cara melihat dan memperbarui project.
• Pelajari cara menghapus dan memulihkan project.
• Pelajari cara memindahkan project dalam hierarki resource Anda.
• Pelajari cara memigrasikan project dari satu resource organisasi ke resource organisasi lain.