Skip to content

Commit cc19660

Browse files
claudeclaude
committed
Solution complète M3 Max: override et guide détaillé
- Ajout docker-compose.override.yml pour désactiver compreface-core - Guide complet M3_MAX_SOLUTION_COMPLETE.md avec 3 options - Recommandations pour déploiement production sur serveur Linux - Instructions pour tester sans reconnaissance sur M3 Max CompreFace core ne fonctionne pas sur ARM64 (deadlock émulation). Solution: Serveur Linux/Intel pour production, M3 Max pour tests UI only.
1 parent 9b7e179 commit cc19660

2 files changed

Lines changed: 326 additions & 0 deletions

File tree

‎M3_MAX_SOLUTION_COMPLETE.md‎

Lines changed: 292 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,292 @@
1+
# 🍎 Solution Complète pour M3 Max ARM64
2+
## 1BIP - CompreFace sur Apple Silicon
3+
4+
---
5+
6+
## 🚨 PROBLÈME IDENTIFIÉ
7+
8+
CompreFace **NE FONCTIONNE PAS** correctement sur M3 Max ARM64 parce que:
9+
10+
❌ Les images Docker officielles sont **AMD64 uniquement**
11+
❌ L'émulation Rosetta 2 cause un **deadlock** dans compreface-core
12+
❌ Le chargement des modèles ML bloque indéfiniment
13+
14+
**Symptômes:**
15+
- compreface-core bloqué à 100% CPU pendant des heures
16+
- Logs s'arrêtent à "Operational MODE: threaded"
17+
- Port 3000 ne répond jamais
18+
- Interface UI reste sur "Core node loading..."
19+
20+
---
21+
22+
## ✅ SOLUTIONS (3 Options)
23+
24+
### Option 1: Utiliser un Serveur Linux/Intel (RECOMMANDÉ POUR PRODUCTION)
25+
26+
**Pour 300-500 utilisateurs en production militaire, vous DEVEZ utiliser un serveur dédié:**
27+
28+
#### Configuration Recommandée:
29+
```
30+
Serveur: Ubuntu 22.04 LTS (Intel/AMD64)
31+
CPU: 8 cores minimum (16 cores recommandé)
32+
RAM: 32 GB minimum (64 GB recommandé)
33+
SSD: 500 GB minimum
34+
Réseau: 1 Gbps
35+
```
36+
37+
#### Avantages:
38+
✅ Performance maximale (pas d'émulation)
39+
✅ Stabilité garantie
40+
✅ Scalable pour 500+ utilisateurs
41+
✅ Support officiel CompreFace
42+
✅ Compatible avec toutes les fonctionnalités
43+
44+
#### Déploiement:
45+
```bash
46+
# Sur le serveur Linux
47+
git clone [votre-repo]
48+
cd CompreFaceModeling
49+
docker-compose up -d
50+
51+
# Tout fonctionnera directement!
52+
```
53+
54+
---
55+
56+
### Option 2: Tester Sans Reconnaissance Faciale (M3 Max - Tests Seulement)
57+
58+
**Pour tester l'interface et le dashboard sur M3 Max:**
59+
60+
```bash
61+
cd ~/Desktop/Projects/CompreFaceModeling
62+
63+
# Arrêter compreface-core seulement
64+
docker-compose stop compreface-core
65+
66+
# Les autres services fonctionnent:
67+
docker-compose ps
68+
```
69+
70+
#### Ce Qui Fonctionne:
71+
✅ Interface UI CompreFace (création compte, gestion users)
72+
✅ Base de données PostgreSQL
73+
✅ Dashboard 1BIP en français
74+
✅ Upload de photos
75+
✅ Gestion des applications
76+
77+
#### Ce Qui NE Fonctionne PAS:
78+
❌ Reconnaissance faciale (service core désactivé)
79+
❌ Détection de visages
80+
❌ Caméra Hikvision (nécessite reconnaissance)
81+
82+
#### Test:
83+
```bash
84+
# Ouvrir l'interface
85+
open http://localhost:8000
86+
87+
# Vous DEVRIEZ voir la page de login maintenant
88+
# Créez votre compte et explorez l'interface
89+
```
90+
91+
---
92+
93+
### Option 3: Builder en ARM64 Natif (AVANCÉ - 2-3 heures)
94+
95+
**Pour développeurs expérimentés seulement:**
96+
97+
#### Étape 1: Cloner CompreFace Original
98+
99+
```bash
100+
cd ~/Desktop/Projects
101+
git clone https://github.com/exadel-inc/CompreFace.git
102+
cd CompreFace
103+
```
104+
105+
#### Étape 2: Builder les Images ARM64
106+
107+
```bash
108+
# Modifier docker-compose pour build local
109+
nano docker-compose.yml
110+
111+
# Changer les images de:
112+
# image: exadel/compreface-core:1.2.0
113+
# À:
114+
# build:
115+
# context: ./embedding-calculator
116+
# dockerfile: Dockerfile
117+
# platforms:
118+
# - linux/arm64
119+
120+
# Builder
121+
docker-compose build --no-cache
122+
123+
# Cela prendra 1-2 heures sur M3 Max
124+
```
125+
126+
#### Étape 3: Tagger et Utiliser
127+
128+
```bash
129+
# Tagger les images buildées
130+
docker tag compreface-core:latest custom-compreface-core-arm64:1.2.0
131+
132+
# Dans votre projet 1BIP, modifier docker-compose.yml
133+
# image: exadel/compreface-core:1.2.0
134+
# → image: custom-compreface-core-arm64:1.2.0
135+
```
136+
137+
#### Limitations:
138+
⚠️ Très technique (Docker, Python, ML models)
139+
⚠️ Long (2-3 heures de build)
140+
⚠️ Non supporté officiellement
141+
⚠️ Peut nécessiter des modifications de code
142+
143+
---
144+
145+
## 🎯 RECOMMANDATION POUR 1BIP
146+
147+
Pour une **brigade militaire de 300-500 personnes**, voici ce que je recommande:
148+
149+
### Phase 1: Test sur M3 Max (Maintenant - 1 semaine)
150+
```bash
151+
# Tester l'interface sans reconnaissance
152+
docker-compose stop compreface-core
153+
open http://localhost:8000
154+
155+
# Objectifs:
156+
- ✅ Créer compte admin
157+
- ✅ Créer applications par unité
158+
- ✅ Tester l'interface dashboard
159+
- ✅ Valider le workflow
160+
- ✅ Former les administrateurs
161+
```
162+
163+
### Phase 2: Déploiement Production (Après validation)
164+
```
165+
Obtenir un serveur Linux/Intel dédié:
166+
- CPU: Intel Xeon ou AMD EPYC (16 cores)
167+
- RAM: 64 GB
168+
- SSD: 1 TB NVMe
169+
- OS: Ubuntu Server 22.04 LTS
170+
171+
Installer sur le serveur:
172+
1. Docker & Docker Compose
173+
2. Cloner votre repo 1BIP
174+
3. Configurer les caméras Hikvision
175+
4. Déployer: docker-compose up -d
176+
177+
Résultat: Système 100% fonctionnel pour 500+ utilisateurs
178+
```
179+
180+
### Phase 3: Scalabilité (Si besoin >1000 users)
181+
```
182+
Utiliser Kubernetes pour distribution de charge:
183+
- Multiple instances compreface-core (reconnaissance)
184+
- Load balancer pour API
185+
- Database replication
186+
```
187+
188+
---
189+
190+
## 🔧 QUICK FIX - Tester Maintenant sur M3 Max
191+
192+
```bash
193+
cd ~/Desktop/Projects/CompreFaceModeling
194+
195+
# 1. Arrêter le service problématique
196+
docker-compose stop compreface-core
197+
198+
# 2. Vérifier les autres services
199+
docker-compose ps
200+
201+
# 3. Ouvrir l'interface
202+
open http://localhost:8000
203+
204+
# 4. Si "Core node loading..." persiste:
205+
docker-compose restart compreface-ui
206+
sleep 30
207+
open http://localhost:8000
208+
209+
# 5. Créer votre compte admin
210+
# Email: admin@1bip.ma
211+
# Password: [votre mot de passe sécurisé]
212+
213+
# 6. Explorer le dashboard
214+
open http://localhost:5000
215+
```
216+
217+
---
218+
219+
## 📊 Comparaison des Options
220+
221+
| Critère | M3 Max (sans core) | M3 Max (build ARM64) | Serveur Linux |
222+
|---------|-------------------|----------------------|---------------|
223+
| **Temps setup** | 5 minutes | 2-3 heures | 30 minutes |
224+
| **Difficulté** | Facile | Très difficile | Facile |
225+
| **Performance** | N/A (pas de reco) | Moyenne | Excellente |
226+
| **Production ready** | ❌ Non | ⚠️ Risqué | ✅ Oui |
227+
| **Support officiel** | ❌ Non | ❌ Non | ✅ Oui |
228+
| **Coût** | Gratuit | Gratuit | ~$50-200/mois |
229+
| **Scalabilité** | N/A | Limitée | Excellente |
230+
231+
---
232+
233+
## 🇲🇦 Recommandation Finale pour 1BIP
234+
235+
**Pour une organisation militaire avec 300-500 personnes:**
236+
237+
1. **AUJOURD'HUI (M3 Max):**
238+
- Tester l'interface sans reconnaissance
239+
- Valider le workflow et l'UI
240+
- Former les administrateurs
241+
- Créer la structure organisationnelle
242+
243+
2. **SEMAINE PROCHAINE (Serveur Production):**
244+
- Déployer sur serveur Linux/Intel dédié
245+
- Configurer caméras Hikvision
246+
- Importer les photos du personnel
247+
- Tests complets avec reconnaissance
248+
249+
3. **PRODUCTION (Après validation):**
250+
- Mise en service officielle
251+
- Surveillance 24/7
252+
- Backups automatiques
253+
- Support technique
254+
255+
---
256+
257+
## 🚀 COMMENCEZ MAINTENANT
258+
259+
```bash
260+
# Arrêter le service bloqué
261+
docker-compose stop compreface-core
262+
263+
# Redémarrer l'interface
264+
docker-compose restart compreface-ui compreface-admin
265+
266+
# Attendre 30 secondes
267+
sleep 30
268+
269+
# Tester
270+
open http://localhost:8000
271+
272+
# Vous devriez voir la page de login!
273+
```
274+
275+
---
276+
277+
## 📞 Support
278+
279+
Pour déploiement sur serveur Linux ou questions:
280+
- Consultez: `DEPLOYMENT_GUIDE.md`
281+
- Vérifiez: `OFFLINE_OPERATION_GUIDE.md`
282+
283+
---
284+
285+
## 🇲🇦 1BIP - 1ère Brigade d'Infanterie Parachutiste
286+
### Forces Armées Royales Marocaines - Troupes Aéroportées
287+
288+
**CLASSIFIÉ - USAGE MILITAIRE UNIQUEMENT**
289+
290+
---
291+
292+
*Guide généré avec [Claude Code](https://claude.com/claude-code)*

‎docker-compose.override.yml‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# Docker Compose Override pour M3 Max ARM64
2+
# Ce fichier désactive compreface-core qui ne fonctionne pas avec émulation AMD64
3+
#
4+
# Les autres services fonctionnent:
5+
# - Interface UI CompreFace ✅
6+
# - Base de données ✅
7+
# - API Admin ✅
8+
# - Dashboard 1BIP ✅
9+
#
10+
# Limitation: La reconnaissance faciale ne fonctionnera pas
11+
# Solution permanente: Utiliser un serveur Linux/Intel ou builder en ARM64 natif
12+
13+
services:
14+
# Désactiver compreface-core (service bloqué sur ARM64)
15+
compreface-core:
16+
profiles:
17+
- disabled
18+
restart: "no"
19+
20+
# Modifier compreface-api pour ne pas dépendre de core
21+
compreface-api:
22+
environment:
23+
- SPRING_PROFILES_ACTIVE=dev
24+
- POSTGRES_USER=${postgres_username}
25+
- POSTGRES_PASSWORD=${postgres_password}
26+
- POSTGRES_URL=jdbc:postgresql://${postgres_domain}:${postgres_port}/${postgres_db}
27+
- API_JAVA_OPTS=${compreface_api_java_options}
28+
- SAVE_IMAGES_TO_DB=${save_images_to_db}
29+
- MAX_FILE_SIZE=${max_file_size}
30+
- MAX_REQUEST_SIZE=${max_request_size}B
31+
- CONNECTION_TIMEOUT=${connection_timeout:-10000}
32+
- READ_TIMEOUT=${read_timeout:-60000}
33+
# Désactiver l'attente de compreface-core
34+
- ML_API_URL=http://localhost:3000

0 commit comments

Comments
 (0)