跳至主要内容 跳至导航 跳至页脚

服务

使用 Rediaccfile、服务网络和开机自启来部署和管理容器化服务。

服务

本页面涵盖的内容:部署和管理容器化服务,包括 Rediaccfile、服务网络、启动/停止、批量操作和开机自启。

Rediaccfile

Rediaccfile 是一个 Bash 脚本,用于定义服务的启动和停止方式。该文件通过 source 加载(而不是作为单独进程执行),因此其函数共享相同的 shell 上下文,可以访问所有导出的环境变量。文件必须命名为 Rediaccfile 或 rediaccfile(不区分大小写),并放置在仓库的已挂载文件系统中。

Rediaccfile 在两个位置被发现:

  1. 仓库挂载路径的根目录
  2. 挂载路径的第一级子目录(不递归)

隐藏目录(名称以 . 开头)将被跳过。

生命周期函数

renet 会运行 Rediaccfile 中的以下函数:

函数运行时机用途错误行为
up()启动时启动服务(例如 renet compose -- up -d)根 Rediaccfile 失败是关键性的(停止所有操作)。子目录失败是非关键性的(记录日志,继续下一个)
down()停止时停止服务(例如 renet compose -- down)尽力而为 — 失败会被记录,但所有 Rediaccfile 都会被执行
health()运行 rdc repo health、rdc machine health 以及部署的健康关卡时报告仓库自身的健康状况:退出码 0 正常,1 警告,2 错误每个 Rediaccfile 的 health() 都会运行,取最差的级别。退出码 75 表示仍在预热(警告)。任何其他退出码、信号或超时都算错误(部署健康关卡把超时视为仍在预热并重试,见超时与关机顺序)。没有任何 Rediaccfile 定义 health() 的仓库会报告无检查,绝不会算作健康
repair()运行 rdc repo repair,以及对 health() 不正常的仓库运行 rdc machine repair 时修复同一文件的 health() 所报告的问题仅当其所在文件的 health() 不正常且所声明的类别被允许时才会运行(见下文)。以退出码 75(仍在预热)结束的 health() 算警告,因此 repair() 应放过仍在启动的仓库。之后 health() 会再次运行。失败或超时的 repair() 算错误

所有函数都是可选的。如果某个函数未定义,它会被静默跳过。

声明修复类别

repair() 会收到 REDIACC_HEALTH_LEVEL(warning 或 error,即其所在文件的 health() 报告的级别)和 REDIACC_HEALTH_OUTPUT(该 health() 输出的末尾部分)。用一行注释声明这个函数有多安全:

# rediacc:repair class=auto-safe
# rediacc:repair class=auto-with-backup window=only
类别由谁运行
auto-saferdc machine repair 和 rdc repo repair 会自行运行
auto-with-backup仅在使用 --with-backup 且仓库快照成功之后运行
operator-only绝不会自行运行。rdc repo repair 会先询问(或接受 --yes);rdc machine repair 从不运行

没有声明的 repair() 视为 operator-only,因此除非仓库自己表明安全,否则没有任何工具会在无人值守时运行仓库的代码。window=only 增加第二个条件:该函数只在机器的维护窗口内(监控)运行,或在使用 --window-override 时运行。当多行声明了类别时,以最严格的为准。

执行顺序

  • 启动(up): 先执行根 Rediaccfile,然后按字母顺序(A 到 Z)执行子目录中的 Rediaccfile。
  • 停止(down): 先按反向字母顺序(Z 到 A)执行子目录中的 Rediaccfile,最后执行根 Rediaccfile。

环境变量

当 Rediaccfile 函数执行时,以下环境变量可用:

变量描述示例
REDIACC_WORKING_DIR仓库的挂载路径/mnt/rediacc/mounts/abc123
REDIACC_REPOSITORY仓库 GUIDa1b2c3d4-e5f6-...
REDIACC_NETWORK_ID网络 ID(整数)2816
DOCKER_HOST此仓库隔离守护进程的 Docker 套接字unix:///var/run/rediacc/net-2816/docker-2816.sock
{SERVICE}_IP.rediacc.json 中定义的每个服务的回环 IPPOSTGRES_IP=127.0.11.2

