The ci repository stores configuration files, libraries and custom GHA actions
that are used in the Keep/tBTC Continous Integration process. It also contains
the GitHub Actions workflow (Main) that acts as an entry point for
inter-module builds.
Non-confidential, environment/network-specific variables used in some of the
GitHub Actions workflows across keep-network repositories are stored in the
*.env files under config/env. The keep-network/load-env-variables GH
Action can be used to retrieve the data and load it to the workflow runner's
context. Learn more from the Actions'
README.
The Main workflow (accessible via Actions tab) acts as a single entry point
for inter-module builds. Triggering this workflow via a workflow_dispatch event
will start the chain of automatic executions of the workflows which
build/publish Keep/tBTC modules, according to the order specified in the
config/config.json file. Properly configured order allows the system to
execute the downstream builds only after the upstream dependencies are built and
published.
To trigger the Main workflow, one needs to provide the following four inputs:
| Label | Name | Required? | Default value | Meaning |
|---|---|---|---|---|
| Use workflow from | Yes | Branch: master |
Specifies which version of the Main‘s workflow config file will be used. |
|
| The environment to run the build for | environment |
No | ropsten |
Specified value will be passed between downstream builds and used for package versioning and dependency management (the provided string will be part of a package's version name). |
| Upstream builds | upstream_builds |
No | <empty> | A list of upstream builds that should be used for the building of downstream modules. |
| Ref | upstream_ref |
No | master |
Specifies the branch on which the modules will be built. |
Learn more about the deployment process and the meaning of the workflow inputs by visiting Coda.
The repository stores a couple of custom GitHub Actions which are used in the
Keep/tBTC Continous Integration process. The actions' code is kept in the
actions directory. Currently, following actions are stored (you can learn more
about them by reading their READMEs):
Part of the code stored in the ci repository is used as a dependency in the
actions stored in that repository. If this ci code gets modified, the code of
the actions referencing it needs to be rebuilt in order for the changes to take
effect.
Code that is referenced by some of the actions:
config/**(excludingconfig/env/**)lib/**
Actions requiring rebuild after changes in above files:
Refer to the READMEs of those actions for more information about rebuilding the code.
The following tools can be used to monitor state of the code and deployments:
- AllTheKeeps for Ropsten
- Keep Clients Summary
- Meercode Dashboards with GitHub Actions results: