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

=== "Deployment"

 ```yaml
 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: {}
 ```

=== "Deployment with PVC"

 ```yaml
 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
 ```

=== "Deployment with Keycloak"

 ```yaml
 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: &lt;your-keycloak-auth-server&gt;
             - name: DIRIGIBLE_KEYCLOAK_REALM
               value: &lt;your-keycloak-realm&gt;
             - name: DIRIGIBLE_KEYCLOAK_SSL_REQUIRED
               value: external
             - name: DIRIGIBLE_KEYCLOAK_CLIENT_ID
               value: &lt;your-keycloak-client-id&gt;
             - 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
 ```
 !!! note "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`)_.

!!! tip "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](https://github.com/eclipse/dirigible/releases/).
 - All Eclipse Dirigible Docker images and tags (versions) can be found [here](https://hub.docker.com/u/dirigiblelabs).

Create service configuration file: service.yaml

=== "Service"

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

=== "Route"

 ```yaml
 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.&lt;your-openshift-domain&gt;
   to:
     kind: Service
     name: dirigible
   port:
     targetPort: http
   tls:
     termination: edge
     insecureEdgeTerminationPolicy: Redirect
   wildcardPolicy: None
 ```

 !!! note "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
```
!!! tip "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>

Setup in Red Hat OpenShift ​

Steps ​

Setup in Red Hat OpenShift

Steps