Skip to main content
1

Anmeldung starten

Führe den Login-Befehl in deinem Terminal aus:
Die CLI zeigt einen kurzen Code an und öffnet die Autorisierungsseite in deinem Browser.
2

Im Browser bestätigen

Gib den Code auf der Seite ein und bestätige. Die CLI erhält ihren eigenen API-Schlüssel, ganz ohne Kopieren und Einfügen, und speichert ihn auf diesem Rechner.
Ausgabe
Ein auf diese Weise ausgestellter Schlüssel hat nur die Berechtigungen, die die Befehle der CLI verwenden, und läuft nach 90 Tagen ab. auth whoami zeigt das Datum an; führe squarecloud auth login erneut aus, um ihn zu erneuern. Der Schlüssel wird in einer Datei config.json gespeichert, die nur du lesen kannst: unter Windows in %APPDATA%\Square Cloud CLI, unter macOS und Linux in $XDG_CONFIG_HOME/squarecloud oder ~/.config/squarecloud.

​
squarecloud auth login

Verwendung
Ausgabe mit einem API-Schlüssel
  • Drücke Ctrl+C, um eine Anmeldung abzubrechen, die auf die Bestätigung wartet.
  • Wenn dieser Rechner bereits mit einem anderen Konto angemeldet ist, fragt auth login nach, bevor es ersetzt wird. Übergib -y, um die Frage zu überspringen.
  • Hat dein Konto sein Limit an API-Schlüsseln erreicht, weist die Browser-Anmeldung darauf hin und fährt von selbst fort, sobald du im Dashboard einen Schlüssel widerrufst.
  • Ohne Terminal fragt der Befehl nichts ab: Er beendet sich mit einem Hinweis. Mit CI=true verweigert die Browser-Anmeldung die Ausführung. Siehe CI und Skripte.

​
squarecloud auth whoami

Verwendung
Zeigt das Konto, mit dem du angemeldet bist, seinen Plan und wie viele Tage bis zum Ablauf des Plans bleiben. Bei einem Schlüssel aus der Browser-Anmeldung zeigt der Befehl außerdem, wann der Schlüssel abläuft, und seine Scopes; stammt der Schlüssel aus SQUARECLOUD_API_KEY, weist er stattdessen darauf hin.
Ausgabe
Mit --json gibt der Befehl das Konto (ID, Name, E-Mail, Locale, Plan und Erstellungsdatum) als JSON aus.

​
squarecloud auth logout

Verwendung
Entfernt den gespeicherten API-Schlüssel von diesem Rechner. Der Schlüssel wird dabei nicht widerrufen: Lösche ihn dafür im Dashboard. Ist SQUARECLOUD_API_KEY gesetzt, verwenden die Befehle diesen Schlüssel auch nach einem Logout weiter.
Ausgabe
Ist kein Konto verbunden, gibt der Befehl No account is connected on this machine. aus und endet mit Exit-Code 0.

​
CI und Skripte

Melde dich in der CI gar nicht erst an: Erstelle einen API-Schlüssel im Dashboard und setze ihn in der Umgebungsvariable SQUARECLOUD_API_KEY. Jeder Befehl verwendet ihn anstelle des gespeicherten Schlüssels, und die CLI läuft auch auf Rechnern ohne Home-Verzeichnis.
  • Ohne Terminal fragt auth login nichts ab: Der Befehl beendet sich mit einem Hinweis. Verwende --with-token, --token oder SQUARECLOUD_API_KEY.
  • Mit CI=true verweigert die Browser-Anmeldung die Ausführung, da ihr Schlüssel nach 90 Tagen abläuft und nur eine Person ihn erneuern kann.
Mehr zu Exit-Codes und JSON-Ausgabe unter Globale Flags und CI.

​
Wenn der Schlüssel nicht mehr funktioniert

Wenn ein Befehl meldet, dass deine Sitzung abgelaufen ist oder der API-Schlüssel widerrufen wurde, führe squarecloud auth login erneut aus. Befehle, die ein Konto benötigen, geben You need to be logged in to run this command. aus und enden mit Exit-Code 1, wenn kein Schlüssel gespeichert oder gesetzt ist.

​
Siehe auch