> ## 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 — usa Laravel Cloud dal terminale

> Come gestire dal terminale app, ambienti, database, domini e altre risorse di Laravel Cloud usando laravel/cloud-cli.

## Cos'è Laravel Cloud CLI

`laravel/cloud-cli` è la CLI per usare [Laravel Cloud](https://cloud.laravel.com) dal terminale.\
Lo strumento è realizzato con Laravel Zero e ti permette di eseguire con il comando `cloud` le operazioni che faresti dalla dashboard.

Con questa CLI puoi gestire in un unico posto applicazioni, ambienti, database, cache, bucket, domini, WebSocket e altro.

## Requisiti

Prima di installarla, assicurati di soddisfare i seguenti requisiti.

* `PHP 8.2+`
* `Composer`
* `GitHub CLI (gh)` (installato e autenticato)
* `Git`

## Installazione

Per prima cosa, configura la CLI in locale.

<Steps>
  <Step title="Clona il repository e installa le dipendenze">
    ```bash theme={null}
    gh repo clone laravel/cloud-cli
    cd cloud-cli
    composer install
    ```
  </Step>

  <Step title="Configura 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="Configurazione manuale con path arbitrario">
    ```bash theme={null}
    alias cloud="php /path/to/cloud-cli/cloud"
    ```
  </Step>
</Steps>

## Autenticazione

Autenticati prima di usare la maggior parte dei comandi.

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

`cloud auth` apre il browser e ti autentica via OAuth.\
Se vuoi gestire un token per usi CI, usa `cloud auth:token`.

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

## Configurazione del repository

Se non vuoi selezionare `application` o `environment` ogni volta nel tuo progetto, esegui `cloud repo:config`.

```bash theme={null}
cloud repo:config
```

Questa configurazione salva valori predefiniti nel repository Git e ti permette di eseguire `cloud deploy` e simili con comandi brevi.

## Deploy

È efficiente distinguere il primo deploy dai deploy successivi.

```bash theme={null}
# Prima volta: creazione dell'app e deploy guidato
cloud ship

# Dalla seconda volta: deploy su un'app esistente
cloud deploy

# Apri la dashboard
cloud dashboard
```

## Principali categorie di comandi

Dalla reference dei comandi del README, ecco un riassunto delle categorie di uso quotidiano.

| Categoria     | Esempi principali                                                           | Uso                                         |
| ------------- | --------------------------------------------------------------------------- | ------------------------------------------- |
| Auth / Config | `cloud auth`, `cloud auth:token`, `cloud repo:config`                       | Autenticazione e configurazione predefinita |
| Application   | `cloud application:list`, `cloud application:create`                        | Gestione app                                |
| Environment   | `cloud environment:list`, `cloud environment:get`, `cloud environment:logs` | Info ambiente e visualizzazione log         |
| Deploy        | `cloud ship`, `cloud deploy`, `cloud deploy:monitor`                        | Gestione dei deploy                         |
| Database      | `cloud database-cluster:*`, `cloud database:*`, `cloud database-snapshot:*` | Gestione cluster DB, database e snapshot    |
| Cache         | `cloud cache:list`, `cloud cache:create`, `cloud cache:types`               | Gestione della cache                        |
| Bucket        | `cloud bucket:*`, `cloud bucket-key:*`                                      | Gestione dell'object storage                |
| Domain        | `cloud domain:list`, `cloud domain:create`, `cloud domain:verify`           | Configurazione e verifica dei domini        |
| WebSocket     | `cloud websocket-cluster:*`, `cloud websocket-application:*`                | Gestione delle risorse Reverb               |

## Gestione delle variabili d'ambiente

Le variabili d'ambiente si gestiscono con `cloud environment:variables`.\
Questo comando raccoglie le operazioni di append / set / replace.

```bash theme={null}
cloud environment:variables
```

In CI e nell'operatività di team, usa questo comando per uniformare la procedura di modifica delle configurazioni.

## Verifica dell'utilizzo

Puoi verificare fatturazione e utilizzo delle risorse con `cloud usage`.

```bash theme={null}
# Uso del mese corrente
cloud usage

# Visualizzazione dettagliata
cloud usage --detailed

# Uso del periodo precedente
cloud usage --period=previous
```

Per filtrare per ambiente, usa `cloud usage --environment=<id>`.


## Related topics

- [Cloud Sessions](/it/packages/laravel-copilot-sdk/cloud-sessions.md)
- [Laravel Cloud — la panoramica completa del PaaS dedicato a Laravel](/it/blog/laravel-cloud.md)
- [laravel/symfony-on-cloud — eseguire app Symfony su Laravel Cloud](/it/blog/symfony-on-cloud-introduction.md)
- [Laravel Cloud Hibernation (sospensione automatica)](/it/blog/laravel-cloud-hibernation.md)
- [Laravel Cloud - GitHub Copilot SDK for Laravel](/it/packages/laravel-copilot-sdk/laravel-cloud.md)