Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page explique comment créer un projet Google Distributed Cloud (GDC) isolé pour regrouper vos ressources au sein d'une organisation. Les projets fournissent un cycle de vie et une limite de stratégie pour les ressources, ce qui permet à plusieurs groupes d'utilisateurs de gérer les ressources GDC séparément.
Cette page s'adresse aux audiences telles que les administrateurs informatiques, les ingénieurs en sécurité et les administrateurs réseau du groupe d'administrateurs de plate-forme, qui sont chargés de gérer les ressources au sein de leur organisation. Pour en savoir plus, consultez la documentation sur les audiences pour GDC en mode air-gapped.
Avant de commencer
Pour obtenir les autorisations nécessaires pour créer un projet, demandez à votre administrateur IAM de l'organisation de vous accorder le rôle Créateur de projet (project-creator).
Avant de créer un projet, examinez les informations utilisées par Google Distributed Cloud (GDC) air-gapped pour identifier votre projet :
Nom de projet : nom lisible attribué à votre projet.
Le nom de projet n'est utilisé par aucune API GDC. Vous pouvez modifier le nom d'un projet à tout moment, aussi bien pendant qu'après la création du projet. Les noms de projet ne doivent pas nécessairement être uniques.
Les noms de projet doivent respecter les exigences suivantes :
Comporter entre 4 et 30 caractères.
Contient des lettres, des chiffres, des guillemets simples, des traits d'union, des espaces ou des points d'exclamation.
ID de projet : identifiant unique global pour votre projet.
Un ID de projet est une chaîne unique utilisée pour différencier votre projet de tous les autres dans GDC. Vous ne pouvez modifier l'ID d'un projet que lorsque vous le créez.
Les ID de projet doivent répondre aux exigences suivantes :
Comporter entre 6 et 30 caractères.
Contient des lettres minuscules, des chiffres et des traits d'union.
Commence par une lettre.
Ne doit pas commencer par le préfixe g-, comme g-project.
Ne doit pas se terminer par un trait d'union.
ne pas se terminer par la chaîne -cluster ou -system ; Le suffixe -system est réservé aux projets créés par GDC.
Il ne doit pas être déjà utilisé ou avoir été utilisé précédemment (y compris pour des projets supprimés).
N'incluez aucune information sensible dans le nom de votre projet, l'ID de votre projet ou les autres noms de ressources. L'ID du projet est utilisé dans le nom de nombreuses autres ressources GDC. Toute référence au projet ou aux ressources associées expose l'ID du projet et le nom de la ressource.
Créez un projet
Vous pouvez créer un projet pour regrouper logiquement les ressources de service. Par exemple, vous pouvez créer des projets distincts pour héberger les ressources des environnements de développement, de test et de production.
Pour obtenir les autorisations nécessaires pour créer un projet, demandez à votre administrateur IAM de l'organisation de vous attribuer le rôle Créateur de projet. Pour en savoir plus sur l'attribution d'autorisations, consultez la section Attribuer une liaison de rôle à l'identité de service.
Console
Pour créer un projet à l'aide de la console GDC, procédez comme suit :
Dans le menu de navigation, cliquez sur Projets.
Cliquez sur Ajouter un projet.
Dans le champ Nom du projet, saisissez le nom du projet.
Cliquez sur Continuer.
Facultatif : configurez les capacités réseau de votre projet. Décochez la case Activer la protection contre l'exfiltration de données pour désactiver tout le trafic sortant vers d'autres projets de votre organisation.
Cliquez sur Continuer.
Dans la section Vérifier, vérifiez le récapitulatif, puis cliquez sur Créer.
Pour vérifier que le nouveau projet est disponible, un message s'affiche dans la console : Project PROJECT_NAME
successfully created.
Associez votre nouveau projet à un compte de facturation. Pour suivre les coûts des ressources d'un projet, vous devez disposer d'un compte de facturation associé à votre projet.
gdcloud
Pour créer un projet à l'aide de la CLI gdcloud, procédez comme suit :
Assurez-vous d'avoir installé gdcloud CLI. Pour en savoir plus, consultez la page Présentation de la gcloud CLI.
Pour créer un projet, exécutez :
gdcloudprojectscreatePROJECT_ID
Remplacez PROJECT_ID par l'identifiant unique de votre nouveau projet.
Pour vérifier que le nouveau projet est disponible, exécutez la commande suivante :
gdcloudprojectslist
Associez votre nouveau projet à un compte de facturation. Pour suivre les coûts des ressources d'un projet, vous devez disposer d'un compte de facturation associé à votre projet.
API
Pour créer un projet directement à l'aide de l'API, procédez comme suit :
Définissez une variable d'environnement pour le fichier kubeconfig du serveur de l'API de gestion globale :
exportKUBECONFIG=GLOBAL_API_SERVER_KUBECONFIG
Si vous ne disposez pas du fichier kubeconfig du serveur d'API de gestion globale, générez-en un.
Créez et appliquez la ressource personnalisée Project :
Remplacez PROJECT_ID par l'identifiant unique de votre nouveau projet.
Vérifiez que le nouveau projet est disponible :
kubectl--kubeconfig=${KUBECONFIG}getnamespaces
Associez votre nouveau projet à un compte de facturation. Pour suivre les coûts des ressources d'un projet, vous devez disposer d'un compte de facturation associé à votre projet.
Terraform
Pour créer un projet à l'aide de Terraform, procédez comme suit :
Assurez-vous que Terraform est configuré et que les autorisations appropriées sont définies.
Pour en savoir plus, consultez la page Configurer Terraform.
Dans un fichier de configuration Terraform, insérez l'extrait de code suivant :
Remplacez GLOBAL_API_SERVER_KUBECONFIG par le chemin d'accès au fichier kubeconfig du serveur de l'API de gestion globale. Si vous ne possédez pas ce fichier kubeconfig, générez-en un.
Dans un fichier de configuration Terraform, tel que main.tf, insérez l'extrait de code suivant :
Remplacez PROJECT_ID par l'identifiant unique de votre nouveau projet.
Appliquez le nouveau projet à l'aide de Terraform :
terraformapply
Associez votre nouveau projet à un compte de facturation. Pour suivre les coûts des ressources d'un projet, vous devez disposer d'un compte de facturation associé à votre projet.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]
