85 lines
2.2 KiB
Markdown
85 lines
2.2 KiB
Markdown
# 🚀 Guide de déploiement Coolify
|
|
|
|
## Configuration rapide
|
|
|
|
### 1. Variables d'environnement requises
|
|
|
|
Dans Coolify, ajoutez ces variables d'environnement :
|
|
|
|
```env
|
|
NEXTCLOUD_URL=https://votre-serveur-nextcloud.com
|
|
NEXTCLOUD_USERNAME=votre_username
|
|
NEXTCLOUD_PASSWORD=votre_password
|
|
```
|
|
|
|
### 2. Configuration du projet
|
|
|
|
- **Build Pack** : Dockerfile (ou Docker Compose)
|
|
- **Port** : 8000 (port interne exposé)
|
|
- **Health Check Path** : `/health`
|
|
- **Health Check Interval** : 30s
|
|
|
|
**Important :** Ne configurez PAS de port externe manuellement. Coolify gère automatiquement les ports via Traefik.
|
|
|
|
### 3. Déploiement automatique
|
|
|
|
Coolify détectera automatiquement :
|
|
- ✅ `Dockerfile` pour construire l'image
|
|
- ✅ `docker-compose.yml` pour la configuration
|
|
- ✅ Health check configuré
|
|
- ✅ Port 8000 exposé (sans binding externe)
|
|
|
|
### 4. Branches et CI/CD
|
|
|
|
- **Branche principale** : `main` ou `master`
|
|
- **Auto-deploy** : Activez le déploiement automatique sur push
|
|
- **Build automatique** : Coolify construira l'image à chaque push
|
|
|
|
### 5. Vérification du déploiement
|
|
|
|
Après le déploiement, testez ces endpoints :
|
|
|
|
```bash
|
|
# Health check
|
|
curl https://votre-domaine.com/health
|
|
|
|
# Documentation
|
|
https://votre-domaine.com/docs
|
|
|
|
# Liste des routes
|
|
curl https://votre-domaine.com/debug/routes
|
|
```
|
|
|
|
### 6. Logs et monitoring
|
|
|
|
```bash
|
|
# Dans Coolify, accédez aux logs via l'interface
|
|
# Ou utilisez la commande Docker :
|
|
docker logs -f <container_name>
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### Le conteneur ne démarre pas
|
|
- Vérifiez que toutes les variables d'environnement sont définies
|
|
- Consultez les logs du build dans Coolify
|
|
- Vérifiez que le port 8000 n'est pas déjà utilisé
|
|
|
|
### Health check échoue
|
|
- Attendez 40 secondes (start_period) après le démarrage
|
|
- Vérifiez que l'endpoint `/health` répond
|
|
- Consultez les logs de l'application
|
|
|
|
### Erreurs de connexion Nextcloud
|
|
- Vérifiez l'URL de votre serveur Nextcloud
|
|
- Testez les identifiants manuellement
|
|
- Assurez-vous que le serveur Nextcloud est accessible depuis le conteneur
|
|
|
|
## Support
|
|
|
|
Pour toute question, consultez :
|
|
- [Documentation Coolify](https://coolify.io/docs)
|
|
- Les logs de l'application dans Coolify
|
|
- L'endpoint `/debug/routes` pour vérifier les routes disponibles
|
|
|