웹 콘솔

절차

1. 관점 전환 기능을 사용하여 관리자 또는 개발자 화면으로 전환합니다.
2. 프로젝트 드롭다운 목록에서 기존 프로젝트를 선택합니다. 이 드롭다운에서 새 프로젝트를 생성할 수도 있습니다.

절차

1. 로그인 인증 정보를 사용하여 OpenShift Container Platform 웹 콘솔에 로그인합니다.
2. masthead를 사용하여 사용자 프로필의 사용자 기본 설정에 액세스합니다.

3. 일반 섹션에서 다음을 수행합니다.

   1. Perspective 필드에서 로그인할 기본 관점을 설정할 수 있습니다. 필요에 따라 관리자 또는 개발자 화면을 선택할 수 있습니다. 관점을 선택하지 않으면 마지막으로 방문한 화면에 기록됩니다.
   2. 프로젝트 필드에서 작업할 프로젝트를 선택합니다. 로그인할 때마다 콘솔은 프로젝트에 기본적으로 사용됩니다.
   3. 토폴로지 필드에서 토폴로지 보기를 기본적으로 그래프 또는 목록 보기로 설정할 수 있습니다. 선택되지 않은 경우 콘솔은 기본적으로 사용한 마지막 보기로 설정됩니다.
   4. Create/Edit 리소스 메서드 필드에서 리소스를 생성하거나 편집하기 위한 기본 설정을 설정할 수 있습니다. 양식 및 YAML 옵션을 모두 사용할 수 있는 경우 콘솔은 기본적으로 선택 사항으로 설정됩니다.
4. Language 섹션에서 Default browser language 를 선택하여 기본 브라우저 언어 설정을 사용합니다. 그렇지 않으면 콘솔에 사용할 언어를 선택합니다.

프로세스

1. 관리자 관점에서 관리 → 클러스터 설정으로 이동합니다.
2. 클러스터 설정 페이지에서 구성 탭을 클릭합니다.

3. Configuration 페이지에서 description operator.openshift.io 를 사용하여 Console 구성 리소스를 클릭합니다.

   
4. 작업 드롭다운 목록에서 사용자 지정을 선택하여 클러스터 구성 페이지가 열립니다.

5. 일반 탭의 빠른 시작 섹션에서 Enabled 또는 Disabled 목록에서 항목을 선택하고 화살표 버튼을 사용하여 한 목록에서 다른 목록으로 해당 항목을 이동할 수 있습니다.

   • 단일 퀵 스타트를 활성화하거나 비활성화하려면 퀵 스타트를 클릭한 다음 단일 화살표 버튼을 사용하여 퀵 스타트를 적절한 목록으로 이동합니다.
   • 한 번에 여러 퀵 스타트를 활성화하거나 비활성화하려면 Ctrl을 누른 후 이동할 퀵 스타트를 클릭합니다. 그런 다음 단일 화살표 버튼을 사용하여 퀵 스타트를 적절한 목록으로 이동합니다.
   • 한 번에 모든 퀵 스타트를 활성화하거나 비활성화하려면 이중 화살표 버튼을 클릭하여 모든 퀵 스타트를 적절한 목록으로 이동합니다.

프로세스

1. 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
   binaryData:
     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. 저장을 클릭하여 변경 사항을 적용합니다.

프로세스

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. 생성 을 클릭하여 변경 사항을 적용합니다.

프로세스

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. 저장을 클릭합니다.

절차

1. 새 탭에서 새 탭에서 플러그인을 생성하는 템플릿이 포함된 console-plugin-template 리포지토리를 엽니다.

   중요

   사용자 정의 플러그인 코드는 Red Hat에서 지원하지 않습니다. 귀하의 플러그인에 협력 커뮤니티 지원 만 사용할 수 있습니다.

