Linode usa gli StackScript — script con un’interfaccia basata su form dove puoi compilare i campi di configurazione direttamente nel Linode Manager senza modificare alcun codice.

Gli StackScript di Linode sono il metodo di deployment più semplice. I campi appaiono come un form quando crei un Linode — non è richiesta la modifica dello script.


Keycloak integrato (consigliato)

Passaggio 1 — Trova lo StackScript

Lo StackScript è disponibile pubblicamente nella community Linode — non è necessaria alcuna configurazione manuale:

  1. Vai su LinodesCrea Linode
  2. Sotto Scegli una distribuzione, seleziona StackScriptStackScript della community
  3. Cerca RTA rtSurvey - Self-Hosted with Keycloak SSO
  4. Selezionalo e compila il form di configurazione:

In alternativa, scarica lo script e crea il tuo StackScript sotto StackScriptCrea StackScript.

CampoObbligatorioDescrizione
ID ProgettoNoIdentificatore univoco (predefinito: rtsurvey). Usato come nome del database e ID client Keycloak.
Password admin KeycloakNoPassword sia per la console admin Keycloak che per l’accesso admin dell’app. Predefinito a admincambia dopo il primo accesso.
DominioIl tuo nome di dominio. Il record A DNS deve puntare all’IP di questo Linode. Richiesto per HTTPS e Keycloak.
Email Let’s EncryptEmail per le notifiche del certificato Let’s Encrypt.
Tag immagine DockerNoImmagine da distribuire (predefinito: rtawebteam/rta-smartsurvey:survey-dockerize).

Sicurezza: Tutte le password hanno admin come valore predefinito. Cambiale immediatamente dopo il tuo primo accesso.

  1. Scegli Ubuntu 22.04 LTS come immagine
  2. Scegli il piano Shared CPU 4 GB o superiore
  3. Fai clic su Crea Linode

Passaggio 2 — Aggiungi il record DNS

Mentre il Linode si avvia, aggiungi un record A nel tuo provider DNS:

  Tipo  : A
Nome  : myapp          (o @ per il dominio root)
Valore : <linode-ip>
TTL   : 300
  

Passaggio 3 — Monitora l’avanzamento

  ssh root@<linode-ip>
tail -f /var/log/stackscript.log
  

Lo script stampa l’IP del tuo server all’inizio — aggiungi il record DNS non appena lo vedi.

Passaggio 4 — Accedi all’app

Al completamento della configurazione, il log mostra un riepilogo:

  ============================================================
 rtCloud deployment complete! (Embedded Keycloak)
============================================================
 App URL   : https://myapp.example.com
 Admin     : admin / admin
 Keycloak  : https://myapp.example.com/auth/admin

 !! SECURITY: All passwords default to 'admin'.
    Change them immediately after first login.
============================================================
  

Accedi con nome utente admin e password admin, poi cambia subito la tua password.


Dopo il deployment

Cambiare una password

  nano /opt/rtcloud/.env
docker compose -f /opt/rtcloud/docker-compose.production.yml up -d --force-recreate rtcloud
  

Visualizza tutti i container

  docker compose -f /opt/rtcloud/docker-compose.production.yml ps
  

Controlla il log

  tail -200 /var/log/stackscript.log
  
Questa pagina è stata utile?