Hobby
Porta l'idea fuori dal localhost e mettila online.
- Fino a 2 vCPU
- Metriche in tempo reale
- Blob Storage
- Rollback con 1 clic
- Square Shield anti-DDoS
A partire da12,49 BRL/mese≈ 2,00 €
A ogni push, release o avvio manuale, l’action ufficiale installa la CLI di Square Cloud sul runner, la verifica e invia il tuo codice alla tua applicazione.
Due valori salvati nel tuo repository e un file di workflow. Da lì in poi, ogni push su main invia il codice alla tua applicazione e la riavvia.
Crea una chiave API nelle impostazioni di sicurezza del tuo account e salvala nel repository come secret SQUARECLOUD_API_KEY.
Copia l’ID dalla pagina dell’applicazione nella dashboard e salvalo come variabile del repository SQUARECLOUD_APP_ID.
Fai il commit del file qui sotto come .github/workflows/deploy.yml. Il prossimo push su main fa il deploy della tua applicazione.
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 }} --restartSenza actions/checkout, il runner non ha file da inviare.
--restart riavvia l’applicazione dopo l’upload e la avvia se era ferma. Senza, i nuovi file entrano in uso al prossimo riavvio.
Senza ID, commit legge la riga ID= del file squarecloud.app nella cartella, se esiste, quindi basta commit --restart.
Quattro passaggi, in quest’ordine, su ogni runner. Se uno fallisce, fallisce anche lo step, così un deploy che non è avvenuto non appare mai verde.
Sceglie la release della CLI per il sistema e il processore del runner: la più recente o la versione che fissi tu. I runner self-hosted la tengono nella loro tool cache.
Lo SHA-256 del download viene confrontato con il checksums.txt della release. Un file che non corrisponde non viene mai installato né avviato.
La chiave viene mascherata nei log e impostata come SQUARECLOUD_API_KEY per il resto del job. Niente viene scritto sul disco del runner.
squarecloud seguito dal tuo command parte in workdir. Se il comando fallisce, fallisce anche lo step.
Quattro schemi dalla documentazione dell’action, pronti da copiare. Le righe evidenziate sono quelle che cambiano rispetto al workflow qui sopra.
I push su main vanno in produzione e quelli su develop in staging, ognuno sulla propria applicazione.
concurrency mette in fila i deploy dello stesso branch invece di sovrapporliname: 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 }} --restartOgni cartella è un’applicazione a sé. Una matrice fa il deploy di tutte fianco a fianco, un job per cartella.
workdir indirizza ogni deploy alla sua cartellafail-fast: false evita che un deploy fallito annulli gli altriname: 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 }} --restartSolo il codice di una release pubblicata arriva all’applicazione.
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 }} --restartTieni token e password nei secret di GitHub e inviali all’applicazione prima di ogni deploy. env set aggiunge o aggiorna solo le variabili che elenca, e il riavvio dopo il commit le carica.
$, &, ; o | arrivano esattamente come salvati nel secretenv tiene i loro valori fuori dallo script che GitHub avvia- 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 }} --restartSolo token è obbligatorio. Gli altri hanno valori predefiniti che puoi lasciare così.
tokenObbligatoriocommandsquarecloud, per esempio commit --restart. Senza, l’action installa solo la CLI.versionPredefinito latestlatest, oppure 3.1.0 o successive. Trovare l’ultima versione non chiama l’API di GitHub, quindi il suo limite di richieste non è mai d’intralcio.workdirPredefinito .install-onlyPredefinito falsesquarecloud da soli.Fa il deploy della cartella bot con la CLI 3.1.1 a ogni avvio, qualunque sia l’ultima release.
- uses: squarecloudofc/github-action@v2 with: token: ${{ secrets.SQUARECLOUD_API_KEY }} version: 3.1.1 workdir: bot command: commit ${{ vars.SQUARECLOUD_APP_ID }} --restartCon install-only, la CLI e la sua chiave restano disponibili per gli step successivi: build, deploy e poi lo stato in 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 }} --jsonL’action è testata sui runner Linux, Windows e macOS di GitHub, su x64 e arm64. Funzionano anche i tuoi runner self-hosted, purché la loro versione supporti le action node24.
x64 e arm64 sui runner ospitati da GitHub. I tuoi runner possono essere anche x86 o ARMv7.
x64 e arm64 sui runner ospitati da GitHub. I tuoi runner possono essere anche x86.
Intel e Apple silicon, sia sui runner ospitati da GitHub sia sui tuoi.
L’action tratta la chiave API come la password che è.
La chiave viene registrata come secret prima che parta qualsiasi cosa, quindi appare come *** in ogni riga di log.
La CLI la legge da SQUARECLOUD_API_KEY. Non viene salvata sul runner né passata dalla riga di comando.
Gli step successivi dello stesso job possono usarla, gli altri job no. Avvia le action di cui non ti fidi in un job separato.
Dai a ogni repository la sua chiave, così puoi revocarne una senza toccare le altre.
Ogni comando che l’action avvia è un comando della CLI di Square Cloud, e la CLI è fatta per funzionare senza terminale.
I comandi che modificano o eliminano dati chiedono conferma. Un workflow non può rispondere, quindi aggiungi -y: senza, il comando termina con codice 1 e non cambia nulla.
I comandi che stampano dati accettano --json, per un output che lo step successivo può leggere.
Imposta SQUARECLOUD_DEBUG: 1 nell’env dello step per registrare metodo, percorso, stato e durata di ogni richiesta all’API, mai header o body.
commit esclude ciò che elenca squarecloud.ignore, con la sintassi di gitignore. node_modules, .git e i lockfile restano fuori, a meno che tu non li riaggiunga con !.
@v2 ora punta alla nuova versione, quindi il tuo workflow continua a funzionare senza modifiche. Ecco cosa è cambiato.
workdir viene applicato. Fino alla 2.1.2 veniva ignorato e i comandi partivano dalla radice del repository.version ne fissa la versione.La CLI 3.1 esclude anche i lockfile dagli upload. Per continuare a inviare il tuo, aggiungi !package-lock.json (o il tuo lockfile) a squarecloud.ignore.
Dal primo deploy a 1 TB di RAM, senza cambiare piattaforma. Ogni fase aggiunge memoria e funzionalità alla precedente, e l'upgrade vale subito.
Porta l'idea fuori dal localhost e mettila online.
A partire da12,49 BRL/mese≈ 2,00 €
Produzione con database, dominio personalizzato e team.
A partire da44,99 BRL/mese≈ 7,20 €
Più memoria, snapshot giornalieri e visibilità su ciò che gira.
A partire da124,99 BRL/mese≈ 20,00 €
Grandi operazioni, con un canale Discord privato.
A partire da299,90 BRL/mese≈ 47,98 €
| Hobby | Standard | Pro | Enterprise | |
|---|---|---|---|---|
| Calcolo | ||||
| Memoria RAM | 1 GB → 2 GB | 4 GB → 8 GB | 12 GB → 24 GB | 32 GB → 1 TB |
| vCPU | 1 → 2 | 4 | 6 → 12 | 16 |
| Piattaforma | ||||
| Metriche in tempo reale | Incluso | Incluso | Incluso | Incluso |
| Blob Storage | Incluso | Incluso | Incluso | Incluso |
| Rollback con 1 clic | Incluso | Incluso | Incluso | Incluso |
| Square Shield anti-DDoS | Incluso | Incluso | Incluso | Incluso |
| Database | Non incluso | Incluso | Incluso | Incluso |
| Dominio personalizzato | Non incluso | Incluso | Incluso | Incluso |
| Load balancerapp per dominio | Non incluso | 2 | 5 | 10 |
| AI Gateway | Non incluso | Incluso | Incluso | Incluso |
| Snapshot giornalieri delle applicazioni | Non incluso | Non incluso | Incluso | Incluso |
| Analisi delle prestazioni | Non incluso | Non incluso | Incluso | Incluso |
| Team e supporto | ||||
| Workspacemembri per workspace | Non incluso | 3 → 7 | 10 → 20 | 20 → 50 |
| Supporto prioritario | Non incluso | Non incluso | Incluso | Incluso |
| Canale Discord privato | Non incluso | Non incluso | Non incluso | Incluso |
4,9 su 5
482 recensioni su Google e Trustpilot
Ospitato in un datacenter partner con certificazioni