Cette page explique comment créer un projet d'appliance Google Distributed Cloud (GDC) air-gapped pour regrouper vos ressources dans un environnement. Les projets fournissent une limite de cycle de vie et 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 à des 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 dans leur environnement.
Avant de commencer
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 (project-creator).
Les éléments suivants sont utilisés pour identifier votre projet :
Nom de projet : nom lisible attribué à votre projet.
Le nom du projet n'est utilisé par aucune API GDC. Vous pouvez modifier le nom du projet à tout moment pendant ou après sa création. Les noms de projet ne doivent pas nécessairement être uniques.
Les noms de projet doivent respecter les exigences suivantes :
- Entre 4 et 30 caractères.
- Contenir des lettres minuscules, des chiffres, des points ou des traits d'union.
ID du 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 du projet que lorsque vous créez le projet.
Les ID de projet doivent respecter les exigences suivantes :
- Entre 6 et 30 caractères.
- Contenir des lettres minuscules, des chiffres et des traits d'union.
- Commencer par une lettre.
- Ne pas commencer par le préfixe
g-, tel queg-project. - Ne pas se terminer par un trait d'union.
- Ne pas se terminer par la chaîne
-clusterou-system. Le suffixe-systemest réservé aux projets créés par GDC. - Ne pas être utilisé ou avoir été utilisé auparavant, y compris pour les projets supprimés.
Numéro de projet : identifiant unique généré automatiquement pour votre projet.
N'incluez aucune information sensible dans le nom de votre projet, l'ID de votre projet ou les autres noms de ressources. L'ID de projet est utilisé dans le nom de nombreuses autres ressources GDC, et toute référence au projet ou aux ressources associées expose l'ID du projet et le nom de la ressource.
Créer 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 Accorder et révoquer l'accès.
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 un nom de projet.
- Cliquez sur Suivant.
Sélectionnez les clusters existants à associer au projet. Cliquez sur Suivant.
Facultatif : configurez les fonctionnalité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 Suivant.
Dans la section Vérifier , vérifiez le résumé, 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.
gdcloud
Pour créer un projet à l'aide de la gdcloud CLI, procédez comme suit :
Assurez-vous que la gdcloud CLI est installée. Pour en savoir plus, consultez la page Présentation de la gdcloud CLI Overview.
Pour créer un projet :
gdcloud projects create PROJECT_IDRemplacez
PROJECT_IDpar l'identifiant unique de votre nouveau projet.Pour vérifier que le nouveau projet est disponible, exécutez la commande suivante :
gdcloud projects list
API
Pour créer un projet directement à l'aide de l'API, appliquez une ressource personnalisée à votre instance GDC :
Pour créer un projet à l'aide de la kubectl CLI, procédez comme suit :
Créez et appliquez la ressource personnalisée
Project:kubectl apply -f - <<EOF apiVersion: resourcemanager.gdc.goog/v1 kind: Project metadata: namespace: platform name: PROJECT_NAME EOFRemplacez
PROJECT_NAMEpar le nom de votre projet.Vérifiez que le nouveau projet est disponible :
kubectl get namespaces