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**
|
||||
|
||||
[](https://quarkus.io/)
|
||||
[](https://openjdk.org/)
|
||||
[](https://quarkus.io/)
|
||||
[](https://openjdk.org/)
|
||||
[](https://www.postgresql.org/)
|
||||
[](../LICENSE)
|
||||
|
||||
@@ -44,9 +44,10 @@ BTPXpress Backend est une **API REST complète** construite avec **Quarkus** pou
|
||||
## 🛠️ Technologies
|
||||
|
||||
### **Framework & Runtime**
|
||||
- **Quarkus 3.15.1** - Framework Java supersonic subatomic
|
||||
- **Java 17 LTS** - Langage de programmation
|
||||
- **Quarkus 3.27.3 LTS** - Framework Java supersonic subatomic
|
||||
- **Java 21 LTS** - Langage de programmation
|
||||
- **Maven 3.9.6** - Gestion des dépendances
|
||||
- **Packaging** : `quarkus.package.type=uber-jar` (voir `src/main/resources/application.properties`)
|
||||
|
||||
### **Persistance**
|
||||
- **Hibernate ORM Panache** - ORM simplifié
|
||||
@@ -119,7 +120,7 @@ btpxpress-server/
|
||||
|
||||
### **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/))
|
||||
- ✅ **PostgreSQL 15** (production) ou H2 (dev)
|
||||
- ✅ **Keycloak** (pour l'authentification)
|
||||
@@ -127,7 +128,7 @@ btpxpress-server/
|
||||
### **Vérifier les prérequis**
|
||||
|
||||
```bash
|
||||
java -version # Doit afficher Java 17+
|
||||
java -version # Doit afficher Java 21+
|
||||
mvn -version # Doit afficher Maven 3.9+
|
||||
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
|
||||
|
||||
**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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user