SHA256
feat: 新增 Docker Compose 部署方案, 移除未验证的 ansible 草案
原 ansible/ 方案从未在任何环境验证过, 且与本机实际状态严重不符(硬编码
amd64 二进制、会覆盖生产 /etc/gitea/app.ini、会启动 firewalld 切断其它
服务、建的库名与现网不一致); 加上宿主机 Rocky 8 的系统 Python 无法升级,
新版 ansible 也跑不起来。改为 Docker Compose。
新增 deploy/:
- compose.yaml 版本锁定; Gitea 只发布 127.0.0.1:2080(Apache 反代无需
改动), PostgreSQL 不发布端口; 配置全部由
GITEA__section__KEY 环境变量注入; 数据用 bind mount
- db/Dockerfile 官方 postgres 只生成 en_US.UTF-8, 这里补 zh_CN.UTF-8,
与现有集群 collation 保持一致
- scripts/ backup.sh(pg_dump + 数据 tar + SHA256SUMS)、
restore.sh(默认 dry-run, 校验后还原, 拒收宿主布局备份)、
verify.sh(容器健康 + 回环 API + 经 Apache 反代)
文档 deploy/README.md 以 部署/备份/恢复/升级 四条流程为主线, 并记录本机
踩过的四个陷阱: PG18 挂载点、s6 chown 守卫、APP_NAME 只能走裸变量、
HTTP 代理导致的假 502。
一次性迁移脚本(install-docker / configure-docker-proxy / preflight /
migrate-from-binary)已清理, 相应步骤内联进文档。
实测: 源 116 表 → 目标 116 表, /api/healthz 200, 经 Apache /QA 200,
站点名与 OIDC 登录源注册正常。
This commit is contained in:
@@ -0,0 +1,95 @@
|
||||
# =============================================================================
|
||||
# deploy/.env —— 复制为 .env 后填写。.env 已被 .gitignore 排除, 不要提交。
|
||||
#
|
||||
# cp .env.example .env
|
||||
#
|
||||
# 已有部署的密钥【不要重新生成】: 从现有 /etc/gitea/app.ini 对应段抄写
|
||||
# (INTERNAL_TOKEN / LFS_JWT_SECRET / oauth2 JWT_SECRET 变更会使已发出的令牌失效)。
|
||||
#
|
||||
# 注意: 值里若含 $ 需要写成 $$(compose 会做变量插值); 含 # 或空格要用引号。
|
||||
# =============================================================================
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# 路径
|
||||
# -----------------------------------------------------------------------------
|
||||
# Gitea 数据根目录(容器内挂到 /data), 结构为 gitea/(配置与日志) 与 git/(仓库)
|
||||
GITEA_DATA_DIR=/srv/gitea
|
||||
# PostgreSQL 数据目录(容器内挂到 /var/lib/postgresql)
|
||||
# postgres:18 的布局: 实际数据在 <此目录>/18/docker,
|
||||
# 所以这里给父目录即可(不要再按老写法挂 /var/lib/postgresql/data)
|
||||
POSTGRES_DATA_DIR=/srv/pgdata
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# 版本(锁定, 便于回滚)
|
||||
# -----------------------------------------------------------------------------
|
||||
GITEA_VERSION=1.27.3
|
||||
POSTGRES_VERSION=18.6
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# 对外地址(必须与现有 Apache 反代一致, 否则链接/克隆地址会错)
|
||||
# 现有: ROOT_URL = https://cpp.tongji.sh/QA
|
||||
# Apache: ProxyPass /QA http://localhost:2080
|
||||
# -----------------------------------------------------------------------------
|
||||
GITEA_DOMAIN=10.80.42.185
|
||||
GITEA_ROOT_URL=https://cpp.tongji.sh/QA
|
||||
GITEA_NO_REPLY_ADDRESS=noreply.10.80.42.185
|
||||
# 容器发布的回环端口, 必须等于 Apache ProxyPass 的目标端口
|
||||
GITEA_HTTP_PORT=2080
|
||||
# 离线模式(沿用现有 app.ini 的 OFFLINE_MODE=true)
|
||||
GITEA_OFFLINE_MODE=true
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# 容器内 git 用户 uid/gid —— 必须与 GITEA_DATA_DIR 的属主一致
|
||||
# 现有宿主: /var/lib/gitea 属主 git:git = 982:982
|
||||
# -----------------------------------------------------------------------------
|
||||
GITEA_UID=982
|
||||
GITEA_GID=982
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# 站点名
|
||||
# ★ 走【裸变量 APP_NAME】(compose 映射为 APP_NAME, 不是 GITEA__*):
|
||||
# 镜像 /etc/s6/gitea/setup 用 envsubst 渲染模板, 模板第一行是
|
||||
# `APP_NAME = $APP_NAME`。GITEA__DEFAULT__APP_NAME 不生效(原因见 README)。
|
||||
# 从现有 app.ini 的【顶层】(无段名)抄写真实值; 全新部署才自行取名。
|
||||
# -----------------------------------------------------------------------------
|
||||
GITEA_APP_NAME=Gitea
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# Webhook 出站白名单(逗号分隔; loopback 是内置网络名)
|
||||
# loopback 为内置项; 其余按实际通知服务填写。
|
||||
# 从现有 app.ini 的【[security] 段】抄写真实值。
|
||||
# 段位: 1.27 的规范位置就是 [security]; [webhook] 是 v28.0.0 将移除的
|
||||
# deprecated fallback(modules/setting/webhook.go)。
|
||||
# -----------------------------------------------------------------------------
|
||||
GITEA_ALLOWED_HOST_LIST=loopback,example.com
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# 密钥 —— 【必须沿用现有值】
|
||||
# INTERNAL_TOKEN / LFS_JWT_SECRET / oauth2 JWT_SECRET 变更会使已发出的令牌失效。
|
||||
# 从现有 /etc/gitea/app.ini 抄写; 只有全新部署才用 generate secret 生成。
|
||||
#
|
||||
# GITEA_SECRET_KEY 特别说明:
|
||||
# 现有 /etc/gitea/app.ini **没有** SECRET_KEY, 实例一直在用 Gitea 内置默认值。
|
||||
# 默认留空 = 容器同样使用内置默认值, SSO 与已加密数据行为不变。
|
||||
# 如需轮换(安全加固), 填一个新的随机值, 但必须在切换后到管理后台
|
||||
# 重新填写 OIDC(OAuth2)登录源的 Client Secret, 并验证登录。详见 README。
|
||||
# 生成新值:
|
||||
# docker run --rm docker.gitea.com/gitea:1.27.3 gitea generate secret SECRET_KEY
|
||||
# -----------------------------------------------------------------------------
|
||||
GITEA_SECRET_KEY=
|
||||
GITEA_INTERNAL_TOKEN=
|
||||
GITEA_LFS_JWT_SECRET=
|
||||
GITEA_OAUTH2_JWT_SECRET=
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# PostgreSQL(容器内部)
|
||||
# 现有集群: db=giteadb, user=gitea, collate=zh_CN.UTF-8
|
||||
# -----------------------------------------------------------------------------
|
||||
POSTGRES_DB=giteadb
|
||||
POSTGRES_USER=gitea
|
||||
POSTGRES_PASSWORD=
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# 时区
|
||||
# -----------------------------------------------------------------------------
|
||||
TZ=Asia/Shanghai
|
||||
Reference in New Issue
Block a user