Preserve production website unit with deployment drop-in
This commit is contained in:
KenanZhu committed
1 parent
18216953e7
commit
ea3c288df7
4 files changed
+22
-32
No files matched your search
@@ -2,4 +2,5 @@
|
||||
/frontend/** text=auto eol=lf
|
||||
*.sh text eol=lf
|
||||
*.service text eol=lf
|
||||
/deploy/systemd/*.conf text eol=lf
|
||||
*.yml text eol=lf
|
||||
@@ -1,19 +0,0 @@
|
||||
[Unit]
|
||||
Description=AutoLibrary Website
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
Type=exec
|
||||
User=autolibrary
|
||||
Group=autolibrary
|
||||
WorkingDirectory=/opt/autolibrary/current
|
||||
ExecStart=/opt/autolibrary/current/webserver start --config /opt/autolibrary/shared/config.json
|
||||
Environment=GIN_MODE=release
|
||||
UMask=0027
|
||||
NoNewPrivileges=true
|
||||
Restart=on-failure
|
||||
RestartSec=5s
|
||||
TimeoutStopSec=20s
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
@@ -0,0 +1,4 @@
|
||||
[Service]
|
||||
WorkingDirectory=/opt/autolibrary/current
|
||||
ExecStart=
|
||||
ExecStart=/opt/autolibrary/current/webserver start --config /opt/autolibrary/shared/config.json
|
||||
+17
-13
@@ -6,34 +6,37 @@
|
||||
|
||||
安装 Bash、Git、curl、sudo、`build-essential`、`util-linux`、Go 1.25.6 或更新版本、Node.js 22.13 或更新版本。确认 Runner 的服务环境中能找到 `git`、`node`、`npm`、`go` 和 `gcc`，并能访问 Gitea、GitHub 上固定版本的 checkout Action、npm registry 和 Go 模块代理。
|
||||
|
||||
部署使用两个专用账号。首次创建账号及目录时运行以下命令。已有同名账号时复用，并确认组和权限与示例相符。
|
||||
网站继续使用现有的 `autolibrary` 账号。首次接入时创建专用部署账号和发布目录。已有部署账号时复用，并确认组和权限与示例相符。
|
||||
|
||||
```sh
|
||||
sudo useradd --system --user-group --create-home --home-dir /var/lib/autolibrary-runner autolibrary-deploy
|
||||
sudo useradd --system --user-group --no-create-home autolibrary
|
||||
sudo chmod 0700 /var/lib/autolibrary-runner
|
||||
sudo install -d -o root -g autolibrary-deploy -m 1775 /opt/autolibrary
|
||||
sudo install -d -o autolibrary-deploy -g autolibrary-deploy -m 0755 /opt/autolibrary/releases
|
||||
sudo install -d -o root -g autolibrary -m 0771 /opt/autolibrary/shared
|
||||
sudo install -d -o autolibrary -g autolibrary -m 0750 /opt/autolibrary/shared/logs
|
||||
sudo install -d -o root -g autolibrary -m 0751 /opt/autolibrary/shared
|
||||
sudo ln -s /home/autolibrary/logs /opt/autolibrary/shared/logs
|
||||
```
|
||||
|
||||
从现有站点迁移时，按 [Ubuntu 部署说明](migration-to-ubuntu.md) 停服备份，再迁入现有配置和数据。新站点可以从 `config.example.json` 起步并填入实际参数。生产配置路径为 `/opt/autolibrary/shared/config.json`，文件权限设为 `0640`，所有者设为 `root:autolibrary`。配置应包括：
|
||||
现网的基础 unit 为 `autolibrary-webserver.service`，运行账号为 `autolibrary`，原程序和配置位于 `/home/autolibrary`。按 [Ubuntu 部署说明](migration-to-ubuntu.md) 备份后，将原配置复制到 `/opt/autolibrary/shared/config.json`，设为 `root:autolibrary`、权限 `0640`。调整副本中的路径：
|
||||
|
||||
- SQLite 数据库和主题文件使用发布目录之外的绝对路径，例如 `/opt/autolibrary/shared/themes.db` 与 `/opt/autolibrary/shared/themes_files`。运行用户 `autolibrary` 需要对数据库所在目录和主题文件目录有写权限。
|
||||
- `frontend.host` 监听 `127.0.0.1`，`frontend.static.path` 使用 `./frontend/dist`。生产端口与现有 Nginx upstream 对齐。
|
||||
- 保留生产 API Key、Casdoor 配置及独立运行的 Casdoor 服务。启用 API Key 校验时填写实际的 Key。
|
||||
- 将三个 SQLite 数据库和主题文件目录的路径改为现有 `/home/autolibrary/backend/data/` 下的绝对路径，继续使用原数据。运行用户需要对数据库所在目录和主题文件目录有写权限。
|
||||
- 将 `frontend.static.path` 改为 `./frontend/dist`，让程序从本次发布目录读取资源。沿用前端 `3003`、后端 `8080` 及现有监听地址。
|
||||
- 保留现有 API Key 和 `backend.casdoor` 配置。网站通过 `http://127.0.0.1:8000` 使用 Casdoor 处理账户和认证。现网的 `autolibrary-casdoor.service` 独立运行，发布任务只重启 `autolibrary-webserver.service`。
|
||||
|
||||
已有 `current` 时，它应为指向上一版的符号链接。核实上一版可用新 unit 和共享配置启动，并把该链接本身交给部署账号（`sudo chown -h autolibrary-deploy:autolibrary-deploy /opt/autolibrary/current`），以便部署替换和回滚。若原站使用其他 unit，在第一次自动发布前停止并禁用该旧 unit，避免争用端口。
|
||||
首次接入时，以部署账号创建指向原站的链接，作为首次发布失败时的回退目标。已有 `current` 时，确认链接指向可用的上一版并由部署账号拥有。
|
||||
|
||||
```sh
|
||||
sudo -u autolibrary-deploy ln -s /home/autolibrary /opt/autolibrary/current
|
||||
```
|
||||
|
||||
## 2. 安装网站服务和 Runner
|
||||
|
||||
从网站源码目录安装 unit。它在首次发布时启动。
|
||||
在现有网站 unit 上安装 drop-in，只调整工作目录和启动命令。原 unit 继续提供运行账号、重启策略和 `/home/autolibrary/logs/errors.log` 的 stderr 设置。新服务器可先按 [Ubuntu 部署说明](migration-to-ubuntu.md#4-systemd) 安装基础 unit。已有站点执行 `daemon-reload` 后，覆盖配置会在下一次网站服务启动时生效。
|
||||
|
||||
```sh
|
||||
sudo install -m 0644 deploy/autolibrary-webserver.service /etc/systemd/system/autolibrary-webserver.service
|
||||
sudo install -d -m 0755 /etc/systemd/system/autolibrary-webserver.service.d
|
||||
sudo install -m 0644 deploy/systemd/10-gitea-release.conf /etc/systemd/system/autolibrary-webserver.service.d/10-gitea-release.conf
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl enable autolibrary-webserver.service
|
||||
sudo visudo -f /etc/sudoers.d/autolibrary-deploy
|
||||
```
|
||||
|
||||
@@ -86,6 +89,7 @@ git push -u origin main
|
||||
## 排查和回滚
|
||||
|
||||
- 任务排队时，检查仓库 Actions 设置、Runner 在线状态和标签。
|
||||
- 重启或健康检查失败时，检查 Actions 日志和 `sudo journalctl -u autolibrary-webserver.service -n 100`。检查端口、共享配置、数据路径和权限。
|
||||
- 重启或健康检查失败时，检查 Actions 日志、`sudo journalctl -u autolibrary-webserver.service -n 100` 和 `/home/autolibrary/logs/errors.log`。检查端口、共享配置、数据路径和权限。
|
||||
- 网站发布检查覆盖首页和网站后端。排查账户或登录时，分别查看 `systemctl status autolibrary-casdoor.service` 和 `curl -fsS http://127.0.0.1:8000/.well-known/openid-configuration`。
|
||||
- 发生业务回归时，用 `git revert` 后推送 `main` 重新构建上一份可用代码。紧急切回已有目录时，先确保 Runner 没有在部署，再按 [Ubuntu 部署说明](migration-to-ubuntu.md#回滚) 切换 `current`。清理历史发布目录前确认其未被 `current` 使用，并至少保留一个可用的上一版。
|
||||
- 自动回滚切换的是程序和静态文件。涉及数据库结构变化时，上线前备份共享数据，并确认旧版本兼容变更后的结构。
|
||||
Reference in new issue
Block a user