Installation Self-Hosted
Guide complet pour déployer Lumyria sur votre infrastructure Azure ou Google Cloud Platform.
Avant de commencer
Lumyria nécessite un accès à BigQuery avec le dataset LumApps configuré. Assurez-vous d'avoir les permissions appropriées sur le projet GCP.
Prérequis infrastructure
🔵 Azure Cloud Platform
- Subscription Azure active
- Azure Container Instances
- Azure Database for PostgreSQL
- Azure Key Vault
🟡 Google Cloud Platform
- Projet GCP avec BigQuery activé
- Cloud Run pour le backend
- Firebase Hosting pour le frontend
- Secret Manager
Architecture recommandée
Composants techniques
Backend (Node.js)
- • Express + TypeScript
- • JWT Authentication
- • BigQuery SDK
- • Winston logging
Frontend (React)
- • React + Vite
- • Radix UI + Tailwind
- • React Query
- • Recharts
Infrastructure
- • Docker containers
- • Nginx reverse proxy
- • Prometheus monitoring
- • SSL/TLS terminaison
Déploiement avec Docker
1. Cloner le repository Lumyria
git clone https://github.com/lumyria/brand-dashboard.git
cd brand-dashboard
2. Configuration BigQuery
Configurez l'accès à votre dataset BigQuery LumApps :
# Copier la configuration exemple
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env
# Éditer la configuration
nano backend/.env
3. Authentification GCP
Configurez l'authentification Google Cloud pour BigQuery :
# Créer un service account GCP
gcloud iam service-accounts create lumyria-service
# Télécharger la clé JSON
gcloud iam service-accounts keys create key.json \
--iam-account=lumyria-service@PROJECT_ID.iam.gserviceaccount.com
# Placer la clé dans le projet
mv key.json backend/config/gcp-key.json
Configuration des variables
Backend (.env)
| Variable | Description | Exemple |
|---|---|---|
| BIGQUERY_PROJECT_ID | ID du projet GCP avec BigQuery | hm-prod-ms-data-001 |
| BIGQUERY_DATASET | Dataset principal LumApps | external |
| GOOGLE_APPLICATION_CREDENTIALS | Chemin vers la clé service account | ./config/gcp-key.json |
| JWT_SECRET | Clé secrète pour l'authentification JWT | your-super-secret-key-256-bits |
| PORT | Port d'écoute du serveur backend | 8080 |
| CORS_ORIGIN | URL autorisée pour CORS (frontend) | http://localhost:3000 |
Déploiement en production
Docker Compose
Utilisez le fichier docker-compose.production.yml pour un déploiement complet :
# Déploiement avec monitoring complet
docker-compose -f deployment/docker-compose.production.yml up -d
# Vérifier le statut des services
docker-compose ps
Services inclus
- • Backend API (Node.js)
- • Frontend React (Nginx)
- • Reverse Proxy (Nginx)
- • Monitoring (Prometheus + Grafana)
- • Logs (Loki + Promtail)
Vérification et accès
Déploiement réussi !
Une fois déployé, Lumyria sera accessible via les URLs suivantes :
• Application web : http://localhost:3000
• API Backend : http://localhost:8080/api
• Monitoring Grafana : http://localhost:3001
• Métriques Prometheus : http://localhost:9090
Tests de connectivité
# Tester l'API de santé
curl http://localhost:8080/api/health
# Tester la connexion BigQuery
curl http://localhost:8080/api/bigquery/test