Create Custom ConsoleLinks

Sometimes it can be very helpful to have a direct link from an OpenShift project to the IBM Solution Designer and IBM Solution Hub. How that link can be created is shown below. For both cases you can use the prepared YAML template and adjust it.

Prerequisites

  • Admin access to OpenShift cluster

Step 1: Get your links

  1. In openshift go to Networking -> Routes
  2. Use your namespace where the operator is installed.
  3. Then get the link from k5-designer-frontend-route (Do the same for k5-hub-frontend-route, k5-dashboard)
  4. Copy the link from the Location tab

Step 2: Navigating to OpenShift Console Link

  1. Log in to the admin console of OpenShift
  2. Navigate to Administration -> Custom Resource Definition -> ConsoleLink
  3. Click on Instances

Step 3: Create the console links k5-designer

  1. Click on Create Console Link
  2. Copy/paste k5-designer-frontend-route YAML
  3. Check the spec.href if it is the same as you got in step 1, if not replace it
  4. Click create

k5-designer-frontend-route YAML

apiVersion: console.openshift.io/v1
kind: ConsoleLink
metadata:
  name: k5-designer-console-link
spec:
  applicationMenu:
    imageURL: >-
      data:image/png;base64,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
    section: IBM Solutions Workbench
  href: 'https://k5-designer-k5-tools.my.cluster/'
  location: ApplicationMenu
  text: k5-designer

Step 4: Create the console links k5-hub

  1. Click on Create Console Link
  2. Copy/paste k5-hub-frontend-route YAML
  3. Check the spec.href if it is the same as you got in step 1, if not replace it
  4. Click create

k5-hub-frontend-route YAML

apiVersion: console.openshift.io/v1
kind: ConsoleLink
metadata:
  name: k5-hub-console-link
spec:
  applicationMenu:
    imageURL: >-
      data:image/png;base64,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
    section: IBM Solutions Workbench
  href: 'https://k5-hub-k5-tools.my.cluster/'
  location: ApplicationMenu
  text: k5-hub

Delete a console link using the Open Shift Admin Console

  1. Log into admin console of OpenShift
  2. Navigate to Administration -> Custom Resource Definition -> ConsoleLink
  3. Click on Instances and click on Console Link which needs to be deleted
  4. Navigate to Actions -> Delete Console Link