Skip to content

Railway deploy della wiki

Questa configurazione pubblica solo la documentazione MkDocs, non l'estensione browser.

Architettura

  • Service Railway: wiki.
  • Build: Dockerfile dedicato Dockerfile.railway-wiki.
  • Output pubblicato: sito statico generato da mkdocs build.
  • Runtime: python -m http.server su 0.0.0.0:$PORT.
  • Healthcheck Railway: /.
  • Variabili applicative: nessuna richiesta.
  • Database, volumi, worker o private network: non necessari.

Istanza Railway creata

  • Project: sf-inspector-wiki
  • Environment: production
  • Service: wiki
  • Dominio Railway: https://wiki-production-4d32.up.railway.app
  • Feature wiki: https://wiki-production-4d32.up.railway.app/features/

Il file Dockerfile.railway-wiki.dockerignore limita il contesto Docker a:

  • docs/**
  • mkdocs.yml
  • README.md
  • PRIVACY.md
  • CHANGES.md
  • file Railway/Docker dedicati

In questo modo il deploy non include src, addon, build dell'estensione o altri asset applicativi.

Prerequisiti

La Railway CLI deve essere installata e autenticata.

railway --version
railway login
railway whoami

Versione verificata localmente durante la preparazione: railway 4.11.2.

Creare il progetto Railway

Dal root del repository:

railway init --name sf-inspector-wiki

Il comando crea un nuovo progetto e collega la directory corrente. Se lavori in un workspace specifico:

railway init --name sf-inspector-wiki --workspace "<workspace-name-or-id>"

Poi crea e collega il service web:

railway add --service wiki
railway status

Se il progetto esiste gia, collega progetto, ambiente e service:

railway link --project "<project-id-or-name>" --environment production --service wiki

Primo deploy

railway up --service wiki

Per avviare il deploy senza restare attaccato ai log:

railway up --service wiki --detach

Il file .railwayignore fa si che railway up carichi solo i file necessari alla wiki. Non rimuoverlo se l'obiettivo e pubblicare solo la documentazione.

Dominio pubblico

Genera un dominio Railway:

railway domain --service wiki

Per un dominio custom:

railway domain docs.example.com --service wiki

La CLI restituira i record DNS richiesti.

Verifica

Dopo il deploy:

railway status
railway logs --service wiki

Apri il dominio generato e verifica:

  • home docs raggiungibile;
  • /features/ raggiungibile;
  • screenshot feature caricati;
  • ricerca MkDocs inizializzata.

Operazioni ricorrenti

Nuovo deploy manuale:

railway up --service wiki

Log:

railway logs --service wiki

Redeploy dell'ultima build:

railway redeploy --service wiki

Aprire dashboard:

railway open

Note operative

  • railway.json forza il builder Dockerfile e usa Dockerfile.railway-wiki.
  • watchPatterns limita gli autodeploy alle modifiche documentali e ai file deploy della wiki.
  • Railway inietta PORT; il container ascolta su 0.0.0.0:$PORT.
  • mkdocs build --strict non e usato nel Dockerfile perche attualmente fallisce su warning preesistenti in docs/index.md/README snippet e troubleshooting.md.