96 lines
6.7 KiB
Markdown
96 lines
6.7 KiB
Markdown
# 通过 Gitea Actions 部署原生网站服务
|
|
|
|
本页用于手动触发原生网站发布。推送触发的镜像构建见 [容器部署说明](container-deployment.md)。在 Gitea Actions 手动运行 `Deploy native AutoLibrary service` 时，任务由具备 `autolibrary-native-deploy` 标签的宿主机 Runner 接收。每次发布生成独立目录，原子切换 `current`，重启 systemd 服务并检查首页和 `/api/health`。检查失败时自动切回上一发布，并将本次任务标记为失败。
|
|
|
|
## 1. 准备 Ubuntu 部署机
|
|
|
|
安装 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 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 0751 /opt/autolibrary/shared
|
|
sudo ln -s /home/autolibrary/logs /opt/autolibrary/shared/logs
|
|
```
|
|
|
|
现网的基础 unit 为 `autolibrary-webserver.service`，运行账号为 `autolibrary`，原程序和配置位于 `/home/autolibrary`。按 [Ubuntu 部署说明](migration-to-ubuntu.md) 备份后，将原配置复制到 `/opt/autolibrary/shared/config.json`，设为 `root:autolibrary`、权限 `0640`。调整副本中的路径：
|
|
|
|
- 将三个 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` 时，确认链接指向可用的上一版并由部署账号拥有。
|
|
|
|
```sh
|
|
sudo -u autolibrary-deploy ln -s /home/autolibrary /opt/autolibrary/current
|
|
```
|
|
|
|
## 2. 安装网站服务和 Runner
|
|
|
|
在现有网站 unit 上安装 drop-in，只调整工作目录和启动命令。原 unit 继续提供运行账号、重启策略和 `/home/autolibrary/logs/errors.log` 的 stderr 设置。新服务器可先按 [Ubuntu 部署说明](migration-to-ubuntu.md#4-systemd) 安装基础 unit。已有站点执行 `daemon-reload` 后，覆盖配置会在下一次网站服务启动时生效。
|
|
|
|
```sh
|
|
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 visudo -f /etc/sudoers.d/autolibrary-deploy
|
|
```
|
|
|
|
加入以下精确授权，使 Runner 可以操作网站 unit。
|
|
|
|
```sudoers
|
|
autolibrary-deploy ALL=(root) NOPASSWD: /usr/bin/systemctl restart autolibrary-webserver.service, /usr/bin/systemctl stop autolibrary-webserver.service
|
|
```
|
|
|
|
在 Gitea 创建一个空的网站源码仓库，启用仓库的 Actions 功能并保护 `main`。使用该网站仓库的 Runner 注册令牌，在部署机安装 [Gitea Runner](https://docs.gitea.com/runner/)，然后以部署账号交互注册：
|
|
|
|
```sh
|
|
sudo -u autolibrary-deploy -H sh -c 'cd "$HOME" && gitea-runner register'
|
|
```
|
|
|
|
输入实例地址和仓库级令牌，使用独立的原生发布 Runner 名称，标签只填写 `autolibrary-native-deploy:host`。以同一账号和工作目录运行 `gitea-runner daemon`。可用下面的 systemd unit 持久运行，将 `ExecStart` 与 `PATH` 调整到实际安装位置。
|
|
|
|
```ini
|
|
[Unit]
|
|
Description=AutoLibrary Gitea Runner
|
|
Wants=network-online.target
|
|
After=network-online.target
|
|
|
|
[Service]
|
|
User=autolibrary-deploy
|
|
WorkingDirectory=/var/lib/autolibrary-runner
|
|
Environment=PATH=/usr/local/go/bin:/usr/local/bin:/usr/bin:/bin
|
|
ExecStart=/usr/local/bin/gitea-runner daemon
|
|
Restart=on-failure
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
```
|
|
|
|
例如保存为 `/etc/systemd/system/autolibrary-runner.service` 后，执行 `sudo systemctl daemon-reload` 和 `sudo systemctl enable --now autolibrary-runner.service`。旧版 Runner 的二进制名可能为 `act_runner`，按实际名称替换。确认仓库设置页中 Runner 在线，并且标签与工作流的 `runs-on` 一致。宿主机任务使用部署账号的权限直接运行，只将这个 Runner 分配给受信任的网站仓库。
|
|
|
|
## 3. 首次推送
|
|
|
|
在 Gitea 仓库的 Actions Variables 中将 `AUTOLIBRARY_PORT` 设为生产 `frontend.port`；省略时为 `3003`，若沿用通用示例配置则设置为 `3000`。
|
|
|
|
在本地网站源码目录绑定新建仓库的克隆地址并推送：
|
|
|
|
```sh
|
|
git remote add origin <Gitea 网站源码仓库的克隆地址>
|
|
git push -u origin main
|
|
```
|
|
|
|
在 Gitea 的 Actions 页手动运行 `Deploy native AutoLibrary service`，选择 `main`，然后确认部署任务完成。发布脚本在切换前读取远端 `main`，已过时的任务会跳过部署。生产密钥、数据库、上传目录和 Casdoor 实例数据由部署机保存。
|
|
|
|
## 排查和回滚
|
|
|
|
- 任务排队时，检查仓库 Actions 设置、Runner 在线状态和标签。
|
|
- 重启或健康检查失败时，检查 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` 使用，并至少保留一个可用的上一版。
|
|
- 自动回滚切换的是程序和静态文件。涉及数据库结构变化时，上线前备份共享数据，并确认旧版本兼容变更后的结构。
|