Skip to content

Upgrade Frappe 15 → 16 ​

Scopo ​

Migrare runtime e bench a Frappe version-16 con Python 3.14, Node 24, MariaDB 11.8, Redis 8.8.

Stato progetto: le immagini server attuali puntano già a Frappe 16; questa pagina resta come runbook se si riparte da un bench 15 o si onborda un clone legacy.

Prerequisiti ​

  • Backup completo DB + file site.
  • Nessun deploy production durante la migrazione del bench persistente.

Piano ​

  1. Backup database, file site e configurazione.
  2. Runtime: Python 3.14, Node 24, MariaDB 11.8, Redis 8.8.
  3. Ricreare/migrare virtualenv Bench a Python 3.14.
  4. Switch Frappe a version-16, requirements e asset.
  5. Patch, migrate, test app ez_factoryos.
  6. Promuovere artifact dev → staging → main.

Procedura — development con bench persistente ​

bash
make backup
docker compose -f deploy/compose/development.yml --env-file .env stop frappe
docker compose -f deploy/compose/development.yml --env-file .env run --rm --entrypoint bash frappe

Nel container:

bash
cd /home/frappe/data/frappe-bench
bench migrate-env /usr/local/bin/python3.14
bench switch-to-branch version-16 frappe --upgrade
bench update --requirements
bench build --apps frappe,ez_factoryos
bench --site factory.local migrate
exit
bash
docker compose -f deploy/compose/development.yml --env-file .env up -d

Staging e produzione ​

Immagini immutabili con Frappe 16; configurator aggiorna config/asset/schema. Promozione:

text
dev → staging → main

Su main: tree uguale a staging; promote tag OCI senza rebuild.

Verifica ​

bash
bench version
bench --site factory.local migrate
bench --site factory.local run-tests --app ez_factoryos
python --version
node --version
docker compose -f deploy/compose/development.yml --env-file .env ps

Atteso: Frappe version-16, Python 3.14.x, Node 24.x, servizi healthy, Desk /desk, worker/scheduler/websocket OK.

Rollback ​

  1. Fermare stack senza eliminare volumi.
  2. Immagine/tag precedente.
  3. Restore backup DB + file.
  4. Bench Python 3.11 / Frappe 15 solo con il relativo database.

Non riusare un DB già migrato a Frappe 16 con immagine Frappe 15.
Niente DROP DATABASE / reset volumi in rollback senza conferma esplicita.

Ez FactoryOS — MES per Ortobellina / OP Raggio di Sole · App Frappe v16 ez_factoryos