{SERVICE}_IP 变量从 .rediacc.json 中的槽位映射自动生成,在 Rediaccfile 函数运行前导出。命名规则是将服务名称转换为大写,连字符替换为下划线,然后追加 _IP。例如,listmonk-app 变为 LISTMONK_APP_IP=127.0.11.2。

警告:请勿在 Rediaccfile 中使用 sudo docker。 sudo 命令会重置环境变量,导致 DOCKER_HOST 丢失,Docker 命令将指向系统守护进程而非仓库的隔离守护进程。这会破坏容器隔离并可能导致端口冲突。如果 Rediacc 检测到 sudo docker,将阻止执行。

在 Rediaccfile 中请使用 renet compose,它会自动处理 DOCKER_HOST,注入路由发现所需的网络标签,并配置服务网络。有关服务如何通过反向代理暴露的详细信息,请参阅网络。如果直接调用 Docker,请使用不带 sudo 的 docker,Rediaccfile 函数以通用用户身份(而非 root)访问仓库的 Docker 守护进程(参阅权限)。

renet 是远程低级别工具。对于从工作站执行的正常用户工作流,请优先使用 rdc 命令,如 rdc repo up 和 rdc repo down。参阅 rdc vs renet。

权限

up() 和 down() 以通用用户(rediacc)而非 root 的身份运行,处于一个限制其读写位置的沙箱中。环境是为函数单独构建的,而不是继承而来,因此只包含上文的变量、仓库的 REDIACC_SECRET_* 值和一个最小的 PATH。任何层级下都不能使用 sudo:沙箱设置了 no_new_privs,所以使用 sudo 的 Rediaccfile 行会失败,必须去掉 sudo。没有 Landlock 的机器会拒绝 up() 和 down(),而不是在无约束的情况下运行它们。

需要超出默认权限的行会以沙箱给出的错误失败,日志和 CLI 会打印对应的 Rediaccfile 行以及授权命令。

