Services
Voici ce que cette page couvre : le déploiement et la gestion des services conteneurisés, y compris les Rediaccfiles, le réseau de services, le démarrage/arrêt, les opérations en masse et le démarrage automatique.
Le Rediaccfile
Le Rediaccfile est un script Bash qui définit comment vos services sont démarrés et arrêtés. Il est sourcé (non exécuté comme un processus séparé), de sorte que ses fonctions partagent le même contexte de shell et ont accès à toutes les variables d’environnement exportées. Il doit être nommé Rediaccfile ou rediaccfile (insensible à la casse) et placé à l’intérieur du système de fichiers monté du dépôt.
Les Rediaccfiles sont découverts à deux emplacements :
- La racine du chemin de montage du dépôt
- Les sous-répertoires de premier niveau du chemin de montage (non récursif)
Les répertoires cachés (noms commençant par .) sont ignorés.
Fonctions du cycle de vie
renet exécute ces fonctions du Rediaccfile :
| Fonction | Quand elle s’exécute | Objectif | Comportement en cas d’erreur |
|---|---|---|---|
up() | Au démarrage | Démarrer les services (par ex., renet compose -- up -d) | L’échec du Rediaccfile racine est critique (arrête tout). Les échecs des sous-répertoires sont non critiques (journalisés, passage au suivant) |
down() | Lors de l’arrêt | Arrêter les services (par ex., renet compose -- down) | Au mieux — les échecs sont journalisés mais tous les Rediaccfiles sont toujours exécutés |
health() | Avec rdc repo health, avec rdc machine health et dans le contrôle de santé du déploiement | Signaler l’état propre du dépôt : code de sortie 0 ok, 1 avertissement, 2 erreur | Le health() de chaque Rediaccfile s’exécute et le niveau le plus grave compte. Le code 75 signifie que le dépôt est encore en chauffe (un avertissement). Tout autre code, un signal ou un dépassement de délai est une erreur (le contrôle de santé du déploiement lit un dépassement de délai comme « encore en chauffe » et réessaie, voir Délais et ordre d’arrêt). Un dépôt dont aucun Rediaccfile ne définit health() signale aucun contrôle, jamais « sain » |
repair() | Avec rdc repo repair, et avec rdc machine repair pour un dépôt dont le health() n’est pas ok | Corriger ce que le health() du même fichier a signalé | S’exécute uniquement si le health() de son fichier n’est pas ok et que la classe déclarée est autorisée (voir ci-dessous). Un health() qui sort avec le code 75 (encore en chauffe) compte comme un avertissement : un repair() doit donc laisser tranquille un dépôt qui démarre encore. health() s’exécute ensuite de nouveau. Un repair() qui échoue ou dépasse son délai est une erreur |
Chaque fonction est facultative. Si une fonction n’est pas définie, elle est silencieusement ignorée.
Déclarer une classe de réparation
repair() reçoit REDIACC_HEALTH_LEVEL (warning ou error, le niveau signalé par le health() de son propre fichier) et REDIACC_HEALTH_OUTPUT (la fin de la sortie de ce health()). Une ligne de commentaire déclare le degré de sécurité de la fonction :
# rediacc:repair class=auto-safe
# rediacc:repair class=auto-with-backup window=only
| Classe | Qui l’exécute |
|---|---|
auto-safe | rdc machine repair et rdc repo repair l’exécutent d’eux-mêmes |
auto-with-backup | S’exécute uniquement avec --with-backup, après un instantané réussi du dépôt |
operator-only | Ne s’exécute jamais d’elle-même. rdc repo repair demande d’abord confirmation (ou accepte --yes) ; rdc machine repair ne l’exécute jamais |
Un repair() sans déclaration est operator-only : aucun outil n’exécute donc le code d’un dépôt sans surveillance, sauf si le dépôt indique qu’il est sûr. window=only ajoute une seconde condition : la fonction s’exécute uniquement dans la fenêtre de maintenance de la machine (Supervision), ou avec --window-override. Quand plusieurs lignes déclarent une classe, la plus restrictive l’emporte.
Ordre d’exécution
- Démarrage (
up) : Rediaccfile racine en premier, puis les sous-répertoires en ordre alphabétique (A à Z). - Arrêt (
down) : Sous-répertoires en ordre alphabétique inverse (Z à A), puis la racine en dernier.
Variables d’environnement
Lorsqu’une fonction du Rediaccfile s’exécute, les variables d’environnement suivantes sont disponibles :
| Variable | Description | Exemple |
|---|---|---|
REDIACC_WORKING_DIR | Chemin de montage du dépôt | /mnt/rediacc/mounts/abc123 |
REDIACC_REPOSITORY | GUID du dépôt | a1b2c3d4-e5f6-... |
REDIACC_NETWORK_ID | ID réseau (entier) | 2816 |
DOCKER_HOST | Socket Docker pour le démon isolé de ce dépôt | unix:///var/run/rediacc/net-2816/docker-2816.sock |
{SERVICE}_IP | IP de bouclage pour chaque service défini dans .rediacc.json | POSTGRES_IP=127.0.11.2 |
Les variables {SERVICE}_IP sont auto-générées à partir des mappages de slots dans .rediacc.json et exportées avant l’exécution de vos fonctions Rediaccfile. La convention de nommage convertit le nom du service en majuscules avec les tirets remplacés par des underscores, puis ajoute _IP. Par exemple, un service nommé listmonk-app avec le slot 0 devient LISTMONK_APP_IP=127.0.11.2.
Attention : N’utilisez pas
sudo dockerdans les Rediaccfiles. La commandesudoréinitialise les variables d’environnement, ce qui signifie queDOCKER_HOSTest perdu et les commandes Docker cibleront le démon système au lieu du démon isolé du dépôt. Cela casse l’isolation des conteneurs et peut causer des conflits de ports. Rediacc bloquera l’exécution s’il détectesudo docker.Utilisez
renet composedans vos Rediaccfiles, il gère automatiquementDOCKER_HOST, injecte les labels réseau pour la découverte des routes et configure le réseau des services. Consultez Réseau pour les détails sur l’exposition des services via le proxy inverse. Si vous appelez Docker directement, utilisezdockersanssudo: les fonctions du Rediaccfile atteignent le démon Docker du dépôt en tant qu’utilisateur universel, sans root (voir Privilèges).
renetest l’outil distant de bas niveau. Pour les workflows normaux des utilisateurs depuis votre workstation, préférez les commandesrdctelles querdc repo upetrdc repo down. Consultez rdc vs renet.
Privilèges
up() et down() s’exécutent en tant qu’utilisateur universel (rediacc), et non en root, dans un sandbox qui limite les endroits où elles peuvent lire et écrire. L’environnement est construit pour la fonction plutôt qu’hérité : il contient donc les variables ci-dessus, les valeurs REDIACC_SECRET_* du dépôt et un PATH minimal. sudo n’est disponible à aucun niveau : le sandbox active no_new_privs, de sorte qu’une ligne de Rediaccfile qui utilise sudo échoue et doit s’en passer. Une machine sans Landlock refuse up() et down() au lieu de les exécuter sans confinement.
Une ligne qui a besoin de plus que le niveau par défaut échoue avec l’erreur que lui donne le sandbox, et le journal et la CLI affichent la ligne correspondante du Rediaccfile avec la commande d’autorisation.
| Un Rediaccfile fait | Il voit | Correction |
|---|---|---|
sudo x | sudo: The "no new privileges" flag is set | Retirer sudo. L’étape n’a pas besoin de root ou nécessite une autorisation |
chown 5050 ... ou rm -rf sur un répertoire appartenant à un conteneur | Operation not permitted / Permission denied | Exécuter l’étape dans un conteneur à usage unique (root dans le conteneur ; le démon Docker du dépôt refuse les montages en dehors des racines propres au dépôt) : renet compose -- run --rm --no-deps --user 0 --entrypoint chown <service> -R 5050:5050 /data |
Écrit .env ou d’autres fichiers dans le montage | Fonctionne ; les fichiers appartiennent à l’utilisateur universel | Aucune |
Lit /etc/rediacc/*, /proc/kcore ou un périphérique bloc | Permission denied | Demander une autorisation de chemin |
| Lit directement un secret de type fichier | Permission denied | Utiliser secrets: de compose ou un secret en mode env |
nvidia-smi sans autorisation de périphérique | Le périphérique est absent | Accorder le périphérique, voir GPU |
sysctl -w | Permission denied | Le définir une fois sur la machine, en tant qu’administrateur |
Demander une autorisation
Une autorisation étend ce que up() et down() peuvent atteindre. Seul un opérateur l’accorde, depuis l’extérieur du dépôt :
rdc repo permission grant <repo-ref> --path /srv/data:rw
rdc repo permission grant <repo-ref> --root
rdc repo permission show <repo-ref>
rdc repo permission revoke <repo-ref> --path /srv/data
--path ajoute une règle Landlock, en lecture seule sauf si :rw est indiqué, et la machine refuse un chemin qui atteint un autre dépôt, le datastore ou /etc/rediacc. --root exécute les fonctions en root sans abandon de privilèges, et une sauvegarde à froid refuse un tel dépôt. Les agents ne peuvent pas accorder --root, sauf si l’opérateur a défini REDIACC_ALLOW_GRAND_REPO avant le démarrage de l’agent. Un fork a un nouvel identifiant réseau et démarre sans autorisation, et une autorisation trouvée sous un identifiant réseau réutilisé est écartée.
Un Rediaccfile peut déclarer ce dont il a besoin par une ligne de commentaire, à titre de simple demande :
# rediacc:needs root
# rediacc:needs path=/srv/data
# rediacc:needs device=nvidia.com/gpu=all
up() compare la déclaration à l’autorisation. Quand l’autorisation manque, up() est refusé avant l’exécution de toute ligne, et le message affiche la commande d’autorisation exacte. down() ne vérifie jamais la déclaration, afin qu’un commentaire modifié dans le dépôt ne puisse pas empêcher le repo down d’un opérateur ; un down() qui a réellement besoin de l’autorisation échoue dans sa propre étape. machine converge ignore un tel dépôt avec le statut needs_lifecycle_grant au lieu de le redémarrer vers le refus.
Délais et ordre d’arrêt
Les conteneurs d’un dépôt ne s’arrêtent qu’une fois son down() exécuté et terminé. Cela couvre systemctl stop et restart de l’unité Docker du dépôt, machine converge, repo down --unmount, la réécriture d’une unité et l’arrêt de l’hôte. Les exceptions sont un plantage du démon Docker ou de l’hôte, une coupure de courant et un down() qui dépasse son délai, que ce soit à l’arrêt de l’hôte ou lors d’un systemctl stop ou restart. Ce down() est tué et l’arrêt se poursuit, comme décrit plus bas.
Chaque unité Docker exécute un crochet d’arrêt avant d’envoyer le signal au démon. Le crochet lance down() sur le démon encore actif, sauf si renet l’a déjà fait pour ce démarrage du démon, et l’ignore si le démon ne répond pas ou si le dépôt n’a pas de Rediaccfile. À l’arrêt de l’hôte, les unités Docker s’arrêtent d’abord, chacune exécutant down() en parallèle, puis une unité de balayage démonte tous les dépôts montés, avec ou sans autostart. Le budget d’arrêt d’une unité est de 17 minutes, ce qui tient dans le délai de 30 minutes de la tâche de redémarrage. Si down() dépasse son délai dans ce crochet, son groupe de processus reçoit SIGTERM puis, 10 secondes plus tard, SIGKILL (FunctionKillGrace, pkg/orchestration/procgroup.go), un avertissement est journalisé et le crochet sort avec 0 : systemd poursuit l’arrêt. Un down() expiré retarde donc un systemctl stop ou un redémarrage de son délai plus 10 secondes au plus (15 minutes 10 secondes au plafond), et l’arrêt reste borné par le TimeoutStopSec de 17 minutes de l’unité. Le refus d’arrêter ne vaut que pour les chemins propres à renet, comme repo down --unmount.
up() et down() disposent de 10 minutes chacun par défaut, réglables avec RENET_UP_TIMEOUT et RENET_DOWN_TIMEOUT ou --up-timeout et --down-timeout. À l’expiration, le groupe de processus reçoit SIGTERM, puis SIGKILL après 10 secondes. Une opération qui exige down() d’abord, comme repo down --unmount ou un redémarrage par converge, laisse les conteneurs tourner si down() dépasse son délai ; --force poursuit. Un Rediaccfile peut relever une limite avec une ligne de commentaire :
# rediacc:timeout up=20m down=15m backup=120s health=60s repair=10m
| Clé | Par défaut | Plafond |
|---|---|---|
up | 10 minutes | 60 minutes |
down | 10 minutes | 15 minutes |
backup | 30 secondes | 300 secondes |
health | 30 secondes | 300 secondes |
repair | 5 minutes | 30 minutes |
health() est borné de la même façon : son délai par défaut se règle avec RENET_HEALTH_TIMEOUT et, en cas de dépassement, son groupe de processus reçoit SIGTERM, puis SIGKILL 10 secondes plus tard. Le contrôle de santé du déploiement traite un health() qui dépasse son délai comme un dépôt encore en chauffe et réessaie ; rdc repo health et rdc machine health le signalent comme une erreur. repair() suit le même modèle avec RENET_REPAIR_TIMEOUT, et un repair() qui dépasse son délai est considéré comme échoué.
Une directive ne fait que relever une limite et elle est ramenée à son plafond : le dépôt ne peut donc pas raccourcir down() jusqu’à le faire tuer. Les clés inconnues sont ignorées avec un avertissement.
Les démons de dépôt gardent live-restore de Docker désactivé. Les conteneurs survivraient à un redémarrage du démon, mais les shims partagent le cgroup de l’unité et sont tués avec elle ; le démon restauré ne pourrait pas se rattacher, et les conteneurs garderaient le montage occupé lors d’un arrêt planifié.
Un volume RAM géré par renet pour chaque dépôt (# rediacc:ram size=6G, la RAM de l’hôte étant accordée par l’opérateur) n’existe qu’à l’état de conception et n’est pas encore implémenté.
Exemple
#!/bin/bash
up() {
echo "Starting services..."
renet compose -- up -d
}
down() {
echo "Stopping services..."
renet compose -- down
}
Important : Utilisez toujours
renet compose --au lieu dedocker compose. Le wrapperrenet composeimpose le réseau hôte, l’allocation d’IP et les labels de découverte de services requis par renet-proxy. Les capacités CRIU checkpoint/restauration sont ajoutées aux conteneurs avec le labelrediacc.checkpoint=true. L’utilisation directe dedocker composeest rejetée par la validation du Rediaccfile. Consultez Réseau pour les détails.
Labels de capacité
Par défaut, les conteneurs démarrent avec un ensemble minimal de capacités Linux. Un service peut en demander davantage en ajoutant un label à son docker-compose.yml :
| Label | Accorde | Pour |
|---|---|---|
rediacc.checkpoint=true | CHECKPOINT_RESTORE, SYS_PTRACE, NET_ADMIN | CRIU checkpoint/restauration (migration en direct, sauvegarde et reprise) |
rediacc.wireguard=true | NET_ADMIN et le périphérique /dev/net/tun | Faire tourner un client WireGuard dans le conteneur |
services:
vpn:
image: alpine
labels:
- "rediacc.wireguard=true"
rediacc.wireguard permet à un service de monter un tunnel WireGuard, par exemple pour faire sortir un processus précis par un point de terminaison distant. Comme tous les services utilisent le réseau hôte, confinir le tunnel dans un espace de noms réseau interne au conteneur afin qu’il ne modifie pas le routage de l’hôte. Les options privilégiées larges comme privileged: true, pid: host et ipc: host restent refusées quel que soit le label utilisé, aussi bien par la validation compose que sur l’API Docker, où le démon du dépôt répond par un 403.
Disposition multi-services
Pour les projets avec plusieurs groupes de services indépendants, utilisez des sous-répertoires :
/mnt/rediacc/repos/my-app/
├── Rediaccfile # Racine : configuration partagée
├── docker-compose.yml
├── database/
│ ├── Rediaccfile # Services de base de données
│ └── docker-compose.yml
├── backend/
│ ├── Rediaccfile # Serveur API
│ └── docker-compose.yml
└── monitoring/
├── Rediaccfile # Prometheus, Grafana, etc.
└── docker-compose.yml
Ordre d’exécution pour up : racine, puis backend, database, monitoring (A-Z).
Ordre d’exécution pour down : monitoring, database, backend, puis racine (Z-A).
Réseau de services (.rediacc.json)
Chaque dépôt obtient un sous-réseau /26 (64 adresses IP) dans la plage de bouclage 127.x.x.x. Les services se lient à des adresses IP de bouclage uniques afin de pouvoir fonctionner sur les mêmes ports sans conflits.
Le fichier .rediacc.json
Associe les noms de services à des numéros de slot. Chaque slot correspond à une adresse IP unique au sein du sous-réseau du dépôt.
{
"services": {
"api": {"slot": 0},
"postgres": {"slot": 1},
"redis": {"slot": 2}
}
}
Génération automatique depuis Docker Compose
Vous n’avez pas besoin de créer .rediacc.json manuellement. Lorsque vous exécutez rdc repo up, Rediacc effectue automatiquement les opérations suivantes :
- Analyse tous les répertoires contenant un Rediaccfile à la recherche de fichiers compose (
docker-compose.yml,docker-compose.yaml,compose.ymloucompose.yaml) - Extrait les noms de services de la section
services: - Attribue le prochain slot disponible à tout nouveau service
- Enregistre le résultat dans
{repository}/.rediacc.json
Calcul des adresses IP
L’adresse IP d’un service est calculée à partir de l’ID réseau du dépôt et du slot du service. L’ID réseau est réparti sur les deuxième, troisième et quatrième octets d’une adresse de bouclage 127.x.y.z. Les services commencent à l’offset 2 :
| Offset | Adresse | Objectif |
|---|---|---|
| .0 | 127.0.11.0 | Adresse réseau (réservée) |
| .1 | 127.0.11.1 | Passerelle (réservée) |
| .2 à .62 | 127.0.11.2 à 127.0.11.62 | Services (slot + 2) |
| .63 | 127.0.11.63 | Broadcast (réservé) |
Exemple pour l’ID réseau 2816 (0x0B00), adresse de base 127.0.11.0 :
| Service | Slot | Adresse IP |
|---|---|---|
| api | 0 | 127.0.11.2 |
| postgres | 1 | 127.0.11.3 |
| redis | 2 | 127.0.11.4 |
Chaque dépôt prend en charge jusqu’à 61 services (slots 0 à 60).
Utilisation des IP de services dans Docker Compose
Puisque chaque dépôt exécute un démon Docker isolé, renet compose configure automatiquement network_mode: host pour tous les services. Le noyau réécrit de façon transparente les appels bind() vers l’IP de bouclage assignée au service, de sorte que les services peuvent se lier à 0.0.0.0 ou localhost sans conflits. Pour les connexions vers d’autres services, utilisez le nom du service. renet injecte chaque nom de service comme nom d’hôte qui résout toujours vers la bonne IP, même dans les forks :
services:
postgres:
image: postgres:16
environment:
PGDATA: /var/lib/postgresql/data
POSTGRES_PASSWORD: secret
# Pas de listen_addresses explicite nécessaire -- le noyau réécrit bind vers la bonne IP de bouclage
api:
image: my-api:latest
environment:
DATABASE_URL: postgresql://postgres:secret@postgres:5432/mydb # utiliser le nom de service
LISTEN_ADDR: 0.0.0.0:8080 # le noyau réécrit vers l'IP du service
Noms de service pour les connexions : Utilisez le nom de service (p.ex.
postgres,redis) pour vous connecter à d’autres services — renet mappe automatiquement chaque nom de service vers son IP de bouclage via/etc/hosts. Intégrer${POSTGRES_IP}dans des chaînes de connexion stockées dans des bases de données ou des fichiers de configuration figera l’IP brute, ce qui rompt l’isolation des forks et constitue une erreur de validation. Les variables${SERVICE_IP}restent disponibles pour un usage explicite, mais la liaison est gérée automatiquement par le noyau.
Note : N’ajoutez pas
network_mode: hostmanuellement,renet composel’injecte automatiquement. Les politiques de redémarrage (p.ex.,restart: always) sont sûres à utiliser, renet les supprime automatiquement pour la compatibilité CRIU et le watchdog du routeur gère la récupération des conteneurs.
Récupération des conteneurs et politique de redémarrage
renet et Docker ont délibérément des avis divergents sur la façon de gérer les redémarrages de conteneurs. Comprendre cette séparation est important pour diagnostiquer pourquoi un conteneur est ou n’est pas revenu.
Traduction de la politique de redémarrage. Lorsque vous écrivez restart: always (ou unless-stopped, ou on-failure) dans votre fichier compose, renet la supprime lors de la synthèse du déploiement compose réel et la remplace par restart: no. La valeur originale est sauvegardée dans .rediacc.json du dépôt sous services.<name>.restart_policy. Cela empêche le redémarrage automatique au niveau du démon Docker d’interférer avec CRIU checkpoint/restore (un redémarrage piloté par le démon reprendrait depuis un état antérieur au checkpoint devenu obsolète).
Application du watchdog. Le watchdog du routeur s’exécute périodiquement sur chaque machine. À chaque cycle :
- Il lit
.rediacc.jsonpour chaque dépôt et trouve les services avec unerestart_policyrécupérable. - Il liste tous les conteneurs du démon de ce dépôt, identifie ceux qui sont arrêtés, et les redémarre selon la politique sauvegardée. Une période de grâce de 30 secondes empêche tout conflit avec un opérateur qui vient d’exécuter
docker stop. - La même boucle traite également
/var/run/rediacc/cold-backup-<guid>.running.json(voir Sémantique Cold Backup). Les conteneurs listés sont redémarrés indépendamment de la politique sauvegardée, car le sidecar signifie “renet a arrêté ces conteneurs intentionnellement et doit à l’opérateur un redémarrage.”
Pourquoi on-failure peut sembler cassé. La politique on-failure de Docker redémarre uniquement lorsque le conteneur sort avec un code non nul. Un arrêt propre (exit 0) depuis docker stop ou un arrêt du démon n’est pas un “échec” et ne déclenche PAS de redémarrage, ni par la logique native de Docker ni par le chemin de politique sauvegardée du watchdog. Le sidecar cold backup est le filet de sécurité : tout conteneur que nous avons arrêté intentionnellement est redémarré indépendamment de sa politique.
Comment interpréter l’état d’exécution :
docker inspect <container>→RestartPolicy.Name: sera toujoursnopour les conteneurs gérés par renet. Ne vous fiez pas à cela pour la politique sémantique..rediacc.jsonà la racine du montage du dépôt →services.<name>.restart_policy: l’intention réelle.docker ps --format '{{.Status}}': état d’exécution.
Comment corriger une dérive. Si la politique sauvegardée dans .rediacc.json d’un conteneur est incorrecte (par exemple parce que vous avez modifié compose sans jamais recréer le conteneur), relancez rdc repo up <repo>. Le conteneur est recréé avec la politique mise à jour enregistrée.
Expérimental : La récupération basée sur le sidecar cold backup et le flag
--sync-certssurrdc machine statusont été livrés dans renet 0.9+. Les versions antérieures s’appuient uniquement sur larestart_policysauvegardée pour la récupération par watchdog, ce qui peut laisser les conteneurson-failurebloqués après un cold backup.
Le réseau bridge Docker est désactivé pour les daemons par dépôt. Chaque daemon par dépôt (
FlavorRediacc) est configuré avec"bridge": "none"et"iptables": false. Un simpledocker run <image>dans un shell de dépôt se lancera quand même, mais le conteneur n’obtiendra qu’une interface de loopback et ne disposera ni de DNS ni de connectivité sortante. C’est voulu : l’isolation de loopback entre dépôts est appliquée par des hooks cgroup eBPF qu’un conteneur bridgé contournerait. Les services de production doivent utiliserrenet compose(qui injecte le réseau hôte pour vous) ; pour le débogage ponctuel, passez explicitement--network host:docker run --rm --network host -it ubuntu bash.Les daemons Hub par utilisateur (
FlavorHub, utilisés dans les environnements de développement) font exception : ils définissentbridge="docker0",iptables=trueetlive-restore=trueafin que les conteneurs lancés par l’utilisateur bénéficient d’un réseau bridge normal et d’une connectivité sortante.
Note : Les repos fork obtiennent des auto-routes sous le sous-domaine du parent :
{service}-fork-{tag}.{repo}.{machine}.{baseDomain}. Les domaines personnalisés sont ignorés pour les forks.
Démarrer les services
Montez le dépôt et démarrez tous les services :
rdc repo up my-app
| Option | Description |
|---|---|
--no-wait | Revient dès que les conteneurs sont lancés ; les vérifications de santé continuent en arrière-plan |
--skip-router-restart | Ne pas redémarrer le serveur de routes après l’opération |
La séquence d’exécution est :
- Monter le dépôt chiffré LUKS (montage automatique si non monté)
- Démarrer le démon Docker isolé
- Générer automatiquement
.rediacc.jsonà partir des fichiers compose - Exécuter
up()dans tous les Rediaccfiles (ordre A-Z)
Après le déploiement, la sortie affiche une section PROXY ROUTES avec les URLs réelles pour chaque service. Les services avec des labels Traefik personnalisés (par ex. traefik.http.routers.myapp.rule=Host(...)) affichent leurs domaines personnalisés comme URLs principales :
HTTP services (accessible via proxy after ~3s):
gitlab-server:
HTTPS: https://gitlab.example.com (custom)
Auto: https://gitlab-server.gitlab.server-1.example.com
IP: 127.0.11.130
Les services sans labels Traefik personnalisés affichent uniquement la route auto-générée. Utilisez ces URLs (et non le motif générique imprimé par la CLI) pour l’accès au navigateur, les appels API et la configuration inter-services.
Démarrage détaché
Avec --no-wait, la commande rend la main dès que les conteneurs sont lancés, sans attendre la fin des vérifications de santé. Le démarrage se poursuit en arrière-plan : le proxy réessaie les connexions montantes jusqu’à ce que chaque service soit lié, les routes se rétablissent d’elles-mêmes. Suivez la progression avec rdc machine status <machine> --containers. Idéal pour les forks jetables et les boucles scriptées où la disponibilité immédiate des services n’est pas requise avant l’étape suivante.
Sonde de disponibilité
Après up(), renet sonde chaque service HTTP jusqu’à ce qu’il accepte les connexions TCP, afin que la première requête du navigateur ne tombe pas sur une erreur 502 du proxy. Les services dont les conteneurs définissent un health check Docker sont considérés comme fiables directement : un conteneur sain saute la sonde, et celui encore dans sa start_period génère une note informative plutôt qu’un avertissement. La sonde abandonne après 15 secondes (modifiable via la variable d’environnement REDIACC_READINESS_TIMEOUT, en secondes, sur la machine) ; les démarrages détachés la sautent entièrement.
Arrêter les services
rdc repo down my-app
| Option | Description |
|---|---|
--unmount | Démonter le dépôt chiffré après l’arrêt des services. |
--skip-router-restart | Ne pas redémarrer le serveur de routes après l’opération |
La séquence d’exécution est :
- Exécuter
down()dans tous les Rediaccfiles (ordre inverse Z-A, au mieux) - Arrêter le démon Docker isolé (si
--unmount) - Démonter et fermer le volume chiffré LUKS (si
--unmount)
Opérations en masse
Démarrez ou arrêtez tous les dépôts d’une machine en une seule fois :
rdc repo up --all -m server-1
| Option | Description |
|---|---|
--include-forks | Inclure les dépôts dupliqués (forks) |
--no-start | Monter et préparer uniquement, sans exécuter les étapes up() du dépôt |
--dry-run | Afficher ce qui serait fait |
--parallel | Exécuter les opérations en parallèle |
--concurrency <n> | Nombre maximum d’opérations simultanées (par défaut : 3) |
--skip-router-restart | Ne pas redémarrer le serveur de routes après l’opération |
Démarrage automatique au boot
Par défaut, les dépôts doivent être montés et démarrés manuellement après un redémarrage du serveur. Le démarrage automatique configure les dépôts pour qu’ils se montent automatiquement, démarrent Docker et exécutent le up() du Rediaccfile au démarrage du serveur.
Fonctionnement
Lorsque vous activez le démarrage automatique pour un dépôt :
- Un fichier de clé LUKS aléatoire de 256 octets est généré et ajouté au slot LUKS 1 du dépôt (le slot 0 reste la phrase secrète utilisateur)
- Le fichier de clé est stocké dans
{datastore}/.credentials/keys/{guid}.keyavec les permissions0600(root uniquement) - Un service systemd (
rediacc-autostart) s’exécute au démarrage pour monter tous les dépôts activés et démarrer leurs services
Lors de l’arrêt, le service arrête gracieusement tous les services (Rediaccfile down()), arrête les démons Docker et ferme les volumes LUKS.
Note de sécurité : L’activation du démarrage automatique stocke un fichier de clé LUKS sur le disque du serveur. Toute personne ayant un accès root au serveur peut monter le dépôt sans la phrase secrète. Évaluez ceci en fonction de votre modèle de menace.
Activer
rdc repo admin autostart enable my-app
La phrase secrète du dépôt vous sera demandée.
Activer pour tous les dépôts
rdc repo admin autostart enable
Désactiver
rdc repo admin autostart disable my-app
Ceci supprime le fichier de clé et invalide le slot LUKS 1.
Actualisation du fichier de clé lors du déploiement
Quand le démarrage automatique est activé, rdc repo up valide le fichier de clé du slot LUKS 1.
Si le fichier de clé sur disque correspond encore au slot LUKS, aucun changement n’est effectué.
Après avoir transféré un dépôt entre machines via repo push / repo pull,
le fichier de clé sur la nouvelle machine ne correspondra pas. Dans ce cas, repo up régénère automatiquement
le fichier de clé et met à jour le slot LUKS 1. Vous verrez des messages de journal :
Refreshing keyfile credential for <guid>
Killing LUKS slot 1: /mnt/rediacc/repositories/<guid>
Adding keyfile to LUKS slot 1: /mnt/rediacc/repositories/<guid>
C’est sans risque, le slot 0 (votre phrase secrète) n’est jamais modifié. Si le démarrage automatique n’est pas activé, la vérification est silencieusement ignorée. Les échecs sont non fatals et ne bloquent pas le déploiement.
Lister le statut
rdc repo admin autostart list -m server-1
Pour plus de détails sur la façon dont le réconciliateur périodique récupère les dépôts qui tombent après le démarrage, consultez Démarrage automatique et récupération.
Exemple complet
Cet exemple déploie une application web avec PostgreSQL, Redis et un serveur API.
1. Configurer l’environnement
curl -fsSL https://www.rediacc.com/install.sh | bash
rdc config init production --ssh-key ~/.ssh/id_ed25519
rdc machine add prod-1 --ip 203.0.113.50 --user deploy
rdc machine setup prod-1
rdc repo create webapp -m prod-1 --size 10G
2. Monter et préparer
rdc repo up webapp --no-start
3. Créer les fichiers de l’application
À l’intérieur du dépôt, créez les fichiers suivants :
docker-compose.yml :
services:
postgres:
image: postgres:16
volumes:
- ./data/postgres:/var/lib/postgresql/data
environment:
POSTGRES_DB: webapp
POSTGRES_USER: app
POSTGRES_PASSWORD: changeme
redis:
image: redis:7-alpine
api:
image: myregistry/api:latest
environment:
DATABASE_URL: postgresql://app:changeme@postgres:5432/webapp
REDIS_URL: redis://redis:6379
LISTEN_ADDR: 0.0.0.0:8080
Rediaccfile :
#!/bin/bash
up() {
mkdir -p data/postgres
renet compose -- up -d
echo "Waiting for PostgreSQL..."
for i in $(seq 1 30); do
if renet compose -- exec postgres pg_isready -q 2>/dev/null; then
echo "PostgreSQL is ready."
return 0
fi
sleep 1
done
echo "Warning: PostgreSQL did not become ready within 30 seconds."
}
down() {
renet compose -- down
}
4. Démarrer
rdc repo up webapp
5. Activer le démarrage automatique
rdc repo admin autostart enable webapp
Utiliser des secrets par dépôt dans compose
Le placeholder POSTGRES_PASSWORD: changeme ci-dessus convient pour un tutoriel, mais les applications réelles ont besoin de vrais identifiants, et les committer dans le fichier compose (ou un fichier .env à l’intérieur du dépôt) signifie qu’un fork en hérite aussi. Pour les identifiants au moment du déploiement, utilisez rdc repo secret. Les valeurs vivent en dehors de l’image du dépôt chiffré, de sorte que les forks commencent avec une carte de secrets vide.
Deux modes de livraison fonctionnent dans compose :
Mode env. Interpolez via ${REDIACC_SECRET_<KEY>} dans n’importe quelle valeur environment:. Le wrapper renet transmet la valeur dans l’environnement du conteneur au moment du déploiement.
Mode file. La valeur atterrit dans un fichier tmpfs côté hôte dans /var/run/rediacc/net-<networkID>/secrets/<KEY>, et vous le montez dans le conteneur via le bloc secrets: standard de Docker compose. Le conteneur lit /run/secrets/<key>. Privilégiez ce mode pour quoi que ce soit de sensible. Les valeurs n’apparaissent jamais dans docker inspect ou /proc/<pid>/environ.
services:
api:
image: myregistry/api:latest
environment:
DATABASE_URL: ${REDIACC_SECRET_DATABASE_URL}
secrets:
- stripe_live_key
secrets:
stripe_live_key:
file: /var/run/rediacc/net-${REDIACC_NETWORK_ID}/secrets/STRIPE_LIVE_KEY
Semez les valeurs avec rdc repo secret set <repo> --key DATABASE_URL --value <val> --mode env --current "" et l’équivalent en mode fichier. Consultez Dépôts § Secrets pour la procédure complète et Secrets par dépôt sur la feuille de triche pour la référence des commandes.
Les chemins entre dépôts sont rejetés lors de la validation. Un
secrets: file:(ouconfigs: file:, ouenv_file:) de compose pointant vers le répertoire/var/run/rediacc/net-<other-networkID>/secrets/d’un autre dépôt est fortement rejeté par le wrapper renet avant l’exécution de docker compose.--unsafene l’ignore PAS. Défense en profondeur : le sandbox Landlock autour du shell Rediaccfile limite les lectures au répertoire des secrets du réseau actuel, de sorte qu’uncat /var/run/rediacc/net-<other>/secrets/Xdepuis bash du Rediaccfile échoue avec EACCES même s’il contourne le validateur YAML. Vous n’avez pas besoin d’opt-in ; c’est activé par défaut pour chaquerepo up.