Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan cara membuat project perlengkapan air-gapped Google Distributed Cloud (GDC) untuk
mengelompokkan resource Anda bersama-sama dalam suatu lingkungan. Project menyediakan batas kebijakan dan siklus proses untuk resource, sehingga memungkinkan beberapa grup pengguna mengelola resource GDC secara terpisah.
Halaman ini ditujukan untuk audiens seperti administrator IT, engineer keamanan, dan administrator jaringan dalam grup administrator platform, yang bertanggung jawab untuk mengelola resource dalam lingkungan mereka.
Sebelum memulai
Untuk mendapatkan izin yang diperlukan untuk membuat project, minta Admin IAM Organisasi Anda untuk memberi Anda peran Project Creator (project-creator).
Berikut ini digunakan untuk mengidentifikasi project Anda:
Nama project: Nama project yang dapat dibaca manusia.
Nama project tidak digunakan oleh API GDC mana pun. Anda dapat
mengedit nama project kapan saja selama atau setelah pembuatan project. Nama
project tidak harus unik.
Project memiliki persyaratan nama berikut:
Panjangnya 4 hingga 30 karakter.
Berisi huruf kecil, angka, titik, atau tanda hubung.
Project ID: ID unik global untuk project Anda.
Project ID adalah string unik yang digunakan untuk membedakan project Anda dari
project lain di GDC. Anda hanya dapat mengubah project ID
saat membuat project.
ID project memiliki persyaratan berikut:
Terdiri dari 6 hingga 30 karakter.
Berisi huruf kecil, angka, dan tanda hubung.
Dimulai dengan huruf.
Tidak boleh dimulai dengan awalan g-, seperti g-project.
Tidak boleh diakhiri dengan tanda hubung.
Tidak boleh diakhiri dengan string -cluster atau -system. Sufiks -system
dicadangkan untuk project yang dibuat oleh GDC.
Tidak boleh sedang digunakan atau pernah digunakan; hal ini mencakup project yang dihapus.
Nomor project: ID unik yang dibuat secara otomatis untuk project Anda.
Jangan sertakan informasi sensitif dalam nama project, project ID, atau nama resource lainnya. ID project digunakan dalam nama banyak resource GDC lainnya, dan setiap referensi ke project atau resource terkait akan mengekspos ID project dan nama resource.
Membuat project baru
Anda dapat membuat project untuk menyediakan pengelompokan logis resource layanan. Misalnya, Anda dapat membuat project terpisah untuk menyimpan resource untuk lingkungan pengembangan, pengujian, dan produksi.
Untuk mendapatkan izin yang Anda perlukan untuk membuat project, minta Admin IAM Organisasi Anda untuk memberi Anda peran Project Creator. Untuk mengetahui informasi selengkapnya tentang cara memberikan izin, lihat Memberikan dan mencabut akses.
Konsol
Untuk membuat project baru menggunakan konsol GDC, selesaikan langkah-langkah berikut:
Di menu navigasi, klik Projects.
Klik Tambahkan project.
Di kolom Project name, masukkan nama project.
Klik Berikutnya.
Pilih cluster yang ada untuk dilampirkan ke project. Klik
Berikutnya.
Opsional: Konfigurasi kemampuan jaringan project Anda. Hapus centang pada kotak Aktifkan perlindungan eksfiltrasi data untuk menonaktifkan semua traffic keluar ke project lain di dalam organisasi Anda.
Klik Berikutnya.
Di bagian Tinjau, tinjau ringkasan, lalu klik Buat.
Untuk memverifikasi bahwa project baru tersedia, pesan akan ditampilkan di
konsol: Project PROJECT_NAME
successfully created.
gdcloud
Untuk membuat project baru menggunakan gdcloud CLI, selesaikan langkah-langkah berikut:
Pastikan Anda telah menginstal gdcloud CLI. Untuk mengetahui informasi selengkapnya, lihat halaman Ringkasan gcloud CLI.
Untuk membuat project, jalankan:
gdcloudprojectscreate--namePROJECT_ID
Ganti PROJECT_ID dengan ID unik untuk project baru Anda.
Untuk memverifikasi bahwa project baru tersedia, jalankan:
gdcloudprojectslist
API
Untuk membuat project baru menggunakan API secara langsung, terapkan resource kustom ke instance GDC Anda:
Untuk membuat project baru menggunakan kubectl CLI, selesaikan langkah-langkah berikut:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eProjects group resources within an organization, establishing a lifecycle and policy boundary.\u003c/p\u003e\n"],["\u003cp\u003eEach project has a human-readable name, a unique project ID, and an automatically generated project number, each with specific requirements.\u003c/p\u003e\n"],["\u003cp\u003eTo create a project, you need the Project Creator role, granted by an Organization IAM Admin.\u003c/p\u003e\n"],["\u003cp\u003eYou can create a project using the GDC console, the gdcloud CLI, or directly via the API with kubectl, which will create and apply the Project custom resource.\u003c/p\u003e\n"],["\u003cp\u003eProject IDs must be globally unique, meet specific character and prefix requirements, and not have been previously used, including deleted projects.\u003c/p\u003e\n"]]],[],null,["# Create a project\n\nThis page explains how to create a Google Distributed Cloud (GDC) air-gapped appliance project for\ngrouping your resources together within an environment. Projects provide a\nlifecycle and policy boundary for resources, allowing for multiple groups of\nusers to manage GDC resources separately.\n\nThis page is for audiences such as IT administrators, security engineers, and\nnetwork administrators within the platform administrator group, who are\nresponsible for managing resources within their environment.\n\nBefore you begin\n----------------\n\nTo get the permissions needed to create a project, ask your Organization\nIAM Admin to grant you the Project Creator role (`project-creator`).\n\nThe following are used to identify your project:\n\n- **Project name**: A human-readable name for your project.\n\n The project name isn't used by any GDC APIs. You can\n edit the project name at any time during or after project creation. Project\n names don't need to be unique.\n\n Projects have the following name requirements:\n - 4 to 30 characters in length.\n - Contains lowercase letters, numbers, periods, or hyphens.\n- **Project ID**: A globally unique identifier for your project.\n\n A project ID is a unique string used to differentiate your project from all\n others in GDC. You can only modify the project ID\n when you're creating the project.\n | **Note:** The namespaces propagated by a project are the same as the project name.\n\n Project IDs have the following requirements:\n - 6 to 30 characters in length.\n - Contains lowercase letters, numbers, and hyphens.\n - Starts with a letter.\n - Must not start with the prefix `g-`, such as `g-project`.\n - Must not end with a hyphen.\n - Must not end with the string `-cluster` or `-system`. The `-system` suffix is reserved for projects created by GDC.\n - Must not be in use or previously used; this includes deleted projects.\n- **Project number**: An automatically generated unique identifier for your\n project.\n\nDon't include sensitive information in your project name, project ID, or other\nresource names. The project ID is used in the name of many other\nGDC resources, and any reference to the project or\nrelated resources exposes the project ID and resource name.\n\nCreate a new project\n--------------------\n\nYou can create a project to provide logical grouping of service resources. For\nexample, you can create separate projects to hold resources for development,\ntest, and production environments.\n\nTo get the permissions that you need to create a project, ask your Organization\nIAM Admin to grant you the Project Creator role. For more information on\ngranting permissions, see\n[Grant and revoke access](/distributed-cloud/hosted/docs/latest/appliance/platform/pa-user/iam/set-up-role-bindings). \n\n### Console\n\nTo create a new project using the GDC console, complete the\nfollowing steps:\n\n1. In the navigation menu, click **Projects**.\n2. Click **Add project**.\n3. In the **Project name** field, enter a project name.\n4. Click **Next**.\n5. Select the existing clusters to attach to the project. Click\n **Next**.\n\n | **Important:** Clusters must be attached to at least one project.\n6. Optional: Configure your project's networking capabilities. Clear the\n **Enable data exfiltration protection** checkbox to disable all egress\n traffic to other projects inside your organization.\n\n7. Click **Next**.\n\n8. In the **Review** section, review the summary and click **Create**.\n\n9. To verify the new project is available, a message is displayed in the\n console: `Project `\u003cvar class=\"readonly\" translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e`\n successfully created`.\n\n### gdcloud\n\nTo create a new project using the gdcloud CLI, complete the\nfollowing steps:\n\n1. Ensure you have the gdcloud CLI installed. For more\n information, see the gdcloud CLI\n [Overview](/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-overview#download_and_install_the)\n page.\n\n2. To create a project, run:\n\n gdcloud projects create --name \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e with the unique identifier for\n your new project.\n3. To verify the new project is available, run:\n\n gdcloud projects list\n\n### API\n\nTo create a new project using the API directly, apply a custom resource\nto your GDC instance:\n\nTo create a new project using the `kubectl` CLI, complete the following\nsteps:\n\n1. Create and apply the `Project` custom resource:\n\n kubectl apply -f - \u003c\u003cEOF\n apiVersion: resourcemanager.gdc.goog/v1\n kind: Project\n metadata:\n namespace: platform\n name: \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e\n EOF\n\n Replace \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e with the name of your project.\n2. Verify the new project is available:\n\n kubectl get namespaces"]]
