squarecloud help
Verwendung
Ausgabe
Globale Flags
Destruktive Befehle akzeptieren außerdem
-y/--yes, um ihre y/N-Bestätigung zu überspringen. Die Seiten der einzelnen Befehle führen das jeweils auf.
squarecloud status
Verwendung
squarecloud app status oder squarecloud db status.
Ausgabe
✓, wenn die Plattform online ist, mit ⚠ bei Wartung oder Beeinträchtigung und mit ?, wenn die Prüfung selbst nicht laufen konnte, was nicht bedeutet, dass die Plattform ausgefallen ist. Darunter listet die CLI die offenen Störungen (Titel, Status, Beginn und erwartetes Ende) und die betroffenen Komponenten auf. Siehe auch die Statusseite.
Debugging
- Setze
SQUARECLOUD_DEBUG=1, um jede API-Anfrage auf stderr zu protokollieren: Methode, Pfad, Status und Dauer. Header, Query-Strings und Bodys werden nie protokolliert, sodass du die Ausgabe gefahrlos teilen kannst. - Leseanfragen werden nach einem Netzwerkfehler oder bei kurzzeitiger Überlastung der Plattform automatisch wiederholt.
- Fehler, auf die du reagieren kannst, kommen mit einem Hinweis, was zu tun ist: ein abgelaufener oder widerrufener Schlüssel, ein Schlüssel ohne die Berechtigung, die der Befehl braucht, zu viele Anfragen, eine Snapshot-Wiederherstellung oder ein Snapshot, der bereits läuft, eine andere laufende Änderung an den Umgebungsvariablen, vorübergehend nicht verfügbare Snapshots und ein Server in Wartung.
- Ctrl+C bricht die laufende Anfrage ab; ein zweites Ctrl+C beendet einen Befehl, der auf eine Eingabe wartet.
Skripte und CI
Die CLI verhält sich vorhersehbar, wenn niemand an der Tastatur sitzt:- Authentifizierung: Setze
SQUARECLOUD_API_KEY, stattauth loginauszuführen. Siehe Authentifizierung. - Übergib IDs explizit. Die Auswahllisten für Anwendungen und Datenbanken benötigen ein Terminal. Siehe Wie die CLI deine Anwendung findet.
- Exit-Codes: Jeder Fehler endet mit Code
1, auch wenn die CLI über npm installiert wurde. Prüfe Exit-Codes, nicht den Meldungstext. - Bestätigungen schlagen sicher fehl. Wer mit Nein antwortet oder einen Befehl mit Bestätigung ohne Terminal und ohne
-yausführt, erhält Exit-Code1, und nichts wird geändert. Nachfragende Befehle sindapp delete,app env replace,app env remove --all,app file delete,app file read -oüber eine vorhandene Datei,app network purge-cache,app snapshot restore,blob delete,db delete,db snapshot restore,db credentials reset,workspace delete,workspace leave,workspace member removeundauth login, wenn es den Schlüssel eines anderen Kontos ersetzen würde. - stdout enthält nur Ergebnisse. Fehler, die Meldung “not logged in”, Bestätigungsabfragen, Fehlerzeilen und der Update-Hinweis gehen nach stderr. Mit
upload --jsongehen auch Fortschrittsmeldungen nach stderr, undblob uploadsendet seinen Fortschritt immer dorthin. - Werte
--jsonaus, nicht Tabellen. Auf nicht englischen Systemen werden Tabellenköpfe undinfo-Beschriftungen übersetzt. Um Englisch zu erzwingen, führe die CLI mitLC_ALL=en_US.UTF-8aus. - Bereits im Zielzustand gilt als Erfolg. Das Starten einer laufenden Anwendung oder Datenbank oder das Stoppen einer gestoppten wird gemeldet und endet mit Code
0.

