GitHub Workflows

This repository contains reusable GitHub Actions workflows for Nethermind projects.

The workflows follow a simple name convention:

• technology-action-flavor.yaml

For example:

• docker-build-push-dockerhub.yaml. Docker is the technology, build-push is the action, dockerhub is the flavor.

Releases

You can use individual releases like v1.11.6 like so:

jobs:
  build:
    uses: NethermindEth/github-workflows/.github/workflows/docker-build-push-jfrog.yaml@v1.11.6

Alternatively, you can use the current stable release, which will get automatically updated as the maintainers decide to do so:

jobs:
  build:
    uses: NethermindEth/github-workflows/.github/workflows/docker-build-push-jfrog.yaml@stable

We do not recommend you track a branch like main.

Creating a new stable tag

The stable tag is a manual process, which must be decided after the version has been validated in at least a few repositories. To do so, simply:

Warning

The stable tag must be a lightweight tag. Annotated tags break nested reusable workflow resolution in GitHub Actions (see community discussion).

NEW_STABLE_VERSION=v9.8.7  # Replace with the new version
git tag -f --no-sign stable "$(git rev-parse $NEW_STABLE_VERSION^{})"
git push origin -f refs/tags/stable

Docker Image Workflows

Read about it in the examples/docker/README.md file.

License

Copyright (c) 2025 Nethermind - All rights reserved See LICENSE file for details.