Get Rewarded! We will reward you with up to €50 credit on your account for every tutorial that you write and we publish!

Trasforma il tuo VPS in una piattaforma di deployment e hosting usando Stormkit

profile picture
Author
Savas Vedova
Published
2026-10-27
Time to read
7 minutes reading time

About the author- Savas è il fondatore di Stormkit e Staff Engineer presso GitLab

Introduzione

Benvenuti a questo tutorial su come trasformare il vostro VPS in una piattaforma di deployment e hosting usando Stormkit! Sono Savas, il fondatore di Stormkit, e oggi configureremo un VPS, installeremo Stormkit e distribuiremo due applicazioni: un'API basata su Go e un'applicazione ibrida TanStack capace di pre-rendering e servire file dinamici allo stesso tempo. Collegheremo anche la nostra API basata su Go al database incluso con Stormkit. Iniziamo!

Tempo stimato

Il tempo stimato per completare questo tutorial è circa 10 minuti.

Terminologia

  • 203.0.113.1: L'indirizzo IP pubblico del vostro VPS che verrà creato nel Passo 1.

Prerequisiti

Passo 1 - Configurazione e Accesso al VPS

  • Seguite questo tutorial per creare un Ubuntu Server.
  • Assicuratevi di selezionare una macchina con minimo 4GB di RAM e 2vCPU per prestazioni ottimali (ad esempio CX23 se disponibile).
  • Copiate l'indirizzo IP pubblico

Hetzner Console

Aprite il terminale e eseguite:

Sostituete 203.0.113.1 con l'IP da Hetzner.

ssh root@203.0.113.1

Ora siete collegati al VPS, pronti per procedere.

Passo 2 - Installazione di Stormkit

Prima di installare Stormkit, aggiorniamo rapidamente il sistema. Questo assicura che il vostro VPS abbia i pacchetti più recenti per una configurazione sicura.

Stormkit viene installato tramite uno script che configura Docker e prepara la piattaforma.

sudo apt update && sudo apt upgrade -y
curl -sSL https://www.stormkit.io/install.sh | sh

Lo script installerà Docker, configurerà le variabili d'ambiente e installerà i container Stormkit sul vostro VPS.

Durante l'installazione, lo script vi chiederà se avete un dominio personalizzato:

  • Se ne avete uno, inseritelo (ad es. example.com) e puntate example.com e *.example.com a 203.0.113.1 con dei record A presso il vostro provider DNS.
  • Altrimenti, premete Invio. Stormkit userà un dominio generato automaticamente in base al vostro indirizzo IP, ad esempio 203-0-113-1.sslip.io.

Ora, godetevi un caffè mentre l'installazione si completa.

Installare Stormkit tramite script

Passo 3 - Accesso alla Console Stormkit

Una volta completata l'installazione, lo script attende che https://stormkit.<your-domain> sia raggiungibile e stampa il link sul vostro terminale.

  • Cliccate sul link fornito nel vostro terminale.
  • Create un account amministratore.
  • Accedete usando queste credenziali.

Nota: Stormkit ha 3 sottodomini riservati per se stesso:

  • stormkit.<your-domain>: Vi permette di accedere all'interfaccia utente
  • api.<your-domain>: Vi permette di accedere a Stormkit programmaticamente
  • health.<your-domain>: Un endpoint per monitorare la vostra istanza Stormkit

Tutti gli altri sottodomini (*.<your-domain>) vengono usati per gli endpoint di sviluppo delle vostre applicazioni.

I certificati TLS per ogni endpoint gestito da Stormkit, incluse le vostre applicazioni, verranno generati automaticamente alla prima richiesta a quell'endpoint. Questo processo di solito richiede alcuni secondi.

Passo 4 - Configurare l'API basata su Go su Stormkit

Se non siete ancora collegati, seguite il Passo 3 per accedere all'interfaccia utente Stormkit. Dovreste vedere una schermata iniziale con diverse opzioni:

Importare app Stormkit

Per impostazione predefinita, Stormkit funziona con repository pubblici, se dovete accedere a repository privati, potete seguire questa documentazione. Per questo tutorial, useremo un repository di esempio.

  • Cliccate "Import from URL".

  • Incollate https://github.com/stormkit-io/stormkit-examples e cliccate Import repo.

  • Cliccate su Production environment.

  • Nel menu di sinistra, cliccate su "Config", poi su "Build" per accedere alle impostazioni di build e configurare la vostra app:

    Nome campo Valore Descrizione
    Install command go get . Installare le dipendenze
    Build command go build -o dist/server . Costruire l'applicazione, dentro una cartella dist
    Output folder ./dist Vogliamo caricare solo la cartella dist
    Build root ./go-api Dato che la nostra applicazione è dentro la cartella go-api di primo livello, cambiamo il build root
  • Cliccate Save.

  • Successivamente, scorrete verso il basso alle impostazioni Server e configurate le vostre impostazioni server:

    Nome campo Valore
    Start command ./dist/server
  • Cliccate di nuovo Save.

