Hobby
Bringen Sie die Idee vom localhost ins Netz.
- Bis zu 2 vCPU
- Echtzeit-Metriken
- Blob Storage
- Rollback mit 1 Klick
- Square Shield gegen DDoS
Ab12,49 R$/Monat≈ 2,00 €
Bei jedem Push, Release oder manuellen Start installiert die offizielle Action die Square Cloud CLI auf dem Runner, prüft sie und sendet Ihren Code an Ihre Anwendung.
Zwei Werte in Ihrem Repository und eine Workflow-Datei. Danach sendet jeder Push auf main den Code an Ihre Anwendung und startet sie neu.
Erstellen Sie in den Sicherheitseinstellungen Ihres Kontos einen API-Schlüssel und speichern Sie ihn im Repository als Secret SQUARECLOUD_API_KEY.
Kopieren Sie die ID von der Seite der Anwendung im Dashboard und speichern Sie sie als Repository-Variable SQUARECLOUD_APP_ID.
Committen Sie die Datei unten als .github/workflows/deploy.yml. Der nächste Push auf main deployt Ihre Anwendung.
name: Deployon: push: branches: [main]jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 - uses: squarecloudofc/github-action@v2 with: token: ${{ secrets.SQUARECLOUD_API_KEY }} command: commit ${{ vars.SQUARECLOUD_APP_ID }} --restartOhne actions/checkout hat der Runner keine Dateien zum Senden.
--restart startet die Anwendung nach dem Upload neu und startet sie, falls sie gestoppt war. Ohne die Option werden die neuen Dateien erst beim nächsten Neustart wirksam.
Ohne ID liest commit die Zeile ID= aus der squarecloud.app im Ordner, sofern vorhanden. Dann genügt commit --restart.
Vier Schritte, in dieser Reihenfolge, auf jedem Runner. Schlägt einer fehl, schlägt auch der Workflow-Schritt fehl: Ein Deploy, der nicht stattgefunden hat, erscheint nie grün.
Sie wählt das CLI-Release für System und Prozessor des Runners: das neueste oder die Version, die Sie festlegen. Selbst gehostete Runner behalten es in ihrem Tool-Cache.
Der SHA-256 des Downloads wird mit der checksums.txt des Releases abgeglichen. Eine Datei, die nicht übereinstimmt, wird nie installiert oder gestartet.
Der Schlüssel wird in den Logs maskiert und für den Rest des Jobs als SQUARECLOUD_API_KEY gesetzt. Auf die Festplatte des Runners wird nichts geschrieben.
squarecloud mit Ihrem command läuft in workdir. Schlägt der Befehl fehl, schlägt auch der Schritt fehl.
Vier Muster aus der Dokumentation der Action, bereit zum Kopieren. Die hervorgehobenen Zeilen zeigen, was sich gegenüber dem Workflow oben ändert.
Pushes auf main gehen in die Produktion, Pushes auf develop ins Staging, jeweils in eine eigene Anwendung.
concurrency lässt Deploys desselben Branches aufeinander warten, statt sie zu überlappenname: Deployon: push: branches: [main, develop] workflow_dispatch:concurrency: group: deploy-${{ github.ref_name }}jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 - uses: squarecloudofc/github-action@v2 with: token: ${{ secrets.SQUARECLOUD_API_KEY }} command: commit ${{ github.ref_name == 'main' && vars.PRODUCTION_APP_ID || vars.STAGING_APP_ID }} --restartJeder Ordner ist eine eigene Anwendung. Eine Matrix deployt sie nebeneinander, mit einem Job pro Ordner.
workdir richtet jeden Deploy auf seinen Ordner ausfail-fast: false verhindert, dass ein fehlgeschlagener Deploy die anderen abbrichtname: Deployon: push: branches: [main]jobs: deploy: runs-on: ubuntu-latest strategy: fail-fast: false matrix: include: - folder: bot app: ${{ vars.BOT_APP_ID }} - folder: website app: ${{ vars.WEBSITE_APP_ID }} steps: - uses: actions/checkout@v7 - uses: squarecloudofc/github-action@v2 with: token: ${{ secrets.SQUARECLOUD_API_KEY }} workdir: ${{ matrix.folder }} command: commit ${{ matrix.app }} --restartNur der Code eines veröffentlichten Releases erreicht die Anwendung.
name: Deployon: release: types: [published]jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 - uses: squarecloudofc/github-action@v2 with: token: ${{ secrets.SQUARECLOUD_API_KEY }} command: commit ${{ vars.SQUARECLOUD_APP_ID }} --restartBewahren Sie Tokens und Passwörter in GitHub-Secrets auf und senden Sie sie vor jedem Deploy an die Anwendung. env set fügt nur die aufgeführten Variablen hinzu oder aktualisiert sie, und der Neustart nach dem Commit lädt sie.
$, &, ; oder | genau so an, wie sie im Secret gespeichert sindenv übergebene Secrets bleiben außerhalb des Skripts, das GitHub startet- uses: squarecloudofc/github-action@v2 with: token: ${{ secrets.SQUARECLOUD_API_KEY }} install-only: true- name: Update environment variables run: squarecloud app env set --app "$APP_ID" "DISCORD_TOKEN=$DISCORD_TOKEN" "DATABASE_URL=$DATABASE_URL" env: APP_ID: ${{ vars.SQUARECLOUD_APP_ID }} DISCORD_TOKEN: ${{ secrets.DISCORD_TOKEN }} DATABASE_URL: ${{ secrets.DATABASE_URL }}- run: squarecloud commit ${{ vars.SQUARECLOUD_APP_ID }} --restartNur token ist erforderlich. Die anderen haben Standardwerte, die Sie so lassen können.
tokenErforderlichcommandsquarecloud, zum Beispiel commit --restart. Ohne ihn installiert die Action nur die CLI.versionStandard latestlatest oder 3.1.0 und höher. Die Suche nach der neuesten Version ruft die GitHub-API nicht auf, deren Rate-Limit also nie im Weg steht.workdirStandard .install-onlyStandard falsesquarecloud selbst starten können.Deployt den Ordner bot bei jedem Lauf mit CLI 3.1.1, egal welches Release das neueste ist.
- uses: squarecloudofc/github-action@v2 with: token: ${{ secrets.SQUARECLOUD_API_KEY }} version: 3.1.1 workdir: bot command: commit ${{ vars.SQUARECLOUD_APP_ID }} --restartMit install-only bleiben die CLI und ihr Schlüssel für die nächsten Schritte verfügbar: Build, Deploy und danach der Status als JSON.
- uses: squarecloudofc/github-action@v2 with: token: ${{ secrets.SQUARECLOUD_API_KEY }} install-only: true- run: npm ci && npm run build- run: squarecloud commit ${{ vars.SQUARECLOUD_APP_ID }} --restart- run: squarecloud app status ${{ vars.SQUARECLOUD_APP_ID }} --jsonDie Action ist auf den Linux-, Windows- und macOS-Runnern von GitHub getestet, mit x64 und arm64. Ihre eigenen selbst gehosteten Runner funktionieren ebenfalls, sofern ihre Runner-Version node24-Actions unterstützt.
x64 und arm64 auf GitHub-gehosteten Runnern. Ihre eigenen Runner können auch x86 oder ARMv7 sein.
x64 und arm64 auf GitHub-gehosteten Runnern. Ihre eigenen Runner können auch x86 sein.
Intel und Apple Silicon, auf GitHub-gehosteten Runnern wie auf Ihren eigenen.
Die Action behandelt den API-Schlüssel wie das Passwort, das er ist.
Der Schlüssel wird als Secret registriert, bevor irgendetwas startet, und erscheint daher in jeder Logzeile als ***.
Die CLI liest ihn aus SQUARECLOUD_API_KEY. Er wird weder auf dem Runner gespeichert noch über die Befehlszeile übergeben.
Spätere Schritte desselben Jobs können ihn nutzen, andere Jobs nicht. Starten Sie Actions, denen Sie nicht vertrauen, in einem separaten Job.
Geben Sie jedem Repository einen eigenen Schlüssel, damit Sie einen widerrufen können, ohne die anderen anzufassen.
Jeder Befehl, den die Action startet, ist ein Befehl der Square Cloud CLI, und die CLI ist dafür gebaut, ohne Terminal zu funktionieren.
Befehle, die Daten ändern oder löschen, fragen vorher nach. Ein Workflow kann nicht antworten, also fügen Sie -y hinzu: Ohne die Option endet der Befehl mit Code 1 und ändert nichts.
Befehle, die Daten ausgeben, akzeptieren --json, für eine Ausgabe, die der nächste Schritt auswerten kann.
Setzen Sie SQUARECLOUD_DEBUG: 1 im env des Schritts, um Methode, Pfad, Status und Dauer jeder API-Anfrage zu protokollieren, nie Header oder Bodys.
commit lässt aus, was squarecloud.ignore in gitignore-Syntax auflistet. node_modules, .git und Lockfiles bleiben draußen, außer Sie nehmen sie mit ! wieder auf.
@v2 zeigt jetzt auf die neue Version, Ihr Workflow läuft also unverändert weiter. Das hat sich geändert.
workdir wird angewendet. Bis 2.1.2 wurde es ignoriert und Befehle liefen im Stammverzeichnis des Repositorys.version legt die Version fest.CLI 3.1 lässt außerdem Lockfiles aus Uploads heraus. Um Ihres weiterhin zu senden, fügen Sie !package-lock.json (oder Ihr Lockfile) zu squarecloud.ignore hinzu.
Vom ersten Deploy bis 1 TB RAM, ohne die Plattform zu wechseln. Jede Phase ergänzt die vorherige um Speicher und Funktionen, und Upgrades gelten sofort.
Bringen Sie die Idee vom localhost ins Netz.
Ab12,49 R$/Monat≈ 2,00 €
Produktion mit Datenbanken, eigener Domain und Team.
Ab44,99 R$/Monat≈ 7,20 €
Mehr Speicher, tägliche Snapshots und Einblick in das, was läuft.
Ab124,99 R$/Monat≈ 20,00 €
Große Betriebe, mit privatem Discord-Kanal.
Ab299,90 R$/Monat≈ 47,98 €
| Hobby | Standard | Pro | Enterprise | |
|---|---|---|---|---|
| Rechenleistung | ||||
| RAM | 1 GB → 2 GB | 4 GB → 8 GB | 12 GB → 24 GB | 32 GB → 1 TB |
| vCPU | 1 → 2 | 4 | 6 → 12 | 16 |
| Plattform | ||||
| Echtzeit-Metriken | Enthalten | Enthalten | Enthalten | Enthalten |
| Blob Storage | Enthalten | Enthalten | Enthalten | Enthalten |
| Rollback mit 1 Klick | Enthalten | Enthalten | Enthalten | Enthalten |
| Square Shield gegen DDoS | Enthalten | Enthalten | Enthalten | Enthalten |
| Datenbanken | Nicht enthalten | Enthalten | Enthalten | Enthalten |
| Eigene Domain | Nicht enthalten | Enthalten | Enthalten | Enthalten |
| Load BalancerApps pro Domain | Nicht enthalten | 2 | 5 | 10 |
| AI Gateway | Nicht enthalten | Enthalten | Enthalten | Enthalten |
| Tägliche Snapshots der Anwendungen | Nicht enthalten | Nicht enthalten | Enthalten | Enthalten |
| Performance-Analyse | Nicht enthalten | Nicht enthalten | Enthalten | Enthalten |
| Team und Support | ||||
| WorkspacesMitglieder pro Workspace | Nicht enthalten | 3 → 7 | 10 → 20 | 20 → 50 |
| Priorisierter Support | Nicht enthalten | Nicht enthalten | Enthalten | Enthalten |
| Privater Discord-Kanal | Nicht enthalten | Nicht enthalten | Nicht enthalten | Enthalten |
4,9 von 5
482 Bewertungen auf Google und Trustpilot
Gehostet in einem Partner-Rechenzentrum mit den Zertifizierungen