Настройка OKD console#

OKD console возможно настроить установив проприетарный логотип, название продукта, ссылки, уведомления и загрузки из командной строки.

Добавление логотипа продукта#

Выполнение сценария обеспечивает интеграцию собственного логотипа или названия продукта.

Предварительные условия#

Предварительные условия добавления логотипа продукта:

Получены права администратора;
Развернут кластер DropApp;
Создан файл логотипа в графическом формате - GIF, JPG, PNG или SVG, и его размер ограничен расширением 60px.

Процедура#

Процедура добавления логотипа продукта:

Примените YAML для создания карты конфигурации:

apiVersion: v1
kind: ConfigMap
metadata:
  name: console-custom-logo
  namespace: openshift-config
binaryData:
  console-custom-logo.png: <base64-encoded_logo> ... #   Предоставьте действительный логотип в кодировке Base64.

Отредактируйте конфигурацию оператора веб-консоли, включив в нее customLogoFile и customProductName:
```
apiVersion: operator.io/v1
kind: Console
metadata:
  name: cluster
spec:
  customization:
    customLogoFile:
      key: console-custom-logo.png
      name: console-custom-logo
    customProductName: My Console
```
После обновления конфигурации оператора он синхронизирует карту конфигурации пользовательского логотипа с namespace консоли, подключит ее к модулю консоли и повторно развернет.
При возникновении каких-либо проблем оператор кластера консоли сообщит о состоянии Degraded, а конфигурация оператора консоли также сообщит о состоянии CustomLogoDegraded, но с указанием причин, таких как KeyOrFilenameInvalid или NoImageProvided.

Создание пользовательских ссылок в OKD console#

Предварительные условия#

Предварительные условия создания пользовательских ссылок:

Получены права администратора кластера DropApp.

Процедура#

Процедура создания пользовательских ссылок:

В разделе Administration → Custom Resource Definitions нажмите ConsoleLink.
Выберите вкладку Instances.

Нажмите Create Console Link и отредактируйте файл:

apiVersion: console.io/v1
kind: ConsoleLink
metadata:
  name: example
spec:
  href: 'https://www.example.com'
  location: HelpMenu # Допустимые настройки местоположения: HelpMenu, UserMenu, ApplicationMenu и NamespaceDashboard.
  text: Link 1

Чтобы пользовательская ссылка отображалась во всех namespaces, следуйте примеру:

apiVersion: console.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

Чтобы пользовательская ссылка отображалась только в некоторых namespaces, следуйте этому примеру:

apiVersion: console.io/v1
kind: ConsoleLink
metadata:
  name: namespaced-dashboard-for-some-namespaces
spec:
  href: 'https://www.example.com'
  location: NamespaceDashboard
  # Этот текст появится в поле «Панель запуска» в разделе «Пространство имен» или «Проект» веб-консоли.
  text: Custom Link Text
  namespaceDashboard:
    namespaces:
    # Для этих конкретных namespaces
    - my-namespace
    - your-namespace
    - other-namespace

Чтобы пользовательская ссылка появилась в меню приложения, следуйте этому примеру:

apiVersion: console.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

Нажмите Save, чтобы применить изменения.

Наблюдение доступных квот и ресурсов проекта#

Просмотрите графическое представление потребления ресурсов и выделенных квот во вкладке Topology в роли разработчика OKD console.

Если на ресурсе есть сообщение о достижении ограничений или квот ресурсов, вокруг имени ресурса появляется желтая рамка. Нажмите левой кнопкой мыши на ресурс, чтобы открыть боковую панель и просмотреть сообщение. Если масштаб представления топологии уменьшен, оповещение о новом сообщении маркируется желтой точкой.

При использовании представления списка из меню List View ресурсы отображаются в виде списка. В столбце Alerts указывается, доступно ли сообщение.

Создание пользовательских баннеров уведомлений#

Предварительные условия#

Предварительные условия создания пользовательских баннеров уведомлений:

В кластер осуществлен вход с правами администратора.

Процедура#

Процедура создания пользовательских баннеров уведомлений:

В разделе Administration → Custom Resource Definitions нажмите ConsoleNotification.
Выберите вкладку Instances.

Нажмите Create Console Notification и отредактируйте файл:

apiVersion: console.io/v1
kind: ConsoleNotification
metadata:
  name: example
spec:
  text: Это пример уведомления с дополнительной ссылкой.
  location: BannerTop # 
  link:
    href: 'https://www.example.com'
    text: Опциональный текст сылки
  color: '#fff' # цвет текста
  backgroundColor: '#0088ce' # цвет заливки фона

Нажмите «Create», чтобы применить изменения.

Настройка загрузки CLI#

Настройте ссылки для загрузки CLI с настраиваемым текстом ссылки и URL-адресами, которые могут указывать непосредственно на пакеты файлов или на внешнюю страницу, предоставляющую пакеты.

Предварительные условия#

Предварительные условия загрузки CLI:

В кластер осуществлен вход с правами администратора.

Процедура#

Процедура загрузки CLI:

Перейдите в раздел Administration → Custom Resource Definitions.
Выберите ConsoleCLIDownload из списка определений пользовательских ресурсов (CRD).

Откройте вкладку YAML и внесите изменения:

apiVersion: console.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

Нажмите кнопку Save.

Добавление примеров YAML в ресурсы Kubernetes#

Выполнение сценария позволяет добавлять примеры YAML к любым ресурсам Kubernetes.

Предварительные условия#

Предварительные условия для добавления примеров YAML:

В кластер осуществлен вход с правами администратора.

Процедура#

Процедура добавления примеров YAML:

В разделе Administration → Custom Resource Definitions нажмите ConsoleYAMLSample

Нажмите YAML и отредактируйте файл:

apiVersion: console.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 при наведении курсора пользователя.

Нажмите Save.