Déploiements, aperçus et retours en arrière.
Comment vos push sont mis en ligne, les aperçus de branche, le retour à une version précédente, la commande de release pour les migrations, les paramètres de build, les hooks de déploiement, le mode maintenance et le mot de passe des aperçus.
Une fois une application en ligne, vous n'avez presque plus besoin du panel pour livrer vos changements : faites un push sur la branche et la nouvelle version est mise en ligne toute seule. Cet article couvre tout ce qui tourne autour : l'onglet Déploiements, les Aperçus, l'onglet Processus et quelques réglages dans Paramètres.
Déploiement automatique à chaque push
Chaque push sur la branche de l'application lance le build du dernier commit et le déploie. La nouvelle version démarre à côté de celle qui tourne et ne reçoit les visiteurs qu'une fois qu'elle répond ; si elle ne démarre pas, la version précédente continue de tourner et nous vous prévenons par e-mail (et par Telegram, si vous l'avez connecté).
Un push effectué alors qu'un autre build attend encore dans la file rejoint ce build : une rafale de push ne crée donc pas une longue file d'attente.
Vous pouvez désactiver ce comportement dans Paramètres → Déployer à chaque push. Une fois désactivé, vous déployez depuis le panel, l'API ou un hook de déploiement.
Déployer depuis le panel
L'onglet Déploiements liste tous les déploiements : ce qui les a déclenchés (un push, le panel, un retour en arrière, un hook de déploiement), le commit, la durée et le statut. Cliquez sur un déploiement pour voir son journal de build complet.
Redéployer propose deux choix :
- Construire le dernier commit : récupère le code le plus récent de la branche et lance son build.
- Redéployer la version en cours : applique les variables modifiées, sans nouveau build. À utiliser après avoir modifié les Variables.
Le menu à côté de Ouvrir propose les deux mêmes actions, plus Redémarrer.
Revenir en arrière
Vous pouvez revenir à n'importe laquelle des 5 dernières versions réussies. Dans l'onglet Déploiements, cliquez sur Revenir à cette version sur la version souhaitée, puis confirmez. La version précédente démarre à côté de la version actuelle et prend le relais dès qu'elle répond, sans nouveau build.
Un retour en arrière n'annule pas les modifications de la base de données. Si une version a modifié la structure de la base, restaurez aussi la base : voir Bases de données.
Aperçus des branches
Un push sur n'importe quelle autre branche obtient son propre aperçu : une adresse distincte où vérifier les changements avant leur mise en ligne. Retrouvez-les dans l'onglet Aperçus.
- Jusqu'à 3 aperçus simultanés, inclus dans votre prix.
- Un aperçu sans nouveau push pendant 7 jours est supprimé. Il est recréé au prochain push sur cette branche.
- Les aperçus ne reçoivent que les variables qui leur sont destinées : voir Variables d'environnement.
- Les aperçus sont créés pour le service principal d'un projet, pas pour ses autres services.
Un mot de passe pour les aperçus
Dans l'onglet Aperçus, Mot de passe des aperçus → Demander un mot de passe. Saisissez un nom d'utilisateur et un mot de passe (8 caractères minimum). Dès lors, seules les personnes qui ont le mot de passe peuvent ouvrir les aperçus ; l'application elle-même reste ouverte à tous.
La commande de release (migrations)
Onglet Processus → Commande de release. Elle s'exécute une fois à chaque déploiement, avant que la nouvelle version ne reçoive les visiteurs : en général, les migrations de base de données. Si elle échoue, le déploiement s'arrête et la version actuelle continue de tourner : une migration défaillante n'atteint jamais vos visiteurs.
Nous proposons une commande pour les frameworks qui en ont une :
| Framework | Commande de release recommandée |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Utiliser la commande recommandée la conserve ; vous pouvez aussi saisir la vôtre ou choisir Aucune. Les changements s'appliquent à partir du prochain déploiement.
Paramètres de build
Paramètres → Paramètres de build vous permet de modifier ce que nous avons détecté :
- Commande d'installation : par exemple
npm ci - Commande de build : par exemple
npm run build - Commande de démarrage : la commande qui lance votre application. Elle doit écouter sur le port indiqué dans
$PORT. - Dossier de sortie : pour les sites statiques, le dossier contenant les fichiers générés.
- Dossier du projet : pour un dépôt qui contient plusieurs projets.
Laissez un champ vide pour utiliser ce que nous avons détecté. Le prochain déploiement est construit avec les nouveaux paramètres ; Lancer le build le démarre tout de suite.
Paramètres contient aussi la Branche déployée.
Hooks de déploiement
Paramètres → Hooks de déploiement → Créer un hook. Un hook de déploiement est une adresse privée : quand un autre service lui envoie une requête POST, le dernier commit de votre branche est construit et déployé. Usage typique : un CMS qui reconstruit le site après chaque publication.
curl -X POST "<the hook address from the panel>"- L'adresse n'est affichée qu'une fois : copiez-la à la création du hook. Toute personne qui la possède peut lancer un déploiement, gardez-la donc privée.
- Jusqu'à 10 déploiements par heure et par hook. Un appel qui arrive alors qu'un build attend encore le rejoint.
- Révoquer désactive l'adresse immédiatement ; les services qui l'appellent ont alors besoin d'une nouvelle adresse.
Mode maintenance
Paramètres → Mode maintenance → Afficher la page de maintenance. Les visiteurs voient une courte page avec votre message à la place de l'application ; laissez le message vide pour afficher « Nous apportons quelques améliorations. Merci de revenir dans un petit moment. »
L'application continue de tourner : vous pouvez donc tout vérifier avant de la rouvrir. Un lien privé pour vous affiche l'application normalement sur l'appareil qui l'ouvre, pendant 12 heures. Nouveau lien en crée un autre ; l'ancien cesse de fonctionner.
Désactivez l'interrupteur pour rouvrir l'application aux visiteurs.
Notifications de déploiement
Nous vous envoyons un e-mail (et un message Telegram, si vous l'avez connecté) quand un déploiement n'aboutit pas. Pour envoyer aussi les événements à votre équipe (nouvelle version en ligne, déploiement non abouti, service arrêté ou revenu, forte utilisation de la mémoire ou du processeur, sauvegarde, disque d'une base de données), ajoutez Slack, Discord ou votre propre webhook dans Paramètres → Notifications pour votre équipe. Les messages webhook sont en JSON, signés avec un secret affiché une seule fois, dans l'en-tête X-Rivervo-Signature.