Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite wird beschrieben, wie Sie ein Google Distributed Cloud-Projekt (GDC) ohne Internetverbindung erstellen, um Ihre Ressourcen in einer Organisation zu gruppieren. Projekte bieten einen Lebenszyklus und eine Richtliniengrenze für Ressourcen, sodass mehrere Nutzergruppen GDC-Ressourcen separat verwalten können.
Diese Seite richtet sich an Nutzer wie IT‑Administratoren, Sicherheitsexperten und Netzwerkadministratoren in der Gruppe der Plattformadministratoren, die für die Verwaltung von Ressourcen in ihrer Organisation verantwortlich sind. Weitere Informationen finden Sie in der Dokumentation zu Zielgruppen für GDC-Air-Gap-Umgebungen.
Hinweise
Bitten Sie Ihren Organisations-IAM-Administrator, Ihnen die Rolle „Projektersteller“ (project-creator) zuzuweisen, um die Berechtigungen zu erhalten, die zum Erstellen eines Projekts erforderlich sind.
Bevor Sie ein Projekt erstellen, sollten Sie sich ansehen, welche Informationen Google Distributed Cloud (GDC) Air-gapped verwendet, um Ihr Projekt zu identifizieren:
Projektname: ein von Menschen lesbarer Name für das Projekt
Der Projektname wird von den GDC APIs nicht verwendet. Sie können den Projektnamen während oder nach der Projekterstellung bearbeiten. Projektnamen müssen nicht eindeutig sein.
Für Projektnamen gelten die folgenden Anforderungen:
Es muss 4 bis 30 Zeichen lang sein.
Darf nur Buchstaben, Zahlen, einfache Anführungszeichen, Bindestriche, Leerzeichen oder Ausrufezeichen enthalten.
Projekt-ID: eine global nur einmal vorkommende Kennzeichnung für das Projekt
Eine Projekt-ID ist ein eindeutiger String, mit dem Ihr Projekt von allen anderen in GDC unterschieden wird. Sie können die Projekt-ID nur ändern, wenn Sie das Projekt erstellen.
Für Projekt-IDs gelten die folgenden Anforderungen:
Muss zwischen 6 und 30 Zeichen lang sein.
Enthält Kleinbuchstaben, Ziffern und Bindestriche.
Beginnt mit einem Buchstaben.
Darf nicht mit dem Präfix g- beginnen, z. B. g-project.
Darf nicht mit einem Bindestrich enden.
Darf nicht mit der Zeichenfolge -cluster oder -system enden. Das Suffix -system ist für Projekte reserviert, die von GDC erstellt wurden.
Darf nicht derzeit verwendet werden oder zuvor verwendet worden sein. Dies gilt auch für gelöschte Projekte.
Der Projektname, die Projekt-ID oder andere Ressourcennamen sollten keine vertraulichen Informationen enthalten. Die Projekt-ID wird im Namen vieler anderer GDC-Ressourcen verwendet. Bei jedem Verweis auf das Projekt oder zugehörige Ressourcen werden die Projekt-ID und der Ressourcenname offengelegt.
Neues Projekt erstellen
Sie können ein Projekt erstellen, um Dienstressourcen logisch zu gruppieren. Sie können beispielsweise separate Projekte erstellen, um Ressourcen für Entwicklungs-, Test- und Produktionsumgebungen zu speichern.
Bitten Sie Ihren Organisations-IAM-Administrator, Ihnen die Rolle „Project Creator“ (Projektersteller) zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines Projekts benötigen. Weitere Informationen zum Zuweisen von Berechtigungen finden Sie im Abschnitt Rollenbindung der Dienstidentität zuweisen.
Console
So erstellen Sie ein neues Projekt mit der GDC Console:
Klicken Sie im Navigationsmenü auf Projekte.
Klicken Sie auf Projekt hinzufügen.
Geben Sie im Feld Projektname einen Projektnamen ein.
Klicken Sie auf Weiter.
Optional: Konfigurieren Sie die Netzwerkfunktionen Ihres Projekts. Entfernen Sie das Häkchen aus dem Kästchen Schutz vor Datenexfiltration aktivieren, um den gesamten Egress-Traffic zu anderen Projekten in Ihrer Organisation zu deaktivieren.
Klicken Sie auf Weiter.
Sehen Sie sich im Bereich Überprüfen die Zusammenfassung an und klicken Sie auf Erstellen.
Um zu prüfen, ob das neue Projekt verfügbar ist, wird in der Konsole die Meldung Project PROJECT_NAME
successfully created angezeigt.
Verknüpfen Sie Ihr neues Projekt mit einem Rechnungskonto. Wenn Sie die Kosten für Projektressourcen nachverfolgen möchten, muss Ihrem Projekt ein Rechnungskonto zugewiesen sein.
gdcloud
So erstellen Sie ein neues Projekt mit der gcloud CLI:
Prüfen Sie, ob die gcloud CLI installiert ist. Weitere Informationen finden Sie auf der Seite Übersicht zur gcloud CLI.
Führen Sie Folgendes aus, um ein Projekt zu erstellen:
gdcloudprojectscreatePROJECT_ID
Ersetzen Sie PROJECT_ID durch die eindeutige Kennung für Ihr neues Projekt.
Führen Sie Folgendes aus, um zu prüfen, ob das neue Projekt verfügbar ist:
gdcloudprojectslist
Verknüpfen Sie Ihr neues Projekt mit einem Rechnungskonto. Wenn Sie die Kosten für Projektressourcen nachverfolgen möchten, muss Ihrem Projekt ein Rechnungskonto zugewiesen sein.
API
So erstellen Sie ein neues Projekt direkt über die API:
Legen Sie eine Umgebungsvariable für die kubeconfig-Datei des globalen Management-API-Servers fest:
exportKUBECONFIG=GLOBAL_API_SERVER_KUBECONFIG
Wenn Sie die kubeconfig-Datei des globalen Management-API-Servers nicht haben, generieren Sie eine.
Erstellen und wenden Sie die benutzerdefinierte Ressource Project an:
Ersetzen Sie PROJECT_ID durch die eindeutige Kennung für Ihr neues Projekt.
Prüfen Sie, ob das neue Projekt verfügbar ist:
kubectl--kubeconfig=${KUBECONFIG}getnamespaces
Verknüpfen Sie Ihr neues Projekt mit einem Rechnungskonto. Wenn Sie die Kosten für Projektressourcen nachverfolgen möchten, muss Ihrem Projekt ein Rechnungskonto zugewiesen sein.
Terraform
So erstellen Sie ein neues Projekt mit Terraform:
Prüfen Sie, ob Terraform konfiguriert ist und die entsprechenden Berechtigungen festgelegt sind.
Weitere Informationen finden Sie auf der Seite Terraform konfigurieren.
Fügen Sie in eine Terraform-Konfigurationsdatei das folgende Code-Snippet ein:
Ersetzen Sie GLOBAL_API_SERVER_KUBECONFIG durch den Pfad zur kubeconfig-Datei des globalen Management-API-Servers. Wenn Sie diese kubeconfig-Datei nicht haben, generieren Sie eine.
Fügen Sie in eine Terraform-Konfigurationsdatei, z. B. main.tf, das folgende Code-Snippet ein:
Ersetzen Sie PROJECT_ID durch die eindeutige Kennung für Ihr neues Projekt.
Wenden Sie das neue Projekt mit Terraform an:
terraformapply
Verknüpfen Sie Ihr neues Projekt mit einem Rechnungskonto. Wenn Sie die Kosten für Projektressourcen nachverfolgen möchten, muss Ihrem Projekt ein Rechnungskonto zugewiesen sein.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[[["\u003cp\u003eProjects group resources within an organization, establishing a lifecycle and policy boundary.\u003c/p\u003e\n"],["\u003cp\u003eEach project requires a unique Project ID, which must be 6-30 characters long, contain lowercase letters, numbers, and hyphens, start with a letter, and not end with a hyphen, \u003ccode\u003e-cluster\u003c/code\u003e, or \u003ccode\u003e-system\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eProject names are human-readable, can be edited anytime, do not need to be unique, and must be between 4 to 30 characters in length.\u003c/p\u003e\n"],["\u003cp\u003eYou can create projects using the GDC console, the gdcloud CLI, directly via the API, or with Terraform.\u003c/p\u003e\n"],["\u003cp\u003eAfter creating a project, it is necessary to link it to a billing account to monitor project resource costs.\u003c/p\u003e\n"]]],[],null,["# Create a project\n\nThis page explains how to create a Google Distributed Cloud (GDC) air-gapped project for\ngrouping your resources together within an organization. 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 organization. For more information,\nsee [Audiences for GDC air-gapped documentation](/distributed-cloud/hosted/docs/latest/gdch/resources/audiences).\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\nBefore you create a project, review the information Google Distributed Cloud (GDC) air-gapped\nuses 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 letters, numbers, single quotes, hyphens, spaces, or exclamation points.\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 ID.\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\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 the\n[Assign a role binding to the service identity](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/service-identity#assign_a_role_binding_to_the_service_identity)\nsection. \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 **Continue**.\n5. Optional: Configure your project's networking capabilities. Clear the **Enable data exfiltration protection** checkbox to disable all egress traffic to other projects inside your organization.\n6. Click **Continue**.\n7. In the **Review** section, review the summary and click **Create**.\n8. To verify the new project is available, a message is displayed in the console: `Project `\u003cvar class=\"readonly\" translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e`\n successfully created`.\n9. [Link your new project](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/billing/manage-billing-accounts#link_a_project) with a billing account. To track project resource costs, you must have an associated billing account linked to your project.\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/gdch/resources/gdcloud-overview#download_and_install_the)\n page.\n\n2. To create a project, run:\n\n gdcloud projects create \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.\n | **Important:** The gdcloud CLI does not support attaching a project to a Kubernetes cluster. You must do this in the GDC console after the project is created by following [Attach project to a cluster](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/cluster#attach-project-to-cluster).\n3. To verify the new project is available, run:\n\n gdcloud projects list\n\n4. [Link your new project](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/billing/manage-billing-accounts#link_a_project)\n with a billing account. To track project resource costs, you must have\n an associated billing account linked to your project.\n\n### API\n\nTo create a new project using the API directly, complete the following\nsteps:\n\n1. Set an environment variable for the global management API server\n kubeconfig file:\n\n export KUBECONFIG=\u003cvar translate=\"no\"\u003eGLOBAL_API_SERVER_KUBECONFIG\u003c/var\u003e\n\n If you don't have the global management API server kubeconfig file,\n [generate one](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/sign-in).\n2. Create and apply the `Project` custom resource:\n\n kubectl apply -f --kubeconfig=${KUBECONFIG} - \u003c\u003cEOF\n apiVersion: resourcemanager.global.gdc.goog/v1\n kind: Project\n metadata:\n namespace: platform\n name: \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n EOF\n\n Replace \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e with the unique identifier\n for your new project.\n | **Important:** The `Project` custom resource does not directly support attaching a Kubernetes cluster. You must do this in the GDC console after the project is provisioned by following [Attach project to a cluster](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/cluster#attach-project-to-cluster).\n3. Verify the new project is available:\n\n kubectl --kubeconfig=${KUBECONFIG} get namespaces\n\n4. [Link your new project](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/billing/manage-billing-accounts#link_a_project)\n with a billing account. To track project resource costs, you must have\n an associated billing account linked to your project.\n\n### Terraform\n\nTo create a new project using Terraform, complete the following\nsteps:\n\n1. Ensure you have Terraform configured and the appropriate permissions set.\n For more information, see the\n [Configure Terraform](/distributed-cloud/hosted/docs/latest/gdch/resources/configure-terraform) page.\n\n2. In a Terraform configuration file, insert the following code snippet:\n\n provider \"kubernetes\" {\n config_path = \"\u003cvar translate=\"no\"\u003eGLOBAL_API_SERVER_KUBECONFIG\u003c/var\u003e\"\n }\n\n Replace \u003cvar translate=\"no\"\u003eGLOBAL_API_SERVER_KUBECONFIG\u003c/var\u003e with the path to\n the global management API server's kubeconfig file. If you don't have this\n kubeconfig file,\n [generate one](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/sign-in).\n3. In a Terraform configuration file, such as `main.tf`, insert the\n following code snippet:\n\n resource \"kubernetes_manifest\" \"project-create\" {\n manifest = {\n \"apiVersion\" = \"resourcemanager.global.gdc.goog/v1\"\n \"kind\" = \"Project\"\n \"metadata\" = {\n \"name\" = \"\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\"\n \"namespace\" = \"platform\"\n }\n }\n }\n\n Replace \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e with the unique identifier\n for your new project.\n | **Important:** The `Project` Kubernetes manifest does not directly support attaching a Kubernetes cluster. You must do this in the GDC console after the project is provisioned by following [Attach project to a cluster](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/cluster#attach-project-to-cluster).\n4. Apply the new project using Terraform:\n\n terraform apply\n\n5. [Link your new project](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/billing/manage-billing-accounts#link_a_project)\n with a billing account. To track project resource costs, you must have\n an associated billing account linked to your project."]]
