mcloud-projects

Par medusajs · medusa-agent-skills

Exécute les commandes `mcloud projects` pour lister, récupérer ou supprimer des projets Cloud. À utiliser pour découvrir des projets, résoudre des handles de projet par nom, ou récupérer les détails d'un projet, y compris les environnements liés.

npx skills add https://github.com/medusajs/medusa-agent-skills --skill mcloud-projects

Cloud CLI : Commandes Projects

Exécutez les commandes mcloud projects pour gérer les projets Cloud.

Contraintes

  • projects delete est irréversible — supprime tous les environnements, déploiements et ressources associés. Toujours confirmer l'ID/handle du projet avant de le supprimer.
  • Utilisez --yes avec delete dans 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

Skills similaires