docs: explain deployment stages and separate comment sections [skip ci]

This commit is contained in:
2026-11-17 00:01:26 +08:00
parent 00fd89af1a
commit 53bc8d73eb
7 changed files with 123 additions and 0 deletions
+16
View File
@@ -1,21 +1,29 @@
#!/usr/bin/env bash
# 远程部署的路由切换阶段,参数必须是本次已通过内部就绪检查的 Core 容器名。
set -euo pipefail
umask 077
# 固定工作目录供下面 Compose 与动态配置使用;这里只接受 release.sh 生成的容器名,避免随意写路由目标。
cd /opt/endoleap-infra
live=$1
[[ "$live" =~ ^foundry-core-[a-f0-9]{12}$ ]]
# 动态路由和 ACME 证书状态在服务器持久目录内;该目录会挂给 Traefik 的 file provider。
install -d -m 700 dev/foundry-edge
edge=dev/foundry-edge
route=$edge/foundry.yml
# 从现有动态配置提取旧容器;仅在新路由完成 HTTPS 探测后才停止它。
previous=
if [[ -f "$route" ]]; then
previous=$(sed -n 's@.*url: http://\(foundry-core-[a-f0-9]\{12\}\):8080.*@\1@p' "$route")
fi
# 先备份现有路由,再安装 EXIT 恢复器;切流探测失败时可恢复旧目标,但不会撤销外部数据库副作用。
backup=$(mktemp)
if [[ -f "$route" ]]; then cp "$route" "$backup"; fi
# EXIT trap 只恢复动态路由文件或删除新路由,不回滚已执行的数据库迁移/worker/Compose 配置。
rollback() {
if [[ -s "$backup" ]]; then
@@ -31,6 +39,9 @@ trap rollback EXIT
# ACME 文件保存证书状态,限制权限;动态路由先写隐藏临时文件再 mv,避免 watcher 读到半文件。
touch "$edge/acme.json"
chmod 600 "$edge/acme.json"
# 这个 heredoc 生成 Traefik 动态配置:域名路由、证书解析器、限流和新容器的内部 HTTP 地址。
# 它需要展开 $live,所以结束标记未加引号;先写临时文件,后面的 mv 才使新配置可见。
cat > "$edge/.foundry.yml" <<YAML
http:
routers:
@@ -53,7 +64,10 @@ http:
- url: http://$live:8080
YAML
mv "$edge/.foundry.yml" "$route"
# Compose 覆盖文件保持 Traefik 入口、证书与目录 provider 配置,不重建其他服务。
# 这个 heredoc 生成 Compose 覆盖配置,固定宿主 443 -> Traefik 8443 的映射。
# 标记加引号以保留 YAML 原文;这里的 Node/Go 应用端口并未直接发布。
cat > foundry-edge.yml <<'YAML'
services:
traefik:
@@ -71,6 +85,8 @@ services:
volumes:
- ./dev/foundry-edge:/edge
YAML
# Compose 文件中的入口/挂载变化在此应用,只更新 traefik;不会重新构建或重建其他服务。
docker compose -p endoleap-dev --env-file dev/env -f compose.yml -f dev.yml -f foundry-edge.yml up -d --no-deps traefik
# --resolve 在本机回环命中 Traefik,同时保留公开域名 Host/TLS 验证,探测真正的 HTTPS 路由。