The OpenShift GitHub Connector provides a webapp on your OpenShift cluster which connects GitHub repositories to your OpenShift cluster, and automates setting up GitHub Actions for OpenShift.
See the chart.
The inputs are described in values.yaml
.
Install from the root of the repo as follows:
helm upgrade --install github-connector \
chart/openshift-github-connector \
--set clusterAppsSubdomain=apps.<your-openshift-server>.com \
--set clusterApiServer=$(oc whoami --show-server)
If you are using CRC, you can omit the two --set
statements, since the defaults are for CRC.
You need to be a cluster administrator to create an OAuthClient
since it is a cluster-scoped resource.
See the values.yaml
for an explanation of these values and the others you may set.
The chart creates a Route through which the app can be accessed. The route host is github-connector.<clusterAppsSubdomain>
. For example, for CRC, the host is github-connector.apps-crc.testing
.
The route must be accessible from the internet, so GitHub can call back to it when the GitHub app is created.
See developing.md.