Deployen und steuern Sie Ihre Anwendungen aus dem Terminal

Melden Sie sich mit einem Code im Browser an, deployen Sie jeden Ordner mit einem Befehl und erreichen Sie Logs, Datenbanken und Workspaces im selben Terminal, mit einer Ausgabe, die Ihre Skripte lesen können.

CLI installierenZur Dokumentation
Die Square Cloud CLI ist Open Source und läuft unter macOS, Linux und Windows, auf x86 und ARM. Der Quellcode liegt auf GitHub.

Mit einem Befehl installiert

Das Installationsskript und das npm-Paket laden den Build für Ihr System aus dem neuesten Release und prüfen seine Prüfsumme vor der Installation.

macOS, Linux und WSL

curl -fsSL https://cli.squarecloud.app/install | bash

Installiert nach /usr/local/bin und fragt daher eventuell nach Ihrem Passwort.

Windows

npm i -g @squarecloud/cli

Benötigt Node.js mit npm. Derselbe Befehl funktioniert auch unter macOS und Linux.

  • Geprüft gegen die SHA-256-Prüfsummen des Releases
  • Builds für x86 und ARM, inklusive Apple Silicon
  • Zum Aktualisieren denselben Befehl erneut ausführen
Weitere Installationswege

Anmelden, ohne einen Schlüssel zu kopieren

Die CLI zeigt einen Code an, Sie genehmigen ihn im Browser, und das Terminal erhält einen eigenen Schlüssel, so wie sich auch die VS-Code-Erweiterung verbindet.

  1. 1

    Das Terminal zeigt einen Code

    Führen Sie den Login-Befehl aus: Der Browser öffnet die Genehmigungsseite, während das Terminal einen achtstelligen Code und einen Countdown anzeigt.

  2. 2

    Sie genehmigen ihn im Browser

    Geben Sie den Code auf der Seite von Square Cloud ein und genehmigen Sie. Geben Sie niemals einen Code ein, den Ihnen jemand geschickt hat.

  3. 3

    Die CLI ist angemeldet

    Das Terminal bestätigt Ihr Konto und speichert einen eigens erstellten Schlüssel, nur mit den Berechtigungen, die seine Befehle nutzen.

  • Jeder Schlüssel gilt 90 Tage, und auth whoami zeigt, bis wann
  • Fragt nach, bevor ein anderes Konto auf diesem Rechner ersetzt wird
  • Über SSH gibt --no-browser den Link aus, den Sie überall öffnen können
  • Schon einen Schlüssel? Nutzen Sie --token oder --with-token

Deployen aus jedem Ordner

Laden Sie den aktuellen Ordner als neue Anwendung hoch, senden Sie Änderungen an eine bestehende oder verknüpfen Sie ein GitHub-Repository, damit jeder Push sie deployt.

  • Anwendung hochladen

    Die CLI packt den aktuellen Ordner nach Ihren Ignore-Regeln als ZIP, erstellt die Anwendung und gibt den Link zu ihrer Seite im Dashboard aus.

    uploadupload --file

    • Oder senden Sie ein vorhandenes ZIP
    • Schreibt die neue ID in squarecloud.app, falls das Projekt eine hat

  • Änderungen committen

    Senden Sie den Ordner oder ein ZIP an eine bestehende Anwendung. Sie behält ihre ID, ihre Domain und ihre Einstellungen.

    commitcommit -rcommit --path

    • Startet die Anwendung danach neu, wenn Sie es möchten
    • Kann die Dateien in einen Ordner der Anwendung legen

  • Deploy bei jedem Push

    Verknüpfen Sie Repository und Branch über die GitHub App von Square Cloud oder legen Sie einen Webhook mit einem GitHub-Token an, ohne das Terminal zu verlassen.

    app deploy github linkapp deploy webhookapp deploy list

Eine Ignore-Datei für CLI und VS Code

upload, commit und zip lassen weg, was squarecloud.ignore im Stammverzeichnis Ihres Projekts auflistet. Die VS-Code-Erweiterung liest dieselbe Datei mit denselben Regeln.

  • Die Syntax von .gitignore

    # für Kommentare, !, um einen Pfad zurückzuholen, dir/ nur für Ordner, /build nur im Stammverzeichnis, dazu *, ?, [abc] und **. Die letzte passende Zeile gewinnt, Groß- und Kleinschreibung spielt keine Rolle.

  • Sinnvolle Standards

    node_modules, .git, .github, .vscode und die Lockfiles von npm, pnpm und Yarn bleiben draußen, bevor Ihre Regeln greifen. Eine Zeile wie !yarn.lock holt eine zurück.

  • Vor dem Senden prüfen

    squarecloud zip erstellt dasselbe Archiv in Ihrem Ordner, damit Sie es öffnen und genau sehen, was hochgeladen würde.

Variablen kommen genau so an, wie Sie sie eingegeben haben

Ihre Anwendung lädt ihre Variablen über eine Shell. Seit Version 3.1.1 sendet die CLI Werte mit Leerzeichen oder Zeichen wie $, & oder ; in Anführungszeichen, damit die Shell sie weder abschneiden noch expandieren kann.

  • Direkt im Terminal

    Übergeben Sie beliebig viele KEY=VALUE-Paare. Die CLI nimmt die Anwendung aus squarecloud.app oder lässt Sie sie aus einer Liste wählen.

    app env setapp env list

    • Einfache Anführungszeichen, doppelte, wenn der Wert eines enthält
    • Ein Wert, der schon in Anführungszeichen steht, bleibt unverändert

  • Aus einer .env-Datei

    Liest KEY=VALUE-Zeilen aus einer Datei und überspringt Kommentare und Leerzeilen. Zeilen, die mit export beginnen, und Werte in Anführungszeichen funktionieren auch.

    --from-file .env

    • Funktioniert beim Setzen und beim Ersetzen von Variablen
    • Die Liste zeigt sie wieder als KEY=VALUE

  • Alles auf einmal

    Ersetzen Sie alle Variablen auf einmal oder entfernen Sie alle. Beides fragt nach, bevor sich etwas ändert, und Ersetzen braucht mindestens eine neue Variable.

    app env replaceapp env remove --all-y

    • Ein Flag bestätigt für Sie in Skripten
    • Antworten Sie mit Nein, ändert sich nichts

