流程

1. 在 openshift-config 命名空间中将您的徽标文件导入到配置映射中：

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

2. 编辑 web 控制台的 Operator 配置使其包含 customLogoFile 和 customProductName：

   $ oc edit console.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 并重新部署。

3. 检查操作是否成功。如果有任何问题，控制台集群 Operator 将报告 Degraded 状态，控制台 Operator 配置也会报告 CustomLogoDegraded 状态，但状态类似于 KeyOrFilenameInvalid 或 NoImageProvided。

   运行以下命令检查 clusteroperator：

   $ oc get clusteroperator console -o yaml

   运行以下命令检查 console Operator 配置：

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

流程

1. 在 Administration → Custom Resource Definitions 中点 ConsoleLink。
2. 选择 Instances 标签

3. 点击 Create Console Link 并编辑文件：

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

   1

   有效的位置设置为 HelpMenu、UserMenu、ApplicationMenu 和 NamespaceDashboard。

   要使自定义链接出现在所有命名空间中，请按照以下示例操作：

   apiVersion: console.openshift.io/v1
   kind: ConsoleLink
   metadata:
     name: namespaced-dashboard-link-for-all-namespaces
   spec:
     href: 'https://www.example.com'
     location: NamespaceDashboard
     text: This appears in all namespaces

   要使自定义链接只出现在某些命名空间中，请按照以下示例操作：

   apiVersion: console.openshift.io/v1
   kind: ConsoleLink
   metadata:
     name: namespaced-dashboard-for-some-namespaces
   spec:
     href: 'https://www.example.com'
     location: NamespaceDashboard
     # This text will appear in a box called "Launcher" under "namespace" or "project" in the web console
     text: Custom Link Text
     namespaceDashboard:
       namespaces:
       # for these specific namespaces
       - my-namespace
       - your-namespace
       - other-namespace

   要使自定义链接出现在应用程序菜单中，请按照以下示例操作：

   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

4. 点 Save 按钮应用所做的改变。

流程

1. 运行以下命令来创建您可以修改的模板：

   $ oc adm create-login-template > login.html

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

   $ oc adm create-error-template > errors.html

2. 创建 secret:

   $ 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. 运行：

   $ oc edit oauths cluster

4. 更新规格：

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

   运行 oc explain oauths.spec.templates 以了解选项。

流程

1. 在 Administration → Custom Resource Definitions 中点 ConsoleExternalLogLink。
2. 选择 Instances 标签

3. 点击 Create Console External Log Link 并编辑文件：

   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

流程

1. 在 Administration → Custom Resource Definitions 中点 ConsoleNotification。
2. 选择 Instances 标签

3. 点击 Create Console Notification 并编辑文件：

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

   1

   有效的位置设置为 BannerTop、BannerBottom 和 BannerTopBottom。

4. 点 Create 按钮应用所做的改变。

流程

1. 进入 Administration → Custom Resource Definitions。
2. 从 Custom Resource Definitions (CRDs) 列表中选 ConsoleCLIDownload 。

3. 点 YAML 标签页，然后进行编辑：

   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. 点 Save 按钮。

流程

1. 在 Administration → Custom Resource Definitions 中点 ConsoleYAMLSample。

2. 点 YAML 并编辑该文件：

   apiVersion: console.openshift.io/v1
   kind: ConsoleYAMLSample
   metadata:
     name: example
   spec:
     targetResource:
       apiVersion: batch/v1
       kind: Job
     title: Example Job
     description: An example Job YAML sample
     yaml: |
       apiVersion: batch/v1
       kind: Job
       metadata:
         name: countdown
       spec:
         template:
           metadata:
             name: countdown
           spec:
             containers:
             - name: counter
               image: centos:7
               command:
               - "bin/bash"
               - "-c"
               - "for i in 9 8 7 6 5 4 3 2 1 ; do echo $i ; done"
             restartPolicy: Never

   使用 spec.snippet 表示 YAML 样本不是完整的 YAML 资源定义，而是可在用户光标处的现有 YAML 文档中插入的片段。

3. 点 Save。

流程

1. 使用您的登录凭证登录到 OpenShift Container Platform web 控制台。OpenShift Container Platform Web 控制台的默认视图是 Administrator 视角。

2. 使用视角切换功能把它切换到 Developer 视角。带有创建应用程序选项的 Topology 视图会被显示。

   图 5.1. Developer Perspective (开发者视角)