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
- Backup database, file site e configurazione.
- Runtime: Python 3.14, Node 24, MariaDB 11.8, Redis 8.8.
- Ricreare/migrare virtualenv Bench a Python 3.14.
- Switch Frappe a
version-16, requirements e asset. - Patch, migrate, test app
ez_factoryos. - 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 frappeNel 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
exitbash
docker compose -f deploy/compose/development.yml --env-file .env up -dStaging e produzione
Immagini immutabili con Frappe 16; configurator aggiorna config/asset/schema. Promozione:
text
dev → staging → mainSu 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 psAtteso: Frappe version-16, Python 3.14.x, Node 24.x, servizi healthy, Desk /desk, worker/scheduler/websocket OK.
Rollback
- Fermare stack senza eliminare volumi.
- Immagine/tag precedente.
- Restore backup DB + file.
- 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.
