feat: 支持 arm64 与 amd64 双架构构建
构建并推送 Docker 镜像 (AMD64 & ARM64) / build-and-push (push) Canceled after 0s

- 在 Gitea Actions 中引入 QEMU 与 Docker Buildx
- 设置构建目标架构为 linux/amd64,linux/arm64
- 更新 README.md 多架构拉取说明
This commit is contained in:
Antigravity committed 2026-10-22 15:23:34 +08:00
1 parent fca87a1abc
commit b11523a2d3
2 files changed
+22 -11

No files matched your search

+21 -11
View File
@@ -1,4 +1,4 @@
name: 构建并推送 Docker 镜像
name: 构建并推送 Docker 镜像 (AMD64 & ARM64)
on:
push:
@@ -16,6 +16,14 @@ jobs:
- name: 检出源码
uses: actions/checkout@v4
- name: 设置 QEMU 跨架构仿真 (支持 ARM64 与 AMD64)
uses: docker/setup-qemu-action@v3
with:
platforms: linux/amd64,linux/arm64
- name: 设置 Docker Buildx 构建器
uses: docker/setup-buildx-action@v3
- name: 登录 Gitea 镜像仓库 (Container Registry)
run: |
# 提取 Gitea 主机名及端口 (去除协议头)
@@ -23,21 +31,23 @@ jobs:
echo "登录镜像仓库: ${REGISTRY_HOST}"
echo "${{ secrets.GITHUB_TOKEN }}" | docker login "${REGISTRY_HOST}" -u "${{ gitea.actor }}" --password-stdin
- name: 构建并推送 Docker 镜像
- name: 构建并推送多架构镜像 (linux/amd64, linux/arm64)
run: |
REGISTRY_HOST=$(echo "${{ gitea.server_url }}" | sed -e 's|^[^/]*//||' -e 's|/.*$||')
# 镜像名称在 Docker 中必须全部小写
IMAGE_REPO=$(echo "${REGISTRY_HOST}/${{ gitea.repository }}" | tr '[:upper:]' '[:lower:]')
# 判断当前是 Tag 还是分支提交
# 组装镜像标签
TAG_ARGS="-t ${IMAGE_REPO}:latest"
if [[ "${{ gitea.ref }}" =~ ^refs/tags/ ]]; then
VERSION_TAG="${{ gitea.ref_name }}"
docker build -t "${IMAGE_REPO}:${VERSION_TAG}" -t "${IMAGE_REPO}:latest" .
docker push "${IMAGE_REPO}:${VERSION_TAG}"
docker push "${IMAGE_REPO}:latest"
echo "已推送标签: ${IMAGE_REPO}:${VERSION_TAG} 和 ${IMAGE_REPO}:latest"
else
docker build -t "${IMAGE_REPO}:latest" .
docker push "${IMAGE_REPO}:latest"
echo "已推送标签: ${IMAGE_REPO}:latest"
TAG_ARGS="${TAG_ARGS} -t ${IMAGE_REPO}:${VERSION_TAG}"
fi
echo "开始使用 Buildx 构建多架构镜像 (linux/amd64, linux/arm64)..."
docker buildx build \
--platform linux/amd64,linux/arm64 \
${TAG_ARGS} \
--push \
.
echo "多架构镜像推送完成!"
+1
View File
@@ -28,6 +28,7 @@ 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 权限)。