accelbyte/golang-builder

AccelByte 基础构建镜像

1. 镜像概述和主要用途

AccelByte 基础构建镜像是AccelByte产品生态的官方基础Docker镜像，包含预安装的核心组件，主要用于Golang项目的构建流程，同时支持应用开发过程中的调试与故障排除。该镜像旨在简化构建环境配置，提供统一、高效的开发工具链，适用于AccelByte产品相关项目及通用Golang应用的构建需求。

2. 核心功能和特性

• Golang构建工具链集成：预安装Golang编译器、依赖管理工具（如go mod）及构建辅助工具，支持Golang项目的编译、打包及依赖解析。
• 调试与故障排除支持：内置常用调试工具，便于开发过程中的问题定位与代码调试。
• 生态兼容性：针对AccelByte产品生态优化，兼容相关项目的依赖环境与构建流程。
• 环境一致性：提供标准化构建环境，避免因本地环境差异导致的构建问题，适合团队协作与CI/CD集成。

3. 使用场景和适用范围

• Golang项目构建：适用于本地开发或CI/CD流水线中Golang应用的编译、打包。
• AccelByte产品开发：作为AccelByte产品生态的基础构建环境，支持相关应用的合规性构建。
• 统一开发环境：需要确保团队成员使用一致构建工具链的场景。
• 调试与问题定位：开发阶段中对Golang应用的运行时问题排查。

4. 使用方法和配置说明

4.1 镜像拉取

从Docker Hub拉取镜像（具体镜像名称及标签请参考https://hub.docker.com/r/accelbyte%EF%BC%89%EF%BC%9A

bash
docker pull docker.xuanyuan.run/accelbyte/<镜像名称>:<标签>

4.2 基本构建示例（docker run）

通过挂载本地项目目录，使用镜像执行Golang项目构建：

bash
# 假设本地项目目录为当前工作目录，构建输出可执行文件myapp
docker run --rm \
  -v $(pwd):/app \          # 挂载本地项目目录到容器内/app
  -w /app \                 # 设置容器工作目录为/app
  accelbyte/<镜像名称>:<标签> \  # 指定使用的AccelByte基础镜像
  go build -o myapp main.go  # 执行Golang构建命令

参数说明：

• --rm：容器退出后自动删除，避免残留临时容器。
• -v $(pwd):/app：将本地当前目录（项目根目录）挂载到容器内/app目录，实现代码文件共享。
• -w /app：设置容器工作目录为/app，确保构建命令在项目目录下执行。

4.3 调试场景示例

结合镜像中的调试工具（如dlv）进行应用调试：

bash
docker run --rm -it \
  -v $(pwd):/app \
  -w /app \
  --security-opt=seccomp:unconfined \  # 调试工具可能需要的安全选项
  accelbyte/<镜像名称>:<标签> \
  dlv debug main.go  # 使用dlv启动调试会话

4.4 配置说明

当前镜像无特殊环境变量或配置参数，构建行为主要通过挂载目录及执行自定义命令控制。如需自定义Golang环境（如代理、版本等），可在运行命令中附加环境变量，例如：

bash
docker run --rm \
  -e GOPROXY=https://goproxy.cn \  # 设置Golang模块代理
  -v $(pwd):/app \
  -w /app \
  accelbyte/<镜像名称>:<标签> \
  go build -o myapp main.go

5. 注意事项

• 请通过https://hub.docker.com/r/accelbyte%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E9%95%9C%E5%83%8F%E5%90%8D%E7%A7%B0%E3%80%81%E6%A0%87%E7%AD%BE%E5%8F%8A%E7%89%88%E6%9C%AC%E4%BF%A1%E6%81%AF%E3%80%82
• 构建大型项目时，建议配合Docker Volume或绑定挂载优化依赖缓存，提升构建效率。
• 调试场景下可能需要额外的容器权限（如--security-opt），具体取决于使用的调试工具要求。