gcloud : projets, API et IAM
Un principal s'écrit user:EMAIL, group:EMAIL, serviceAccount:EMAIL ou domain:DOMAINE. Un rôle prédéfini s'écrit roles/SERVICE.ROLE, un rôle personnalisé projects/PROJECT_ID/roles/ROLE_ID ou organizations/ORG_ID/roles/ROLE_ID.
Projets, dossiers et facturation
| Objectif | Syntaxe | Résultat |
|---|---|---|
| Créer un projet dans un dossier | gcloud projects create PROJECT_ID --folder=FOLDER_ID --labels=env=dev |
ID de 6 à 30 caractères, minuscules, chiffres et tirets, non modifiable ; --organization=ORG_ID pour le placer à la racine |
| Décrire un projet | gcloud projects describe PROJECT_ID |
Numéro, parent, état (ACTIVE, DELETE_REQUESTED), labels |
| Lister les projets d'un dossier | gcloud projects list --filter="parent.id=FOLDER_ID" |
Projets directement sous ce dossier, pas ceux des sous-dossiers |
| Remonter la hiérarchie | gcloud projects get-ancestors PROJECT_ID |
Projet, dossiers parents, organisation |
| Supprimer un projet | gcloud projects delete PROJECT_ID |
Projet arrêté puis supprimé définitivement après 30 jours |
| Restaurer un projet supprimé | gcloud projects undelete PROJECT_ID |
Possible pendant les 30 jours qui précèdent la suppression définitive |
| préversion Déplacer un projet | gcloud beta projects move PROJECT_ID --folder=FOLDER_ID |
Le projet hérite ensuite des stratégies du nouveau parent |
| Trouver l'organisation | gcloud organizations list |
Nom de domaine et ID numérique |
| Créer un dossier | gcloud resource-manager folders create --display-name=NOM --organization=ORG_ID |
--folder=FOLDER_ID pour un sous-dossier |
| Lister les dossiers | gcloud resource-manager folders list --organization=ORG_ID |
Premier niveau seulement ; répéter avec --folder pour descendre |
| Lister les comptes de facturation | gcloud billing accounts list |
ID de la forme XXXXXX-XXXXXX-XXXXXX, statut ouvert ou fermé |
| Rattacher un projet à la facturation | gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID |
Exige roles/billing.user sur le compte de facturation et le droit de modifier la facturation du projet |
| Vérifier la facturation d'un projet | gcloud billing projects describe PROJECT_ID |
billingEnabled: true et le compte rattaché |
| Détacher la facturation | gcloud billing projects unlink PROJECT_ID |
Les ressources payantes du projet s'arrêtent |
API (services)
| Objectif | Syntaxe | Résultat |
|---|---|---|
| Activer des API | gcloud services enable run.googleapis.com artifactregistry.googleapis.com |
Plusieurs services en une commande ; quelques minutes de propagation possibles |
| Lister les API activées | gcloud services list --enabled |
Nom et titre de chaque service |
| Chercher le nom d'une API | gcloud services list --available --filter="name:bigquery" |
Services activables dont le nom contient ce mot |
| Désactiver une API | gcloud services disable SERVICE.googleapis.com |
Refusé si d'autres API activées en dépendent ou si l'API a servi récemment ; --force passe outre et désactive aussi les API dépendantes |
| préversion Créer l'agent de service d'une API | gcloud beta services identity create --service=SERVICE.googleapis.com --project=PROJECT_ID |
Adresse de l'agent de service, à qui donner un rôle avant la première utilisation (CMEK, par exemple) |
Stratégie d'autorisation (IAM)
| Objectif | Syntaxe | Résultat |
|---|---|---|
| Donner un rôle sur un projet | gcloud projects add-iam-policy-binding PROJECT_ID --member=group:GROUPE@DOMAINE --role=roles/bigquery.dataViewer |
Liaison ajoutée ; la stratégie complète s'affiche en retour |
| Donner un rôle sur un dossier | gcloud resource-manager folders add-iam-policy-binding FOLDER_ID --member=... --role=... |
Hérité par tous les projets du dossier |
| Donner un rôle sur l'organisation | gcloud organizations add-iam-policy-binding ORG_ID --member=... --role=... |
Hérité par toute l'organisation |
| Rôle temporaire (condition) | gcloud projects add-iam-policy-binding PROJECT_ID --member=user:EMAIL --role=roles/compute.admin --condition='expression=request.time < timestamp("2026-12-31T23:59:59Z"),title=jusqua-fin-2026' |
Liaison conditionnelle en CEL ; interdit sur les rôles de base (owner, editor, viewer) |
| Condition dont l'expression contient une virgule | --condition='^;^title=env-prod;expression=resource.matchTag("ORG_ID/env", "prod")' |
^;^ change le séparateur des paires clé=valeur ; ici, accès limité aux ressources portant le tag env=prod |
| Ajouter sans condition dans une stratégie qui en a | --condition=None |
Sans cette valeur, gcloud demande quelle condition utiliser, ou échoue en mode --quiet |
| Retirer un rôle | gcloud projects remove-iam-policy-binding PROJECT_ID --member=user:EMAIL --role=ROLE |
--all retire aussi toutes les variantes conditionnelles de la liaison |
| Qui a un rôle donné | gcloud projects get-iam-policy PROJECT_ID --flatten="bindings[].members" --filter="bindings.role=roles/owner" --format="value(bindings.members)" |
Un principal par ligne |
| Quels rôles a un principal | gcloud projects get-iam-policy PROJECT_ID --flatten="bindings[].members" --filter="bindings.members=user:EMAIL" --format="value(bindings.role)" |
Liaisons directes sur le projet seulement, sans l'héritage ni les groupes |
| Exporter puis réécrire la stratégie | gcloud projects get-iam-policy PROJECT_ID --format=json > policy.json puis gcloud projects set-iam-policy PROJECT_ID policy.json |
Remplace la stratégie entière ; l'etag du fichier fait échouer l'écriture si elle a changé entre-temps |
| Pourquoi un accès est accordé ou refusé | gcloud policy-intelligence troubleshoot-policy iam //cloudresourcemanager.googleapis.com/projects/PROJECT_ID --principal-email=EMAIL --permission=PERMISSION |
Liaisons examinées sur toute la hiérarchie, avec leur verdict |
set-iam-policyécrase toute la stratégie : un fichier obsolète retire des accès sans prévenir. Pour ajouter ou retirer un accès, préféreradd-etremove-iam-policy-binding, qui relisent la stratégie à chaque appel.
Comptes de service
| Objectif | Syntaxe | Résultat |
|---|---|---|
| Créer un compte de service | gcloud iam service-accounts create SA_NAME --display-name="Pipeline ventes" |
Adresse SA_NAME@PROJECT_ID.iam.gserviceaccount.com ; aucun rôle par défaut |
| Lister les comptes de service | gcloud iam service-accounts list --format="table(email, disabled)" |
Inclut les comptes de service par défaut du projet |
| Lister les clés gérées par l'utilisateur | gcloud iam service-accounts keys list --iam-account=SA@PROJECT_ID.iam.gserviceaccount.com --managed-by=user |
Clés téléchargées, donc à auditer ; system : clés gérées par Google |
| Supprimer une clé | gcloud iam service-accounts keys delete KEY_ID --iam-account=SA@PROJECT_ID.iam.gserviceaccount.com |
Les applications qui l'utilisent perdent l'accès aussitôt |
| Autoriser l'emprunt d'identité | gcloud iam service-accounts add-iam-policy-binding SA@PROJECT_ID.iam.gserviceaccount.com --member=user:EMAIL --role=roles/iam.serviceAccountTokenCreator |
Rôle donné sur le compte de service, pas sur le projet : l'utilisateur peut émettre des jetons courts pour ce seul compte |
| Autoriser l'attachement à une ressource | gcloud iam service-accounts add-iam-policy-binding SA@PROJECT_ID.iam.gserviceaccount.com --member=user:EMAIL --role=roles/iam.serviceAccountUser |
Permet de déployer une VM, un service Cloud Run ou un job avec ce compte de service |
| Obtenir un jeton en tant que compte de service | gcloud auth print-access-token --impersonate-service-account=SA@PROJECT_ID.iam.gserviceaccount.com |
Jeton court, sans clé |
| Désactiver un compte de service | gcloud iam service-accounts disable SA@PROJECT_ID.iam.gserviceaccount.com |
Réversible par enable ; à faire avant une suppression pour vérifier que rien ne casse |
Ne pas créer de clé de compte de service (
gcloud iam service-accounts keys create) : une clé est un secret longue durée qui fuit facilement. Emprunter l'identité depuis un poste, attacher le compte de service à la ressource dans Google Cloud, et utiliser la fédération d'identité de charge de travail depuis l'extérieur. La contrainteiam.managed.disableServiceAccountKeyCreationbloque leur création.
Rôles
| Objectif | Syntaxe | Résultat |
|---|---|---|
| Permissions d'un rôle | gcloud iam roles describe roles/storage.objectViewer |
includedPermissions, titre, niveau de publication |
| Chercher un rôle prédéfini | gcloud iam roles list --filter="name:bigquery" --format="table(name, title)" |
Sans --project ni --organization, la commande liste les rôles prédéfinis |
| Rôles attribuables sur une ressource | gcloud iam list-grantable-roles //cloudresourcemanager.googleapis.com/projects/PROJECT_ID |
Rôles applicables à ce type de ressource |
| Créer un rôle personnalisé | gcloud iam roles create ROLE_ID --project=PROJECT_ID --title="Lecteur des jobs" --permissions=bigquery.jobs.get,bigquery.jobs.list --stage=GA |
Rôle projects/PROJECT_ID/roles/ROLE_ID ; --file=role.yaml pour une définition en fichier |
| Ajouter des permissions à un rôle personnalisé | gcloud iam roles update ROLE_ID --project=PROJECT_ID --add-permissions=bigquery.jobs.create |
--remove-permissions pour en retirer |
| Partir d'un rôle prédéfini | gcloud iam roles copy --source=roles/viewer --destination=ROLE_ID --dest-project=PROJECT_ID |
Copie à élaguer ensuite |
| Supprimer un rôle personnalisé | gcloud iam roles delete ROLE_ID --project=PROJECT_ID |
Récupérable par gcloud iam roles undelete pendant 7 jours ; les liaisons qui le citent restent mais n'ont plus d'effet |
Règles d'administration
| Objectif | Syntaxe | Résultat |
|---|---|---|
| Règles définies sur un projet | gcloud org-policies list --project=PROJECT_ID |
Contraintes qui ont une règle à ce niveau ; --show-unset pour toutes |
| Règle effective (héritage compris) | gcloud org-policies describe iam.managed.disableServiceAccountKeyCreation --project=PROJECT_ID --effective |
Résultat de la hiérarchie pour cette contrainte |
| Appliquer une règle depuis un fichier | gcloud org-policies set-policy policy.yaml |
Fichier YAML : name: projects/PROJECT_ID/policies/CONTRAINTE, puis spec: → rules: → - enforce: true pour une contrainte booléenne |
| Revenir à la règle héritée | gcloud org-policies reset CONTRAINTE --project=PROJECT_ID |
La règle du parent s'applique de nouveau |
Audit à l'échelle de l'organisation
| Objectif | Syntaxe | Résultat |
|---|---|---|
| Qui a un rôle, partout | gcloud asset search-all-iam-policies --scope=organizations/ORG_ID --query="policy:roles/owner" |
Liaisons trouvées sur toutes les ressources de l'organisation ; exige cloudasset.assets.searchAllIamPolicies |
| Tous les accès d'un principal | gcloud asset search-all-iam-policies --scope=organizations/ORG_ID --query="policy:EMAIL" |
Ressource, rôle et condition de chaque liaison qui le cite |
| Liaisons accordant une permission | gcloud asset search-all-iam-policies --scope=folders/FOLDER_ID --query="policy.role.permissions:storage.buckets.delete" |
Rôles qui contiennent la permission, où qu'ils soient attribués |
| Accès donnés à des comptes personnels | gcloud asset search-all-iam-policies --scope=organizations/ORG_ID --query="memberTypes:user" |
Liaisons à des utilisateurs individuels plutôt qu'à des groupes |
| Accès effectifs d'un principal | gcloud asset analyze-iam-policy --organization=ORG_ID --identity=user:EMAIL |
Ressources accessibles, en tenant compte de l'héritage et des groupes |
| Qui peut agir en tant qu'un compte de service | gcloud asset analyze-iam-policy --organization=ORG_ID --full-resource-name=//iam.googleapis.com/projects/PROJECT_ID/serviceAccounts/SA_EMAIL --permissions=iam.serviceAccounts.actAs |
Principaux qui détiennent la permission sur ce compte |
Contexte : bonnes pratiques IAM, hiérarchie des ressources, Cloud IAM, filtres et formats, authentifier un appel.