go-ci

Tooling for linting, testing and building Go applications

Project home

See our GitHub repo for the latest content, to file an issue or submit improvements for review and potential inclusion into the project.

Docker images

See these container image registries for the full listing of available images:

Overview

A mix of GitHub Actions / CI focused Docker container images primarily intended to simplify linting/testing/building other Go projects that I maintain. I am developing the content in the open in case it is useful to others.

Linting tools included

The following linting tools are included in the go-ci-stable, go-ci-oldstable and go-ci-unstable images:

Linter	Version
`staticcheck`	`2023.1.7` (`v0.4.7`)
`golangci-lint`	`v1.58.1`
`govulncheck`	`v1.1.0`
`deadcode`	`v0.19.0`
`orijtech/httperroryzer`	`v0.0.1`
`orijtech/structslop`	`v0.0.8`
`orijtech/tickeryzer`	`v0.0.3`
`pelletier/go-toml`	`v2.2.2`
`fatih/errwrap`	`v1.6.0`

Build tools included

The following build tools are included in all *-build* images except for the *-mirror-* images:

Build tool	Version
`tc-hib/go-winres`	`v0.3.3`
`goreleaser/nfpm`	`v2.37.1`
`choffmeister/git-describe-semver`	`v0.4.0`

Testing tools included

The following testing tools are included in the go-ci-stable, go-ci-oldstable and go-ci-unstable images:

Testing tool	Version
`bitfield/gotestdox`	`v0.2.2`

Images

Matrix images

`go-ci-stable`

built from the latest version of the current stable golang image.
used for building and testing Go applications, both directly and via Makefile builds.
intended for use in a build/test matrix of prior, current and upcoming Go releases
✔️ provides multiple linters
✔️ provides testing tools
❌ does not include custom build tools

`go-ci-oldstable`

built from the latest version of the current outgoing stable golang image.
used for building and testing Go applications, both directly and via Makefile builds.
intended for use in a build/test matrix of prior, current and upcoming Go releases
✔️ provides multiple linters
✔️ provides testing tools
❌ does not include custom build tools

`go-ci-unstable`

built from the latest available non-stable golang:beta image, golang:rc image or if not recently available, the latest stable golang image
- intended to test whether new Go versions break existing code or surface problems in existing code that current Go releases do not
used for building and testing Go applications, both directly and via Makefile builds
intended for use in a build/test matrix of prior, current and upcoming Go releases
✔️ provides multiple linters
✔️ provides testing tools
❌ does not include custom build tools
used to test new or additional golangci-lint linters prior to inclusion in the stable and oldstable container image variants
- new linters as a whole may be added to multiple image variants, not just this image unless it is suspected that the new linters are highly experimental/unstable

General build images

`go-ci-oldstable-alpine-buildx86`

based on the latest version of the current outgoing stable i386/golang alpine image.
used for building and testing Go applications, both directly and via Makefile builds.
uses musl libc instead of glibc
- see Comparison of C/POSIX standard library implementations for Linux
supports cross-platform, cgo-enabled builds for Windows and Linux
- Windows 32-bit: i686-w64-mingw32-gcc
- Windows 64-bit: x86_64-w64-mingw32-gcc
✔️ provides multiple custom build tools
❌ does not include linters
❌ does not include testing tools

`go-ci-oldstable-alpine-buildx64`

same as go-ci-oldstable-alpine-buildx86, but specific to x64 architecture
✔️ provides multiple custom build tools
❌ does not include linters
❌ does not include testing tools

`go-ci-stable-alpine-buildx86`

based on the latest version of the current stable i386/golang alpine image.
used for building and testing Go applications, both directly and via Makefile builds.
uses musl libc instead of glibc
- see Comparison of C/POSIX standard library implementations for Linux
supports cross-platform, cgo-enabled builds for Windows and Linux
- Windows 32-bit: i686-w64-mingw32-gcc
- Windows 64-bit: x86_64-w64-mingw32-gcc
✔️ provides multiple custom build tools
❌ does not include linters
❌ does not include testing tools

`go-ci-stable-alpine-buildx64`

same as go-ci-stable-alpine-buildx86, but specific to x64 architecture
✔️ provides multiple custom build tools
❌ does not include linters
❌ does not include testing tools

