Merge your first pull request
The last steps of the installation, protect the target branch, check that your CI runs on the tests of the queue, then submit a first pull request and follow it to the merge.
CIHub runs and the App is installed on your repositories. You do not create a queue: the first /cihub merge on a
pull request of the default branch creates it, with the default settings.
Protect the target branch
Two rulesets on the target branch make every merge go through the queue: one that restricts the updates, with the App in its bypass list in the mode Exempt, and one that holds the rules of a pull request. Turn off "Require branches to be up to date before merging". Protect the target branch gives each click.
Check that your CI runs on the tests
By default, each test of the queue opens a draft pull request: a workflow on pull_request runs on it without a
change, if it does not skip draft pull requests. The test waits for the required checks of the rules of the branch.
Run your CI on the tests of the queue covers GitHub Actions and the other CIs.
Submit a pull request
Choose a pull request of the default branch that is approved and whose checks pass, and comment:
/cihub mergeCIHub adds a 👍 reaction, then a comment that it keeps up to date, and the status CIHub Merge Queue (main):
🧪 Testing · position 2 in the queue for main
Tested on top of #118, #119 in #130.
Open in CIHub
▸ History (3)
/cihub restart to test again · /cihub cancel to leave the queue
The pull request merges when its test passes. If it waits, the comment says why: The life of a pull request in the queue.
Follow the queue
The link Open in CIHub of the comment opens the pull request in the dashboard, with its queue. From a terminal, the command line shows the same:
cihub auth login --hostname cihub.example.com # approve the code in the dashboard
cihub queue statusInstall the command line first.
In a CI, set CIHUB_HOST and CIHUB_TOKEN, with an API token of the
organization.
Next
Run CIHub on Kubernetes
Install CIHub on a Kubernetes cluster with its Helm chart, get a Postgres for it (CloudNativePG, a managed service or your own server), expose it, and update it.
Install the command line
Install cihub, the command line of CIHub, on Linux or macOS, to drive the queues of an instance from a terminal or a CI.