第4章 Customizing the web console in OpenShift Container Platform
You can customize the OpenShift Container Platform web console to set a custom logo, product name, links, notifications, and command line downloads. This is especially helpful if you need to tailor the web console to meet specific corporate or government requirements.
4.1. Adding a custom logo and product name
You can create custom branding by adding a custom logo or custom product name. You can set both or one without the other, as these settings are independent of each other.
Prerequisites
- You must have administrator privileges.
-
Create a file of the logo that you want to use. The logo can be a file in any common image format, including GIF, JPG, PNG, or SVG, and is constrained to a
max-heightof60px.
Procedure
Import your logo file into a ConfigMap in the
openshift-confignamespace:$ oc create configmap console-custom-logo --from-file ~/path/to/console-custom-logo.png -n openshift-config
Edit the web console’s Operator configuration to include
customLogoFileandcustomProductName:$ 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 ConsoleOnce the Operator configuration is updated, it will sync the custom logo ConfigMap into the console namespace, mount it to the console pod, and redeploy.
Check for success. If there are any issues, the console cluster operator will report
Degraded, and the console Operator configuration will also reportCustomLogoDegraded, but with reasons likeKeyOrFilenameInvalidorNoImageProvided.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
