tetchel / openshift-github-connector

OpenShift <--> GitHub connector app

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

OpenShift GitHub Connector

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.

Installing on 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.

Developing

See developing.md.

About

OpenShift <--> GitHub connector app


Languages

Language:TypeScript 95.7%Language:SCSS 3.0%Language:JavaScript 0.9%Language:Shell 0.2%Language:HTML 0.2%