Rediaccfile 的操作看到的结果处理方式
sudo xsudo: The "no new privileges" flag is set去掉 sudo。该步骤要么不需要 root,要么需要授权
chown 5050 ...,或对容器所属目录执行 rm -rfOperation not permitted 或 Permission denied在一次性容器中运行该步骤(仅在容器内是 root;仓库的 Docker 守护进程会拒绝仓库自身根目录之外的绑定):renet compose -- run --rm --no-deps --user 0 --entrypoint chown <service> -R 5050:5050 /data
在挂载目录中写入 .env 或其他文件正常;文件属于通用用户无需处理
读取 /etc/rediacc/*、/proc/kcore 或块设备Permission denied申请路径授权
直接读取文件型密钥Permission denied使用 compose 的 secrets: 或 env 模式密钥
没有设备授权就运行 nvidia-smi设备不存在授予设备,参阅 GPU
sysctl -wPermission denied由管理员在机器上设置一次

申请授权

授权会扩大 up() 和 down() 可以访问的范围。只有运维人员能够授权,并且要在仓库之外操作:

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 添加一条 Landlock 规则,除非带有 :rw,否则为只读;机器会拒绝触及其他仓库、数据存储或 /etc/rediacc 的路径。--root 以 root 身份运行函数且不降权,冷备份会拒绝这样的仓库。除非运维人员在代理启动之前设置了 REDIACC_ALLOW_GRAND_REPO,否则代理不能授予 --root。分叉有新的网络 ID,启动时没有授权,在被复用的网络 ID 下找到的授权会被丢弃。

Rediaccfile 可以用注释行声明自己的需求,这只是一个请求:

# rediacc:needs root
# rediacc:needs path=/srv/data
# rediacc:needs device=nvidia.com/gpu=all

up() 会把声明与授权进行比对。授权缺失时,up() 在任何一行运行之前就会被拒绝,消息中会打印确切的授权命令。down() 从不检查声明,因此在仓库内修改注释无法阻止运维人员的 repo down;真正需要授权的 down() 会在自己的步骤中失败。machine converge 会把这样的仓库作为 needs_lifecycle_grant 跳过,而不是把它重启进拒绝状态。

超时与关机顺序

仓库的容器必须等到其 down() 运行并结束后才会停止。这适用于对仓库 Docker 单元执行的 systemctl stop 和 restart、machine converge、repo down --unmount、单元重写以及主机关机。例外情况是 Docker 守护进程或主机崩溃、断电,以及超过超时的 down(),无论发生在主机关机时还是 systemctl stop 或 restart 时。该 down() 会被终止,停止按下文所述继续。

每个 Docker 单元在向守护进程发送信号之前会运行一个停止钩子。除非 renet 已在本次守护进程启动中运行过,钩子会对仍在运行的守护进程执行 down();如果守护进程没有响应或仓库没有 Rediaccfile,则跳过。主机关机时,先停止各 Docker 单元,每个单元并行执行 down(),随后清扫单元会卸载所有已挂载的仓库,无论是否启用自动启动。单元的停止预算为 17 分钟,可以放进重启任务 30 分钟的上限内。如果 down() 在这个钩子中超时,其进程组会先收到 SIGTERM,10 秒后收到 SIGKILL(FunctionKillGrace,pkg/orchestration/procgroup.go),记录一条警告,钩子以 0 退出,systemd 因此继续停止。所以超时的 down() 最多让 systemctl stop 或重启延迟其超时时长加 10 秒(上限为 15 分 10 秒),停止仍受单元 17 分钟 TimeoutStopSec 的限制。拒绝停止只适用于 renet 自己的路径,例如 repo down --unmount。

up() 和 down() 默认各有 10 分钟,可通过 RENET_UP_TIMEOUT 和 RENET_DOWN_TIMEOUT 或 --up-timeout 和 --down-timeout 设置。超时后,进程组先收到 SIGTERM,10 秒后收到 SIGKILL。需要先执行 down() 的操作(如 repo down --unmount 或 converge 重启)在 down() 超时时会让容器继续运行,加上 --force 则继续执行。Rediaccfile 可以用一行注释调高限制:

# rediacc:timeout up=20m down=15m backup=120s health=60s repair=10m
键默认值上限
up10 分钟60 分钟
down10 分钟15 分钟
backup30 秒300 秒
health30 秒300 秒
repair5 分钟30 分钟

health() 同样有时间限制:默认值通过 RENET_HEALTH_TIMEOUT 设置,超时时其进程组会先收到 SIGTERM,10 秒后收到 SIGKILL。部署的健康关卡把超时的 health() 视为仍在预热并重试;rdc repo health 和 rdc machine health 则把它报告为错误。repair() 遵循同样的模型,使用 RENET_REPAIR_TIMEOUT,超时的 repair() 算作失败。

该指令只能调高限制,并且会被截断到上限,因此仓库无法把 down() 缩短到被强制终止的程度。未知的键会被忽略并给出警告。

仓库守护进程保持 Docker 的 live-restore 关闭。开启后容器可以在守护进程重启后存活,但容器 shim 与单元共用 cgroup,会随单元一起被终止,恢复后的守护进程无法重新接管,而且在计划内停止期间容器仍会占用挂载点。

由 renet 管理的每仓库 RAM 卷(# rediacc:ram size=6G,主机内存由运维人员授予)目前只是设计,尚未实现。

示例

#!/bin/bash

up() {
    echo "Starting services..."
    renet compose -- up -d
}

down() {
    echo "Stopping services..."
    renet compose -- down
}

重要: 请始终使用 renet compose -- 而非 docker compose。renet compose 封装器强制实施主机网络、IP 分配和 renet-proxy 所需的服务发现标签。CRIU 检查点/恢复功能会添加到带有 rediacc.checkpoint=true 标签的容器。直接使用 docker compose 会被 Rediaccfile 验证拒绝。详情请参阅网络。

能力标签

容器默认以最小 Linux 能力集运行。服务可通过在 docker-compose.yml 中添加标签来申请额外能力:

标签授权内容适用场景
rediacc.checkpoint=trueCHECKPOINT_RESTORE、SYS_PTRACE、NET_ADMINCRIU 检查点/恢复(热迁移、保存与恢复)
rediacc.wireguard=trueNET_ADMIN 及 /dev/net/tun 设备在容器内运行 WireGuard 客户端
services:
  vpn:
    image: alpine
    labels:
      - "rediacc.wireguard=true"

rediacc.wireguard 允许服务建立 WireGuard 隧道,例如将某个进程的流量通过远端节点转发出去。由于所有服务均使用主机网络,应将隧道限制在容器内的网络命名空间中,避免影响宿主机的路由表。privileged: true、pid: host、ipc: host 等宽泛特权选项无论是否添加标签,都会被拒绝,compose 验证器和 Docker API 均如此,在 Docker API 上由仓库的守护进程返回 403。

多服务布局

对于包含多个独立服务组的项目,使用子目录:

/mnt/rediacc/repos/my-app/
├── Rediaccfile              # 根目录:共享设置
├── docker-compose.yml
├── database/
│   ├── Rediaccfile          # 数据库服务
│   └── docker-compose.yml
├── backend/
│   ├── Rediaccfile          # API 服务器
│   └── docker-compose.yml
└── monitoring/
    ├── Rediaccfile          # Prometheus、Grafana 等
    └── docker-compose.yml

up 执行顺序:根目录,然后 backend、database、monitoring(A-Z)。 down 执行顺序:monitoring、database、backend,然后根目录(Z-A)。

服务网络(.rediacc.json)

每个仓库获得一个 /26 子网(64 个 IP),位于 127.x.x.x 回环地址范围内。服务绑定到唯一的回环 IP,因此可以使用相同的端口而不会产生冲突。

.rediacc.json 文件

将服务名称映射到槽位编号。每个槽位对应仓库子网内的一个唯一 IP 地址。

{
  "services": {
    "api": {"slot": 0},
    "postgres": {"slot": 1},
    "redis": {"slot": 2}
  }
}

从 Docker Compose 自动生成

您无需手动创建 .rediacc.json。当您运行 rdc repo up 时,Rediacc 会自动:

  1. 扫描所有包含 Rediaccfile 的目录中的 compose 文件(docker-compose.yml、docker-compose.yaml、compose.yml 或 compose.yaml)
  2. 从每个 compose 文件的 services: 部分提取服务名称
  3. 为新服务分配下一个可用槽位
  4. 将结果保存到 {repository}/.rediacc.json

IP 计算

服务的 IP 根据仓库的网络 ID 和服务的槽位计算。网络 ID 分布在 127.x.y.z 回环地址的第二、第三和第四个八位组中。服务从偏移量 2 开始:

偏移量地址用途
.0127.0.11.0网络地址(保留)
.1127.0.11.1网关(保留)
.2 – .62127.0.11.2 – 127.0.11.62服务(slot + 2)
.63127.0.11.63广播(保留)

示例:网络 ID 为 2816(0x0B00)时,基础地址为 127.0.11.0:

服务槽位IP 地址
api0127.0.11.2
postgres1127.0.11.3
redis2127.0.11.4

每个仓库最多支持 61 个服务(槽位 0 到 60)。

在 Docker Compose 中使用服务 IP

由于每个仓库运行隔离的 Docker 守护进程,renet compose 会自动为所有服务配置 network_mode: host。内核透明地将 bind() 调用重写到服务分配的回环 IP,因此服务可以绑定到 0.0.0.0 或 localhost 而不会产生冲突。对于连接到其他服务,请使用服务名称。renet 将每个服务名称作为主机名注入,始终解析到正确的 IP,即使在 fork 中也是如此:

services:
  postgres:
    image: postgres:16
    environment:
      PGDATA: /var/lib/postgresql/data
      POSTGRES_PASSWORD: secret
    # 无需显式 listen_addresses -- 内核会将 bind 重写到正确的回环 IP

  api:
    image: my-api:latest
    environment:
      DATABASE_URL: postgresql://postgres:secret@postgres:5432/mydb  # 使用服务名称
      LISTEN_ADDR: 0.0.0.0:8080                                      # 内核重写到服务 IP

连接用服务名称: 使用服务名称(如 postgres、redis)连接到其他服务 — renet 通过 /etc/hosts 自动将每个服务名称映射到其回环 IP。在数据库或配置文件中存储的连接字符串中嵌入 ${POSTGRES_IP} 会固化原始 IP,这会破坏 fork 隔离并且是验证错误。${SERVICE_IP} 变量仍可用于显式使用,但绑定由内核自动处理。

注意: 不要手动添加 network_mode: host,renet compose 会自动注入。重启策略(如 restart: always)可以安全使用,renet 会为了 CRIU 兼容性自动删除它们,路由器看门狗负责容器恢复。

容器恢复与重启策略

renet 和 Docker 有意在如何处理容器重启方面存在分工。在调试容器为什么恢复或未能恢复时,理解这种分工很重要。

重启策略转换。 当您在 compose 文件中写入 restart: always(或 unless-stopped,或 on-failure)时,renet 在合成实际 compose 部署时会删除它,并用 restart: no 替换。原始值保存到仓库的 .rediacc.json 中 services.<name>.restart_policy 下。这可以防止 Docker 守护进程级别的自动重启干扰 CRIU 检查点/恢复(守护进程驱动的重启会从过时的检查点前状态恢复)。

看门狗执行。 路由器看门狗在每台机器上定期运行。每次滴答时:

  1. 读取每个仓库的 .rediacc.json,找到具有可恢复 restart_policy 的服务
  2. 列出该仓库守护进程的所有容器,识别已停止的容器,并按保存的策略重启它们。30 秒的宽限期防止与刚刚运行 docker stop 的操作员发生冲突
  3. 同一循环还处理 /var/run/rediacc/cold-backup-<guid>.running.json(参见冷备份语义)。列出的容器无论保存的策略如何都会重启,因为 sidecar 意味着”renet 有意停止了这些容器,欠操作员一次重启”

为什么 on-failure 看起来像坏掉了。 Docker 的 on-failure 策略仅在容器以非零代码退出时重启。来自 docker stop 或守护进程关闭的正常停止(exit 0)不是”失败”,不会触发重启,无论是通过 Docker 的原生逻辑还是看门狗的保存策略路径。冷备份 sidecar 是安全网:有意停止的任何容器都会重启,无论其策略如何。

如何解读运行时状态:

  • docker inspect <container> → RestartPolicy.Name:对于 renet 管理的容器始终为 no。不要依赖这个来判断语义策略
  • 仓库挂载根目录的 .rediacc.json → services.<name>.restart_policy:真实意图
  • docker ps --format '{{.Status}}':运行时状态

如何修复偏差。 如果容器的 .rediacc.json 保存策略错误(例如,因为您编辑了 compose 但未重新创建容器),请重新运行 rdc repo up <repo>。容器将以更新的策略重新创建。

实验性: 基于冷备份 sidecar 的恢复和 rdc machine status 上的 --sync-certs 标志在 renet 0.9+ 中发布。旧版本仅依赖保存的 restart_policy 进行看门狗恢复,这可能在冷备份后使 on-failure 容器搁浅。

每个仓库的守护进程禁用了 Docker bridge 网络。 每个仓库的守护进程(FlavorRediacc)都配置了 "bridge": "none" 和 "iptables": false。在仓库 shell 内运行一个简单的 docker run <image> 仍然能启动容器,但该容器只有 loopback 接口,没有 DNS 或出站连接。这是设计使然,因为仓库之间的 loopback 隔离由 eBPF cgroup 钩子强制执行,而 bridge 容器会绕过这些钩子。生产服务应使用 renet compose(它会自动为您注入主机网络);对于临时调试,请显式传递 --network host:docker run --rm --network host -it ubuntu bash。

每个用户的 Hub 守护进程(FlavorHub,用于开发环境)是例外:它们设置 bridge="docker0"、iptables=true 和 live-restore=true,使用户运行的容器拥有正常的 bridge 网络和出站连接。

注意: Fork 仓库在父仓库子域下获得自动路由:{service}-fork-{tag}.{repo}.{machine}.{baseDomain}。自定义域名在 fork 中被跳过。

启动服务

挂载仓库并启动所有服务:

rdc repo up my-app
选项描述
--no-wait容器启动后立即返回,健康检查在后台继续
--skip-router-restart跳过操作后重启路由服务器

执行顺序为:

  1. 挂载 LUKS 加密仓库(未挂载时自动挂载)
  2. 启动此仓库的隔离 Docker 守护进程
  3. 从 compose 文件自动生成 .rediacc.json
  4. 按 A-Z 顺序在所有 Rediaccfile 中运行 up()

部署后,输出显示 PROXY ROUTES 部分,其中包含每个服务的实际 URL。具有自定义 Traefik 标签的服务将其自定义域名显示为主要 URL:

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

未具有自定义 Traefik 标签的服务仅显示自动生成的路由。使用这些 URL(而非 CLI 输出的通用模式)进行浏览器访问、API 调用和跨服务配置。

后台启动

加上 --no-wait,命令在容器启动后即返回,不等待健康检查完成。启动过程在后台继续:代理持续重试上游连接,直到各服务就绪,路由自动恢复。可通过 rdc machine status <machine> --containers 查看进度。适合一次性临时分支和无需等待服务就绪即可进行下一步的脚本化流程。

就绪探测

up() 执行完成后,renet 会对每个 HTTP 服务发起 TCP 探测,确认其接受连接,避免首次浏览器请求遭遇代理 502。容器已定义 Docker 健康检查的服务可直接信任:状态为 healthy 的容器跳过探测;仍处于 start_period 内的容器记录信息日志而非警告。探测最长等待 15 秒(可通过机器上的环境变量 REDIACC_READINESS_TIMEOUT 以秒为单位覆盖);后台模式启动跳过探测。

停止服务

rdc repo down my-app
选项描述
--unmount停止服务后卸载加密仓库。
--skip-router-restart跳过操作后重启路由服务器

执行顺序为:

  1. 按 Z-A 反向顺序在所有 Rediaccfile 中运行 down()(尽力而为)
  2. 停止隔离的 Docker 守护进程(如果指定了 --unmount)
  3. 卸载并关闭 LUKS 加密卷(如果指定了 --unmount)

批量操作

一次启动或停止机器上的所有仓库:

rdc repo up --all -m server-1
选项描述
--include-forks包含 fork 仓库
--no-start仅挂载并准备,不运行仓库的 up() 步骤
--dry-run显示将要执行的操作
--parallel并行运行操作
--concurrency <n>最大并发操作数(默认:3)
--skip-router-restart跳过操作后重启路由服务器

开机自启

默认情况下,服务器重启后需要手动挂载和启动仓库。开机自启功能可配置仓库在服务器启动时自动挂载、启动 Docker 并运行 Rediaccfile up()。

工作原理

当您为仓库启用开机自启时:

  1. 生成一个 256 字节的随机 LUKS 密钥文件,并添加到仓库的 LUKS 槽位 1(槽位 0 仍为用户密码短语)
  2. 密钥文件存储在 {datastore}/.credentials/keys/{guid}.key,权限为 0600(仅 root 可读)
  3. 安装一个 systemd 服务(rediacc-autostart),在启动时挂载所有已启用的仓库并启动其服务

在系统关机或重启时,该服务会优雅地停止所有服务(Rediaccfile down())、停止 Docker 守护进程并关闭 LUKS 卷。

安全提示: 启用开机自启会将 LUKS 密钥文件存储在服务器磁盘上。任何拥有服务器 root 权限的人都可以在无需密码短语的情况下挂载仓库。请根据您的威胁模型进行评估。

启用

rdc repo admin autostart enable my-app

系统将提示您输入仓库密码短语。

为所有仓库启用

rdc repo admin autostart enable

禁用

rdc repo admin autostart disable my-app

此操作将删除密钥文件并清除 LUKS 槽位 1。

部署时刷新密钥文件

当开机自启已启用时,rdc repo up 会验证 LUKS 槽位 1 的密钥文件。 如果磁盘上的密钥文件仍与 LUKS 槽位匹配,则不会进行任何更改。

通过 repo push / repo pull 在机器之间传输仓库后, 新机器上的密钥文件将不匹配。此时,repo up 会自动重新生成密钥文件并更新 LUKS 槽位 1。您将看到以下日志消息:

Refreshing keyfile credential for <guid>
Killing LUKS slot 1: /mnt/rediacc/repositories/<guid>
Adding keyfile to LUKS slot 1: /mnt/rediacc/repositories/<guid>

这是安全的,槽位 0(您的密码短语)永远不会被修改。如果未启用开机自启, 此检查将静默跳过。失败不是致命的,不会阻止部署。

查看状态

rdc repo admin autostart list -m server-1

有关周期性协调器在启动后如何恢复停止的仓库的详细信息,请参阅自动启动与恢复。

完整示例

以下示例部署一个包含 PostgreSQL、Redis 和 API 服务器的 Web 应用。

1. 设置环境

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. 挂载并准备

rdc repo up webapp --no-start

3. 创建应用文件

在仓库内创建以下文件:

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. 启动

rdc repo up webapp

5. 启用开机自启

rdc repo admin autostart enable webapp

在 compose 中使用按仓库的密钥

上面 POSTGRES_PASSWORD: changeme 占位符对于教程来说没问题,但真实应用需要真实凭证。将它们提交到 compose 文件(或仓库内的 .env 文件)意味着 fork 也会继承它们。对于部署时凭证,请使用 rdc repo secret。值存储在加密仓库镜像之外,因此 fork 开始时具有空的密钥映射。

compose 中两种传递模式有效:

env 模式。通过 ${REDIACC_SECRET_<KEY>} 在任何 environment: 值中进行内插。renet 封装器在部署时将值传递到容器的环境中。

file 模式。值输入到主机端 tmpfs 文件 /var/run/rediacc/net-<networkID>/secrets/<KEY>,您通过 Docker compose 的标准 secrets: 块将其挂载到容器中。容器读取 /run/secrets/<key>。对于任何敏感内容,请优先选择此模式。值永远不会出现在 docker inspect 或 /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

使用 rdc repo secret set <repo> --key DATABASE_URL --value <val> --mode env --current "" 和等效的文件模式来设定值。参阅仓库 - 密钥了解完整的操作方法和按仓库的密钥在速查表中了解命令参考。

跨仓库路径在验证时被拒绝。 指向另一仓库的 /var/run/rediacc/net-<other-networkID>/secrets/ 目录的 compose secrets: file:(或 configs: file:,或 env_file:)在 docker compose 运行前由 renet 封装器硬拒绝。--unsafe 不会覆盖。纵深防御:Rediaccfile shell 周围的 Landlock 沙箱限制读取到当前网络的密钥目录,因此即使绕过 YAML 验证器,来自 Rediaccfile bash 的 cat /var/run/rediacc/net-<other>/secrets/X 也会以 EACCES 失败。您无需选择加入;这对每个 repo up 都默认启用。