> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://cloud.laravel.com) 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.

<Steps>
  <Step title="Cloner le dépôt et installer les dépendances">
    ```bash theme={null}
    gh repo clone laravel/cloud-cli
    cd cloud-cli
    composer install
    ```
  </Step>

  <Step title="Définir l'alias `cloud`">
    zsh :

    ```bash theme={null}
    echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.zshrc
    source ~/.zshrc
    ```

    bash :

    ```bash theme={null}
    echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.bashrc
    source ~/.bashrc
    ```
  </Step>

  <Step title="Configuration manuelle depuis un chemin arbitraire">
    ```bash theme={null}
    alias cloud="php /path/to/cloud-cli/cloud"
    ```
  </Step>
</Steps>

## Authentification

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

```bash theme={null}
cloud auth
```

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

```bash theme={null}
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`.

```bash theme={null}
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.

```bash theme={null}
# 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.

```bash theme={null}
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`.

```bash theme={null}
# 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>`.


## Related topics

- [Laravel Cloud — le PaaS dédié à Laravel](/fr/blog/laravel-cloud.md)
- [Cloud Sessions](/fr/packages/laravel-copilot-sdk/cloud-sessions.md)
- [Laravel Sail](/fr/sail.md)
- [laravel/symfony-on-cloud — faire tourner une application Symfony sur Laravel Cloud](/fr/blog/symfony-on-cloud-introduction.md)
- [Laravel Cloud Hibernation (mise en veille automatique)](/fr/blog/laravel-cloud-hibernation.md)