Gemacht für Skripte und CI

Ausgaben, die ein Programm lesen kann, Exit-Codes, die stimmen, und ein Schlüssel, der ohne Browser funktioniert.

  • JSON auf Wunsch

    Befehle, die Daten ausgeben, antworten auf Wunsch in JSON, mit nur dem Ergebnis auf stdout. Die anderen lehnen das Flag mit einem Fehler ab, statt Text auszugeben, über den ein Parser stolpern würde.

    --json

  • Ehrliche Exit-Codes

    Jeder Fehler endet mit 1. Kann eine Bestätigung nicht abgefragt werden, ohne Terminal und ohne Flag, das sie beantwortet, schlägt der Befehl fehl und ändert nichts.

    -y

  • Ein sauberes stdout

    Fehler, Fragen und Hinweise gehen an stderr, bei JSON auch der Fortschritt, sodass eine Pipe nur das Ergebnis transportiert.

    stdoutstderr

  • Ein Schlüssel für CI

    Legen Sie einen Schlüssel Ihres Kontos als Umgebungsvariable fest, und jeder Befehl nutzt ihn, ohne Login. Ist CI auf true gesetzt, startet der Browser-Login nicht.

    SQUARECLOUD_API_KEYCI=true

  • Traces zum Teilen

    Eine Variable gibt Methode, Pfad, Status und Dauer jedes API-Aufrufs auf stderr aus, niemals Header, Query-Strings oder Bodys.

    SQUARECLOUD_DEBUG=1

  • GitHub Actions

    Die Square Cloud Action installiert die CLI auf dem Runner, prüft sie gegen die Prüfsummen des Releases und führt jeden Befehl mit Ihrem Schlüssel aus.

    squarecloudofc/github-action@v2

Und der Rest der Plattform

Logs, Metriken, Dateien, Snapshots, Domains, Datenbanken und Workspaces, jeweils nur einen Befehl entfernt.

  • Logs und Live-Stream

    Geben Sie die neuesten Zeilen aus oder verfolgen Sie die Ausgabe live, samt jeder Statusänderung. Was Ihre Anwendung nach stderr schreibt, bleibt auf stderr.

    app logsapp realtime

  • Status und Metriken

    CPU, Arbeitsspeicher, Speicherplatz und Uptime für eine Anwendung oder eine Zeile pro Anwendung, dazu die Metriken der letzten 24 Stunden.

    app status --allapp metrics

  • Entfernte Dateien

    Dateien der Anwendung auflisten, lesen, schreiben, verschieben und löschen. Schreiben aus einer Datei lässt Binärdateien intakt, und Lesen in eine Datei fragt vor dem Überschreiben nach.

    app file readapp file write

  • Snapshots

    Einen Snapshot erstellen und herunterladen, seine Versionen auflisten und eine wiederherstellen, für Anwendungen und Datenbanken.

    app snapshot createdb snapshot restore

  • Domains und Traffic

    Eine eigene Domain festlegen, die anzulegenden DNS-Einträge abrufen, Analytics, Fehler und Performance der Edge lesen und den Cache leeren.

    app network domainapp network analytics

  • Datenbanken

    MongoDB-, MySQL-, PostgreSQL- und Redis-Datenbanken erstellen, starten oder stoppen, das TLS-Zertifikat herunterladen und das Passwort rotieren.

    db createdb credentials reset

Alle Befehle in der Dokumentation

Umsichtig, offen und in Ihrer Sprache

  • In acht Sprachen

    Meldungen, Hilfe und Tabellen folgen bei jedem Aufruf der Anzeigesprache Ihres Systems. LC_ALL wählt für einen einzelnen Befehl eine andere.

  • Keine IDs merken

    Die meisten Befehle nehmen die Anwendung aus squarecloud.app oder listen Ihre auf, damit Sie eine auswählen.

  • Fragt vorher nach

    Löschen, alle Variablen ersetzen, einen Snapshot wiederherstellen oder den Cache leeren fragt zuerst nach, und Skripte können mit einem Flag bestätigen.

  • Open Source

    Der Code liegt auf GitHub, und jedes Release veröffentlicht seine Builds mit SHA-256-Prüfsummen.

Ein Plan für jede Phase Ihres Projekts

Starten Sie klein und skalieren Sie bei Bedarf – ohne Vertragsbindung.

Alle Pläne vergleichen

4,9 von 5 · 402 Bewertungen auf Google + TrustpilotTrustpilot

Gehostet in einem Partner-Rechenzentrum mit den Zertifizierungen
Tier 3ISO 27001SOC 2 Type IIAlways-On-DDoS-Schutz
Entdecken Sie unsere Infrastruktur

Bereit, Ihr Projekt zu skalieren?

Schließen Sie sich den mehr als 500.000 Entwicklern an, die Square Cloud für das Hosting ihrer Projekte genutzt haben.

Jetzt mit Square Cloud startenPläne und Preise ansehen
  • Vorhersehbare Preise
  • Keine Überraschungen bei der Abrechnung
  • Deploy in Sekunden
  • Hohe Verfügbarkeit
  • Stabil skalieren
  • Automatischer Neustart
  • SSL und Sicherheit inklusive
  • Isolierte Container