docs: Quarkus 3.15.1→3.27.3 LTS, Java 17→21, section Déploiement lionsctl pipeline (repo btpxpress-backend, uber-jar, probes longues)
Some checks failed
CI/CD Pipeline / pipeline (push) Failing after 4m53s
Some checks failed
CI/CD Pipeline / pipeline (push) Failing after 4m53s
This commit is contained in:
40
README.md
40
README.md
@@ -2,8 +2,8 @@
|
|||||||
|
|
||||||
**Backend REST API pour la gestion complète d'entreprises BTP**
|
**Backend REST API pour la gestion complète d'entreprises BTP**
|
||||||
|
|
||||||
[](https://quarkus.io/)
|
[](https://quarkus.io/)
|
||||||
[](https://openjdk.org/)
|
[](https://openjdk.org/)
|
||||||
[](https://www.postgresql.org/)
|
[](https://www.postgresql.org/)
|
||||||
[](../LICENSE)
|
[](../LICENSE)
|
||||||
|
|
||||||
@@ -44,9 +44,10 @@ BTPXpress Backend est une **API REST complète** construite avec **Quarkus** pou
|
|||||||
## 🛠️ Technologies
|
## 🛠️ Technologies
|
||||||
|
|
||||||
### **Framework & Runtime**
|
### **Framework & Runtime**
|
||||||
- **Quarkus 3.15.1** - Framework Java supersonic subatomic
|
- **Quarkus 3.27.3 LTS** - Framework Java supersonic subatomic
|
||||||
- **Java 17 LTS** - Langage de programmation
|
- **Java 21 LTS** - Langage de programmation
|
||||||
- **Maven 3.9.6** - Gestion des dépendances
|
- **Maven 3.9.6** - Gestion des dépendances
|
||||||
|
- **Packaging** : `quarkus.package.type=uber-jar` (voir `src/main/resources/application.properties`)
|
||||||
|
|
||||||
### **Persistance**
|
### **Persistance**
|
||||||
- **Hibernate ORM Panache** - ORM simplifié
|
- **Hibernate ORM Panache** - ORM simplifié
|
||||||
@@ -119,7 +120,7 @@ btpxpress-server/
|
|||||||
|
|
||||||
### **Prérequis**
|
### **Prérequis**
|
||||||
|
|
||||||
- ✅ **Java 17** ou supérieur ([OpenJDK](https://openjdk.org/))
|
- ✅ **Java 21** ou supérieur ([OpenJDK](https://openjdk.org/))
|
||||||
- ✅ **Maven 3.9+** ([Apache Maven](https://maven.apache.org/))
|
- ✅ **Maven 3.9+** ([Apache Maven](https://maven.apache.org/))
|
||||||
- ✅ **PostgreSQL 15** (production) ou H2 (dev)
|
- ✅ **PostgreSQL 15** (production) ou H2 (dev)
|
||||||
- ✅ **Keycloak** (pour l'authentification)
|
- ✅ **Keycloak** (pour l'authentification)
|
||||||
@@ -127,7 +128,7 @@ btpxpress-server/
|
|||||||
### **Vérifier les prérequis**
|
### **Vérifier les prérequis**
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
java -version # Doit afficher Java 17+
|
java -version # Doit afficher Java 21+
|
||||||
mvn -version # Doit afficher Maven 3.9+
|
mvn -version # Doit afficher Maven 3.9+
|
||||||
psql --version # Doit afficher PostgreSQL 15+
|
psql --version # Doit afficher PostgreSQL 15+
|
||||||
```
|
```
|
||||||
@@ -341,6 +342,31 @@ MIT License - Voir [LICENSE](../LICENSE)
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## 🚀 Déploiement (lionsctl)
|
||||||
|
|
||||||
|
Le repo Gitea est publié sous le nom **`btpxpress-backend`** (pas `btpxpress-server`).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
lionsctl pipeline \
|
||||||
|
-u https://git.lions.dev/lionsdev/btpxpress-backend \
|
||||||
|
-b main -j 21 -e production -c k1 -p prod
|
||||||
|
```
|
||||||
|
|
||||||
|
**Pipeline** : clone → `mvn package -P prod` → `docker build -f Dockerfile` → push `registry.lions.dev` → `kubectl apply` → health check
|
||||||
|
|
||||||
|
**URL prod** : `https://api.lions.dev/btpxpress`
|
||||||
|
|
||||||
|
**Pré-requis infrastructure** (migration Helm → lionsctl) :
|
||||||
|
- `Dockerfile` racine (uber-jar : `FROM ubi8/openjdk-21:1.21` + `COPY target/*-runner.jar`, UID 1001)
|
||||||
|
- `.dockerignore` : `target/*` + `!target/*-runner.jar`
|
||||||
|
- Secret K8s `btpxpress-server-db-secret` (créé depuis `lions-shared-db-secret` : user `lionsuser`, DB `btpxpress` owned by `lionsuser`)
|
||||||
|
- `QUARKUS_DATASOURCE_JDBC_URL=jdbc:postgresql://postgresql-service.postgresql.svc.cluster.local:5432/btpxpress` override
|
||||||
|
- Probes longues : `initialDelaySeconds=120`, `failureThreshold=6` (startup ~82s)
|
||||||
|
- Deployment Helm existant supprimé au préalable (selector immutable)
|
||||||
|
- Service selector à repatcher après pipeline (retirer labels `app.kubernetes.io/*`)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## 👥 Auteurs
|
## 👥 Auteurs
|
||||||
|
|
||||||
**BTPXpress Team**
|
**BTPXpress Team**
|
||||||
@@ -356,6 +382,6 @@ MIT License - Voir [LICENSE](../LICENSE)
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Dernière mise à jour**: 2025-09-30
|
**Dernière mise à jour**: 2026-04-24 (Quarkus 3.27.3 LTS + lionsctl pipeline migration)
|
||||||
**Version**: 1.0.0
|
**Version**: 1.0.0
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user