# ARM64 部署说明

## ARM64 平台支持

本项目支持在 ARM64 (aarch64) 架构上部署，如树莓派、ARM开发板等设备。

## 预构建 ARM64 镜像

以下镜像可用于 ARM64 部署：

| 镜像 | 地址 | 说明 |
|------|------|------|
| ClawManager 主应用 | `ghcr.io/yuan-lab-llm/clawmanager:latest` | 官方多架构镜像，包含 ARM64 |
| Skill Scanner | `ghcr.io/yuan-lab-llm/skill-scanner:latest` | 官方镜像已支持 ARM64 |

### 使用预构建镜像

```bash
# 拉取ARM64镜像
docker pull ghcr.io/yuan-lab-llm/clawmanager:latest --platform linux/arm64
docker pull ghcr.io/yuan-lab-llm/skill-scanner:latest --platform linux/arm64
```

## 从源码构建 ARM64 镜像

### 后端静态编译

```bash
cd backend
CGO_ENABLED=0 go build -ldflags="-s -w -extldflags=-static" -o bin/clawreef-server ./cmd/server
```

### Docker 多平台构建

```bash
# 构建并推送多平台镜像
docker buildx build --platform linux/amd64,linux/arm64 -t ghcr.io/your-name/clawmanager:latest --push .
```

### skill-scanner ARM64 构建（可选）

`ghcr.io/yuan-lab-llm/skill-scanner:latest` 已支持 ARM64 平台。

如需自定义镜像，可从源码构建：

```bash
# 克隆仓库
git clone https://github.com/Yuan-lab-LLM/skill-scanner.git
cd skill-scanner

# 使用代理构建（国内网络需要）
export http_proxy="http://your-proxy:port"
export https_proxy="http://your-proxy:port"

# 构建并推送ARM64镜像
docker buildx build --platform linux/arm64 \
  -t ghcr.io/your-name/skill-scanner:latest \
  --push .
```

## Kubernetes ARM64 部署

### 修改镜像地址

在 `clawmanager.yaml` 中确认镜像地址支持 ARM64：

```yaml
# 主应用
image: ghcr.io/yuan-lab-llm/clawmanager:latest

# skill-scanner（如果需要）
image: ghcr.io/yuan-lab-llm/skill-scanner:latest
```

### 数据库初始化

首次部署需要手动创建数据库用户：

```bash
kubectl exec -it -n clawmanager-system mysql-xxx -- mysql -u root

# 在MySQL中执行
CREATE USER IF NOT EXISTS 'clawmanager'@'%' IDENTIFIED BY 'your-password';
GRANT ALL PRIVILEGES ON *.* TO 'clawmanager'@'%' WITH GRANT OPTION;
CREATE DATABASE IF NOT EXISTS clawmanager CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
FLUSH PRIVILEGES;
```

## 已知问题

### ClawManager 官方镜像支持 ARM64

- **状态**: `ghcr.io/yuan-lab-llm/clawmanager:latest` 发布为多架构镜像
- **支持平台**: `linux/amd64`、`linux/arm64`
- **部署方式**: ARM64 节点会自动拉取对应架构镜像，无需单独维护主应用镜像地址

### skill-scanner 官方镜像支持 ARM64

- **状态**: `ghcr.io/yuan-lab-llm/skill-scanner:latest` 已提供 ARM64 平台镜像
- **部署方式**: ARM64 节点会自动拉取对应架构镜像
- **建议**: 如需可复现部署，建议使用固定 tag 而非 `latest`

### ARM64 设备性能注意

- 建议设备内存 >= 4GB
- 建议使用 SSD 存储（项目数据目录 `/mnt/Storage1`）
- 建议配置 swap 以避免内存不足

## 测试环境

以下环境已验证可正常运行：

- **开发板**: S922X-Oes-Plus (Amlogic S922X)
- **系统**: Armbian OS 26.05.0 trixie
- **内核**: 6.12.80-ophub
- **内存**: 3.6GB RAM
- **存储**: 110GB SSD
- **集群**: k3s v1.34.6