Cloud CLI : Commandes Deployments

Exécutez les commandes mcloud deployments pour inspecter les deployments et leurs logs de build.

Contraintes

• Passez toujours --json lors du parsing de la sortie — le format texte peut changer.
• Confirmez toujours le contexte (mcloud whoami --json) avant d'exécuter des commandes si l'org/projet ne sont pas déjà connus.
• Utilisez les IDs --deployment au format depl_* ou les build IDs ; les build IDs se résolvent automatiquement vers leur deployment le plus récent.

Commandes

deployments list

Liste les deployments récents pour un projet (défaut : 20 les plus récents dans tous les environnements).

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

Options :

• -o/--organization <id> — ID de l'organisation (revient au contexte actif)
• -p/--project <id-or-handle> — ID ou handle du projet (revient au contexte actif)
• -e/--environment <handle> — Filtrer par handle d'environnement
• --environment-type <production|long-lived|preview> — Filtrer par type d'environnement
• --commit <sha> — Filtrer par SHA du commit Git (complet ou préfixe)
• --limit <1-200> — Nombre max de résultats (défaut : 20)
• --offset <number> — Offset de pagination (défaut : 0)
• --json — Sortie au format JSON

deployments get

Récupère les détails d'un deployment unique par ID.

mcloud deployments get <deployment-id> --organization <org-id> --project <project-id-or-handle> --json

Arguments :

• deployment — ID du deployment (requis)

Options :

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

deployments build-logs

Récupère les logs de build pour un deployment. Utilisez ceci pour déboguer le statut build-failed.

mcloud deployments build-logs <deployment-id> --organization <org-id> --project <project-id-or-handle>

Arguments :

• deployment — ID du deployment (requis)

Options :

• -o/--organization <id>, -p/--project <id-or-handle>
• --type <backend|storefront> — Quel flux de log de build lire (défaut : backend)
• --json — Sortie au format JSON

Statuts de Deployment

Exemples

# Lister tous les deployments (avec contexte actif défini)
mcloud deployments list --json

# Trouver le deployment build-failed le plus récent
mcloud deployments list --json \
  | jq -r '[.[] | select(.backend_status == "build-failed")][0].id'

# Obtenir les détails du deployment
mcloud deployments get bld_01ABC123 --json

# Lire les logs de build du backend
mcloud deployments build-logs bld_01ABC123

# Lire les logs de build du storefront
mcloud deployments build-logs bld_01ABC123 --type storefront

# Filtrer les deployments par SHA du commit
mcloud deployments list --commit a1b2c3d --json | jq '.'

# Obtenir les deployments pour un environnement spécifique
mcloud deployments list --environment production --json