notnoopci/golang

CircleCI Go (golang) 镜像文档

镜像概述和主要用途

CircleCI Go镜像基于Docker官方Go镜像扩展，旨在为开发和持续集成(CI)场景提供更完善的工具支持。官方镜像虽适用于通用场景，但缺乏CI/开发中常用的工具和配置。本镜像通过补充必要工具、提供场景化变体及默认非root用户配置，简化Docker和CircleCI在Go项目中的应用。

核心功能和特性

1. 丰富工具集：预装CI/开发常用工具，包括git、ssh、tar、ca-certificates、curl、wget等，满足日常开发和构建需求。

2. 场景化变体：提供针对特定场景的镜像变体，如包含浏览器（Firefox、Chrome及chromedriver）的版本，便于浏览器测试。

3. 非root用户默认配置：默认使用circleci用户运行，避免部分应用（如Chrome）拒绝以root用户运行的问题，同时规避root用户下工具行为差异（如tar文件所有权问题）。

使用场景和适用范围

• 日常Go开发：作为本地开发环境，提供完整工具链。
• CI流程集成：在CircleCI或其他CI平台中用于Go项目的构建、测试和部署。
• 浏览器测试：通过带浏览器的变体，支持Go项目中的前端/UI自动化测试。

主要变体说明

golang:<version>

基础镜像，适用于大多数通用场景。若对需求不明确，建议优先使用此版本，包含核心工具集。

golang:<version>-browsers

扩展基础镜像，预装Firefox、Chrome及chromedriver，并配置为容器环境中可运行，专门优化浏览器测试场景。

使用方法

基础镜像使用示例

可直接基于此镜像构建自定义Dockerfile，或在CI配置中引用：

dockerfile
# 示例Dockerfile
FROM cimg/golang:<version>

# 项目构建步骤
WORKDIR /app
COPY . .
RUN go build -o myapp
CMD ["./myapp"]

浏览器测试镜像使用示例

在需要浏览器测试的场景中引用带浏览器的变体：

yaml
# CircleCI配置示例 (.circleci/config.yml)
version: 2.1
jobs:
  test:
    docker:
      - image: cimg/golang:<version>-browsers
    steps:
      - checkout
      - run: go test ./... # 执行包含浏览器测试的Go测试

用户反馈

问题反馈

如在使用镜像过程中遇到问题或有疑问，请通过CircleCI Discuss Forum联系我们。