Skip to content

Latest commit

 

History

History
85 lines (69 loc) · 2.36 KB

README.md

File metadata and controls

85 lines (69 loc) · 2.36 KB
Raw

OpenShift Console GitOps Plugin

Based on Openshift Console dynamic plugin, this plugin implement the console elements for GitOps.

Building

Option 1: Without running Console locally

In one terminal window, run:

  1. yarn install
  2. yarn run start

In another terminal window, run:

  1. oc login (requires oc and an OpenShift cluster)
  2. Create a route to expose the backend service, cluster-route.yaml and run oc apply -f cluster-route.yaml
kind: Route
apiVersion: route.openshift.io/v1
metadata:
    name: cluster
    namespace: openshift-gitops
spec: 
  to:
    kind: Service
    name: cluster
  port:
    targetPort: 8080
  tls:
    termination: reencrypt
    insecureEdgeTerminationPolicy: Allow
  1. yarn run start-console (requires Docker or podman 3.2.0+)

This will run the OpenShift console in a container connected to the cluster you've logged into. The plugin HTTP server runs on port 9001 with CORS enabled. Navigate to http://localhost:9000/envdynamic to see the running plugin.

Running start-console with Apple silicon and podman

If you are using podman on a Mac with Apple silicon, yarn run start-console might fail since it runs an amd64 image. You can work around the problem with qemu-user-static by running these commands:

podman machine ssh
sudo -i
rpm-ostree install qemu-user-static
systemctl reboot

Option 2: Have Console running locally

In plugin directory, run

  1. yarn install
  2. yarn run start

In your local console/ directory

  1. Sign into a new cluster and run the oc login command
  2. Create a route to expose the backend service, cluster-route.yaml and run oc apply -f cluster-route.yaml
kind: Route
apiVersion: route.openshift.io/v1
metadata:
    name: cluster
    namespace: openshift-gitops
spec: 
  to:
    kind: Service
    name: cluster
  port:
    targetPort: 8080
  tls:
    termination: reencrypt
    insecureEdgeTerminationPolicy: Allow
  1. Set up the environment and run console with gitops-plugin
source ./contrib/oc-environment.sh
./bin/bridge -plugins gitops-plugin=http://localhost:9001/