infra-nimbus/ansible/roles/beacon-node-builds/README.md

38 lines
1.5 KiB
Markdown

# Description
This role configures a set of Systemd timers that build configured branches of [nimbus-eth2]() and push the built docker images.
# Configuration
The minimal configuration would look something like:
```yaml
# Branch to build and frequency
beacon_node_builds_branches:
- name: 'xyz'
branch: 'feature/xyz'
targets: ['nimbus_beacon_node_spec_0_12_3', 'nimbus_signing_process']
frequency: '*-*-* 02:00:00'
# Required to push Docker images
beacon_node_builds_docker_hub_user: 'docker-hub-user'
beacon_node_builds_docker_hub_token: 'super-secret-password'
```
# Management
You can check the status of the timers using:
```
> sudo systemctl list-timers 'beacon-node-build-*'
NEXT LEFT LAST PASSED UNIT ACTIVATES
Tue 2020-11-10 18:00:00 UTC 2h 3min left Mon 2020-11-09 18:00:03 UTC 21h ago beacon-node-build-libp2p.timer beacon-node-build-libp2p.service
Tue 2020-11-10 20:00:00 UTC 4h 3min left n/a n/a beacon-node-build-toledo.timer beacon-node-build-toledo.service
Wed 2020-11-11 02:00:00 UTC 10h left Tue 2020-11-10 02:00:03 UTC 13h ago beacon-node-build-master.timer beacon-node-build-master.service
Wed 2020-11-11 10:00:00 UTC 18h left Tue 2020-11-10 10:00:03 UTC 5h 56min ago beacon-node-build-devel.timer beacon-node-build-devel.service
4 timers listed.
```
You can start a job without having to wait for it with:
```
sudo systemctl --no-block start beacon-node-build-master
```