Skip to content

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

  1. Install and configure Docker Compose
    Refer to the Docker Compose Deployment Guide for installation steps.

  2. Restore Database

    • Place apple.sql in the project root directory.
    • Import the database using:
    bash
    docker cp apple.sql appleautopro-mariadb-1:/tmp
    docker exec -it appleautopro-mariadb-1 bash
    mariadb -uroot -p<database_root_password>
  3. 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.

  1. Restart the Service:
bash
docker compose restart
  1. 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

  1. Frontend Installation
    Follow Frontend Installation Guide steps 1 to 6.
    Note: Set PHP version to 8.x.
  2. System Configuration Check
    Log into the admin panel and verify system settings.
  3. Backend Installation
    Follow Backend Installation Guide to complete the backend setup.

🎉 Upgrade Complete

You have successfully upgraded from v3 to v4!