Membuat project

Project adalah unit operasi dasar dalam hierarki resource Google Cloud dan memungkinkan Anda mengatur, mengisolasi, dan mengontrol resource cloud Anda. Berada di antara folder (atau resource organisasi) dan resource layanan seperti virtual machine dan penyimpanan, project membantu Anda mengelola API, penagihan, dan izin di seluruh lingkungan. Untuk membuat dan mengelola project, Anda dapat menggunakan konsol Google Cloud , Google Cloud CLI, atau Cloud Resource Manager API.

Karakteristik utama project

Karakteristik utama project meliputi:

• Penampung layanan utama: Project adalah level dasar tempat Anda mengaktifkan layanan (API) dan membuat resource seperti instance Compute Engine atau set data BigQuery. Google Cloud

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

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

• Titik lampiran kebijakan: Meskipun project mewarisi kebijakan dari folder dan resource organisasi, level project adalah tempat paling umum untuk memberikan izin Identity and Access Management (IAM) tertentu kepada developer dan akun layanan untuk tugas harian.

Sebelum memulai

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

ID berikut digunakan untuk project Anda:

• Nama project: Nama yang dapat dibaca manusia untuk project Anda.

  Nama project memiliki persyaratan berikut:

  • Harus terdiri dari 4 hingga 30 karakter.
  • Nama ini dapat berisi huruf, angka, tanda kutip tunggal, tanda hubung, spasi, atau tanda seru.
  • ID ini harus diakhiri dengan huruf atau angka.

  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 secara global untuk project Anda.

  Project ID adalah string unik yang membedakan project Anda dari project lain di Google Cloud. Setelah Anda memasukkan nama project, Google Cloud console 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, project ID bersifat permanen.

  Project ID memiliki persyaratan berikut:

  • Panjangnya harus antara 6 hingga 30 karakter.
  • Nama ini hanya boleh berisi huruf kecil, angka, dan tanda hubung.
  • Nama harus diawali dengan huruf.
  • ID tidak boleh diakhiri dengan tanda hubung.
  • ID project tidak boleh sedang digunakan atau pernah digunakan sebelumnya; ini termasuk project yang dihapus.
  • ID tersebut tidak boleh berisi string yang dibatasi seperti google dan ssl. Hindari penggunaan string seperti undefined dan null dalam project ID.

• Nomor project: Nomor project adalah ID unik yang dibuat secara otomatis untuk project Anda. Untuk menemukan nomor project, lihat Mengidentifikasi project.

Jangan menyertakan informasi sensitif, misalnya, informasi identitas pribadi atau data keamanan, dalam nama project, project ID, atau nama resource lainnya. Project ID muncul dalam nama banyak resource Google Cloud lainnya. Mereferensikan project atau resource-nya akan mengekspos project ID 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).

Untuk mengetahui informasi tentang cara memberikan peran kepada individu dan membatasi akses luas 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 tindakan berikut:

1. Buka halaman Manage resources di konsol Google Cloud .

   Buka Kelola Resource

   Langkah-langkah selanjutnya akan muncul di konsol Google Cloud .

2. Klik Create project.
3. Di jendela New project 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 sampai 30 karakter.
   Catatan: Akun penagihan hanya tersedia untuk dipilih jika Anda memiliki peran Billing Account User (roles/billing.user) di organisasi atau akun penagihan. Jika diberikan bersamaan dengan peran Project Creator (roles/resourcemanager.projectCreator), peran ini memungkinkan Anda membuat project baru yang ditautkan ke akun penagihan tersebut. Jika diberikan bersama dengan peran Project Billing Manager (roles/billing.projectManager), peran ini memungkinkan Anda menautkan dan membatalkan tautan project di akun penagihan.
4. Masukkan resource folder atau organisasi induk di kotak Parent resource. 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.
5. Setelah selesai memasukkan detail project baru, klik Create.

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

   gcloud projects create PROJECT_ID
   

   Dengan PROJECT_ID sebagai ID untuk project yang ingin Anda buat. Project ID 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 salah satu flag berikut 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 dalam project ID saat membuat project baru dengan metode projects.create(). Beberapa contohnya mencakup google, null, undefined, dan ssl. Saat Anda menggunakan kata yang dilarang, permintaan akan menampilkan 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.

Membuat Permintaan Project:

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

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

Respons Pembuatan Project:

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

Mendapatkan Permintaan Operasi:

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

Respons Operasi Get:

{
    "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 menyediakan cara untuk membuat anotasi untuk resource. Anda dapat menambahkan tag saat membuat project. Anda harus menetapkan peran Tag User 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 key-value pair yang dipisahkan koma yang dapat Anda tetapkan ke resource. Contoh key-value pair yang dipisahkan koma adalah 123/environment=production, 456/create=testresource. Dalam contoh ini, 123 dan 456 adalah ID unik (ID) resource organisasi atau folder tempat kunci tag ditentukan.

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"
  }
}

Menentukan lingkungan project dengan tag

Anda dapat menggunakan tag untuk membedakan project secara visual berdasarkan lingkungannya, seperti produksi, staging, atau pengembangan. Hal ini membantu mencegah error dan meningkatkan kesadaran 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 pada 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 binding tag.

Jika project memiliki beberapa tag lingkungan (misalnya, satu tag yang diwarisi dari folder dan satu tag 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

Jumlah project yang dapat dibuat oleh pengguna atau akun layanan dibatasi. Jika Anda membuat project di luar resource organisasi, kuota pada akun pengguna Anda akan digunakan. Jika Anda membuat project dalam resource organisasi, kuota pada akun pengguna dan resource organisasi akan diperiksa. Jika salah satunya masih memiliki kuota, project dapat dibuat.

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 beberapa project untuk dihapus 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 untuk 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 Metric dan masukkan cloudresourcemanager.googleapis.com/projects_count.

4. Pilih Cloud Resource Manager API, klik More actions, lalu pilih Edit quota.

5. Dalam dialog Quota changes, masukkan nilai kuota baru dan deskripsi, lalu klik Next.

6. Masukkan detail kontak Anda, lalu klik Submit request.

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

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

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 lainnya.