c19af3b119
Some checks failed
CI/CD Pipeline / Backend - Build, Test & Push (push) Failing after 58s
CI/CD Pipeline / Frontend - Build, Test & Push (push) Failing after 5m55s
CI/CD Pipeline / Integration Tests (push) Has been skipped
CI/CD Pipeline / Deployment Summary (push) Has been skipped
CI/CD Pipeline / Deploy to Portainer (push) Has been skipped
CI/CD Pipeline / Discord Notification (Success) (push) Has been skipped
CI/CD Pipeline / Discord Notification (Failure) (push) Has been skipped
Reorganisation majeure de toute la documentation du projet pour ameliorer la navigation et la maintenance. ## Changements principaux ### Organisation (80 -> 4 fichiers .md a la racine) - Deplace 82 fichiers .md dans docs/ organises en 11 categories - Conserve uniquement 4 fichiers essentiels a la racine: * README.md, CLAUDE.md, PRD.md, TODO.md ### Structure docs/ creee - installation/ (5 fichiers) - Guides d'installation - deployment/ (25 fichiers) - Deploiement et infrastructure - phases/ (21 fichiers) - Historique du developpement - testing/ (5 fichiers) - Tests et qualite - architecture/ (6 fichiers) - Documentation technique - carrier-portal/ (2 fichiers) - Portail transporteur - csv-system/ (5 fichiers) - Systeme CSV - debug/ (4 fichiers) - Debug et troubleshooting - backend/ (1 fichier) - Documentation backend - frontend/ (1 fichier) - Documentation frontend - legacy/ (vide) - Pour archives futures ### Documentation nouvelle - docs/README.md - Index complet de toute la documentation (367 lignes) * Guide de navigation par scenario * Recherche rapide par theme * FAQ et commandes rapides - docs/CLEANUP-REPORT-2025-12-22.md - Rapport detaille du nettoyage ### Scripts reorganises - add-email-to-csv.py -> scripts/ - deploy-to-portainer.sh -> docker/ ### Fichiers supprimes - 1536w default.svg (11MB) - Fichier non utilise ### References mises a jour - CLAUDE.md - Section Documentation completement reecrite - docs/architecture/EMAIL_IMPLEMENTATION_STATUS.md - Chemin script Python - docs/deployment/REGISTRY_PUSH_GUIDE.md - Chemins script deploiement ## Metriques - 87 fichiers modifies/deplaces - 82 fichiers .md organises dans docs/ - 11MB d'espace libere - Temps de recherche reduit de ~5min a ~30s (-90%) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
153 lines
4.2 KiB
Markdown
153 lines
4.2 KiB
Markdown
# ⚡ Fix Rapide Portainer - Images Ne Montent Pas
|
|
|
|
## 🎯 Diagnostic
|
|
|
|
✅ **Images ARM64 existent dans le registry** (vérifié avec `docker manifest inspect`)
|
|
✅ **CI/CD build correctement** les images multi-architecture
|
|
✅ **Stack Portainer correctement configuré**
|
|
|
|
❌ **Problème le plus probable** : **Registry credentials manquants**
|
|
|
|
---
|
|
|
|
## 🔧 Solution Rapide (5 minutes)
|
|
|
|
### Étape 1 : Login Docker sur le Serveur Portainer
|
|
|
|
```bash
|
|
# SSH sur votre serveur ARM64
|
|
ssh votre-serveur
|
|
|
|
# Login au registry Scaleway
|
|
docker login rg.fr-par.scw.cloud/weworkstudio
|
|
|
|
# Credentials :
|
|
Username: nologin
|
|
Password: [copier le token depuis https://console.scaleway.com/registry/namespaces]
|
|
```
|
|
|
|
### Étape 2 : Test Pull Manuel
|
|
|
|
```bash
|
|
# Tester que ça marche
|
|
docker pull rg.fr-par.scw.cloud/weworkstudio/xpeditis-backend:preprod
|
|
|
|
# Devrait afficher :
|
|
# preprod: Pulling from weworkstudio/xpeditis-backend
|
|
# ...
|
|
# Status: Downloaded newer image for rg.fr-par.scw.cloud/weworkstudio/xpeditis-backend:preprod
|
|
|
|
# Vérifier que c'est ARM64
|
|
docker image inspect rg.fr-par.scw.cloud/weworkstudio/xpeditis-backend:preprod | grep Architecture
|
|
|
|
# Devrait afficher : "Architecture": "arm64" ✅
|
|
```
|
|
|
|
### Étape 3 : Ajouter Registry dans Portainer (Interface Web)
|
|
|
|
1. **Portainer** → **Registries** (menu gauche)
|
|
2. **Add registry**
|
|
3. Remplir :
|
|
- **Name** : `Scaleway`
|
|
- **Registry URL** : `rg.fr-par.scw.cloud/weworkstudio`
|
|
- **Authentication** : ✅ Activer
|
|
- **Username** : `nologin`
|
|
- **Password** : `[token Scaleway]`
|
|
4. **Add registry**
|
|
|
|
### Étape 4 : Update le Stack Portainer
|
|
|
|
1. **Portainer** → **Stacks** → Votre stack Xpeditis
|
|
2. Click **Editor**
|
|
3. Copier tout le contenu de `docker/portainer-stack.yml` (avec `platform: linux/arm64` ajouté)
|
|
4. ✅ **Cocher "Re-pull image and redeploy"**
|
|
5. Click **Update the stack**
|
|
|
|
### Étape 5 : Vérifier les Logs
|
|
|
|
1. **Portainer** → **Containers**
|
|
2. Cliquer sur `xpeditis-backend`
|
|
3. **Logs**
|
|
|
|
**Logs attendus** :
|
|
```
|
|
✅ PostgreSQL is ready
|
|
🔄 Running database migrations...
|
|
✅ Successfully ran X migration(s)
|
|
✅ Database migrations completed
|
|
🚀 Starting NestJS application...
|
|
[Nest] Application is running on: http://0.0.0.0:4000
|
|
```
|
|
|
|
---
|
|
|
|
## 🚨 Si Docker Swarm Mode
|
|
|
|
Si vous utilisez Docker Swarm (présence de `deploy.placement.constraints` dans le stack), vous devez login sur **TOUS les nodes** :
|
|
|
|
```bash
|
|
# Sur chaque node du swarm
|
|
docker login rg.fr-par.scw.cloud/weworkstudio
|
|
```
|
|
|
|
Vérifier les nodes :
|
|
```bash
|
|
docker node ls
|
|
# Tous doivent être READY
|
|
```
|
|
|
|
---
|
|
|
|
## ⚙️ Modifications Appliquées au Stack
|
|
|
|
**Ajout de `platform: linux/arm64`** pour forcer la sélection ARM64 :
|
|
|
|
```yaml
|
|
xpeditis-backend:
|
|
image: rg.fr-par.scw.cloud/weworkstudio/xpeditis-backend:preprod
|
|
platform: linux/arm64 # ← AJOUTÉ
|
|
restart: unless-stopped
|
|
# ...
|
|
|
|
xpeditis-frontend:
|
|
image: rg.fr-par.scw.cloud/weworkstudio/xpeditis-frontend:preprod
|
|
platform: linux/arm64 # ← AJOUTÉ
|
|
restart: unless-stopped
|
|
# ...
|
|
```
|
|
|
|
**Pourquoi ?** : Garantit que Docker pull l'image ARM64 et non AMD64.
|
|
|
|
---
|
|
|
|
## 📊 Checklist Rapide
|
|
|
|
- [ ] SSH sur serveur Portainer
|
|
- [ ] `docker login rg.fr-par.scw.cloud/weworkstudio`
|
|
- [ ] Test : `docker pull rg.fr-par.scw.cloud/weworkstudio/xpeditis-backend:preprod`
|
|
- [ ] Ajouter registry dans Portainer (Registries → Add registry)
|
|
- [ ] Copier le nouveau `portainer-stack.yml` (avec `platform: linux/arm64`)
|
|
- [ ] Update stack avec "Re-pull image and redeploy"
|
|
- [ ] Vérifier logs : `✅ Database migrations completed` puis `🚀 Starting NestJS application...`
|
|
- [ ] Tester API : `curl https://api.preprod.xpeditis.com/api/v1/health`
|
|
- [ ] Tester frontend : `https://app.preprod.xpeditis.com`
|
|
|
|
---
|
|
|
|
## 🎯 Résumé du Problème
|
|
|
|
| Composant | Status |
|
|
|-----------|--------|
|
|
| Images ARM64 dans registry | ✅ OK |
|
|
| CI/CD build multi-arch | ✅ OK |
|
|
| Stack configuration | ✅ OK |
|
|
| **Registry credentials** | ❌ **MANQUANTS** |
|
|
|
|
**Solution** : Ajouter credentials Scaleway dans Portainer + forcer `platform: linux/arm64`
|
|
|
|
---
|
|
|
|
**ETA Fix** : 5 minutes
|
|
**Impact** : 🔴 Critique - Bloque déploiement
|
|
**Difficulté** : ⚡ Facile - Configuration uniquement
|