PyNextcloud/COOLIFY.md
2025-10-20 17:40:56 +02:00

84 lines
2.0 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
APP_HOST=0.0.0.0
APP_PORT=8000
```
### 2. Configuration du projet
- **Build Pack** : Dockerfile
- **Port** : 8000
- **Health Check Path** : `/health`
- **Health Check Interval** : 30s
### 3. Déploiement automatique
Coolify détectera automatiquement :
-`Dockerfile` pour construire l'image
-`docker-compose.yml` pour la configuration
- ✅ Health check configuré
### 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