Automates docker builds for ethereum clients. The build process is scheduled every hour to check source repositories for new commits.
Run the Build client workflow;
- Build Besu [source]
- Build Eleel [source]
- Build Erigon [source]
- Build EthereumJS [source]
- Build Geth [source]
- Build Lighthouse [source]
- Build Lodestar [source]
- Build Nethermind [source]
- Build Nimbus-Eth2 [source]
- Build Nimbus-Eth1 [source]
- Build Prysm [source]
- Build Reth [source]
- Build Teku [source]
- Build Grandine [source]
Run the Build tooling workflow;
- Build Flashbots Builder [source]
- Build tx-fuzz [source]
- Build consesnus-monitor [source]
- Build execution-monitor [source]
- Build beacon-metrics-gazer [source]
- Build goomy-blob [source]
- Build ethereum-genesis-generator [source]
- Build mev-rs[source]
Add a new image to config.yaml file and it will be built on schedule from this workflow.
- source:
repository: sigp/lighthouse # source repository to build from
ref: stable # source repository branch/tag/commit to build from
build_script: ./teku/build.sh # optional build script to run INSTEAD of the docker build & push (see below)
target:
tag: stable # tag to add to the docker image tag, this must be unique for each docker hub repository
repository: ethpandaops/lighthouse # dockerhub target to deploy the built image
dockerfile: ./lighthouse/Dockerfile # optional docker file to use, defaults to the source repository's DockerfileTake the following config;
- source:
repository: sigp/lighthouse
ref: stable
target:
tag: banana
repository: ethpandaops/lighthouseThis would produce the following docker image tags;
# the tag by itself to have the latest build
ethpandaops/lighthouse:banana
# the tag and the source repository's commit hash
ethpandaops/lighthouse:banana-abcd123The build_script is a bash script that is run INSTEAD of the docker build & push. This is useful for clients that have a custom build process.
When the build_script is set, you must build and push the docker image yourself! Docker will already be logged in to the target repository. You should try to use the target_tag and target_repository environment variables to tag your image.
The following environment variables are available to the build_script;
source_repository- source repository to build fromsource_ref- source repository branch/tag/commit to build fromtarget_tag- tag to add to the docker image tagtarget_repository- dockerhub target to deploy the built imagetarget_dockerfile- optional docker file to use, defaults to the source repository's Dockerfilesource_git_commit_hash- the source repository's commit hash
Example build_script file;
#!/bin/bash
# helper to get source directory
SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
cd ${SCRIPT_DIR}/../source
# do something here that requires this custom build script
# ...
# finally build with the tags from the dockerfile
docker build -t "${target_repository}:${target_tag}" -t "${target_repository}:${target_tag}-${source_git_commit_hash}" -f "../${target_dockerfile}" .
# push the image tags
docker push "${target_repository}:${target_tag}"
docker push "${target_repository}:${target_tag}-${source_git_commit_hash}"Our image building process utilizes two additional configuration files: platforms.yaml and runners.yaml. These files help in determining the platforms for which docker images should be built and specifying the runners to use for those platforms, respectively.
This configuration determines the platforms for which each client will have a Docker image built.
Sample Content:
besu:
- linux/amd64
lighthouse:
- linux/amd64
- linux/arm64In the example above, the client 'besu' and 'lighthouse' are both configured to have Docker images built for the linux/amd64 platform. While 'lighthouse' is also configured to have Docker images built for the linux/arm64 platform.
This configuration maps platforms to GitHub Action runners. It tells our workflow which runner should be used when building a Docker image for a specific platform.
Sample Content:
linux/amd64: ubuntu-latest
linux/arm64: self-hostedIn this example, the platform linux/amd64 will use the ubuntu-latest runner, while darwin/arm64 will use the self-hosted runner.
Requirements;
# make sure yamale is installed
pip install yamale
# yamale lint
yamale -s schema.yaml config.yaml
# check unique target tag, should return []
yq 'group_by(.target.repository + ":" + .target.tag) | map(select(length>1))' config.yaml
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent