Setup in Red Hat OpenShift

Deploy Eclipse Dirigible in Red Hat OpenShift environment.

Prerequisites

Install kubectl.
Access to Red Hat OpenShift.

Steps

Access the Red Hat OpenShift environment via the OpenShift Console:

Create deployment configuration file: deployment.yaml

DeploymentDeployment with PVCDeployment with Keycloak

apiVersion: apps/v1
kind: Deployment
metadata:
  name: dirigible
spec:
  replicas: 1
  selector:
    matchLabels:
      app: dirigible
  template:
    metadata:
      labels:
        app: dirigible
    spec:
      containers:
        - name: dirigible
          image: dirigiblelabs/dirigible-all:latest
          imagePullPolicy: Always
          resources:
            requests:
              memory: "1Gi"
              cpu: "0.5"
            limits:
              memory: "4Gi"
              cpu: "2"
          ports:
            - name: http
              containerPort: 8080
          env:
            - name: DIRIGIBLE_THEME_DEFAULT
              value: "fiori"
          volumeMounts:
            - name: dirigible-temp-data
              mountPath: /usr/local/tomcat/target
      volumes:
        - name: dirigible-temp-data
          emptyDir: {}

apiVersion: apps/v1
kind: Deployment
metadata:
  name: dirigible
spec:
  replicas: 1
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app: dirigible
  template:
    metadata:
      labels:
        app: dirigible
    spec:
      containers:
        - name: dirigible
          image: dirigiblelabs/dirigible-all:latest
          imagePullPolicy: Always
          resources:
            requests:
              memory: "1Gi"
              cpu: "0.5"
            limits:
              memory: "4Gi"
              cpu: "2"
          ports:
            - name: http
              containerPort: 8080
          env:
            - name: DIRIGIBLE_THEME_DEFAULT
              value: "fiori"
          volumeMounts:
            - name: dirigible-data
              mountPath: /usr/local/tomcat/target/dirigible/repository
            - name: dirigible-temp-data
              mountPath: /usr/local/tomcat/target/dirigible
      volumes:
        - name: dirigible-data
          persistentVolumeClaim:
            claimName: "dirigible-data"
        - name: dirigible-temp-data
          emptyDir: {}
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: dirigible-data
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi

apiVersion: apps/v1
kind: Deployment
metadata:
  name: dirigible
spec:
  replicas: 1
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app: dirigible
  template:
    metadata:
      labels:
        app: dirigible
    spec:
      containers:
        - name: dirigible
          image: dirigiblelabs/dirigible-keycloak:latest
          imagePullPolicy: Always
          resources:
            requests:
              memory: "1Gi"
              cpu: "0.5"
            limits:
              memory: "4Gi"
              cpu: "2"
          ports:
            - name: http
              containerPort: 8080
          env:
            - name: DIRIGIBLE_THEME_DEFAULT
              value: "fiori"
            - name: DIRIGIBLE_KEYCLOAK_ENABLED
              value: "true"
            - name: DIRIGIBLE_KEYCLOAK_AUTH_SERVER_URL
              value: <your-keycloak-auth-server>
            - name: DIRIGIBLE_KEYCLOAK_REALM
              value: <your-keycloak-realm>
            - name: DIRIGIBLE_KEYCLOAK_SSL_REQUIRED
              value: external
            - name: DIRIGIBLE_KEYCLOAK_CLIENT_ID
              value: <your-keycloak-client-id>
            - name: DIRIGIBLE_KEYCLOAK_CONFIDENTIAL_PORT
              value: "443"
          volumeMounts:
            - name: dirigible-data
              mountPath: /usr/local/tomcat/target/dirigible/repository
            - name: dirigible-temp-data
              mountPath: /usr/local/tomcat/target/dirigible
      volumes:
        - name: dirigible-data
          persistentVolumeClaim:
            claimName: "dirigible-data"
        - name: dirigible-temp-data
          emptyDir: {}
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: dirigible-data
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi

Replace Placeholders

Before deploying, replace the following placeholders:

<your-keycloak-auth-server> with your Keycloak Auth server (e.g. https://keycloak-server/auth/).
<your-keycloak-realm> with your Keycloak Realm (e.g. my-realm).
<your-keycloak-client-id> with your Keycloak Client Id (e.g. my-client).

Eclipse Dirigible versions

Instead of using the latest tag (version), for production and development use cases it is recomended to use a stable release version:

All released versions can be found here.
All Eclipse Dirigible Docker images and tags (versions) can be found here.

Create service configuration file: service.yaml

ServiceRoute

apiVersion: v1
kind: Service
metadata:
  name: dirigible
  labels:
    app: dirigible
spec:
  ports:
    - name: http
      port: 8080
  type: ClusterIP
  selector:
    app: dirigible

apiVersion: v1
kind: Service
metadata:
  name: dirigible
  labels:
    app: dirigible
spec:
  ports:
    - name: http
      port: 8080
  type: ClusterIP
  selector:
    app: dirigible
---
kind: Route
apiVersion: route.openshift.io/v1
metadata:
  name: dirigible
spec:
  host: dirigible.<your-openshift-domain>
  to:
    kind: Service
    name: dirigible
  port:
    targetPort: http
  tls:
    termination: edge
    insecureEdgeTerminationPolicy: Redirect
  wildcardPolicy: None

Replace Placeholders

Before deploying, replace the following placeholders:

<your-openshift-domain> with your OpenShift domain (e.g. apps.sandbox.xxxx.yy.openshiftapps.com).

Deploy to the OpenShift Kubernetes Cluster with:
```
kubectl apply -f deployment.yml

kubectl apply -f service.yml
```
OpenShift Console

Alternatively the OpenShift Console could be used to deploy the artifacts via the Console UI.
Open a web browser and go to: https://dirigible.<your-openshift-domain>