Skip to content

Run deployer wizard on OpenShift🔗

Log in to the OpenShift cluster🔗

Log is as a cluster administrator to be able to run the deployer with the correct permissions.

Prepare the deployer project🔗

  • Go to the OpenShift console
  • Click the "+" sign at the top of the page
  • Paste the following block (exactly) into the window
Prepare the deployer project 
---
apiVersion: v1
kind: Namespace
metadata:
  creationTimestamp: null
  name: cloud-pak-deployer
---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: cloud-pak-deployer-sa
  namespace: cloud-pak-deployer
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: system:openshift:scc:privileged
  namespace: cloud-pak-deployer
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: system:openshift:scc:privileged
subjects:
- kind: ServiceAccount
  name: cloud-pak-deployer-sa
  namespace: cloud-pak-deployer
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: cloud-pak-deployer-cluster-admin
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cluster-admin
subjects:
- kind: ServiceAccount
  name: cloud-pak-deployer-sa
  namespace: cloud-pak-deployer

Start the deployer🔗

  • Go to the OpenShift console
  • Click the "+" sign at the top of the page
  • Paste the following block into the window. You can update the image on line 11 and the same value will be used for image for the Deployer Job

Info

The below starts the deployer wizard using the standard configuration. Additionally, you can:

Start the deployer wizard 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
apiVersion: v1
kind: Pod
metadata:
  labels:
    app: cloud-pak-deployer-start
  generateName: cloud-pak-deployer-start-
  namespace: cloud-pak-deployer
spec:
  containers:
  - name: cloud-pak-deployer
    image: quay.io/cloud-pak-deployer/cloud-pak-deployer:latest
    imagePullPolicy: Always
    terminationMessagePath: /dev/termination-log
    terminationMessagePolicy: File
    command: ["/bin/sh","-xc"]
    args: 
      - /cloud-pak-deployer/scripts/deployer/cpd-start-deployer.sh --wizard
    envFrom:
    - configMapRef:
        name: cloud-pak-deployer-env
        optional: true
  restartPolicy: Never
  securityContext:
    runAsUser: 0
  serviceAccountName: cloud-pak-deployer-sa

Open the wizard🔗

Once the start pod finishes, you can access the deployer wizard using the route created in the cloud-pak-deployer project.

Info

It may take a few minutes (5-10 minutes) until the route is created by the deployer-start pod and then an additional few minutes before the wizard has been started. If you don't see the route immediately, or if the deployer wizard page does not show up, please be patient.

  • Open the OpenShift console
  • Go to Networking → Routes
  • Click the Cloud Pak Deployer wizard route
  • Log in using your OpenShift cluster admin credentials (typically kubeadmin)
  • Accept the information that will be shared with Cloud Pak Deployer