docs: Ajout documentation et scripts de démarrage
- Documentation configuration OIDC, démarrage, diagnostic - Scripts batch pour démarrage backend et client - Script shell pour configuration Keycloak frontend
This commit is contained in:
85
DEMARRAGE_BACKEND.md
Normal file
85
DEMARRAGE_BACKEND.md
Normal file
@@ -0,0 +1,85 @@
|
||||
# Démarrage du Backend - Lions User Manager
|
||||
|
||||
## Problème: Backend bloqué au démarrage
|
||||
|
||||
Le backend démarre mais reste bloqué sur "No tests found".
|
||||
|
||||
### Solution 1: Appuyer sur 'r'
|
||||
|
||||
Dans le terminal où le backend tourne, appuyez sur **`r`** (re-run) pour continuer le démarrage.
|
||||
|
||||
### Solution 2: Redémarrer proprement
|
||||
|
||||
Si la solution 1 ne fonctionne pas:
|
||||
|
||||
1. **Arrêter le backend** : Ctrl+C dans le terminal
|
||||
2. **Redémarrer** :
|
||||
```bash
|
||||
cd C:\Users\dadyo\PersonalProjects\lions-workspace\lions-user-manager\lions-user-manager-server-impl-quarkus
|
||||
mvn clean quarkus:dev
|
||||
```
|
||||
|
||||
### Solution 3: Utiliser le profile dev explicitement
|
||||
|
||||
```bash
|
||||
cd C:\Users\dadyo\PersonalProjects\lions-workspace\lions-user-manager\lions-user-manager-server-impl-quarkus
|
||||
mvn clean quarkus:dev -Dquarkus.profile=dev
|
||||
```
|
||||
|
||||
### Solution 4: Désactiver les tests au démarrage
|
||||
|
||||
```bash
|
||||
cd C:\Users\dadyo\PersonalProjects\lions-workspace\lions-user-manager\lions-user-manager-server-impl-quarkus
|
||||
mvn clean quarkus:dev -DskipTests
|
||||
```
|
||||
|
||||
## Vérification du démarrage réussi
|
||||
|
||||
Une fois le backend démarré, vous devriez voir:
|
||||
|
||||
```
|
||||
__ ____ __ _____ ___ __ ____ ______
|
||||
--/ __ \/ / / / _ | / _ \/ //_/ / / / __/
|
||||
-/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \
|
||||
--\___\_\____/_/ |_/_/|_/_/|_|\____/___/
|
||||
...
|
||||
INFO [io.quarkus] (Quarkus Main Thread) lions-user-manager-server-impl-quarkus 1.0.0 on JVM (powered by Quarkus x.x.x) started in Xs.
|
||||
INFO [io.quarkus] (Quarkus Main Thread) Profile dev activated. Live Coding activated.
|
||||
INFO [io.quarkus] (Quarkus Main Thread) Installed features: [cdi, hibernate-validator, micrometer, oidc, rest, rest-client-jackson, rest-jackson, security, smallrye-context-propagation, smallrye-fault-tolerance, smallrye-health, smallrye-openapi, swagger-ui, vertx]
|
||||
```
|
||||
|
||||
## Vérifier que le backend est accessible
|
||||
|
||||
```bash
|
||||
# Health check
|
||||
curl http://localhost:8081/q/health
|
||||
|
||||
# Swagger UI (dans le navigateur)
|
||||
http://localhost:8081/q/swagger-ui
|
||||
|
||||
# Dev UI (dans le navigateur)
|
||||
http://localhost:8081/q/dev
|
||||
```
|
||||
|
||||
## Si le port 8081 est déjà utilisé
|
||||
|
||||
```bash
|
||||
# Trouver le processus qui utilise le port 8081
|
||||
netstat -ano | findstr :8081
|
||||
|
||||
# Tuer le processus (remplacer PID par le numéro affiché)
|
||||
taskkill /PID <PID> /F
|
||||
```
|
||||
|
||||
## Ordre de démarrage recommandé
|
||||
|
||||
1. **Keycloak** (port 8180) - doit tourner en premier
|
||||
2. **Backend** (port 8081) - ensuite
|
||||
3. **Frontend** (port 8080) - en dernier
|
||||
|
||||
## Logs à surveiller
|
||||
|
||||
Si le backend ne démarre pas, vérifiez:
|
||||
- Warnings Hibernate ORM (normaux si pas de base de données)
|
||||
- Erreurs de connexion Keycloak (vérifier que Keycloak tourne sur 8180)
|
||||
- Erreurs de port déjà utilisé
|
||||
Reference in New Issue
Block a user