# Cognio Docker 镜像构建脚本 - 海外服务器版本

本脚本用于在海外 Linux 服务器上构建并推送 Cognio 的多架构 Docker 镜像，无国内加速优化。

## 文件说明

| 文件 | 说明 |
|------|------|
| `buildDockerImage_apq2.bat` | Windows 批处理入口，调用 PowerShell 脚本 |
| `buildDockerImage_apq2.ps1` | 主脚本，包含所有构建逻辑 |

## 使用方法

### 基本用法

双击 `buildDockerImage_apq2.bat` 或在命令行执行：

```cmd
buildDockerImage_apq2.bat
```

### 命令行参数

```cmd
buildDockerImage_apq2.bat [用户名] [主机地址] [SSH端口]
```

### 镜像标签输入

运行后会提示输入镜像标签：

- **留空**: 仅推送 `latest` 标签
- **输入标签**: 如 `v1.0 beta`，将推送 `latest`、`v1.0`、`beta`
- **-l 参数**: 排除 `latest`，如 `-l v1.0` 仅推送 `v1.0`

## 处理流程

```
┌─────────────────────────────────────────────────────────────┐
│                      本地 Windows                           │
├─────────────────────────────────────────────────────────────┤
│  1. 读取配置（远程服务器、Git仓库、Docker镜像名）            │
│  2. 提示用户输入镜像标签                                     │
│  3. 生成远程执行的 Shell 脚本                                │
│  4. 将脚本转为 Base64 编码                                   │
│  5. 通过 SSH 发送到远程服务器的 tmux 会话                    │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼ SSH
┌─────────────────────────────────────────────────────────────┐
│                    远程 Linux 服务器                         │
├─────────────────────────────────────────────────────────────┤
│  6. 在 tmux 会话中解码 Base64 并写入 /tmp/build_cognio.sh   │
│  7. 执行构建脚本：                                           │
│     a. 克隆/更新 Git 仓库                                    │
│     b. 使用 docker buildx 构建多架构镜像                     │
│     c. 推送到 Docker Hub                                     │
└─────────────────────────────────────────────────────────────┘
```

## 配置项

脚本顶部的配置区可修改：

```powershell
# 远程服务器配置
$remoteUser = "root"
$remoteHost = "192.168.1.99"
$remotePort = "22"

# Git 仓库配置
$repoUrl = "http://ds:39418/AI/Cognio"
$repoDir = "Cognio"

# Docker 镜像配置
$imageName = "amwpfiqvy/cognio"

# tmux 会话名
$tmuxSession = "dbx"
```

## 查看构建进度

命令发送后，使用以下命令连接到远程 tmux 会话查看进度：

```bash
ssh -t -p 22 root@192.168.1.99 "tmux attach -t dbx"
```

## 构建产物

- **目标架构**: `linux/amd64`, `linux/arm64`
- **推送目标**: Docker Hub (`amwpfiqvy/cognio`)
- **缓存位置**: 远程服务器 `$HOME/.buildx-cache`

## 与国内版本的区别

此版本适用于海外服务器，不包含以下国内加速优化：

- Docker 镜像加速源
- APT 源加速（阿里云）
- PyPI 源加速（阿里云）
- Poetry 源加速

如需在国内服务器构建，请使用 `buildDockerImage_u24_docker.bat`。