Files
xxxigcc-proxy/llmdoc/guides/how-to-build-docker-images.md
Wang Defa 9afe4a8649
All checks were successful
Build and Release / build-and-test (arm64, alpine) (push) Successful in -13s
Build and Release / build-and-test (amd64, alpine) (push) Successful in -6s
Build and Release / build-and-test (arm64, ubuntu) (push) Successful in -7s
Build and Release / build-and-test (amd64, ubuntu) (push) Successful in 7s
Build and Release / release (push) Successful in 21s
简化 Debian 发布流程并添加项目文档系统
- 将 Debian 包仓库从 bookworm/trixie 双发行版改为通用 stable 仓库
- 新增完整的 llmdoc 文档系统,包含架构、指南和参考文档
- 更新 README.md 和部署指南以反映新的仓库配置
- 添加 .gitignore 文件
2025-12-25 10:18:07 +08:00

55 lines
1.1 KiB
Markdown

# 如何构建 Docker 镜像
## 前提条件
1. 安装 Docker BuildX
2. 启用 Docker BuildKit
```bash
export DOCKER_BUILDKIT=1
export BUILDX_NO_DEFAULT_ATTESTATIONS=1
```
## 本地构建步骤
### 1. 创建 BuildX 实例
```bash
docker buildx create --name multiarch --driver docker-container
docker buildx use multiarch
docker buildx inspect --bootstrap
```
### 2. 构建多架构镜像
```bash
# 构建 Ubuntu 版本
docker buildx build \
--platform linux/amd64,linux/arm64 \
-f docker/Dockerfile.ubuntu \
-t xxxigcc-proxy:latest \
--push .
# 构建 Alpine 版本
docker buildx build \
--platform linux/amd64,linux/arm64 \
-f docker/Dockerfile.alpine \
-t xxxigcc-proxy:alpine \
--push .
```
## 添加新的架构/发行版
### 修改步骤
1. 更新 Dockerfile
2. 调整 `.gitea/workflows/ci.yaml`
3. 更新 `init.sh` 中的兼容性脚本
### 注意事项
- 确保所有依赖支持新架构
- 验证交叉编译兼容性
- 更新 CI/CD 矩阵配置
## 常见问题排查
### 构建失败
- 检查 BuildX 实例状态
- 验证依赖工具链
- 查看详细构建日志