`go-ci-unstable-alpine-buildx86`

built from the latest available non-stable (beta, rc or if not available the latest stable) version of the i386/golang alpine image.
used for building and testing Go applications, both directly and via Makefile builds.
uses musl libc instead of glibc
- see Comparison of C/POSIX standard library implementations for Linux
supports cross-platform, cgo-enabled builds for Windows and Linux
- Windows 32-bit: i686-w64-mingw32-gcc
- Windows 64-bit: x86_64-w64-mingw32-gcc
✔️ provides multiple custom build tools
❌ does not include linters
❌ does not include testing tools

`go-ci-unstable-alpine-buildx64`

same as go-ci-unstable-alpine-buildx86, but specific to x64 architecture
✔️ provides multiple custom build tools
❌ does not include linters
❌ does not include testing tools

`go-ci-oldstable-cgo-mingw-w64-buildx86`

built from the latest version of the current outgoing stable i386/golang image
used for building and testing Go applications, both directly and via Makefile builds.
supports cross-platform, cgo-enabled builds for Windows and Linux
- Windows 32-bit: i686-w64-mingw32-gcc
- Windows 64-bit: x86_64-w64-mingw32-gcc
✔️ provides Fyne toolkit build dependencies
✔️ provides multiple custom build tools
❌ does not include linters
❌ does not include testing tools

`go-ci-oldstable-cgo-mingw-w64-buildx64`

same as go-ci-oldstable-cgo-mingw-w64-buildx86, but specific to x64 architecture
✔️ provides multiple custom build tools
✔️ provides Fyne toolkit build dependencies
❌ does not include linters
❌ does not include testing tools

`go-ci-stable-cgo-mingw-w64-buildx86`

built from the latest version of the current stable i386/golang image
used for building and testing Go applications, both directly and via Makefile builds.
supports cross-platform, cgo-enabled builds for Windows and Linux
- Windows 32-bit: i686-w64-mingw32-gcc
- Windows 64-bit: x86_64-w64-mingw32-gcc
✔️ provides multiple custom build tools
✔️ provides Fyne toolkit build dependencies
❌ does not include linters
❌ does not include testing tools

`go-ci-stable-cgo-mingw-w64-buildx64`

same as go-ci-stable-cgo-mingw-w64-buildx86, but specific to x64 architecture
✔️ provides multiple custom build tools
✔️ provides Fyne toolkit build dependencies
❌ does not include linters
❌ does not include testing tools

`go-ci-unstable-cgo-mingw-w64-buildx86`

built from the latest available non-stable (beta, rc or if not available the latest stable) golang image.
used for building and testing Go applications, both directly and via Makefile builds.
supports cross-platform, cgo-enabled builds for Windows and Linux
- Windows 32-bit: i686-w64-mingw32-gcc
- Windows 64-bit: x86_64-w64-mingw32-gcc
✔️ provides multiple custom build tools
✔️ provides Fyne toolkit build dependencies
❌ does not include linters
❌ does not include testing tools

`go-ci-unstable-cgo-mingw-w64-buildx64`

same as go-ci-unstable-cgo-mingw-w64-buildx86, but specific to x64 architecture
✔️ provides multiple custom build tools
✔️ provides Fyne toolkit build dependencies
❌ does not include linters
❌ does not include testing tools

Mirror build images

`go-ci-mirror-build-*`

built from the latest version of the golang image for that series
- e.g., the go-ci-mirror-build-go1.14 image is built from the final release version in the 1.14 series (1.14.15)
intended to mirror the upstream golang image for Makefile-driven testing, linting and build tasks.
few (if any) customizations are intended for this image, instead relying on a project's Makefile or other build tool to setup the environment for tasks such as testing, linting & building source code
❌ does not include linters
❌ does not include testing tools
❌ does not include custom build tools

These images are intended to assist with asserting that projects build with the latest version in a specific series.

`go-ci-oldstable-mirror-build`

Unlike most other images, the go-ci-oldstable-mirror-build name is not the title of an image (such as go-ci-stable), but rather an additional tag for the latest version of the golang image for the oldstable series.

