wpengine/golang

golang

包含额外开发工具的Golang基础镜像，适用于Go项目的开发、测试和构建流程。

版本说明

本镜像采用以下标签方案进行版本控制，以支持现有应用：

wpengine/golang:<major-golang-version>-wpe<toolset-version>

其中，<major-golang-version> 为Go版本（例如 1.12），<toolset-version> 为整数，当捆绑工具发生非向后兼容修改时独立递增。此方案允许更新Golang主版本，同时保留工具依赖的版本控制。

使用方法

代码检查（Lint）

bash
docker run --rm \
  -v $(pwd):/go/src/${package_name} \
  -w /go/src/${package_name} \
  wpengine/golang \
  golangci-lint run --no-config --issues-exit-code=0 --disable-all --enable=vet --enable=golint --enable=gofmt

说明：将 ${package_name} 替换为实际项目包名，挂载当前目录至容器内项目路径，执行代码检查。

运行单元测试

bash
docker run --rm \
  -v $(pwd):/go/src/${package_name} \
  wpengine/golang \
  bash -c "gocov test ./... | gocov report"

说明：挂载当前目录至容器内项目路径，执行单元测试并生成覆盖率报告。

带覆盖率的单元测试

bash
mkdir -p ./artifacts/
docker run --rm --volume `pwd`/artifacts:/go/src/$(package_name)/artifacts wpengine/golang \
  bash -c "go test ./... -coverprofile=artifacts/coverage.out -v 2>&1 | tee artifacts/test-results.out"
docker run --rm --volume `pwd`/artifacts:/go/src/$(package_name)/artifacts wpengine/golang \
  bash -c "cat artifacts/test-results.out | go-junit-report -set-exit-code > artifacts/junit.xml"
docker run --rm --volume `pwd`/artifacts:/go/src/$(package_name)/artifacts wpengine/golang \
  bash -c "gocov convert ./artifacts/coverage.out | gocov-xml > ./artifacts/coverage.xml"

说明：创建 artifacts 目录存储测试结果，生成覆盖率文件、测试报告及JUnit格式报告。

安装依赖

bash
docker run --rm  \
  -v $(pwd):/go/src/${package_name} \
  -w /go/src/${package_name} \
  wpengine/golang \
  bash -c "git config --global url.'https://$(GITHUB_TOKEN):x-oauth-basic@github.com/'.insteadOf 'https://github.com/' \
  && go mod vendor"

说明：替换 ${package_name} 为项目包名，$(GITHUB_TOKEN) 为GitHub访问令牌，用于配置Git认证并安装依赖。

变更日志

此变更日志描述上述 <toolset-version> 的具体变更。

<version>-wpe0

该版本包含 protobuf-compiler 及以下Go工具：

github.com/golang/protobuf/proto
github.com/golang/protobuf/protoc-gen-go
google.golang.org/grpc
github.com/alecthomas/gometalinter
github.com/Masterminds/glide
github.com/golang/dep/cmd/dep
github.com/jstemmer/go-junit-report
github.com/axw/gocov/gocov
github.com/AlekSi/gocov-xml
github.com/golangci/golangci-lint/cmd/golangci-lint