xpeditis2.0/docs/deployment/DEPLOYMENT_FIX.md

🔧 Fix Portainer Deployment Issues

Problèmes Identifiés

1. ❌ Registry Mismatch (CRITIQUE)

Problème: Portainer essaie de pull les images depuis DockerHub au lieu de Scaleway Registry.

Dans docker/portainer-stack.yml:

# ❌ INCORRECT (ligne 77):
image: weworkstudio/xpeditis-backend:preprod

# ❌ INCORRECT (ligne 136):
image: weworkstudio/xpeditis-frontend:latest

CORRECTION REQUISE:

# ✅ CORRECT:
image: rg.fr-par.scw.cloud/weworkstudio/xpeditis-backend:preprod

# ✅ CORRECT:
image: rg.fr-par.scw.cloud/weworkstudio/xpeditis-frontend:preprod

---

2. ❌ Tag Frontend Incorrect (CRITIQUE)

Problème: Portainer demande :latest mais CI/CD ne crée ce tag QUE si preprod est la branche par défaut.

CORRECTION REQUISE:

# Remplacer :latest par :preprod
image: rg.fr-par.scw.cloud/weworkstudio/xpeditis-frontend:preprod

---

3. ⚠️ Bucket S3 pour CSV Rates

Problème: Le code backend utilise xpeditis-csv-rates par défaut, mais Portainer configure xpeditis-preprod-documents.

CORRECTION REQUISE dans portainer-stack.yml:

environment:
  # Ajouter cette ligne:
  AWS_S3_BUCKET: xpeditis-preprod-documents
  # OU créer un bucket dédié CSV:
  AWS_S3_CSV_BUCKET: xpeditis-csv-rates

Option 1 - Utiliser le même bucket: Pas de changement de code, juste s'assurer que AWS_S3_BUCKET=xpeditis-preprod-documents est bien défini.

Option 2 - Bucket séparé pour CSV (recommandé):

1. Créer le bucket xpeditis-csv-rates dans MinIO
2. Ajouter AWS_S3_CSV_BUCKET: xpeditis-csv-rates dans les env vars
3. Modifier le code backend pour utiliser AWS_S3_CSV_BUCKET

---

📝 Fichier Corrigé: portainer-stack.yml

  # Backend API (NestJS)
  xpeditis-backend:
    image: rg.fr-par.scw.cloud/weworkstudio/xpeditis-backend:preprod  # ← FIXÉ
    restart: unless-stopped
    environment:
      NODE_ENV: preprod
      PORT: 4000

      # Database
      DATABASE_HOST: xpeditis-db
      DATABASE_PORT: 5432
      DATABASE_USER: xpeditis
      DATABASE_PASSWORD: 9Lc3M9qoPBeHLKHDXGUf1
      DATABASE_NAME: xpeditis_preprod

      # Redis
      REDIS_HOST: xpeditis-redis
      REDIS_PORT: 6379
      REDIS_PASSWORD: hXiy5GMPswMtxMZujjS2O

      # JWT
      JWT_SECRET: 4C4tQC8qym/evv4zI5DaUE1yy3kilEnm6lApOGD0GgNBLA0BLm2tVyUr1Lr0mTnV

      # S3/MinIO
      AWS_S3_ENDPOINT: http://xpeditis-minio:9000
      AWS_REGION: us-east-1
      AWS_ACCESS_KEY_ID: minioadmin_preprod_CHANGE_ME
      AWS_SECRET_ACCESS_KEY: RBJfD0QVXC5JDfAHCwdUW
      AWS_S3_BUCKET: xpeditis-csv-rates  # ← FIXÉ pour CSV rates

      # CORS
      CORS_ORIGIN: https://app.preprod.xpeditis.com,https://www.preprod.xpeditis.com

      # App URLs
      FRONTEND_URL: https://app.preprod.xpeditis.com
      API_URL: https://api.preprod.xpeditis.com

    networks:
      - xpeditis_internal
      - traefik_network
    # ... labels inchangés ...

  # Frontend (Next.js)
  xpeditis-frontend:
    image: rg.fr-par.scw.cloud/weworkstudio/xpeditis-frontend:preprod  # ← FIXÉ
    restart: unless-stopped
    environment:
      NODE_ENV: preprod
      NEXT_PUBLIC_API_URL: https://api.preprod.xpeditis.com
      NEXT_PUBLIC_WS_URL: wss://api.preprod.xpeditis.com
    networks:
      - traefik_network
    # ... labels inchangés ...

---

🚀 Étapes pour Déployer

1. Vérifier que les images existent dans Scaleway Registry

# Login au registry Scaleway
docker login rg.fr-par.scw.cloud/weworkstudio

# Vérifier les images disponibles (via Scaleway Console)
# https://console.scaleway.com/registry

2. Mettre à jour Portainer Stack

1. Ouvre Portainer: https://portainer.ton-domaine.com
2. Va dans Stacks → xpeditis
3. Clique sur Editor
4. Remplace les lignes 77 et 136 avec les images corrigées
5. Deploy the stack (ou Update the stack)

3. Créer le bucket MinIO pour CSV

# Accède à MinIO Console
# https://minio.preprod.xpeditis.com

# Login avec:
# User: minioadmin_preprod_CHANGE_ME
# Password: RBJfD0QVXC5JDfAHCwdUW

# Créer le bucket "xpeditis-csv-rates"
# Settings → Public Access: Private

4. Vérifier le déploiement

# Vérifier les containers
docker ps | grep xpeditis

# Vérifier les logs backend
docker logs xpeditis-backend -f --tail=100

# Vérifier les logs frontend
docker logs xpeditis-frontend -f --tail=100

---

🐛 Debugging si ça ne fonctionne toujours pas

Vérifier l'accès au registry

# Teste manuellement le pull de l'image
docker pull rg.fr-par.scw.cloud/weworkstudio/xpeditis-backend:preprod
docker pull rg.fr-par.scw.cloud/weworkstudio/xpeditis-frontend:preprod

Vérifier que les tags existent

Regarde dans GitHub Actions → Dernière exécution → Backend job:

Build and push Backend Docker image
tags: rg.fr-par.scw.cloud/weworkstudio/xpeditis-backend:preprod

Erreur commune: "manifest unknown"

Si tu vois cette erreur, c'est que le tag n'existe pas. Solutions:

1. Push manuellement vers la branche preprod pour déclencher le CI/CD
2. Vérifier que le workflow GitHub Actions s'est bien exécuté
3. Vérifier le secret REGISTRY_TOKEN dans GitHub Settings

---

📋 Checklist de Déploiement

• Corriger portainer-stack.yml lignes 77 et 136 avec le registry Scaleway
• Changer le tag frontend de :latest à :preprod
• Créer le bucket MinIO xpeditis-csv-rates
• Mettre à jour la stack dans Portainer
• Vérifier que les containers démarrent correctement
• Tester l'upload d'un fichier CSV via le dashboard admin
• Vérifier que le CSV apparaît dans MinIO

---

🔐 Note sur les Credentials

Les credentials dans portainer-stack.yml contiennent:

• Passwords de production (PostgreSQL, Redis, MinIO)
• JWT Secret de production
• Access Keys MinIO

IMPORTANT: Change ces credentials IMMÉDIATEMENT si ce repo est public ou accessible par des tiers!