Guida PaaS: gestisci un’applicazione dal codice alla release

Una piattaforma PaaS ti permette di eseguire applicazioni senza configurare manualmente un sistema operativo o gestire i server web sottostanti. Questa guida descrive il ciclo di vita di un servizio Deplomo: dal collegamento del codice sorgente alla configurazione del runtime, fino al deploy, alla gestione dei database e al monitoraggio dell’applicazione.

Con Deplomo PaaS puoi gestire applicazioni web, API, worker per le code, attività pianificate e altri carichi di lavoro in container come servizi. Per le istruzioni di deploy specifiche per linguaggi e framework, consulta le guide al deploy .

Guide PaaS

Consulta queste guide per approfondire ogni fase del ciclo di vita di un servizio:

Collega repository Git, esegui il deploy di immagini Docker, usa il rilevamento automatico e configura i monorepo.

Codice sorgente e deploy

Gestisci i valori sensibili, le variabili di build e runtime e i riferimenti tra variabili.

Variabili d'ambiente e segreti

Usa add-on gestiti, collega database, monta volumi e gestisci i backup.

Database e dati persistenti

Gestisci le release, esegui rollback, promuovi le versioni tra ambienti e pianifica attività.

Operazioni e release

Consulta il log di una build non riuscita e ottieni una spiegazione generata dall’AI con un possibile passo successivo.

Spiegazioni degli errori di build con l'AI

Usa gli assistenti di programmazione per consultare e gestire i servizi Deplomo.

Assistenti AI e MCP

Ciclo di vita di un servizio

In genere, un’applicazione passa da queste fasi, dalla configurazione iniziale alla release:

1. Crea un progetto e i relativi ambienti

Crea un progetto dal pannello. Aggiungi ambienti come production, staging o preview per separare il traffico reale dai test. Ogni ambiente ha le proprie variabili e connessioni ai database.

2. Collega il codice sorgente

Scegli come fornire il codice dell’applicazione: collega un repository GitHub o GitLab, usa un’immagine Docker da un registry oppure esegui il deploy di una cartella locale con deplomo deploy.

3. Configura l’avvio dell’applicazione

Le applicazioni web devono ascoltare su 0.0.0.0 e sulla porta indicata dalla variabile d’ambiente PORT. Configura i comandi di build e di avvio in base al progetto.

4. Imposta variabili e segreti

Aggiungi le credenziali API e le impostazioni dell’applicazione. Definisci le variabili a livello di progetto o di ambiente per evitare che gli ambienti di test usino i valori di produzione. Per i dettagli, consulta la guida alle variabili d’ambiente.

5. Collega database e archiviazione persistente

Crea un database gestito supportato, come PostgreSQL, Redis o MySQL, e collegalo al servizio per fornirgli la stringa di connessione. Archivia i caricamenti degli utenti e gli altri file persistenti in un volume, non nel filesystem del container, che può essere sostituito.

6. Esegui il deploy e controlla il servizio

Consulta i log della build nel pannello. Quando la build è riuscita, verifica che il container si avvii e che il servizio risponda al suo URL. Poi puoi collegare un dominio personalizzato.

7. Gestisci release e rollback

Ogni modifica al codice può produrre una nuova build e una release. Se una nuova release crea problemi, torna a una build precedente senza ricompilarla.

I servizi web e worker restano in esecuzione. Se un processo si arresta in modo anomalo, la piattaforma prova a riavviarlo. I servizi cron vengono eseguiti secondo la pianificazione configurata.

Scegli il tipo di servizio

Carico di lavoro	Tipo di processo	Accesso alla rete	Uso tipico
Sito web o API	Processo web	HTTP, pubblico	Negozi online, frontend Next.js o React, servizi web Laravel o Python
Elaborazione in background	Worker	Privato, rete interna	Consumer di code RabbitMQ o Redis, elaborazione di immagini, invio di email
Attività pianificate	Processo cron	Non serve una porta aperta	Backup, report notturni, pulizia dei dati
Database o sistema di messaggistica	Processo stateful	TCP, pubblico o interno	Connessioni socket personalizzate, database e message broker
Microservizio interno	Web/API interno	Privato, accessibile solo nel progetto	Servizi di autenticazione e comunicazione tra servizi

Responsabilità condivise

Con PaaS, le responsabilità operative sono divise tra la piattaforma e il tuo team di sviluppo:

Deplomo fornisce: il runtime gestito, risorse di calcolo e archiviazione, rete, monitoraggio delle risorse e strumenti di deploy.
Il tuo team gestisce: il codice dell’applicazione, le migrazioni del database, l’ascolto sulla porta configurata in PORT, la gestione dei segreti e i backup dei dati importanti.