2. Use this template → Create new repository를 클릭하여 템플릿에 대한 GitHub 리포지토리를 생성합니다.
3. 새 리포지토리의 이름을 플러그인 이름으로 변경합니다.
4. 코드를 편집할 수 있도록 새 리포지토리를 로컬 시스템에 복제합니다.

5. consolePlugin 선언에 플러그인 메타데이터를 추가하여 package.json 파일을 편집합니다. 예를 들면 다음과 같습니다.

   "consolePlugin": {
     "name": "my-plugin", 1
     "version": "0.0.1", 2
     "displayName": "My Plugin", 3
     "description": "Enjoy this shiny, new console plugin!", 4
     "exposedModules": {
       "ExamplePage": "./components/ExamplePage"
     },
     "dependencies": {
       "@console/pluginAPI": "/*"
     }
   }

   1

   플러그인 이름을 업데이트합니다.

   2

   버전을 업데이트합니다.

   3

   플러그인의 표시 이름을 업데이트합니다.

   4

   플러그인에 대한 synopsis로 설명을 업데이트합니다.

6. console-extensions.json 파일에 다음을 추가합니다.

   {
     "type": "console.tab/horizontalNav",
     "properties": {
       "page": {
         "name": "Example Tab",
         "href": "example"
       },
       "model": {
         "group": "core",
         "version": "v1",
         "kind": "Pod"
       },
       "component": { "$codeRef": "ExampleTab" }
     }
   }

7. 다음 변경 사항을 포함하도록 package.json 파일을 편집합니다.

           "exposedModules": {
               "ExamplePage": "./components/ExamplePage",
               "ExampleTab": "./components/ExampleTab"
           }

8. 새 파일 Golang /components/libvirtTab.tsx를 생성하고 다음 스크립트를 추가하여 Pod 페이지의 새 사용자 지정 탭에 표시할 메시지를 작성합니다.

   import * as React from 'react';
   
   export default function ExampleTab() {
       return (
           <p>This is a custom tab added to a resource using a dynamic plugin.</p>
       );
   }

9. 플러그인 이름과 함께 Helm 차트를 새 네임스페이스 또는 -n 명령줄 옵션에 지정된 기존 네임스페이스에 Helm 릴리스 이름으로 설치하여 클러스터에 플러그인을 배포합니다. 다음 명령을 사용하여 plugin.image 매개변수 내에 이미지의 위치를 제공합니다.

   $ helm upgrade -i  my-plugin charts/openshift-console-plugin -n my-plugin-namespace --create-namespace --set plugin.image=my-plugin-image-location

   참고

   클러스터에 플러그인을 배포하는 방법에 대한 자세한 내용은 "클러스터에 플러그인 배포"를 참조하십시오.

절차

1. 다음 명령을 사용하여 이미지를 빌드합니다.

   $ docker build -t quay.io/my-repositroy/my-plugin:latest .

2. 선택 사항: 이미지를 테스트하려면 다음 명령을 실행합니다.

   $ docker run -it --rm -d -p 9001:80 quay.io/my-repository/my-plugin:latest

3. 다음 명령을 실행하여 이미지를 푸시합니다.

   $ docker push quay.io/my-repository/my-plugin:latest

절차

1. 플러그인을 클러스터에 배포하려면 플러그인 이름을 Helm 릴리스 이름으로 사용하여 -n 명령줄 옵션에 지정된 기존 네임스페이스 또는 기존 네임스페이스에 Helm 차트를 설치합니다. 다음 명령을 사용하여 plugin.image 매개변수 내에 이미지의 위치를 제공합니다.

   $ helm upgrade -i  my-plugin charts/openshift-console-plugin -n my-plugin-namespace --create-namespace --set plugin.image=my-plugin-image-location

   다음과 같습니다.

   n <my-plugin-namespace>

   플러그인을 배포할 기존 네임스페이스를 지정합니다.

   --create-namespace

   선택 사항: 새 네임스페이스에 배포하는 경우 이 매개변수를 사용합니다.

   --set plugin.image=my-plugin-image-location

   plugin.image 매개변수 내 이미지 위치를 지정합니다.

