gittools/build-images

gittools/build-images

镜像概述

gittools/build-images 是用于测试 GitVersion 工具的辅助 Docker 镜像，旨在支持不同 Linux 发行版和硬件架构下的兼容性测试。该镜像基于 https://hub.docker.com/repository/docker/gittools/deps 基础镜像构建，预安装了 .NET 运行时（runtime）或 SDK（sdk），提供两种功能变体以满足不同测试需求。

核心功能与特性

• 基于可靠基础镜像：依赖 https://hub.docker.com/repository/docker/gittools/deps 基础镜像，确保底层环境一致性和稳定性。
• 两种功能变体：
  • sdk 变体：预安装 .NET SDK，用于测试 .NET 工具包 GitVersion.Tool 的功能正确性。
  • runtime 变体：预安装 .NET 运行时，用于打包 GitVersion.Tool 以适应部署场景。
• 多架构支持：大部分标签同时提供 arm64 和 amd64 架构支持，满足跨平台兼容性测试需求。
• 清晰的标签命名：标签格式为 <发行版>.<版本>-<变体>-<.NET版本>（如 alpine.3.20-sdk-8.0），便于快速识别发行版、功能变体及 .NET 版本。

使用场景与适用范围

• GitVersion.Tool 开发测试：使用 sdk 变体在不同 Linux 发行版和架构下验证 GitVersion.Tool 的功能正确性，适用于开发阶段的兼容性测试。
• GitVersion.Tool 打包部署：使用 runtime 变体构建包含 GitVersion.Tool 的轻量级部署包，确保生产环境中运行时依赖的兼容性。
• 多架构兼容性验证：通过 arm64 和 amd64 架构的镜像，验证 GitVersion 工具在不同硬件架构（如 x86_64 服务器、ARM 开发板）下的运行表现。

使用方法与配置说明

标签选择

通用标签（自动匹配架构）

默认标签会根据宿主机架构自动拉取对应镜像（arm64 或 amd64），格式为：
<发行版>.<版本>-<变体>-<.NET版本>
示例：

sh
# 拉取 alpine 3.20 发行版、sdk 变体、.NET 8.0 的镜像（自动匹配架构）
docker run --rm gittools/build-images:alpine.3.20-sdk-8.0

架构特定标签

如需强制指定架构，可在标签后添加 -arm64 或 -amd64 后缀：

sh
# 拉取 arm64 架构镜像
docker run --rm gittools/build-images:alpine.3.20-sdk-8.0-arm64

# 拉取 amd64 架构镜像
docker run --rm gittools/build-images:alpine.3.20-sdk-8.0-amd64

变体选择建议

• 开发测试场景：选择 sdk 变体（如 alpine.3.20-sdk-8.0），用于源码编译、单元测试或集成测试。
• 打包部署场景：选择 runtime 变体（如 alpine.3.20-runtime-8.0），用于构建仅包含运行时依赖的轻量级部署镜像。

相关链接

• 基础镜像地址：https://hub.docker.com/repository/docker/gittools/deps
• 镜像源码仓库：https://github.com/GitTools/build-images/tree/main/src/linux
• GitVersion.Tool NuGet 包：GitVersion.Tool