Cloud CLI : Commandes Variables

Exécutez les commandes mcloud variables pour inspecter les variables d'environnement des environnements Cloud.

Contraintes

Ne passez jamais --reveal sauf si l'utilisateur le demande explicitement. Les valeurs secrètes apparaissent dans l'historique du terminal, les agrégateurs de logs et les listes de processus.
La recherche par clé nécessite --project et --environment (ou l'équivalent dans le contexte actif). La recherche par ID (var_...) fonctionne sans contexte project/environment.

Commandes

variables list

Lister toutes les variables d'environnement pour un environnement Cloud.

mcloud variables list \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --environment <environment-handle> \
  --json

Options :

-o/--organization <id> — ID de l'organisation (utilise le contexte actif par défaut)
-p/--project <id-or-handle> — ID ou handle du projet (utilise le contexte actif par défaut)
-e/--environment <handle> — Handle de l'environnement (utilise le contexte actif par défaut)
--reveal — Afficher les valeurs secrètes en clair au lieu de les masquer (utiliser uniquement si explicitement demandé)
--limit <1-500> — Nombre maximum de résultats (défaut : 200)
--offset <number> — Décalage de pagination (défaut : 0)
--json — Sortie au format JSON

variables get

Récupérer une seule variable par son ID (var_...) ou sa clé.

# Par clé (nécessite contexte project + environment)
mcloud variables get ADMIN_CORS \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --environment <environment-handle> \
  --json

# Par ID (fonctionne sans contexte project/environment)
mcloud variables get var_01XYZ --json

Arguments :

variable — ID de variable (var_...) ou clé (obligatoire)

Options :

-o/--organization <id>, -p/--project <id-or-handle>, -e/--environment <handle>
--reveal — Afficher la valeur secrète en clair (utiliser uniquement si explicitement demandé)
--json — Sortie au format JSON

Champs de Variable (JSON)

Champ	Description
`id`	ID de variable (`var_...`)
`key`	Nom de la variable (ex. `ADMIN_CORS`)
`value`	Valeur de la variable (masquée si `is_secret` et `--reveal` non passé)
`is_secret`	Si la variable est traitée comme un secret
`is_build`	Disponible au moment de la compilation
`is_runtime`	Disponible à l'exécution
`entity_id`	L'ID de l'environnement auquel appartient cette variable

Exemples

# Lister toutes les variables pour l'environnement actif
mcloud variables list --json

# Récupérer une variable par clé (avec contexte actif)
mcloud variables get DATABASE_URL --json

# Récupérer une variable par ID (pas de contexte env requis)
mcloud variables get var_01XYZ --json

# Révéler les secrets uniquement quand l'utilisateur le demande explicitement
mcloud variables get STRIPE_SECRET_KEY --reveal --json | jq -r '.value'

# Exporter toutes les variables dans un fichier .env (l'utilisateur doit explicitement demander --reveal)
mcloud variables list --reveal --json \
  | jq -r '.[] | "\(.key)=\(.value)"' \
  > .env

# Lister uniquement les variables runtime
mcloud variables list --json | jq '[.[] | select(.is_runtime == true)]'

# Vérifier si une variable spécifique existe
mcloud variables list --json | jq '.[] | select(.key == "REDIS_URL")'

mcloud-variables