built from the latest version of the golang image for the oldstable series
- e.g., if the latest oldstable version of the Go toolchain is 1.19.6 and 1.20.1 is the latest in the stable series, the go-ci-oldstable-mirror-build image will refer to the 1.19.6 image
intended to mirror the latest oldstable (outgoing) upstream golang image for Makefile-driven testing, linting and build tasks.
few (if any) customizations are intended for this image, instead relying on a project's Makefile or other build tool to setup the environment for tasks such as testing, linting & building source code
❌ does not include linters
❌ does not include testing tools
❌ does not include custom build tools

These images are intended to assist with asserting that projects build with the latest version in the outgoing stable (aka, oldstable) series.

`go-ci-stable-mirror-build`

Unlike most other images, the go-ci-stable-mirror-build name is not the title of an image (such as go-ci-stable), but rather an additional tag for the latest version of the golang image for the stable series.

built from the latest version of the golang image for the current stable series
- e.g., if the latest oldstable version of the Go toolchain is 1.19.6 and 1.20.1 is the latest in the stable series, the go-ci-stable-mirror-build image tag will refer to the 1.20.1 image
intended to mirror the latest stable (current) upstream golang image for Makefile-driven testing, linting and build tasks.
few (if any) customizations are intended for this image, instead relying on a project's Makefile or other build tool to setup the environment for tasks such as testing, linting & building source code
❌ does not include linters
❌ does not include testing tools
❌ does not include custom build tools

These images are intended to assist with asserting that projects build with the latest version in the current stable series.

Release build images

`go-ci-stable-build`

built from the latest version of the current stable golang image.
used for building dev and stable releases of Go code
✔️ provides multiple custom build tools
❌ does not include linters
❌ does not include testing tools

`go-ci-oldstable-build`

built from the latest version of the current outgoing stable golang image.
used for building dev and stable releases of Go code
✔️ provides multiple custom build tools
❌ does not include linters
❌ does not include testing tools

`go-ci-unstable-build`

built from the latest available non-stable golang:beta image, golang:rc image or if not recently available, the latest stable golang image
- intended to test whether new Go versions break existing code or surface problems in existing code that current Go releases do not
used for building dev and stable releases of Go code
✔️ provides multiple custom build tools
❌ does not include linters
❌ does not include testing tools

Examples / How to use these images

For real-world examples of how these images are used, please see the workflows for these projects:

Changelog

See the CHANGELOG.md file for the changes associated with each release of this application. Changes that have been merged to master, but not yet an official release may also be noted in the file under the Unreleased section. A helpful link to the Git commit history since the last official release is also provided for further review.

Requirements

Docker
- for building images
make
- if using the provided Makefile
Sufficient disk space to hold build images
- 20+ GB free disk space recommended if building all images
- 10+ GB free disk space recommended if building one set of images

Name		Name	Last commit message	Last commit date
Latest commit History 2,394 Commits
.github		.github
mirror		mirror
oldstable		oldstable
stable		stable
tools		tools
unstable		unstable
.gitignore		.gitignore
.markdownlint.yml		.markdownlint.yml
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md

License

atc0005/go-ci

Folders and files

Latest commit

History

Repository files navigation

go-ci

Table of contents

Project home

Docker images

Overview

Linting tools included

Build tools included

Testing tools included

Images

Matrix images

go-ci-stable

go-ci-oldstable

go-ci-unstable

General build images

go-ci-oldstable-alpine-buildx86

go-ci-oldstable-alpine-buildx64

go-ci-stable-alpine-buildx86

go-ci-stable-alpine-buildx64

go-ci-unstable-alpine-buildx86

go-ci-unstable-alpine-buildx64

go-ci-oldstable-cgo-mingw-w64-buildx86

go-ci-oldstable-cgo-mingw-w64-buildx64

go-ci-stable-cgo-mingw-w64-buildx86

go-ci-stable-cgo-mingw-w64-buildx64

go-ci-unstable-cgo-mingw-w64-buildx86

go-ci-unstable-cgo-mingw-w64-buildx64

Mirror build images

go-ci-mirror-build-*

go-ci-oldstable-mirror-build

go-ci-stable-mirror-build