-
Notifications
You must be signed in to change notification settings - Fork 294
Notes for project maintainers
Below is a random collection of notes for project maintainers.
A release is created by creating a semver tag in the GerritHub repository as a member of the CUE Super Admins group, such as Chief Cueckoo. This is most simply done via the Gerrit tag UI. This tag will then replicate to GitHub, at which point the release workflow will be triggered. This workflow is responsible for creating the release assets, Docker images etc. Release notes should then be manually added to the corresponding GitHub release, using cueckoo releaselog.
Whilst some config changes can be made via the Gerrit UI, the majority cannot. Changes to Gerrit config files should be submitted for review in the usual way, but pushed for review against the meta/config branch. The process for submitting a change against this branch is slightly different to the default branch:
# We assume you have a local clone of the CUE repo
git fetch origin refs/meta/config:refs/remotes/origin/refs/meta/config
git switch -c my_config_change origin/refs/meta/config
# Make config changes
git codereview change -s -a -m 'Important configuration changes'
git codereview mail
When you git codereview mail, GerritHub validates the configuration. If it is not valid for whatever reason, it will not accept the change.
Config changes can be approved by a member of the CUE Admins group but can only be submitted by a member of the CUE Super Admins group.
The contribution guide describes the workflow for both Gerrit-based and GitHub PR-based contributions. The GerritHub repository is the source of truth for the CUE project, and as such GitHub PRs should not be merged. Rather, they must be imported via the GerritHub UI.
Given that GerritHub is the source of truth, Pull Requests need to be imported into GerritHub to be submitted as part of the usual change workflow. It's generally easier for the contributor to participate in the Pull Request (familiar review-change process), and then have a CUE approver import and submit the Pull Request when it's ready.
To import a Pull Request, use cueckoo importpr as follows:
go install github.com/cue-sh/tools/cmd/cueckoo@latest
cueckoo importpr 123 # replacing 123 with the PR number to be imported