Cloud CLI : Commandes Projects
Exécutez les commandes mcloud projects pour gérer les projets Cloud.
Contraintes
projects deleteest irréversible — supprime tous les environnements, déploiements et ressources associés. Toujours confirmer l'ID/handle du projet avant de le supprimer.- Utilisez
--yesavecdeletedans les contextes non-interactifs (scripts, pipelines, agents).
Commandes
projects list
Listez tous les projets d'une organisation.
mcloud projects list --organization <org-id> --json
Options :
-o/--organization <id>— ID de l'organisation (utilise le contexte actif par défaut ; requis)--json— Sortie au format JSON
projects get
Récupérez un seul projet par son ID ou handle.
mcloud projects get <project-id-or-handle> --organization <org-id> --json
Arguments :
project— ID ou handle du projet (requis)
Options :
-o/--organization <id>— ID de l'organisation (utilise le contexte actif par défaut ; requis)--json— Sortie au format JSON
projects delete
Supprimez un projet par son ID ou handle. Irréversible.
mcloud projects delete <project-id-or-handle> \
--organization <org-id> \
--yes
Arguments :
project— ID ou handle du projet (requis)
Options :
-o/--organization <id>— ID de l'organisation (utilise le contexte actif par défaut ; requis)-y/--yes— Ignorer le message de confirmation (requis en mode non-interactif)--json— Sortie au format JSON
Champs Project (JSON)
| Champ | Description |
|---|---|
id |
ID du projet |
handle |
Handle du projet sûr pour les URL (utilisé dans la plupart des commandes) |
name |
Nom d'affichage |
status |
ready lorsque sain |
region |
Région de déploiement (ex. us-east-1) |
repository |
Repository GitHub lié (owner/repo) |
root_path |
Chemin racine dans le repository |
environments |
Array des environnements associés |
Exemples
# Listez tous les projets d'une organisation
mcloud projects list --organization org_123 --json
# Définissez le contexte à un projet par nom
PROJECT_HANDLE=$(
mcloud projects list --organization org_123 --json \
| jq -r '.[] | select(.name == "My Store") | .handle'
)
mcloud use --project "$PROJECT_HANDLE"
# Récupérez les détails du projet y compris les environnements
mcloud projects get my-store --organization org_123 --json
# Listez tous les handles d'environnement pour un projet
mcloud projects get my-store --organization org_123 --json \
| jq -r '.environments[].handle'
# Trouvez le handle du projet par nom
mcloud projects list --organization org_123 --json \
| jq -r '.[] | select(.name == "My Store") | .handle'
# Supprimez un projet (irréversible — confirmez avant d'exécuter)
mcloud projects delete old-project --organization org_123 --yes