Files
Antigravity b11523a2d3
构建并推送 Docker 镜像 (AMD64 & ARM64) / build-and-push (push) Canceled after 0s
feat: 支持 arm64 与 amd64 双架构构建
- 在 Gitea Actions 中引入 QEMU 与 Docker Buildx
- 设置构建目标架构为 linux/amd64,linux/arm64
- 更新 README.md 多架构拉取说明
2026-10-22 15:23:34 +08:00

35 lines
1.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# TBox-Gateway Docker Image
本项目包含 `tbox-gateway` 基础运行环境的 Docker 镜像定义,并配置了 Gitea Actions 自动构建与发布流程。
## 镜像拉取与使用
推送代码到分支后,Gitea 会自动触发构建并推送到 Gitea 的 Container Registry。
### 1. 登录 Gitea 镜像仓库
```bash
docker login git.openlocalpdf.com -u <用户名> -p <密码或访问令牌>
```
### 2. 拉取镜像
```bash
docker pull git.openlocalpdf.com/gitea/tbox-gateway-docker:latest
```
也可以拉取指定版本标签(例如 `v1.0.0`):
```bash
docker pull git.openlocalpdf.com/gitea/tbox-gateway-docker:<tag>
```
---
## 自动化构建配置
CI 流程已配置在 [`.gitea/workflows/docker-build.yml`](.gitea/workflows/docker-build.yml):
- **多架构支持**:使用 Docker Buildx 与 QEMU 同时构建并输出 **`linux/amd64`** 和 **`linux/arm64`** 双版本镜像清单(Manifest List)。拉取时客户端将根据 CPU 架构自动选择对应镜像。
- 当代码推送至 `master` 或 `main` 分支时,自动触发构建并推送 `:latest` 镜像。
- 当推送版本标签(如 `v1.0.0`)时,自动构建并同时推送对应标签及 `:latest`。
- 构建所需环境需在 Gitea 中开启 Actions 并注册 `act_runner`(具备 Docker daemon 权限)。