Cloud CLI : Commandes Environments

Exécutez les commandes mcloud environments pour gérer le cycle de vie des environnements et les déploiements.

Contraintes

• Les environnements de production ne peuvent pas être supprimés. Vérifiez toujours le type via environments get --json avant de tenter une suppression dans une automation.
• Utilisez --yes pour les opérations destructrices (delete) dans les contextes non interactifs.
• redeploy et trigger-build ne sont pas interchangeables — choisissez le bon en fonction de l'origine du correctif.

Commandes

environments list

Liste tous les environnements d'un projet.

mcloud environments list --organization <org-id> --project <project-id-or-handle> --json

Options :

• -o/--organization <id> — ID de l'organisation (bascule sur le contexte actif par défaut)
• -p/--project <id-or-handle> — ID ou handle du projet (bascule sur le contexte actif par défaut)
• --json — Sortie au format JSON

environments get

Récupère un seul environnement par handle.

mcloud environments get <environment-handle> --organization <org-id> --project <project-id-or-handle> --json

Arguments :

• environment — Handle de l'environnement (requis)

Options :

• -o/--organization <id>, -p/--project <id-or-handle>, --json

environments create

Crée un nouvel environnement long-lived.

mcloud environments create \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --name "Staging" \
  --branch develop \
  --json

Options :

• -o/--organization <id>, -p/--project <id-or-handle>
• -n/--name <name> — Nom de l'environnement (requis)
• -b/--branch <branch> — Branche Git à suivre (requis)
• --custom-subdomain <subdomain> — Sous-domaine personnalisé optionnel
• --json — Sortie au format JSON

environments delete

Supprime un environnement. Impossible de supprimer les environnements de production.

mcloud environments delete <environment-handle> \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --yes

Arguments :

• environment — Handle de l'environnement (requis)

Options :

• -o/--organization <id>, -p/--project <id-or-handle>
• -y/--yes — Ignore l'invite de confirmation (requis en mode non interactif)
• --json — Sortie au format JSON

environments redeploy

Réexécute un build existant pour le déploiement actif. À utiliser quand le correctif est côté environnement (changement de variable, problème d'infra) — ne démarre PAS un nouveau build.

mcloud environments redeploy <environment-handle> \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --json

Arguments :

• environment — Handle de l'environnement (requis)

Options :

• -o/--organization <id>, -p/--project <id-or-handle>, --json

Nécessite que l'environnement dispose d'un déploiement actif. S'il n'en a pas, utilisez d'abord trigger-build.

environments trigger-build

Démarre un nouveau build à partir de la branche suivie. À utiliser quand le correctif est dans le code commité — crée un nouveau déploiement.

mcloud environments trigger-build <environment-handle> \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --json

Arguments :

• environment — Handle de l'environnement (requis)

Options :

• -o/--organization <id>, -p/--project <id-or-handle>, --json

Décision Redeploy vs Trigger-Build

Exemples

# Lister tous les environnements
mcloud environments list --json

# Obtenir les détails de l'environnement et vérifier le type avant suppression
mcloud environments get staging --json | jq '{id, name, type, status}'

# Créer un nouvel environnement en suivant la branche develop
mcloud environments create --name "Staging" --branch develop --json

# Supprimer un environnement hors production
mcloud environments delete staging --yes

# Redéployer après un changement de variable
mcloud environments redeploy production --json

# Déclencher un build frais à partir de la source
mcloud environments trigger-build production --json

# Trouver les handles d'environnement par nom
mcloud environments list --json \
  | jq -r '.[] | select(.name == "Production") | .handle'

# Vérifier qu'un nouveau build a démarré
mcloud deployments list --environment production --limit 5 --json \
  | jq '.[] | {id, backend_status, updated_at}'