2. 선택 사항: charts/openshift-console-plugin/values.yaml 파일에서 지원되는 매개변수 세트를 사용하여 추가 매개변수를 지정할 수 있습니다.

   plugin:
     name: ""
     description: ""
     image: ""
     imagePullPolicy: IfNotPresent
     replicas: 2
     port: 9443
     securityContext:
       enabled: true
     podSecurityContext:
       enabled: true
       runAsNonRoot: true
       seccompProfile:
         type: RuntimeDefault
     containerSecurityContext:
       enabled: true
       allowPrivilegeEscalation: false
       capabilities:
         drop:
           - ALL
     resources:
       requests:
         cpu: 10m
         memory: 50Mi
     basePath: /
     certificateSecretName: ""
     serviceAccount:
       create: true
       annotations: {}
       name: ""
     patcherServiceAccount:
       create: true
       annotations: {}
       name: ""
     jobs:
       patchConsoles:
         enabled: true
         image: "registry.redhat.io/openshift4/ose-tools-rhel8@sha256:e44074f21e0cca6464e50cb6ff934747e0bd11162ea01d522433a1a1ae116103"
         podSecurityContext:
           enabled: true
           runAsNonRoot: true
           seccompProfile:
             type: RuntimeDefault
         containerSecurityContext:
           enabled: true
           allowPrivilegeEscalation: false
           capabilities:
             drop:
               - ALL
         resources:
           requests:
             cpu: 10m
             memory: 50Mi

1. 웹 콘솔의 Administrator 모드에서 Operator → OperatorHub로 이동합니다.
2. 키워드로 필터링 상자를 사용하여 카탈로그에서 Web Terminal Operator를 검색한 다음 Web Terminal 타일을 클릭합니다.
3. Web Terminal 페이지에서 Operator에 대한 간략한 설명을 확인하고Install을 클릭합니다.

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

   • Update Channel 메뉴의 fast 옵션으로 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 페이지에 나열되어 있는지 확인합니다.

   참고

   Web Terminal Operator는 DevWorkspace Operator를 종속성으로 설치합니다.

7. Operator가 설치되면 페이지를 새로 고침하여 콘솔 마스트 헤드에 있는 명령행 터미널 아이콘( )을 확인합니다.

1. Operator를 설치할 때 추가된 Web Terminal Operator 및 관련 사용자 지정 리소스(CR)를 제거합니다.
2. Web Terminal Operator의 종속성으로 추가된 DevWorkspace Operator 및 관련 사용자 정의 리소스를 설치 제거합니다.

1. Administrator 또는 Developer 모드에서 Help 아이콘을 클릭하고 Quick Starts를 선택합니다.
2. 퀵 스타트 카드를 클릭합니다.
3. 표시되는 창에서 Start를 클릭합니다.
4. 화면에 있는 지침을 실행 완료한 후 Next를 클릭합니다.

5. 표시되는 Check your work 모듈에서 질문에 대답하여 작업을 완료했는지 확인합니다.

   1. Yes를 선택한 경우 Next를 클릭하여 다음 작업으로 이동합니다.
   2. No를 선택하면 작업 단계를 반복하고 작업을 다시 확인하십시오.
6. 위의 1단계에서 6단계를 반복하여 퀵 스타트의 나머지 작업을 완료합니다.
7. 마지막 작업이 완료되면 Close를 클릭하여 퀵 스타트를 종료합니다.

절차

1. 새로운 퀵 스타트를 만들려면 다음을 실행합니다.

   $ oc get -o yaml consolequickstart spring-with-s2i > my-quick-start.yaml

2. 다음을 실행합니다.

   $ oc create -f my-quick-start.yaml

3. 이 문서에 설명된 지침을 사용하여 YAML 파일을 업데이트합니다.
4. 편집한 내용을 저장합니다.