Passo 5 - Collegare un database all'API basata su Go

Stormkit include un database PostgreSQL integrato. Ogni ambiente può avere il proprio schema isolato con credenziali dedicate, così la vostra applicazione non tocca mai il database che Stormkit usa per gestire la piattaforma.

  • Nel menu di sinistra, cliccate su "Database".
  • Cliccate "Attach Database".
  • Attivate "Inject environment variables" e cliccate "Save".

Da questo momento, Stormkit rende disponibili ai vostri deployment le seguenti variabili d'ambiente: POSTGRES_HOST, POSTGRES_PORT, POSTGRES_DB, POSTGRES_SCHEMA, POSTGRES_USER, POSTGRES_PASSWORD e DATABASE_URL. L'API Go di esempio legge queste variabili per connettersi al database, quindi non serve altra configurazione.

Non definite queste variabili manualmente in "Environment variables". Le variabili definite lì hanno la precedenza su quelle iniettate.

Se volete che Stormkit esegua migrazioni SQL a ogni deployment, potete anche attivare "Enable schema migrations" e impostare il percorso dei vostri file di migrazione. Consultate la documentazione del Database per maggiori dettagli.

Ora, distribuiamo l'applicazione:

  • Scorrete di nuovo verso l'alto e cliccate su "Deploy".
  • Una volta completato il deployment e quando in alto appare published, cliccate su "Preview".

Deployment Stormkit

Opzionale: Configurare il nome visualizzato

Potete configurare il nome visualizzato della vostra applicazione per avere una struttura URL più memorabile per i vostri endpoint di sviluppo.

  • Una volta creata la vostra applicazione, cliccate su Settings.
  • Cambiate il Display name in qualcosa di più significativo: Ad esempio go-api.
  • Cliccate Update.

Opzionale: Gestire la versione Go

Per gestire la vostra versione Go, raccomandiamo di usare file .go-version, mise.toml o .tool-versions. Stormkit installerà automaticamente le dipendenze specificate in questi file.

Passo 6 - Configurare l'applicazione ibrida TanStack

  • Navighi su "My apps", clicchi su "Create new app" e poi clicchi su "Import from URL".
  • Incollate https://github.com/stormkit-io/stormkit-examples e cliccate Import repo.
  • Cliccate su Production environment.
  • Aggiornate il Build root per puntare alla cartella TanStack: ./tanstack-ssr.
  • Cliccate Save.
  • Cliccate Deploy

Stormkit creerà due artefatti da questo deployment:

  • File statici: Questi file verranno serviti staticamente, senza invocare alcuna azione server. Potete verificare i file caricati controllando il manifest di build.
  • File server: Questi file verranno invocati su richiesta. Pensateli come funzioni Lambda.

Conclusione

Congratulazioni! Avete trasformato con successo il vostro VPS in una potente piattaforma di deployment e hosting usando Stormkit. Durante questo tutorial, avete raggiunto diversi obiettivi chiave:

  • Configurato un VPS con specifiche ottimali
  • Installato Stormkit con Docker Compose per deployment containerizzati
  • Collegato alla vostra API uno schema PostgreSQL isolato dal database integrato
  • Distribuito un'API basata su Go con configurazioni di build personalizzate
  • Distribuito un'applicazione ibrida TanStack capace sia di rendering statico che lato server

Il vostro VPS ora funge da piattaforma di deployment completa che può gestire più applicazioni simultaneamente. La generazione automatica di certificati TLS assicura che le vostre applicazioni siano sicure, mentre l'interfaccia intuitiva di Stormkit rende semplice la gestione continua.

Con questa configurazione, potete continuare a distribuire applicazioni aggiuntive, scalare la vostra infrastruttura secondo necessità e sfruttare appieno i vantaggi di avere la vostra piattaforma di deployment auto-ospitata. Che stiate lavorando su progetti personali o gestendo applicazioni per clienti, ora avete le fondamenta per una soluzione di hosting robusta.

Buon deployment!

License: MIT

Want to contribute?

Get Rewarded: Get up to €50 in credit! Be a part of the community and contribute. Do it for the money. Do it for the bragging rights. And do it to teach others!

Report Issue

Get new tutorials via RSS / Atom

Try Hetzner Cloud

Get €20/$20 free credit!

Valid until: 31 December 2026 Valid for: 3 months and only for new customers
Get started
Want to contribute?

Get Rewarded: Get up to €50 credit on your account for every tutorial you write and we publish!

Find out more
Report Issue

Get new tutorials via RSS / Atom