Build and smoke-test AutoLibrary as a container

docs/container-deployment.md

@@ -0,0 +1,36 @@
+# 网站容器
+
+镜像在独立构建阶段编译 Vue 和启用 CGO 的 Go 程序。最终镜像运行单个 `webserver` 进程，同时提供静态资源和 API。容器配置、SQLite、上传文件和日志由部署机挂载。
+
+## 构建和验证
+
+需要 Linux Docker Engine 和 Buildx。在源码根目录运行：
+
+```sh
+docker build -t autolibrary-web:local .
+bash deploy/smoke-container.sh autolibrary-web:local
+```
+
+冒烟测试使用临时配置和空数据库，在无外部网络的容器里验证首页、后端健康检查、深层路由、静态资源、SQLite API 和 SIGTERM 退出。
+
+Gitea Actions 在 `main` 和 `container-ci` 推送时执行同一套镜像构建和冒烟测试。专用 Runner `hk-vps-runner-02` 使用 `linux-amd64-docker-small` 标签，作业在 Docker CLI 容器中运行。给构建作业提供专用 rootless Docker daemon，工作流会检查 daemon 的 rootless 标志。镜像仓库推送和生产切换需要单独接入。
+
+## 使用现网配置
+
+生产机运行 Compose v2。复制 `/home/autolibrary/config.json` 到独立文件，将 `frontend.static.path` 设置为 `./frontend/dist`。数据库路径使用 `./backend/data/` 下的现有相对路径。保留前端端口 `3003`、后端端口 `8080` 和 Casdoor 地址 `http://127.0.0.1:8000`。Compose 使用 Linux 宿主机网络，让 Nginx 和 Casdoor 继续通过原有地址连接。
+
+从部署机设置以下环境变量。镜像可以用提交 SHA 标签或不可变的镜像摘要引用：
+
+```dotenv
+AUTOLIBRARY_IMAGE=autolibrary-web:<提交SHA>
+AUTOLIBRARY_CONFIG=/绝对路径/网站容器配置.json
+AUTOLIBRARY_DATA_DIR=/home/autolibrary/backend/data
+AUTOLIBRARY_LOG_DIR=/home/autolibrary/logs
+AUTOLIBRARY_UID=996
+AUTOLIBRARY_GID=987
+AUTOLIBRARY_HTTP_PORT=3003
+```
+
+配置文件对容器运行身份可读，数据目录及日志目录可写。Compose 会检查挂载源是否存在。
+
+正式切换前，先用独立端口和数据库副本验证容器，并备份数据库和上传文件。切换时停止占用相同端口的 `autolibrary-webserver.service`，运行 `docker compose up -d --wait`，然后验证 Nginx 入口、登录及上传。若首次切换失败，停止网站容器，再启动原网站服务。后续发布可将 `AUTOLIBRARY_IMAGE` 指回上一个镜像，再运行 `docker compose up -d --wait`。程序回退继续使用同一份持久数据。

docs/gitea-deployment.md

@@ -1,6 +1,6 @@
-# 通过 Gitea Actions 部署官网
+# 通过 Gitea Actions 部署原生网站服务
 
-推送到网站仓库的 `main` 后，Gitea 把任务交给 Ubuntu 部署机上的专用 Runner。Runner 检出该次提交，使用锁文件安装前端依赖，执行前端构建、`go test ./...` 和启用 CGO 的 Go 编译。每次发布生成独立目录，原子切换 `current`，重启 systemd 服务并检查首页和 `/api/health`。检查失败时自动切回上一发布，并将本次任务标记为失败。
+本页用于手动触发原生网站发布。推送触发的镜像构建见 [容器部署说明](container-deployment.md)。在 Gitea Actions 手动运行 `Deploy native AutoLibrary service` 时，任务由具备 `autolibrary-native-deploy` 标签的宿主机 Runner 接收。每次发布生成独立目录，原子切换 `current`，重启 systemd 服务并检查首页和 `/api/health`。检查失败时自动切回上一发布，并将本次任务标记为失败。
 
 ## 1. 准备 Ubuntu 部署机
 
@@ -52,7 +52,7 @@ autolibrary-deploy ALL=(root) NOPASSWD: /usr/bin/systemctl restart autolibrary-w
 sudo -u autolibrary-deploy -H sh -c 'cd "$HOME" && gitea-runner register'
 ```
 
-输入实例地址和仓库级令牌，名称填写 `hk-vps-runner-02`，标签只填写 `linux-amd64-docker-small:host`。冒号前是工作流使用的调度标签，`:host` 使发布脚本能操作宿主机上的网站服务。以同一账号和工作目录运行 `gitea-runner daemon`。可用下面的 systemd unit 持久运行，将 `ExecStart` 与 `PATH` 调整到实际安装位置。
+输入实例地址和仓库级令牌，使用独立的原生发布 Runner 名称，标签只填写 `autolibrary-native-deploy:host`。以同一账号和工作目录运行 `gitea-runner daemon`。可用下面的 systemd unit 持久运行，将 `ExecStart` 与 `PATH` 调整到实际安装位置。
 
 ```ini
 [Unit]
@@ -84,7 +84,7 @@ git remote add origin <Gitea 网站源码仓库的克隆地址>
 git push -u origin main
 ```
 
-在 Gitea 的 Actions 页确认部署任务完成。之后日常发布只需推送 `main`。发布脚本在切换前读取远端 `main`，已过时的任务会跳过部署。生产密钥、数据库、上传目录和 Casdoor 实例数据由部署机保存。
+在 Gitea 的 Actions 页手动运行 `Deploy native AutoLibrary service`，选择 `main`，然后确认部署任务完成。发布脚本在切换前读取远端 `main`，已过时的任务会跳过部署。生产密钥、数据库、上传目录和 Casdoor 实例数据由部署机保存。
 
 ## 排查和回滚