构建并推送 Docker 镜像 (AMD64 & ARM64) / build-and-push (push) Canceled after 0s
- 在 Gitea Actions 中引入 QEMU 与 Docker Buildx - 设置构建目标架构为 linux/amd64,linux/arm64 - 更新 README.md 多架构拉取说明
35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
# 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 权限)。
|