Guide de mise à jour du système

Ce document fournit les méthodes de mise à jour et les meilleures pratiques pour le système 88API afin de garantir une mise à niveau fluide vers la dernière version.

Préparation avant la mise à jour

Avant de mettre à jour le système, il est recommandé d'effectuer les étapes préparatoires suivantes :

1. Sauvegarde des données: sauvegardez la base de données et les fichiers de configuration importants
2. Vérifiez les journaux de mise à jour: consultez les mises à jour de la dernière version sur GitHub Releases
3. Vérifier la compatibilité: confirmez si la nouvelle version est compatible avec vos plugins, intégrations ou configurations personnalisées existants.
4. Choisissez une heure appropriée: effectuez la mise à jour pendant les heures creuses pour minimiser l'impact sur les utilisateurs.

Méthodes de mise à jour du déploiement Docker

Première méthode: mise à jour du déploiement d'un conteneur unique

Si vous avez déployé 88API à l'aide d'un seul conteneur Docker, vous pouvez mettre à jour en suivant ces étapes:

# Pull the latest image
docker pull calciumion/new-api:latest

# Stop and remove the old container
docker stop new-api
docker rm new-api

# Run the container again with the same parameters
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v /your/data/path:/data \
  calciumion/new-api:latest

Deuxième méthode: utiliser Docker Compose pour mettre à jour

Si vous utilisez Docker Compose pour le déploiement (voir Instructions de configuration de Docker Compose), le processus de mise à jour est plus simple:

# Enter the project directory
cd new-api

# Pull the latest image
docker compose pull

# Stop and restart the service
docker compose down
docker compose up -d

Ou utilisez une commande plus concise:

docker compose pull && docker compose down && docker compose up -d

Troisième méthode: utiliser le panneau 1Panel pour mettre à jour

Si vous avez déployé à l'aide du panneau 1Panel, vous pouvez mettre à jour en suivant ces étapes:

1. Connectez-vous au panneau 1Panel, accédez à App Store -> Page évolutive
2. Recherchez l'application 88API et cliquez sur le bouton Mise à niveau.
3. Sélectionnez la Version cible vers laquelle mettre à niveau
4. Cliquez sur le bouton Confirmer et le système extraira automatiquement la dernière image et mettra à niveau l'application.

Méthode 4: Utiliser le panneau BaoTa pour mettre à jour

Si vous avez déployé à l'aide du panneau BaoTa, vous pouvez mettre à jour en suivant ces étapes:

1. Connectez-vous au panneau BaoTa, accédez à Docker Management -> Container List
2. Recherchez le conteneur 88API, cliquez sur Plus -> Recréer.
3. Cochez l'option Extraire la dernière image, en vous assurant que les autres configurations restent inchangées.
4. Cliquez sur Soumettre et le système extraira automatiquement la dernière image et recréera le conteneur.

Méthode de mise à jour pour la compilation du code source

Si vous avez déployé 88API en compilant à partir du code source, les étapes de mise à jour sont les suivantes:

# Enter the project directory
cd new-api

# Pull the latest code
git pull

# Build the backend
go build -o new-api

# Update and build the frontend
cd web
bun install
bun run build
cd ..

# Restart the service
./new-api --port 3000

Stratégie de mise à jour pour le déploiement multi-nœuds

Pour les environnements de déploiement multi-nœuds, la stratégie de mise à jour suivante est recommandée:

1. Mettre à jour d'abord les nœuds secondaires: commencez par mettre à jour un nœud secondaire et tester sa stabilité
2. Déploiement progressif: après avoir confirmé la stabilité du nœud secondaire, mettez à jour les nœuds secondaires restants un par un.
3. Mettre à jour le nœud principal en dernier: une fois que tous les nœuds secondaires fonctionnent de manière stable, mettez à jour le nœud principal.

Cette stratégie minimise le risque d’interruption de service.

Liste de contrôle post-mise à jour

Après la mise à jour du système, veuillez vérifier les éléments suivants pour vous assurer que le système fonctionne correctement:

1. Interface de gestion des accès: confirmez que vous pouvez vous connecter et accéder normalement à l'interface de gestion.
2. Vérifier les journaux: consultez les journaux du système pour détecter les erreurs ou les avertissements.
3. Test des appels API: testez certains appels API pour vous assurer que la fonctionnalité est normale
4. Vérifier la migration de la base de données: confirmez si la mise à jour de la structure de la base de données a réussi
5. Vérifier l'état de la chaîne: confirmez si toutes les connexions des chaînes sont normales.

Restauration de la version

Si des problèmes surviennent après la mise à jour, vous pouvez revenir à une version stable précédente:

Restauration de Docker

# Pull a specific image version
docker pull calciumion/new-api:v1.x.x

# Stop and remove the current container
docker stop new-api
docker rm new-api

# Recreate the container with the previous image
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v /your/data/path:/data \
  calciumion/new-api:v1.x.x

Restauration du code source

# Enter the project directory
cd new-api

# Switch to a specific version
git checkout v1.x.x

# Build again
go build -o new-api

# Update and build the frontend
cd web
bun install
bun run build
cd ..

# Restart the service
./new-api --port 3000

Foire aux questions (FAQ)

Le service ne démarre pas après la mise à jour

• Vérifier les journaux pour les messages d'erreur
• Confirmez que la connexion à la base de données est normale
• Confirmez que la configuration des variables d'environnement est correcte

Fonctionnalité anormale après la mise à jour

• Vérifiez tout changement dans le format API
• Vérifiez si les versions frontend et backend correspondent
• Confirmez si la nouvelle version nécessite une configuration supplémentaire

Incompatibilité de la structure de la base de données

• Vérifiez les journaux de mise à jour pour les instructions de migration de base de données
• Vérifiez si l'exécution manuelle des scripts de migration de base de données est requise
• Contactez le développeur pour obtenir des conseils sur la mise à niveau de la base de données

Outil de mise à jour automatique (à utiliser avec prudence)

Pour les utilisateurs qui souhaitent mettre à jour automatiquement, Watchtower peut être utilisé pour mettre à jour les conteneurs:

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower -c \
  --run-once new-api