Servicios
En esta página se cubre: despliegue y administración de servicios en contenedores, incluyendo Rediaccfiles, redes de servicios, inicio/parada, operaciones en lote e inicio automático.
El Rediaccfile
El Rediaccfile es un script de Bash que define cómo se inician y detienen sus servicios. Se carga (no se ejecuta como un proceso separado), de modo que sus funciones comparten el mismo contexto de shell y tienen acceso a todas las variables de entorno exportadas. Debe tener el nombre Rediaccfile o rediaccfile (sin distinción de mayúsculas) y ubicarse dentro del sistema de archivos montado del repositorio.
Los Rediaccfiles se descubren en dos ubicaciones:
- La raíz de la ruta de montaje del repositorio
- Subdirectorios de primer nivel de la ruta de montaje (no recursivo)
Se omiten los directorios ocultos (nombres que comienzan con .).
Funciones del Ciclo de Vida
renet ejecuta estas funciones del Rediaccfile:
| Función | Cuándo se ejecuta | Propósito | Comportamiento en caso de error |
|---|---|---|---|
up() | Al iniciar | Iniciar servicios (por ejemplo, renet compose -- up -d) | El fallo raíz es crítico (detiene todo). Los fallos en subdirectorios son no críticos (registrados, continúa) |
down() | Al detener | Detener servicios (por ejemplo, renet compose -- down) | Mejor esfuerzo — los fallos se registran pero siempre se intenta ejecutar todos los Rediaccfiles |
health() | En rdc repo health, en rdc machine health y en la comprobación de salud del despliegue | Informar del estado propio del repositorio: salida 0 ok, 1 advertencia, 2 error | Se ejecuta el health() de cada Rediaccfile y cuenta el nivel más grave. La salida 75 significa que aún se está calentando (una advertencia). Cualquier otra salida, una señal o un tiempo agotado es un error (la comprobación de salud del despliegue interpreta un tiempo agotado como «aún calentando» y reintenta, véase Tiempos límite y orden de apagado). Un repositorio en el que ningún Rediaccfile define health() informa sin comprobación, nunca como saludable |
repair() | En rdc repo repair y en rdc machine repair para un repositorio cuyo health() no está ok | Corregir lo que informó el health() de ese mismo archivo | Solo se ejecuta cuando el health() de su archivo no está ok y la clase declarada está permitida (véase abajo). Un health() que sale con 75 (aún calentando) cuenta como advertencia, así que un repair() debe dejar en paz a un repositorio que todavía está arrancando. Después health() se ejecuta de nuevo. Un repair() que falla o agota el tiempo es un error |
Todas las funciones son opcionales. Si una función no está definida, se omite silenciosamente.
Declarar una clase de reparación
repair() recibe REDIACC_HEALTH_LEVEL (warning o error, el nivel que informó el health() de su propio archivo) y REDIACC_HEALTH_OUTPUT (el final de la salida de ese health()). Una línea de comentario declara lo segura que es la función:
# rediacc:repair class=auto-safe
# rediacc:repair class=auto-with-backup window=only
| Clase | Quién la ejecuta |
|---|---|
auto-safe | rdc machine repair y rdc repo repair la ejecutan por su cuenta |
auto-with-backup | Solo se ejecuta con --with-backup, tras una instantánea correcta del repositorio |
operator-only | Nunca se ejecuta por sí sola. rdc repo repair pregunta antes (o acepta --yes); rdc machine repair nunca la ejecuta |
Un repair() sin declaración es operator-only, de modo que ninguna herramienta ejecuta código de un repositorio sin supervisión a menos que el repositorio indique que es seguro. window=only añade una segunda condición: la función se ejecuta solo dentro de la ventana de mantenimiento de la máquina (Monitoreo) o con --window-override. Cuando varias líneas declaran una clase, cuenta la más restrictiva.
Orden de Ejecución
- Iniciando (
up): Rediaccfile raíz primero, luego subdirectorios en orden alfabético (A a Z). - Deteniendo (
down): Subdirectorios en orden alfabético inverso (Z a A), luego raíz al final.
Variables de Entorno
Cuando se ejecuta una función de Rediaccfile, están disponibles las siguientes variables de entorno:
| Variable | Descripción | Ejemplo |
|---|---|---|
REDIACC_WORKING_DIR | Ruta de montaje del repositorio | /mnt/rediacc/mounts/abc123 |
REDIACC_REPOSITORY | GUID del repositorio | a1b2c3d4-e5f6-... |
REDIACC_NETWORK_ID | ID de red (entero) | 2816 |
DOCKER_HOST | Socket de Docker para el daemon aislado de este repositorio | unix:///var/run/rediacc/net-2816/docker-2816.sock |
{SERVICE}_IP | IP de loopback para cada servicio definido en .rediacc.json | POSTGRES_IP=127.0.11.2 |
Las variables {SERVICE}_IP se generan automáticamente a partir de las asignaciones de slot en .rediacc.json y se exportan antes de que se ejecuten sus funciones de Rediaccfile. La convención de nombres convierte el nombre del servicio a mayúsculas con guiones reemplazados por guiones bajos, luego añade _IP. Por ejemplo, un servicio denominado listmonk-app con slot 0 se convierte en LISTMONK_APP_IP=127.0.11.2.
Advertencia: No use
sudo dockeren Rediaccfiles. El comandosudorestablece las variables de entorno, lo que significa que se pierdeDOCKER_HOSTy los comandos de Docker se dirigirán al daemon del sistema en lugar del daemon aislado del repositorio. Esto rompe el aislamiento de contenedores y puede causar conflictos de puerto. Rediacc bloqueará la ejecución si detectasudo docker.Use
renet composeen sus Rediaccfiles, maneja automáticamenteDOCKER_HOST, inyecta etiquetas de red para descubrimiento de rutas y configura redes de servicios. Véase Redes para detalles sobre cómo se exponen los servicios a través del proxy inverso. Si llama a Docker directamente, usedockersinsudo: las funciones de Rediaccfile llegan al daemon de Docker del repositorio como el usuario universal, sin root (véase Privilegios).
renetes la herramienta remota de bajo nivel. Para flujos de trabajo normales de usuario desde su estación de trabajo, prefiera comandosrdccomordc repo upyrdc repo down. Véase rdc vs renet.
Privilegios
up() y down() se ejecutan como el usuario universal (rediacc), no como root, dentro de un sandbox que limita dónde pueden leer y escribir. El entorno se construye para la función en lugar de heredarse, así que contiene las variables anteriores, los valores REDIACC_SECRET_* del repositorio y un PATH mínimo. sudo no está disponible en ningún nivel: el sandbox activa no_new_privs, de modo que una línea de Rediaccfile que use sudo falla y debe prescindir de él. Una máquina sin Landlock rechaza up() y down() en lugar de ejecutarlas sin restricciones.
Una línea que necesite más que lo predeterminado falla con el error que le da el sandbox, y el journal y la CLI imprimen la línea correspondiente del Rediaccfile junto con el comando de concesión.
| Un Rediaccfile hace | Ve | Solución |
|---|---|---|
sudo x | sudo: The "no new privileges" flag is set | Quitar sudo. El paso o no necesita root o necesita una concesión |
chown 5050 ... o rm -rf de un directorio que pertenece a un contenedor | Operation not permitted / Permission denied | Ejecutar el paso en un contenedor de un solo uso (root dentro del contenedor; el daemon de Docker del repositorio rechaza los montajes fuera de las raíces propias del repositorio): renet compose -- run --rm --no-deps --user 0 --entrypoint chown <service> -R 5050:5050 /data |
Escribe .env u otros archivos en el montaje | Funciona; los archivos pertenecen al usuario universal | Ninguna |
Lee /etc/rediacc/*, /proc/kcore o un dispositivo de bloques | Permission denied | Pedir una concesión de ruta |
| Lee directamente un secreto de archivo | Permission denied | Usar secrets: de compose o un secreto en modo env |
nvidia-smi sin concesión de dispositivo | Falta el dispositivo | Conceder el dispositivo, véase GPU |
sysctl -w | Permission denied | Establecerlo una vez en la máquina como administrador |
Solicitar una concesión
Una concesión amplía lo que up() y down() pueden alcanzar. Solo un operador la da, desde fuera del repositorio:
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 añade una regla de Landlock, de solo lectura salvo que se indique :rw, y la máquina rechaza una ruta que alcance otro repositorio, el datastore o /etc/rediacc. --root ejecuta las funciones como root sin reducir privilegios, y un backup en frío rechaza un repositorio así. Los agentes no pueden dar --root salvo que el operador haya definido REDIACC_ALLOW_GRAND_REPO antes de iniciar el agente. Un fork tiene un nuevo id de red y empieza sin concesión, y una concesión hallada bajo un id de red reutilizado se descarta.
Un Rediaccfile puede declarar lo que necesita con una línea de comentario, solo como solicitud:
# rediacc:needs root
# rediacc:needs path=/srv/data
# rediacc:needs device=nvidia.com/gpu=all
up() compara la declaración con la concesión. Cuando falta la concesión, up() se rechaza antes de ejecutar ninguna línea, y el mensaje imprime el comando de concesión exacto. down() nunca comprueba la declaración, de modo que un comentario editado dentro del repositorio no pueda impedir el repo down de un operador; un down() que de verdad necesita la concesión falla en su propio paso. machine converge omite un repositorio así como needs_lifecycle_grant en lugar de reiniciarlo hacia el rechazo.
Tiempos límite y orden de apagado
Los contenedores de un repositorio no se detienen hasta que su down() se ha ejecutado y ha terminado. Esto abarca systemctl stop y restart de la unidad Docker del repositorio, machine converge, repo down --unmount, la reescritura de una unidad y el apagado del host. Las excepciones son una caída del demonio de Docker o del host, un corte de energía y un down() que supera su tiempo límite, ya sea en el apagado del host o en un systemctl stop o restart. Ese down() se termina y la parada continúa, como se describe más abajo.
Cada unidad Docker ejecuta un gancho de parada antes de enviar la señal al demonio. El gancho ejecuta down() contra el demonio que sigue activo, salvo que renet ya lo haya hecho en este arranque del demonio, y lo omite si el demonio no responde o el repositorio no tiene Rediaccfile. En el apagado del host se detienen primero las unidades Docker, cada una con su down() en paralelo, y después una unidad de barrido desmonta todos los repositorios montados, con o sin autostart. El presupuesto de parada de una unidad es de 17 minutos, que cabe en el límite de 30 minutos del trabajo de reinicio. Si down() agota el tiempo dentro de este gancho, su grupo de procesos recibe SIGTERM y, 10 segundos después, SIGKILL (FunctionKillGrace, pkg/orchestration/procgroup.go), se registra una advertencia y el gancho sale con 0, de modo que systemd continúa con la parada. Un down() que agota el tiempo retrasa un systemctl stop o un reinicio hasta su tiempo límite más 10 segundos (15 minutos y 10 segundos en el máximo), y la parada sigue acotada por el TimeoutStopSec de 17 minutos de la unidad. La negativa a detener solo se aplica a las rutas propias de renet, como repo down --unmount.
up() y down() disponen de 10 minutos cada uno por defecto, configurables con RENET_UP_TIMEOUT y RENET_DOWN_TIMEOUT o con --up-timeout y --down-timeout. Al agotarse el tiempo, el grupo de procesos recibe SIGTERM y, tras 10 segundos, SIGKILL. Una operación que necesita down() primero, como repo down --unmount o un reinicio por converge, deja los contenedores en marcha si down() agota el tiempo; --force continúa. Un Rediaccfile puede subir un límite con una línea de comentario:
# rediacc:timeout up=20m down=15m backup=120s health=60s repair=10m
| Clave | Predeterminado | Máximo |
|---|---|---|
up | 10 minutos | 60 minutos |
down | 10 minutos | 15 minutos |
backup | 30 segundos | 300 segundos |
health | 30 segundos | 300 segundos |
repair | 5 minutos | 30 minutos |
health() tiene el mismo límite: su valor predeterminado se fija con RENET_HEALTH_TIMEOUT y, al agotarse el tiempo, su grupo de procesos recibe SIGTERM y, 10 segundos después, SIGKILL. La comprobación de salud del despliegue interpreta un health() con tiempo agotado como que aún se está calentando y reintenta; rdc repo health y rdc machine health lo informan como un error. repair() sigue el mismo modelo con RENET_REPAIR_TIMEOUT, y un repair() con tiempo agotado cuenta como fallido.
Una directiva solo sube un límite y se recorta a su máximo, así que el repositorio no puede acortar down() hasta convertirlo en una muerte forzada. Las claves desconocidas se ignoran con una advertencia.
Los demonios de repositorio mantienen live-restore de Docker desactivado. Los contenedores sobrevivirían a un reinicio del demonio, pero los shims comparten el cgroup de la unidad y mueren con ella, de modo que el demonio restaurado no podría reconectarse, y los contenedores mantendrían ocupado el montaje durante una parada planificada.
Un volumen de RAM gestionado por renet para cada repositorio (# rediacc:ram size=6G, con la RAM del host concedida por el operador) es solo un diseño y aún no está implementado.
Ejemplo
#!/bin/bash
up() {
echo "Starting services..."
renet compose -- up -d
}
down() {
echo "Stopping services..."
renet compose -- down
}
Importante: Siempre use
renet compose --en lugar dedocker compose. El envoltoriorenet composeimpone redes host, asignación de IP y etiquetas de descubrimiento de servicios requeridas por renet-proxy. Se añaden capacidades de punto de control/restauración CRIU a contenedores con la etiquetarediacc.checkpoint=true. La prueba de Rediaccfile rechaza el uso directo dedocker compose. Véase Redes para detalles.
Etiquetas de capacidad
Los contenedores se ejecutan con un conjunto mínimo de capacidades de Linux por defecto. Un servicio puede activar capacidades adicionales añadiendo una etiqueta a su docker-compose.yml:
| Etiqueta | Otorga | Para usar con |
|---|---|---|
rediacc.checkpoint=true | CHECKPOINT_RESTORE, SYS_PTRACE, NET_ADMIN | Punto de control/restauración CRIU (migración en vivo, guardar y reanudar) |
rediacc.wireguard=true | NET_ADMIN más el dispositivo /dev/net/tun | Ejecutar un cliente WireGuard dentro del contenedor |
services:
vpn:
image: alpine
labels:
- "rediacc.wireguard=true"
rediacc.wireguard permite que un servicio establezca un túnel WireGuard, por ejemplo para enrutar un proceso concreto a través de un endpoint remoto. Como todos los servicios usan red de host, confine el túnel a un namespace de red dentro del contenedor para no modificar el enrutamiento del host. Las opciones de privilegio amplio como privileged: true, pid: host e ipc: host siguen siendo rechazadas independientemente de las etiquetas, tanto por la validación de compose como en la API de Docker, donde el daemon del repositorio responde con un 403.
Diseño Multi-Servicio
Para proyectos con múltiples grupos de servicios independientes, use subdirectorios:
/mnt/rediacc/repos/my-app/
├── Rediaccfile # Raíz: configuración compartida
├── docker-compose.yml
├── database/
│ ├── Rediaccfile # Servicios de base de datos
│ └── docker-compose.yml
├── backend/
│ ├── Rediaccfile # Servidor API
│ └── docker-compose.yml
└── monitoring/
├── Rediaccfile # Prometheus, Grafana, etc.
└── docker-compose.yml
Orden de ejecución para up: raíz, luego backend, database, monitoring (A-Z).
Orden de ejecución para down: monitoring, database, backend, luego raíz (Z-A).
Red de Servicios (.rediacc.json)
Cada repositorio obtiene una subred /26 (64 IPs) en el rango de loopback 127.x.x.x. Los servicios se vinculan a IPs de loopback únicas para que puedan ejecutarse en los mismos puertos sin conflictos.
El Archivo .rediacc.json
Mapea nombres de servicios a números de slot. Cada slot corresponde a una dirección IP única dentro de la subred del repositorio.
{
"services": {
"api": {"slot": 0},
"postgres": {"slot": 1},
"redis": {"slot": 2}
}
}
Generación Automática desde Docker Compose
No necesita crear .rediacc.json manualmente. Cuando ejecuta rdc repo up, Rediacc automáticamente:
- Escanea todos los directorios que contienen un Rediaccfile en busca de archivos compose (
docker-compose.yml,docker-compose.yaml,compose.ymlocompose.yaml) - Extrae los nombres de servicio de la sección
services: - Asigna el siguiente slot disponible a cualquier servicio nuevo
- Guarda el resultado en
{repository}/.rediacc.json
Cálculo de IP
La IP de un servicio se calcula a partir del ID de red del repositorio y el slot del servicio. El ID de red se distribuye entre el segundo, tercer y cuarto octeto de una dirección de loopback 127.x.y.z. Los servicios comienzan en el offset 2:
| Offset | Address | Purpose |
|---|---|---|
| .0 | 127.0.11.0 | Network address (reserved) |
| .1 | 127.0.11.1 | Gateway (reserved) |
| .2. .62 | 127.0.11.2. 127.0.11.62 | Services (slot + 2) |
| .63 | 127.0.11.63 | Broadcast (reserved) |
Ejemplo para ID de red 2816 (0x0B00), dirección base 127.0.11.0:
| Servicio | Slot | Dirección IP |
|---|---|---|
| api | 0 | 127.0.11.2 |
| postgres | 1 | 127.0.11.3 |
| redis | 2 | 127.0.11.4 |
Cada repositorio soporta hasta 61 servicios (slots 0 a 60).
Uso de IPs de Servicio en Docker Compose
Dado que cada repositorio ejecuta un daemon Docker aislado, renet compose configura automáticamente network_mode: host para todos los servicios. El kernel reescribe transparentemente las llamadas bind() a la IP de loopback asignada al servicio, por lo que los servicios pueden vincularse a 0.0.0.0 o localhost sin conflictos. Para conexiones a otros servicios, use el nombre del servicio. renet inyecta cada nombre de servicio como hostname que siempre resuelve a la IP correcta, incluso en forks:
services:
postgres:
image: postgres:16
environment:
PGDATA: /var/lib/postgresql/data
POSTGRES_PASSWORD: secret
# No se necesita listen_addresses explícito - el kernel reescribe bind a la IP de loopback correcta
api:
image: my-api:latest
environment:
DATABASE_URL: postgresql://postgres:secret@postgres:5432/mydb # usar nombre de servicio
LISTEN_ADDR: 0.0.0.0:8080 # el kernel reescribe a IP de servicio
Nombres de servicio para conexiones: Use el nombre de servicio (p.ej.
postgres,redis) para conectarse a otros servicios — renet mapea automáticamente cada nombre de servicio a su IP de loopback vía/etc/hosts. Incrustar${POSTGRES_IP}en cadenas de conexión almacenadas en bases de datos o archivos de configuración fijará la IP bruta, lo que rompe el aislamiento de forks y es un error de validación. Las variables${SERVICE_IP}siguen disponibles para uso explícito, pero el binding es manejado automáticamente por el kernel.
Nota: No agregue
network_mode: hostmanualmente,renet composelo inyecta automáticamente. Las políticas de reinicio (p.ej.,restart: always) son seguras de usar, renet las elimina automáticamente para compatibilidad CRIU y el watchdog del router maneja la recuperación de contenedores.
Recuperación de Contenedores y Política de Reinicio
renet y Docker difieren deliberadamente en cómo manejar los reinicios de contenedores. Entender esta división es importante al depurar por qué un contenedor regresó o no.
Traducción de la política de reinicio. Cuando escribe restart: always (o unless-stopped, o on-failure) en su archivo compose, renet la elimina al sintetizar el deployment real de compose y la reemplaza con restart: no. El valor original se guarda en .rediacc.json del repositorio bajo services.<name>.restart_policy. Esto evita que el auto-reinicio a nivel de daemon de Docker interfiera con CRIU checkpoint/restore (un reinicio controlado por el daemon reanudaría desde un estado previo al checkpoint desactualizado).
Aplicación del watchdog. El watchdog del router se ejecuta periódicamente en cada máquina. En cada ciclo:
- Lee
.rediacc.jsonpara cada repositorio y encuentra servicios con unarestart_policyrecuperable. - Lista todos los contenedores del daemon de ese repositorio, identifica los detenidos y los reinicia según la política guardada. Un período de gracia de 30 segundos evita conflictos con un operador que acaba de ejecutar
docker stop. - El mismo bucle también procesa
/var/run/rediacc/cold-backup-<guid>.running.json(ver Semántica de Cold Backup). Los contenedores listados se reinician independientemente de la política guardada, porque el sidecar significa “renet detuvo estos intencionalmente y debe al operador un reinicio.”
Por qué on-failure puede parecer roto. La política on-failure de Docker solo reinicia cuando el contenedor sale con un código no cero. Una detención ordenada (exit 0) de docker stop o un apagado del daemon no es un “fallo” y NO activa un reinicio, ni por la lógica nativa de Docker ni por la ruta de política guardada del watchdog. El sidecar de cold backup es la red de seguridad: cualquier contenedor que detuvimos intencionalmente se reinicia independientemente de su política.
Cómo interpretar el estado en tiempo de ejecución:
docker inspect <container>->RestartPolicy.Name: siempre seránopara contenedores gestionados por renet. No se base en esto para la política semántica..rediacc.jsonen el root del montaje del repositorio ->services.<name>.restart_policy: la intención real.docker ps --format '{{.Status}}': estado en tiempo de ejecución.
Cómo corregir una desviación. Si la política guardada en .rediacc.json de un contenedor es incorrecta (por ejemplo, porque editó compose pero nunca recreó el contenedor), vuelva a ejecutar rdc repo up <repo>. El contenedor se recrea con la política actualizada registrada.
Experimental: La recuperación basada en sidecar de cold backup y el flag
--sync-certsenrdc machine statusllegaron en renet 0.9+. Las versiones anteriores dependen únicamente derestart_policyguardada para la recuperación del watchdog, lo que puede dejar contenedoreson-failureatascados después de un cold backup.
La red bridge de Docker está deshabilitada en los daemons por repositorio. Cada daemon por repositorio (
FlavorRediacc) se configura con"bridge": "none"e"iptables": false. Un simpledocker run <imagen>dentro de la shell de un repositorio seguirá ejecutándose, pero el contenedor solo obtiene una interfaz de loopback y no tiene DNS ni conectividad saliente. Esto es intencional, ya que el aislamiento de loopback entre repos se impone mediante ganchos eBPF de cgroup que un contenedor en bridge evitaría. Los servicios de producción deben usarrenet compose(que inyecta la red de host por usted); para depuración ad-hoc, pase--network hostexplícitamente:docker run --rm --network host -it ubuntu bash.Los daemons Hub por usuario (
FlavorHub, usados en entornos de desarrollo) son la excepción: establecenbridge="docker0",iptables=trueylive-restore=truepara que los contenedores ejecutados por el usuario tengan red bridge normal y conectividad saliente.
Nota: Los repos fork obtienen rutas automáticas bajo el subdominio del padre:
{service}-fork-{tag}.{repo}.{machine}.{baseDomain}. Los dominios personalizados se omiten para forks.
Iniciar Servicios
Monte el repositorio e inicie todos los servicios:
rdc repo up my-app
| Opción | Descripción |
|---|---|
--no-wait | Vuelve en cuanto los contenedores están iniciados; las comprobaciones de estado continúan en segundo plano |
--skip-router-restart | Omitir el reinicio del servidor de rutas después de la operación |
La secuencia de ejecución es:
- Montar el repositorio cifrado con LUKS (montaje automático si no está montado)
- Iniciar el daemon Docker aislado
- Generar automáticamente
.rediacc.jsona partir de archivos compose - Ejecutar
up()en todos los Rediaccfiles (orden A-Z)
Después del despliegue, la salida muestra una sección PROXY ROUTES con las URLs reales para cada servicio. Los servicios con etiquetas Traefik personalizadas (p.ej. traefik.http.routers.myapp.rule=Host(...)) muestran sus dominios personalizados como 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
Los servicios sin etiquetas Traefik personalizadas muestran solo la ruta auto-generada. Use estas URLs (no el patrón genérico impreso por la CLI) para acceso desde el navegador, llamadas API y configuración entre servicios.
Inicio en modo desconectado
Con --no-wait, el comando devuelve el control en cuanto los contenedores están iniciados, sin esperar a que finalicen las comprobaciones de estado. El arranque termina en segundo plano: el proxy reintenta las conexiones con cada servicio hasta que esté disponible, por lo que las rutas se recuperan solas. Compruebe el progreso con rdc machine status <machine> --containers. Ideal para forks desechables y bucles automatizados donde no necesita que los servicios estén listos antes del siguiente paso.
Sonda de disponibilidad
Tras up(), renet comprueba cada servicio HTTP hasta que acepta conexiones TCP, de modo que la primera petición del navegador no encuentre un 502 del proxy. Los servicios cuyos contenedores definen una comprobación de estado de Docker se dan por válidos directamente: un contenedor sano omite la sonda, y uno aún dentro de start_period registra una nota informativa en lugar de una advertencia. La sonda desiste tras 15 segundos (anúlelo con la variable de entorno REDIACC_READINESS_TIMEOUT, en segundos, en la máquina); los inicios en modo desconectado la omiten por completo.
Detener Servicios
rdc repo down my-app
| Opción | Descripción |
|---|---|
--unmount | Desmontar el repositorio cifrado después de detener los servicios. |
--skip-router-restart | Omitir el reinicio del servidor de rutas después de la operación |
La secuencia de ejecución es:
- Ejecutar
down()en todos los Rediaccfiles (orden inverso Z-A, mejor esfuerzo) - Detener el daemon Docker aislado (si se usa
--unmount) - Desmontar y cerrar el volumen cifrado con LUKS (si se usa
--unmount)
Operaciones Masivas
Inicie o detenga todos los repositorios en una máquina a la vez:
rdc repo up --all -m server-1
| Opción | Descripción |
|---|---|
--include-forks | Incluir repositorios bifurcados |
--no-start | Solo montar y preparar, sin ejecutar los pasos up() del repositorio |
--dry-run | Mostrar lo que se haría |
--parallel | Ejecutar operaciones en paralelo |
--concurrency <n> | Máximo de operaciones concurrentes (predeterminado: 3) |
--skip-router-restart | Omitir el reinicio del servidor de rutas después de la operación |
Inicio Automático al Arranque
Por defecto, los repositorios deben montarse e iniciarse manualmente después de reiniciar el servidor. El inicio automático configura los repositorios para montarse automáticamente, iniciar Docker y ejecutar el up() del Rediaccfile cuando el servidor arranca.
Cómo Funciona
Cuando habilita el inicio automático para un repositorio:
- Se genera un archivo de clave LUKS aleatorio de 256 bytes y se agrega al slot 1 de LUKS del repositorio (el slot 0 permanece como la frase de contraseña del usuario)
- El archivo de clave se almacena en
{datastore}/.credentials/keys/{guid}.keycon permisos0600(solo root) - Se instala un servicio systemd (
rediacc-autostart) que se ejecuta al arranque para montar todos los repositorios habilitados e iniciar sus servicios
Al apagar, el servicio detiene graciosamente todos los servicios (down() del Rediaccfile), detiene los daemons Docker y cierra los volúmenes LUKS.
Nota de seguridad: Habilitar el inicio automático almacena un archivo de clave LUKS en el disco del servidor. Cualquier persona con acceso root al servidor puede montar el repositorio sin la frase de contraseña. Evalúe esto según su modelo de amenazas.
Habilitar
rdc repo admin autostart enable my-app
Se le solicitará la frase de contraseña del repositorio.
Habilitar Todos
rdc repo admin autostart enable
Deshabilitar
rdc repo admin autostart disable my-app
Esto elimina el archivo de clave y destruye el slot 1 de LUKS.
Actualización del Archivo de Clave en el Despliegue
Cuando el inicio automático está habilitado, rdc repo up valida el archivo de clave del slot 1 de LUKS.
Si el archivo de clave en disco aún coincide con el slot LUKS, no se realizan cambios.
Después de transferir un repositorio entre máquinas vía repo push / repo pull,
el archivo de clave en la nueva máquina no coincidirá. En este caso, repo up regenera automáticamente
el archivo de clave y actualiza el slot 1 de LUKS. Verá mensajes de registro:
Refreshing keyfile credential for <guid>
Killing LUKS slot 1: /mnt/rediacc/repositories/<guid>
Adding keyfile to LUKS slot 1: /mnt/rediacc/repositories/<guid>
Esto es seguro, el slot 0 (su frase de contraseña) nunca se modifica. Si el inicio automático no está habilitado, la verificación se omite silenciosamente. Los fallos no son fatales y no bloquean el despliegue.
Listar Estado
rdc repo admin autostart list -m server-1
Para más detalles sobre cómo el reconciliador periódico recupera repositorios que se caen después del arranque, consulte Inicio Automático y Recuperación.
Ejemplo Completo
Este ejemplo despliega una aplicación web con PostgreSQL, Redis y un servidor API.
1. Configurar
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. Montar y Preparar
rdc repo up webapp --no-start
3. Crear los Archivos de la Aplicación
Dentro del repositorio, cree:
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. Iniciar
rdc repo up webapp
5. Habilitar Inicio Automático
rdc repo admin autostart enable webapp
Usar secretos por repositorio en compose
El placeholder POSTGRES_PASSWORD: changeme anterior es correcto para un tutorial, pero las aplicaciones reales necesitan credenciales reales, y confirmar éstas en el archivo compose (o en un archivo .env dentro del repositorio) significa que un fork hereda también esas credenciales. Para credenciales en tiempo de despliegue, use rdc repo secret. Los valores viven fuera de la imagen de repositorio cifrada, por lo que los forks comienzan con un mapa de secretos vacío.
Dos modos de entrega funcionan en compose:
Modo env. Interpole vía ${REDIACC_SECRET_<KEY>} en cualquier valor environment:. El wrapper renet pasa el valor al entorno del contenedor en tiempo de despliegue.
Modo file. El valor aterriza en un archivo tmpfs del lado del host en /var/run/rediacc/net-<networkID>/secrets/<KEY>, y usted lo monta en el contenedor vía el bloque secrets: estándar de Docker compose. El contenedor lee /run/secrets/<key>. Prefiera este modo para cualquier cosa sensible. Los valores nunca aparecen en docker inspect o /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
Siembre los valores con rdc repo secret set <repo> --key DATABASE_URL --value <val> --mode env --current "" y el equivalente en modo file. Consulte Repositorios § Secretos para la guía completa y Secretos por repositorio en la hoja de trucos para la referencia de comandos.
Las rutas entre repositorios se rechazan en tiempo de validación. Un
secrets: file:(oconfigs: file:, oenv_file:) de compose que apunta a/var/run/rediacc/net-<other-networkID>/secrets/de otro repositorio se rechaza duramente por el wrapper renet antes de que docker compose se ejecute.--unsafeNO anula esto. Defensa en profundidad: el sandbox Landlock alrededor de la shell del Rediaccfile restringe lecturas al directorio de secretos de la red actual, por lo que uncat /var/run/rediacc/net-<other>/secrets/Xdesde bash del Rediaccfile falla con EACCES incluso si evita el validador YAML. No necesita optar por esto; está activado por defecto para cadarepo up.