웹 콘솔

프로세스

1. openshift-config 네임 스페이스의 로고 파일을 설정 맵으로 가져옵니다.

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

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: console-custom-logo
     namespace: openshift-config
   data:
     console-custom-logo.png: <base64-encoded_logo> ... 1

   1

   유효한 base64 인코딩 로고를 제공합니다.

2. customLogoFile 및 customProductName을 포함하도록 웹 콘솔의 Operator 설정을 편집합니다.

   $ 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 설정이 업데이트되면 사용자 정의 로고 설정 맵을 콘솔 네임 스페이스에 동기화하고 이를 콘솔 pod에 마운트한 후 다시 배포합니다.

3. 성공적으로 실행되었는지 확인합니다. 문제가 있는 경우 콘솔 클러스터 Operator는 Degraded 상태를 보고하고 콘솔 Operator 설정도 CustomLogoDegraded 상태를 KeyOrFilenameInvalid 또는 NoImageProvided와 같은 이유와 함께 보고합니다.

   clusteroperator를 확인하려면 다음을 실행합니다.

   $ oc get clusteroperator console -o yaml

   콘솔 Operator 설정을 확인하려면 다음을 실행합니다.

   $ oc get consoles.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. consoles.operator.openshift.io 사용자 정의 리소스에서 설치 중에 기본적으로 생성된 클러스터 인스턴스를 변경합니다.

   $ oc patch consoles.operator.openshift.io cluster --patch '{"spec":{"route":{"hostname":"console.example.com"}}}' --type=merge

   apiVersion: operator.openshift.io/v1
   kind: Console
   metadata:
     name: cluster
   spec:
     route:
       hostname: 'console.example.com'

2. 사용자 정의 인증서를 지정하는 경우 키와 인증서가 있는 openshift-config 네임스페이스에 시크릿을 생성해야 합니다. 예를 들면 다음과 같습니다.

   $ oc create secret tls console-tls --key=key.pem --cert=cert.pem -n openshift-config

   apiVersion: v1
   kind: Secret
   metadata:
     name: console-tls
     namespace: openshift-config
   type: kubernetes.io/tls
   data:
     tls.crt: >-
           <base64-encoded_cert> ... 1
     tls.key: >-
           <base64-encoded_key> ... 2

   1

   유효한 TLS 인증서를 제공합니다.

   2

   유효한 TLS 키를 제공합니다.

   그런 다음 웹 콘솔의 Operator 구성을 편집합니다.

   $ oc edit consoles.operator.openshift.io cluster

   구성 리소스에 다음 스탠자를 추가합니다.

   spec:
     route:
       hostname: console.example.com
       secret:
         name: console-tls

프로세스

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 (Custom Resource Definitions) 목록에서 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. 웹 콘솔의 Administrator 모드에서 Operator → OperatorHub로 이동합니다.
2. Filter by keyword 상자를 사용하여 카탈로그에서 Web Terminal Operator를 검색한 다음 Web Terminal 타일을 클릭합니다.
3. Web Terminal 페이지에서 Operator에 대한 간략한 설명을 확인하고Install을 클릭합니다.

4. Install Operator 페이지에서 모든 필드의 기본값을 유지합니다.

   • Update Channel 메뉴의 alpha 옵션으로 Web Terminal Operator의 최신 릴리스버전을 설치할 수 있습니다.
   • Installation Mode 메뉴의 All namespaces on the cluster를 사용하면 Operator가 클러스터의 모든 네임스페이스를 모니터링하고 사용할 수 있습니다.
   • Installed Namespace 메뉴의 openshift-operators 옵션은 기본 openshift-operators 네임스페이스에 Operator를 설치합니다.
   • Approval Strategy 메뉴의 Automatic 옵션은 Operator에 향후 지원되는 업그레이드가 OLM(Operator Lifecycle Manager)에 의해 자동으로 처리됩니다.
5. 설치를 클릭합니다.
6. Installed Operators 페이지에서 View Operator를 클릭하여 Operator가 Installed Operators 페이지에 나열되어 있는지 확인합니다.
7. Operator가 설치되면 페이지를 새로고침하여 콘솔 오른쪽에 있는 명령행 터미널 아이콘을 확인합니다.

1. 웹 터미널을 시작하려면 콘솔 오른쪽에 있는 명령행 터미널 아이콘( )을 클릭합니다. 명령줄 터미널 창에 웹 터미널 인스턴스가 표시됩니다. 이 인스턴스는 사용자의 인증 정보를 사용하여 자동으로 로그인됩니다.

2. 프로젝트 드롭다운 목록에서 DevWorkspace CR을 생성해야 하는 프로젝트를 선택합니다. 기본적으로 현재 프로젝트는 선택됩니다.

   참고
   • DevWorkspace CR은 아직 존재하지 않는 경우에만 생성됩니다.
   • openshift-terminal 프로젝트는 클러스터 관리자에게 사용되는 기본 프로젝트입니다. 다른 프로젝트를 선택할 수 있는 옵션이 없습니다.
3. Start를 클릭하여 선택한 프로젝트를 사용하여 웹 터미널을 초기화합니다.

1. Operator를 설치할 때 기본적으로 추가된 구성 요소 및 사용자 정의 리소스(CR)를 삭제합니다.
2. Web Terminal Operator를 설치 제거합니다.