手順

1. ロゴファイルを openshift-config namespace の設定マップにインポートします。

   $ 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 設定が更新されると、カスタムロゴ設定マップをコンソール namespace に同期し、これをコンソール Pod にマウントし、再デプロイします。

3. 正常に実行されたかどうかを確認します。問題がある場合は、コンソールクラスター Operator は Degraded ステータスを報告し、コンソール Operator 設定も CustomLogoDegraded ステータスを KeyOrFilenameInvalid または NoImageProvided などの理由と共に報告します。

   clusteroperator を確認するには、以下を実行します。

   $ oc get clusteroperator console -o yaml

   コンソール 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 です。

   カスタムリンクがすべての namespace に表示されるようにするには、以下の例に従います。

   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

   カスタムリンクが一部の namespace のみに表示されるようにするには、以下の例に従います。

   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. シークレットを作成します。

   $ 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. カスタムリソース定義 (CRD) の一覧から 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 パースペクティブ