Laravel Cloud CLI — piloter Laravel Cloud depuis le terminal

Comment gérer applications, environnements, bases de données, domaines, etc. de Laravel Cloud depuis le terminal grâce à laravel/cloud-cli.

​

Qu’est-ce que Laravel Cloud CLI ?

laravel/cloud-cli est un CLI qui permet de piloter Laravel Cloud depuis le terminal. Basé sur Laravel Zero, il permet d’exécuter les mêmes opérations que le tableau de bord via la commande cloud.

Grâce à ce CLI, vous gérez en un seul endroit vos applications, environnements, bases de données, caches, buckets, domaines et WebSockets.

​

Prérequis

Avant l’installation, assurez-vous d’avoir :

• PHP 8.2+
• Composer
• GitHub CLI (gh) (installé et authentifié)
• Git

​

Installation

Configurez d’abord le CLI en local.

1. Cloner le dépôt et installer les dépendances

   gh repo clone laravel/cloud-cli
   cd cloud-cli
   composer install
   
2. Définir l'alias `cloud`

   zsh :

   echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.zshrc
   source ~/.zshrc
   

   bash :

   echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.bashrc
   source ~/.bashrc
   
3. Configuration manuelle depuis un chemin arbitraire

   alias cloud="php /path/to/cloud-cli/cloud"
   

​

Authentification

Authentifiez-vous avant d’utiliser la plupart des commandes.

cloud auth

cloud auth ouvre le navigateur et authentifie via OAuth. Pour gérer un token (usage CI par exemple), utilisez cloud auth:token.

cloud auth:token

​

Configuration du dépôt

Si vous ne voulez pas sélectionner application ou environment à chaque fois dans votre projet, exécutez cloud repo:config.

cloud repo:config

Cette configuration stocke les valeurs par défaut dans le dépôt Git et vous permet d’exécuter cloud deploy et d’autres commandes de manière concise.

​

Déploiement

Il est plus efficace de distinguer le premier déploiement des déploiements suivants.

# Première fois : création de l'application et déploiement guidés
cloud ship

# Déploiements suivants : déployer sur une application existante
cloud deploy

# Ouvrir le tableau de bord
cloud dashboard

​

Principales catégories de commandes

Voici les catégories usuelles issues de la référence de commandes du README.

Catégorie	Exemples de commandes	Rôle
Auth / Config	cloud auth, cloud auth:token, cloud repo:config	Authentification et valeurs par défaut
Application	cloud application:list, cloud application:create	Gestion des applications
Environment	cloud environment:list, cloud environment:get, cloud environment:logs	Informations et logs d’environnement
Deploy	cloud ship, cloud deploy, cloud deploy:monitor	Gestion des déploiements
Database	cloud database-cluster:*, cloud database:*, cloud database-snapshot:*	Clusters, bases et snapshots
Cache	cloud cache:list, cloud cache:create, cloud cache:types	Gestion du cache
Bucket	cloud bucket:*, cloud bucket-key:*	Gestion du stockage objet
Domain	cloud domain:list, cloud domain:create, cloud domain:verify	Configuration et vérification des domaines
WebSocket	cloud websocket-cluster:*, cloud websocket-application:*	Ressources liées à Reverb

​

Gestion des variables d’environnement

Les variables d’environnement se gèrent avec cloud environment:variables. Cette commande regroupe les opérations append / set / replace.

cloud environment:variables

Pour la CI ou une utilisation en équipe, uniformisez les modifications via cette commande.

​

Vérification de l’utilisation

Vous pouvez consulter la facturation et l’utilisation des ressources avec cloud usage.

# Utilisation du mois en cours
cloud usage

# Vue détaillée
cloud usage --detailed

# Période précédente
cloud usage --period=previous

Pour filtrer par environnement, utilisez cloud usage --environment=<id>.