Chapter 4. Customizing the web console in OpenShift Container Platform

Procedure

1. Import your logo file into a ConfigMap in the openshift-config namespace:

   $ oc create configmap console-custom-logo --from-file ~/path/to/console-custom-logo.png -n openshift-config

2. Edit the web console’s Operator configuration to include customLogoFile and customProductName:

   $ oc edit console.operator.openshift.io cluster

   apiVersion: operator.openshift.io/v1
   kind: Console
   metadata:
     name: cluster
   spec:
     customization:
       customLogoFile:
         name: console-custom-logo
         key: console-custom-logo.png
       customProductName: My Console

   Once the Operator configuration is updated, it will sync the custom logo ConfigMap into the console namespace, mount it to the console pod, and redeploy.

3. Check for success. If there are any issues, the console cluster operator will report Degraded, and the console Operator configuration will also report CustomLogoDegraded, but with reasons like KeyOrFilenameInvalid or NoImageProvided.

   To check the clusteroperator, run:

   $ oc get clusteroperator console -o yaml

   To check the console Operator configuration, run:

   $ oc get console.operator.openshift.io -o yaml

Procedure

1. From Administration Custom Resource Definitions, click on ConsoleLink.

2. Click YAML and edit the file:

   apiVersion: console.openshift.io/v1
   kind: ConsoleLink
   metadata:
     name: example
   spec:
     href: 'https://www.example.com'
     location: HelpMenu 1
     text: Link 1

   1

   Valid location settings are HelpMenu, UserMenu, and ApplicationMenu.

   To make the custom link appear in the application menu, follow this example:

   apiVersion: console.openshift.io/v1
   kind: ConsoleLink
   metadata:
     name: application-menu-link-1
   spec:
     href: 'https://www.example.com'
     location: ApplicationMenu
     text: Link 1
     applicationMenu:
       section: My New Section
       # image that is 24x24 in size
       imageURL: https://via.placeholder.com/24

3. Click the Save button to apply your changes.

Procedure

1. Run the following commands to create templates you can modify:

   $ oc adm create-login-template > login.html
   $ oc adm create-provider-selection-template > providers.html
   $ oc adm create-error-template > errors.html

2. Create the secrets:

   $ oc create secret generic login-template --from-file=login.html -n openshift-config
   $ oc create secret generic providers-template --from-file=providers.html -n openshift-config
   $ oc create secret generic error-template --from-file=errors.html -n openshift-config

3. Run:

   $ oc edit oauths cluster

4. Update the specification:

   spec:
     templates:
       error:
           name: error-template
       login:
           name: login-template
       providerSelection:
           name: providers-template

   Run oc explain oauths.spec.templates to understand the options.

Procedure

1. From Administration Custom Resource Definitions, click on ConsoleExternalLogLink.

2. Click YAML and edit the file:

   apiVersion: console.openshift.io/v1
   kind: ConsoleExternalLogLink
   metadata:
     name: example
   spec:
     hrefTemplate: >-
       https://example.com/logs?resourceName=${resourceName}&containerName=${containerName}&resourceNamespace=${resourceNamespace}&podLabels=${podLabels}
     text: Example Logs

Procedure

1. From Administration Custom Resource Definitions, click on ConsoleNotification.

2. Click YAML and edit the file:

   apiVersion: console.openshift.io/v1
   kind: ConsoleNotification
   metadata:
     name: example
   spec:
     backgroundColor: '#0088ce'
     color: '#fff'
     link:
       href: 'https://www.example.com'
       text: Optional link text
     location: BannerTop 1
     text: This is an example notification message with an optional link.

   1

   Valid location settings are BannerTop, BannerBottom, and BannerTopBottom.

3. Click the Save button to apply your changes.

Procedure

1. Navigate to Administration Custom Resource Definitions.
2. Select ConsoleCLIDownload from the list of Custom Resource Definitions (CRDs).

3. Click the YAML tab, and then make your edits:

   apiVersion: console.openshift.io/v1
   kind: ConsoleCLIDownload
   metadata:
     name: example-cli-download-links-for-foo
   spec:
     description: |
       This is an example of download links for foo
     displayName: example-foo
     links:
     - href: 'https://www.example.com/public/foo.tar'
       text: foo for linux
     - href: 'https://www.example.com/public/foo.mac.zip'
       text: foo for mac
     - href: 'https://www.example.com/public/foo.win.zip'
       text: foo for windows

4. Click the Save button.