Upgrade from v3 to v4 Guide
Introduction
The v4 version introduces a task queue mechanism, significantly improving resource efficiency and enhancing high-concurrency capabilities.
1. Preparation Before Upgrade
- Export the database and save it as
apple.sql
. - Recommended Deployment Method: Docker Compose
2. Uninstall Old Backend Version
Stop and remove old containers using the following commands:
bash
docker stop appleautopro
docker rm appleautopro
docker ps -a | grep 'apple-auto' | awk '{print $1}' | xargs docker rm -f
3. Deploy the New Version
Using Docker Compose
Install and configure Docker Compose
Refer to the Docker Compose Deployment Guide for installation steps.Restore Database
- Place
apple.sql
in the project root directory. - Import the database using:
bashdocker cp apple.sql appleautopro-mariadb-1:/tmp docker exec -it appleautopro-mariadb-1 bash mariadb -uroot -p<database_root_password>
- Place
Rebuild Database in MariaDB Container:
sql
DROP DATABASE appleautopro;
CREATE DATABASE appleautopro;
USE appleautopro;
SOURCE /tmp/apple.sql;
Exit the container by typing exit
twice.
- Restart the Service:
bash
docker compose restart
- Verify Data and Functionality:
Log in using the original account and check if the data is correct. Once confirmed, old database files and web files can be deleted.
Manual Deployment
- Frontend Installation
Follow Frontend Installation Guide steps 1 to 6.
Note: Set PHP version to8.x
. - System Configuration Check
Log into the admin panel and verify system settings. - Backend Installation
Follow Backend Installation Guide to complete the backend setup.
🎉 Upgrade Complete
You have successfully upgraded from v3 to v4!