第 5 章 在 OpenShift Container Platform 中定制 Web 控制台
您可以对 OpenShift Container Platform web 控制台进行定制,如设置自定义徽标、产品名、链接、通知标语和命令行下载。这在您需要定制 Web 控制台以满足具体公司或政府要求时特别有用。
5.1. 添加自定义徽标和产品名称
您可以通过添加自定义徽标或自定义产品名称来创建自定义品牌。因为这些设置相互独立,因此可以两者都设置或只设置其中的一个。
先决条件
- 您必须具有管理员特权。
-
创建一个要使用的徽标文件。徽标可以是通用图像格式的文件,包括 GIF 、JPG 、PNG 或 SVG ,并有
max-height
为60px
的限制。
流程
在
openshift-config
命名空间中将您的徽标文件导入到配置映射中:$ oc create configmap console-custom-logo --from-file /path/to/console-custom-logo.png -n openshift-config
提示您还可以应用以下 YAML 来创建配置映射:
apiVersion: v1 kind: ConfigMap metadata: name: console-custom-logo namespace: openshift-config data: console-custom-logo.png: <base64-encoded_logo> ... 1
- 1
- 提供有效的 base64 编码徽标。
编辑 web 控制台的 Operator 配置使其包含
customLogoFile
和customProductName
:$ oc edit consoles.operator.openshift.io cluster
apiVersion: operator.openshift.io/v1 kind: Console metadata: name: cluster spec: customization: customLogoFile: key: console-custom-logo.png name: console-custom-logo customProductName: My Console
更新 Operator 配置后,它将会把自定义的 logo 配置映射同步到控制台命名空间中,并将其挂载到 console pod 并重新部署。
检查操作是否成功。如果有任何问题,控制台集群 Operator 将报告
Degraded
状态,控制台 Operator 配置也会报告CustomLogoDegraded
状态,但状态类似于KeyOrFilenameInvalid
或NoImageProvided
。运行以下命令检查
clusteroperator
:$ oc get clusteroperator console -o yaml
运行以下命令检查 console Operator 配置:
$ oc get consoles.operator.openshift.io -o yaml