feat(deploy): add clone-and-run docker installer

This commit is contained in:
姚章浩
2026-09-11 11:12:28 +08:00
parent bcb2f303ff
commit f533c385ea
5 changed files with 111 additions and 57 deletions
+4 -4
View File
@@ -81,7 +81,7 @@ DobotAI 是 WeKnora 的企业外部渠道集成层,负责钉钉协议、身份
| 方式 | 适用场景 | 入口 | 数据库与迁移 | 推荐程度 |
| --- | --- | --- | --- | --- |
| 源码/原生二进制 | 本地开发、快速调试、临时问题定位 | `go run ./cmd/dobotai` 或受控构建的二进制 | 操作人员准备独立PostgreSQL并显式执行迁移 | 仅开发 |
| Docker Compose | 测试、预发布、生产候选 | `deploy/dobotai-dingtalk/install-docker.sh` | 脚本创建`dobotai-postgres`和`dobotai-postgres-data`,并按序执行迁移 | 推荐 |
| Docker Compose | 测试、预发布、生产候选 | 仓库根目录`install-docker.sh` | 脚本构建镜像、创建`dobotai-postgres`和`dobotai-postgres-data`,并按序执行迁移 | 推荐 |
### 源码/原生部署
@@ -96,9 +96,9 @@ curl http://127.0.0.1:8090/healthz
### Docker Compose 部署
```bash
# 安装:自动准备目录、独立PostgreSQL、命名卷、env模板和迁移
sudo DOBOTAI_IMAGE=dobotai-dingtalk:test-<commit-short> \
bash deploy/dobotai-dingtalk/install-docker.sh
# 克隆后进入仓库根目录执行:自动安装Docker/Compose(如缺失)、构建镜像、
# 准备目录、独立PostgreSQL、命名卷、env模板和迁移。
sudo bash ./install-docker.sh
# 配置WeKnora和钉钉后自动启动应用
sudo dobotai-dingtalk-configure
+9 -28
View File
@@ -109,46 +109,27 @@ services:
## 4. 前置条件
```text
Docker Engine 和 Docker Compose 已安装
候选 DobotAI 镜像已 build 或 docker load 导入
部署用户具有 sudo 和 Docker daemon 访问权限
宿主机 WeKnora 已健康,容器可经 host.docker.internal:8080 访问
```
## 5. 构建或导入镜像
Docker与Docker Compose缺失时由根安装脚本自动安装(当前支持APT系统)。不必手工构建、导入或命名镜像。
在干净、已审查的源码目录构建:
## 5. 全新安装
从源码仓库克隆后,进入仓库根目录执行唯一安装入口:
```bash
docker build \
--build-arg VERSION=test-<commit-short> \
--build-arg COMMIT_SHA=<完整提交SHA> \
--build-arg BUILD_TIME=<UTC时间> \
-t dobotai-dingtalk:test-<commit-short> .
sudo bash ./install-docker.sh
```
跨主机传输时:
脚本内部以当前Git提交构建固定内部镜像名:
```bash
docker save -o dobotai-dingtalk.tar dobotai-dingtalk:test-<commit-short>
sha256sum dobotai-dingtalk.tar
# 目标服务器先核验SHA,再导入
docker load -i dobotai-dingtalk.tar
```text
dobotai-dingtalk:local-<当前Git短SHA>
```
生产必须使用已验证的同一归档或不可变摘要,禁止目标机重新构建。
## 6. 全新安装
在包含本目录部署资产的发布目录执行:
```bash
sudo DOBOTAI_IMAGE=dobotai-dingtalk:test-<commit-short> \
bash ./install-docker.sh
```
脚本完成后数据库和迁移已就绪,应用尚未启动。然后执行:
镜像名、PostgreSQL镜像和构建元数据只由根目录`install-docker.sh`维护,用户不传`DOBOTAI_IMAGE`。脚本完成后数据库和迁移已就绪,应用尚未启动。然后执行:
```bash
sudo dobotai-dingtalk-configure
+3 -2
View File
@@ -2,6 +2,7 @@
set -euo pipefail
script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source_root="${DOBOTAI_SOURCE_ROOT:-$(cd "$script_dir/../.." && pwd)}"
home="${DOBOTAI_HOME:-/opt/dobotai}"
container_dir="$home/container"
config_dir="$home/config"
@@ -31,8 +32,8 @@ install -m 0750 "$script_dir/dobotai-dingtalk-start" "$container_dir/dobotai-din
install -m 0750 "$script_dir/dobotai-dingtalk-bind-admin" "$container_dir/dobotai-dingtalk-bind-admin"
install -m 0750 "$script_dir/apply-migrations.sh" "$container_dir/apply-migrations.sh"
install -m 0750 "$script_dir/migrate-existing-database.sh" "$container_dir/migrate-existing-database.sh"
install -m 0644 "$script_dir"/../../db/migrations/*.up.sql "$container_dir/migrations/"
install -m 0644 "$script_dir"/../../db/migrations/*.down.sql "$container_dir/migrations/"
install -m 0644 "$source_root"/db/migrations/*.up.sql "$container_dir/migrations/"
install -m 0644 "$source_root"/db/migrations/*.down.sql "$container_dir/migrations/"
if [[ ! -f "$postgres_env" || ! -f "$app_env" ]]; then
umask 077
+66
View File
@@ -0,0 +1,66 @@
#!/usr/bin/env bash
set -euo pipefail
# 唯一安装入口:镜像仓库名与标签策略只在本脚本维护。
postgres_image="postgres:16-alpine"
if [[ ${EUID} -ne 0 ]]; then
echo "请在克隆仓库根目录执行:sudo bash ./install-docker.sh" >&2
exit 1
fi
repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
cd "$repo_root"
[[ -f Dockerfile && -f deploy/dobotai-dingtalk/install-docker.sh ]] || {
echo "安装脚本必须从完整DobotAI源码仓库根目录运行。" >&2
exit 1
}
command -v git >/dev/null || { echo "未找到 git,无法确定当前源码版本。" >&2; exit 1; }
git -C "$repo_root" rev-parse --is-inside-work-tree >/dev/null || {
echo "请从 git clone 得到的仓库中执行本脚本。" >&2
exit 1
}
install_docker_if_missing() {
if command -v docker >/dev/null && docker compose version >/dev/null 2>&1; then
return
fi
command -v apt-get >/dev/null || {
echo "本脚本仅自动安装基于 apt 的 Docker;请先安装 Docker Engine 和 Docker Compose v2。" >&2
exit 1
}
export DEBIAN_FRONTEND=noninteractive
apt-get update
if apt-cache show docker-compose-v2 >/dev/null 2>&1; then
apt-get install -y docker.io docker-compose-v2
elif apt-cache show docker-compose-plugin >/dev/null 2>&1; then
apt-get install -y docker.io docker-compose-plugin
else
echo "当前APT源没有 Docker Compose v2 插件,无法安全继续。" >&2
exit 1
fi
systemctl enable --now docker
docker compose version >/dev/null
}
install_docker_if_missing
commit_sha="$(git -C "$repo_root" rev-parse HEAD)"
commit_short="$(git -C "$repo_root" rev-parse --short=12 HEAD)"
build_time="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
image="dobotai-dingtalk:local-${commit_short}"
echo "[1/3] 构建 DobotAI 镜像:$image"
docker build \
--build-arg "VERSION=local-${commit_short}" \
--build-arg "COMMIT_SHA=${commit_sha}" \
--build-arg "BUILD_TIME=${build_time}" \
--label "org.opencontainers.image.revision=${commit_sha}" \
--tag "$image" \
"$repo_root"
echo "[2/3] 准备独立PostgreSQL、目录、配置文件和迁移"
export DOBOTAI_IMAGE="$image"
export DOBOTAI_POSTGRES_IMAGE="$postgres_image"
export DOBOTAI_SOURCE_ROOT="$repo_root"
exec bash "$repo_root/deploy/dobotai-dingtalk/install-docker.sh"
+29 -23
View File
@@ -34,10 +34,7 @@ func TestDobotAIDingTalkComposeOwnsApplicationAndPostgres(t *testing.T) {
if err != nil {
t.Fatal(err)
}
for _, required := range []string{
"configure_env.py",
"dobotai-dingtalk-start",
} {
for _, required := range []string{"configure_env.py", "dobotai-dingtalk-start"} {
if !strings.Contains(string(configure), required) {
t.Errorf("configure command missing %q", required)
}
@@ -47,10 +44,7 @@ func TestDobotAIDingTalkComposeOwnsApplicationAndPostgres(t *testing.T) {
if err != nil {
t.Fatal(err)
}
for _, required := range []string{
"docker exec -it dobotai-dingtalk",
"/usr/local/bin/dobotai bootstrap-admin",
} {
for _, required := range []string{"docker exec -it dobotai-dingtalk", "/usr/local/bin/dobotai bootstrap-admin"} {
if !strings.Contains(string(bind), required) {
t.Errorf("bind command missing %q", required)
}
@@ -133,15 +127,8 @@ func TestDobotAIDingTalkDockerInstallerPreparesDirectoriesDatabaseAndMigrations(
}
source := string(data)
for _, required := range []string{
"container",
"secrets",
"backups",
"migrations",
"postgres.env",
"dobotai-postgres",
"apply-migrations.sh",
"docker compose",
"umask 077",
"container", "secrets", "backups", "migrations", "postgres.env",
"dobotai-postgres", "apply-migrations.sh", "docker compose", "umask 077",
} {
if !strings.Contains(source, required) {
t.Errorf("docker installer missing %q", required)
@@ -159,15 +146,34 @@ func TestDobotAIDingTalkExistingDatabaseMigrationHasBackupAndRollbackBoundary(t
}
source := string(data)
for _, required := range []string{
"pg_dump -Fc",
"pg_restore --list",
"dobotai-postgres-data",
"dobotai-dingtalk",
"rollback",
"apply-migrations.sh",
"pg_dump -Fc", "pg_restore --list", "dobotai-postgres-data",
"dobotai-dingtalk", "rollback", "apply-migrations.sh",
} {
if !strings.Contains(source, required) {
t.Errorf("database adoption script missing %q", required)
}
}
}
func TestRootDockerInstallerIsCloneAndRunEntryPoint(t *testing.T) {
data, err := os.ReadFile("../install-docker.sh")
if err != nil {
t.Fatal(err)
}
source := string(data)
for _, required := range []string{
"docker build",
"dobotai-dingtalk:local-",
"install_docker_if_missing",
"docker compose version",
"DOBOTAI_SOURCE_ROOT",
"deploy/dobotai-dingtalk/install-docker.sh",
} {
if !strings.Contains(source, required) {
t.Errorf("root installer missing %q", required)
}
}
if strings.Contains(source, "${DOBOTAI_IMAGE") || strings.Contains(source, "DOBOTAI_IMAGE=?") {
t.Fatal("root installer must not require an operator supplied DOBOTAI_IMAGE")
}
}