Laravel Cloud CLI – Laravel Cloud vom Terminal aus bedienen

Wie Sie mit laravel/cloud-cli Anwendungen, Umgebungen, Datenbanken, Domains und mehr auf Laravel Cloud vom Terminal aus verwalten.

​

Was ist die Laravel Cloud CLI?

laravel/cloud-cli ist die CLI, mit der Sie Laravel Cloud vom Terminal aus steuern.
Sie ist mit Laravel Zero gebaut und lässt Sie die Aktionen des Dashboards über den Befehl cloud ausführen.

Mit dieser CLI verwalten Sie Anwendungen, Umgebungen, Datenbanken, Cache, Buckets, Domains, WebSockets u. v. m. an einer Stelle.

​

Voraussetzungen

Erfüllen Sie vor der Einführung folgende Voraussetzungen:

• PHP 8.2+
• Composer
• GitHub CLI (gh) (installiert und authentifiziert)
• Git

​

Installation

Richten Sie die CLI zunächst lokal ein.

1. Repository klonen und Abhängigkeiten installieren

   gh repo clone laravel/cloud-cli
   cd cloud-cli
   composer install
   
2. Alias `cloud` einrichten

   zsh:

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

   bash:

   echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.bashrc
   source ~/.bashrc
   
3. Manuelle Konfiguration mit beliebigem Pfad

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

​

Authentifizierung

Authentifizieren Sie sich, bevor Sie die meisten Kommandos verwenden.

cloud auth

cloud auth öffnet den Browser und authentifiziert per OAuth.
Wenn Sie für CI oder ähnliches ein Token verwalten möchten, nutzen Sie cloud auth:token.

cloud auth:token

​

Repository-Konfiguration

Wenn Sie in Ihrem Projekt nicht jedes Mal application und environment auswählen möchten, führen Sie cloud repo:config aus.

cloud repo:config

Diese Konfiguration speichert die Defaults im Git-Repository, sodass Sie cloud deploy und andere Kommandos in Kurzform ausführen können.

​

Deployment

Es ist effizient, Erst-Deployment und laufende Deployments zu trennen.

# Erstmalig: geführte App-Erstellung und Deployment
cloud ship

# Ab dem zweiten Mal: Deployment einer bestehenden App
cloud deploy

# Dashboard öffnen
cloud dashboard

​

Wichtige Kommando-Kategorien

Aus der Kommando-Referenz der README die Kategorien für den täglichen Gebrauch:

Kategorie	Beispiele	Zweck
Auth / Config	cloud auth, cloud auth:token, cloud repo:config	Authentifizierung und Defaults
Application	cloud application:list, cloud application:create	Anwendungsverwaltung
Environment	cloud environment:list, cloud environment:get, cloud environment:logs	Umgebungsinfos und Logs
Deploy	cloud ship, cloud deploy, cloud deploy:monitor	Deployment-Verwaltung
Database	cloud database-cluster:*, cloud database:*, cloud database-snapshot:*	Verwaltung von DB-Clustern, Datenbanken und Snapshots
Cache	cloud cache:list, cloud cache:create, cloud cache:types	Cache-Verwaltung
Bucket	cloud bucket:*, cloud bucket-key:*	Objekt-Storage-Verwaltung
Domain	cloud domain:list, cloud domain:create, cloud domain:verify	Domain-Konfiguration und -Verifikation
WebSocket	cloud websocket-cluster:*, cloud websocket-application:*	Verwaltung Reverb-nahen Ressourcen

​

Verwaltung von Umgebungsvariablen

Umgebungsvariablen werden mit cloud environment:variables verwaltet.
Der Befehl unterstützt Operationen wie append, set und replace in einem Aufruf.

cloud environment:variables

Für CI und Teamworkflows sollten Sie mit diesem Kommando die Vorgehensweise für Konfigurationsänderungen vereinheitlichen.

​

Nutzung prüfen

Kosten und Ressourcennutzung prüfen Sie mit cloud usage.

# Nutzung des aktuellen Monats
cloud usage

# Detailansicht
cloud usage --detailed

# Nutzung der Vorperiode
cloud usage --period=previous

Für eine Einschränkung pro Umgebung verwenden Sie cloud usage --environment=<id>.