Gitiles
Code Review Sign In
gerrit.lfbroadband.org / voltha-docker-tools / 33b1dfcb2a6663d8d30f9e5ce2c4a596824c0f2b
commit33b1dfcb2a6663d8d30f9e5ce2c4a596824c0f2b[log] [tgz]
authorEric Ball <eball@linuxfoundation.org>Tue Apr 14 15:04:37 2026 -0700
committerEric Ball <eball@linuxfoundation.org>Mon Jun 15 13:13:22 2026 -0700
tree2befa54955127aff2d534423fb60e79a1f6e4d71
parentecb6276d7e9e38ce5d9be2c3e6fcbba7249e9f67 [diff]
Add Github Actions verification workflow

This implements a shared workflow that will perform the license
check and unit tests previously handled in Jenkins.

Signed-off-by: Eric Ball <eball@linuxfoundation.org>
Change-Id: I138aee4ad25ddd4f3a3aaf0315ef27d279c915de
2 files changed
tree: 2befa54955127aff2d534423fb60e79a1f6e4d71
  1. .dockerignore
  2. .github/
  3. .gitreview
  4. Makefile
  5. README.md
  6. VERSION
  7. docker/
README.md

Dockerized Tools for Voltha

This repo contains Dockerfiles used to generate versioned tool containers.

Versioning

Final docker images are tagged with the image version from the VERSION file. This allows projects to specify a single "voltha toolchain version" and get all relevant tool versions.

The VERSION file should be changed using these rules:

  • Bump Patch version if:
    • Patch version of a tool has changed.
    • This repo's supporting files have changed (Makefile, readme, etc.) This rule assumes that the containers generated are backwards-compatible; if they are not, bump the major version instead.
  • Bump Minor version if:
    • Minor version of a tool has changed.
    • A new tool has been added.
  • Bump Major version if:
    • Major version of a tool has changed.
  • Bump patch/minor/major version according to semver rules if a Dockerfile is changed.
  • Reset lesser versions if greater versions change.
  • Do not use -dev versions.

Tool Usage

Only use containers tagged with <VERSION>-tool.
Do NOT use containers tagged with tool-<TOOL_VERSION>.

Some examples of how to use these containers:

  • golang - docker run --rm --user $(id -u):$(id -g) -v $PWD:/app -v gocache:/.cache -v gocache-${VOLTHA_TOOLS_VERSION}:/go/pkg voltha/voltha-ci-tools:${VOLTHA_TOOLS_VERSION}-golang go <args>
  • golangci-lint - docker run --rm --user $(id -u):$(id -g) -v $PWD:/app -v gocache:/.cache -v gocache-${VOLTHA_TOOLS_VERSION}:/go/pkg voltha/voltha-ci-tools:${VOLTHA_TOOLS_VERSION}-golangci-lint golangci-lint <args>
  • protoc - docker run --rm --user $(id -u):$(id -g) -v $PWD:/app voltha/voltha-ci-tools:${VOLTHA_TOOLS_VERSION}-protoc protoc <args>
  • hadolint - docker run --rm --user $(id -u):$(id -g) -v $PWD:/app voltha/voltha-ci-tools:${VOLTHA_TOOLS_VERSION}-hadolint hadolint <args>

Details:

  • --user is specified so that generated files have sane ownership and permissions.
  • -v bind-mounts the local folder into the container.
  • -v is also used by golang containers to bind-mount volumes for caches.

Key Commands

  • make build to build containers
  • make lint to lint the Dockerfiles
  • make docker-push to push built containers to a registry