Plateformes de déploiement en un clic¶
Déployez Silex en un seul clic sur des plateformes d'hébergement gérées.
Aperçu¶
CapRover fournit une interface de déploiement simplifiée, gérant le SSL, les mises à jour et les sauvegardes via un tableau de bord web. Le support d'autres plateformes est sur la roadmap.
CapRover¶
CapRover est une plateforme orientée développeurs pour auto-héberger des applications Docker sur votre propre serveur.
Prérequis¶
- Instance CapRover en cours d'exécution (voir la documentation CapRover)
Installation depuis les One-Click Apps CapRover¶
Silex est disponible en tant qu'application one-click dans le dépôt officiel CapRover One Click Apps.
- Ouvrez votre tableau de bord CapRover à
https://captain.your-domain.com - Allez dans Apps → Create an app → One-Click Apps
- Recherchez silex — sélectionnez silex-platform
- Choisissez une version (voir les tags Docker Hub pour les versions disponibles)
- Remplissez les champs de configuration (voir ci-dessous)
- Cliquez sur Deploy
C'est tout — CapRover récupère l'image Docker, configure l'application et met en place le SSL automatiquement.
Champs de configuration CapRover¶
Le formulaire one-click app demande :
| Champ | Valeurs | Description |
|---|---|---|
STORAGE_CONNECTOR |
gitlab, ftp, gitlab2 (séparés par des virgules, sans espaces) |
Où les utilisateurs stockent leurs sites |
HOSTING_CONNECTOR |
gitlab, ftp, gitlab2, download (séparés par des virgules, sans espaces) |
Où les sites sont publiés |
GITLAB_CLIENT_ID |
Votre ID d'app OAuth | Pour l'instance GitLab principale (voir la doc OAuth GitLab) |
GITLAB_CLIENT_SECRET |
Votre secret d'app OAuth | Pour l'instance GitLab principale |
GITLAB2_DOMAIN |
ex. https://framagit.org |
Domaine d'une seconde instance GitLab (optionnel) |
GITLAB2_CLIENT_ID |
Votre ID d'app OAuth | Pour la seconde instance GitLab (optionnel) |
GITLAB2_CLIENT_SECRET |
Votre secret d'app OAuth | Pour la seconde instance GitLab (optionnel) |
Vous pouvez connecter jusqu'à deux instances GitLab — par exemple gitlab.com en principal et un GitLab auto-hébergé ou Framagit en secondaire.
Après le déploiement¶
Dans le tableau de bord CapRover vous pouvez :
- Consulter les journaux
- Modifier les variables d'environnement
- Configurer le SSL (CapRover gère automatiquement Let's Encrypt)
- Configurer les volumes persistants pour le stockage
Stack complète auto-hébergée sur CapRover¶
Vous pouvez tout héberger sur CapRover — tout est disponible en one-click app :
- Silex pour le design visuel de sites web
- GitLab pour le stockage et la publication
- WordPress (ou un autre CMS) comme source de données pour le contenu dynamique
Cela vous donne une stack de publication web entièrement auto-hébergée sur votre propre serveur. Connectez-les en configurant les variables d'environnement ci-dessus — pointez GITLAB_CLIENT_ID et GITLAB_CLIENT_SECRET vers votre instance GitLab auto-hébergée, et configurez WordPress comme source de données CMS.
Consultez Connecteurs de stockage pour les détails de la configuration OAuth.
YunoHost (bientôt disponible)¶
YunoHost est une distribution qui simplifie la gestion de serveur. Le support YunoHost pour Silex est prévu mais pas encore disponible — votez sur la roadmap.
Autres plateformes¶
Le support d'autres plateformes de déploiement en un clic (Dokku, Coolify, Sandstorm, etc.) est en discussion sur la roadmap. Votez et commentez pour aider à prioriser.
Référence des variables d'environnement¶
Toutes les plateformes requièrent ces variables :
| Variable | Exemple | Rôle |
|---|---|---|
SILEX_SESSION_SECRET |
(32+ caractères aléatoires) | Clé de chiffrement de session ; générez-en une nouvelle pour chaque déploiement |
SILEX_URL |
https://silex.example.com | URL publique visitée par les utilisateurs |
SILEX_PORT |
6805 | Port interne |
STORAGE_CONNECTOR |
gitlab | Backend de stockage : gitlab, ftp, gitlab2 (séparés par des virgules, sans espaces) |
HOSTING_CONNECTOR |
gitlab,download | Backend de publication : gitlab, ftp, gitlab2, download (séparés par des virgules, sans espaces) |
Générer SILEX_SESSION_SECRET¶
Utilisez une clé aléatoire forte :
Exemple d'intégration GitLab¶
Pour activer le stockage et la publication via GitLab :
STORAGE_CONNECTOR=gitlab
HOSTING_CONNECTOR=gitlab,download
GITLAB_CLIENT_ID=your-oauth-app-id
GITLAB_CLIENT_SECRET=your-oauth-app-secret
Consultez Connecteurs de stockage pour la configuration OAuth.
Persistance des données¶
Les deux plateformes prennent en charge les volumes persistants pour :
- /silex/storage — Données et ressources des sites web
- /silex/hosting — Sites publiés
Les données persistent entre les redémarrages et les mises à jour de l'application. Effectuez des sauvegardes régulières via le tableau de bord de la plateforme.
SSL/HTTPS¶
Les deux plateformes provisionnent et renouvellent automatiquement les certificats SSL via Let's Encrypt. Votre instance Silex est sécurisée dès l'installation.
Définissez SILEX_URL avec votre domaine HTTPS :
Dépannage¶
L'application ne démarre pas¶
Consultez les journaux dans le tableau de bord de la plateforme : - CapRover : Page de détail de l'application → Logs
Problèmes courants :
- SILEX_SESSION_SECRET manquant ou trop court
- Port déjà utilisé (choisissez un port différent)
- Permissions des volumes de stockage (la plateforme gère généralement cela)
Impossible d'envoyer des fichiers volumineux¶
Augmentez les limites Express dans les variables d'environnement :
Problèmes de certificat SSL¶
Toutes les plateformes renouvellent automatiquement les certificats. Si le renouvellement échoue : - Assurez-vous que le DNS de votre domaine pointe vers le serveur - Vérifiez les journaux de la plateforme pour les erreurs de validation DNS - Le renouvellement manuel varie selon la plateforme ; consultez la documentation de la plateforme
Voir aussi¶
- Installation avec Docker Compose
- Exécution depuis Node.js
- Configuration du serveur — API de configuration serveur