2.4. OpenShift 4.x에서 Fuse 콘솔 설정

절차

1. 클러스터 관리자 액세스 권한이 있는 사용자로 OpenShift에 로그인합니다.

   oc login -u <user_with_cluster_admin_role>

2. 다음 명령을 실행하여 서비스 서명 인증 기관 키를 검색합니다.

   • 인증서를 검색하려면 다음을 수행합니다.

     oc get secrets/signing-key -n openshift-service-ca -o "jsonpath={.data['tls\.crt']}" | base64 --decode > ca.crt

   • 개인 키를 검색하려면 다음을 수행합니다.

     oc get secrets/signing-key -n openshift-service-ca -o "jsonpath={.data['tls\.key']}" | base64 --decode > ca.key

3. easyrsa,openssl 또는 cfssl 을 사용하여 Kubernetes 인증서 관리에 설명된 대로 클라이언트 인증서를 생성합니다.

   다음은 openssl을 사용하는 예제 명령입니다.

   1. 개인 키를 생성합니다.

      openssl genrsa -out server.key 2048

   2. CSR 구성 파일을 작성합니다.

      cat <<EOT >> csr.conf
        [ req ]
        default_bits = 2048
        prompt = no
        default_md = sha256
        distinguished_name = dn
      
        [ dn ]
        CN = fuse-console.fuse.svc
      
        [ v3_ext ]
        authorityKeyIdentifier=keyid,issuer:always
        keyUsage=keyEncipherment,dataEncipherment,digitalSignature
        extendedKeyUsage=serverAuth,clientAuth
      EOT

   3. CSR을 생성합니다.

      openssl req -new -key server.key -out server.csr -config csr.conf

   4. 서명된 인증서를 발급합니다.

      openssl x509 -req -in server.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out server.crt -days 10000 -extensions v3_ext -extfile csr.conf

1. 웹 브라우저에서 클러스터 관리자 액세스 권한이 있는 사용자로 OpenShift 콘솔에 로그인합니다.
2. 홈 > 프로젝트를 선택한 다음 Fuse 콘솔을 추가할 프로젝트를 선택합니다.
3. Operators 를 클릭한 다음 OperatorHub 를 클릭합니다.
4. 검색 필드 창에서 Fuse Console 을 입력하여 Operator 목록을 필터링합니다.
5. Fuse Console Operator 를 클릭합니다.

6. Fuse Console Operator 설치 창에서 설치를 클릭합니다.

   Create Operator Subscription 양식이 열립니다.

   • 설치 모드 의 경우 Fuse Console Operator를 특정 네임스페이스(현재 OpenShift 프로젝트)에 설치합니다.

     그런 다음 Operator를 설치한 후 Fuse Console을 배포하여 클러스터의 모든 네임스페이스에서 애플리케이션을 모니터링하거나 Fuse Console Operator가 설치된 네임스페이스에서만 애플리케이션을 모니터링하도록 선택할 수 있습니다.

   • 승인 전략 의 경우 자동 또는 수동 을 선택하여 OpenShift에서 Fuse Console Operator에 대한 업데이트를 처리하는 방법을 구성할 수 있습니다.

     • 자동 업데이트를 선택하면 새 버전의 Fuse Console Operator가 사용 가능할 때 OLM(Operator Lifecycle Manager)은 개입 없이 Fuse Console의 실행 중인 인스턴스를 자동으로 업그레이드합니다.
     • 수동 업데이트를 선택하면 최신 버전의 Operator가 사용 가능할 때 OLM에서 업데이트 요청을 생성합니다. 클러스터 관리자는 Fuse Console Operator가 새 버전으로 업데이트되도록 해당 업데이트 요청을 수동으로 승인해야 합니다.

7. Subscribe를 클릭합니다.

   OpenShift는 현재 네임스페이스에 Fuse Console Operator를 설치합니다.

8. 설치를 확인하려면 Operator를 클릭한 다음 Installed Operators 를 클릭합니다. Operator 목록에서 Fuse Console을 볼 수 있습니다.

9. 터미널 창에서 OpenShift 4.x에서 Fuse Console 보안에서 생성한 인증서를 사용하여 시크릿을 생성하고, APP_NAME 이 Fuse Console 배포 이름(예: fuse-console)을 사용하여 Fuse 콘솔에 마운트합니다.

   oc create secret tls APP_NAME-tls-proxying --cert server.crt --key server.key

   예를 들어 Fuse Console 애플리케이션의 이름이 fuse-console 인 경우 다음 명령을 입력합니다.

   oc create secret tls fuse-console-tls-proxying --cert server.crt --key server.key

   성공하면 이 명령은 보안이 생성되었는지 확인하는 응답을 반환합니다. 예를 들면 다음과 같습니다.

   secret/fuse-console-operator-tls-proxying created

10. OpenShift 웹 콘솔을 사용하여 Fuse 콘솔을 배포하려면 다음을 수행합니다.

    1. 설치된 Operator 목록에서 이름 열에서 Fuse Console 을 클릭합니다.

    2. 제공된 API 아래의 개요 페이지에서 인스턴스 생성을 클릭합니다. 새 CRD(Custom Resource Definition) 파일이 열립니다.

       기본적으로 Fuse Console은 현재 네임스페이스에 배포됩니다.

    3. Fuse Console을 배포하여 현재 네임스페이스 내에서 애플리케이션을 검색하고 관리하려면 다음 단계로 건너뜁니다.

       선택적으로 클러스터(및 인증된 사용자)에 있는 모든 네임스페이스에서 애플리케이션을 검색하고 관리하려면 spec.type 필드의 값을 네임스페이스 에서 클러스터로 변경하여 CRD 파일을 편집합니다.

    4. 생성을 클릭합니다.

       Fuse Console을 배포한 후 Fuse Console CRD 페이지가 새 Fuse Console 서비스를 표시합니다.

1. 네임스페이스 배포의 경우 OpenShift 웹 콘솔에서 Fuse Console Operator를 설치한 프로젝트를 열고 개요 를 선택합니다. 프로젝트 개요 페이지에서 시작 자 섹션까지 아래로 스크롤하고 Fuse Console URL을 클릭하여 엽니다.

   클러스터 배포의 경우 OpenShift 웹 콘솔의 제목 표시줄에서 그리드 아이콘( )을 클릭합니다. 팝업 메뉴의 Red Hat 애플리케이션 에서 Fuse Console URL 링크를 클릭합니다.

2. Fuse 콘솔에 로그인합니다.

   필요한 권한이 나열된 브라우저에서 권한 부여 페이지가 열립니다.

3. 선택한 권한 허용을 클릭합니다.

   브라우저에서 Fuse Console이 열리고 액세스할 수 있는 권한이 있는 Fuse 애플리케이션 포드가 표시됩니다.

4. 확인할 애플리케이션에 대한 연결을 클릭합니다.

   Fuse Console에 애플리케이션이 표시되는 새 브라우저 창이 열립니다.

절차

1. 다음 명령을 사용하여 모든 템플릿 목록을 검색하여 Fuse Console 이미지 스트림이 설치되었는지 확인합니다.

   oc get template -n openshift

2. 선택적으로 이미 설치된 이미지 스트림을 새 릴리스 태그로 업데이트하려면 다음 명령을 사용하여 Fuse Console 이미지를 openshift 네임스페이스로 가져옵니다.

   oc import-image fuse7/fuse7-console:1.7 --from=registry.redhat.io/fuse7/fuse-console:1.7 --confirm -n openshift

3. 다음 명령을 실행하여 Fuse Console APP_NAME 값을 가져옵니다.

   oc process --parameters -f TEMPLATE-FILENAME

   여기서 TEMPLATE-FILENAME 은 다음 템플릿 중 하나입니다.

   • 클러스터 템플릿:

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-cluster-os4.json

   • 구성 가능한 RBAC가 있는 클러스터 템플릿:

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-cluster-rbac.yml

   • 네임스페이스 템플릿:

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-namespace-os4.json

   • 구성 가능한 RBAC가 있는 네임스페이스 템플릿:

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-namespace-rbac.yml

     예를 들어 구성 가능한 RBAC가 있는 클러스터 템플릿의 경우 다음 명령을 실행합니다.

     oc process --parameters -f https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-cluster-rbac.yml

4. OpenShift 4.x에서 Fuse Console 보안에서 생성한 인증서에서 다음 명령을 사용하여 시크릿을 생성하고 Fuse Console에 마운트합니다(여기서 APP_NAME 은 Fuse Console 애플리케이션의 이름입니다).

   oc create secret tls APP_NAME-tls-proxying --cert server.crt --key server.key

5. 다음 명령을 실행하여 Fuse Console 템플릿의 로컬 복사본을 기반으로 새 애플리케이션을 생성합니다. 여기서 myproject 는 OpenShift 프로젝트의 이름, mytemp 는 Fuse Console 템플릿이 포함된 로컬 디렉터리의 경로입니다. myhost 는 Fuse Console에 액세스할 수 있는 호스트 이름입니다.

   • 클러스터 템플릿의 경우:

     oc new-app -n myproject -f {templates-base-url}/fuse-console-cluster-os4.json  -p ROUTE_HOSTNAME=myhost”

   • RBAC 템플릿이 있는 클러스터의 경우:

     oc new-app -n myproject -f {templates-base-url}/fuse-console-cluster-rbac.yml -p ROUTE_HOSTNAME=myhost”

   • 네임스페이스 템플릿의 경우:

     {templates-base-url}/fuse-console-namespace-os4.json

   • RBAC 템플릿이 있는 네임스페이스의 경우:

     oc new-app -n myproject -f {templates-base-url}/fuse-console-namespace-rbac.yml

6. OpenShift 웹 콘솔을 열 수 있도록 Fuse Console을 구성하려면 다음 명령을 실행하여 OPENSHIFT_WEB_CONSOLE_URL 환경 변수를 설정합니다.

   oc set env dc/${APP_NAME} OPENSHIFT_WEB_CONSOLE_URL=`oc get -n openshift-config-managed cm console-public -o jsonpath={.data.consoleURL}`

7. 다음 명령을 실행하여 Fuse Console 배포의 상태 및 URL을 가져옵니다.

   oc status

8. 브라우저에서 Fuse 콘솔에 액세스하려면 7단계로 반환되는 URL(예: https://fuse-console.192.168.64.12.nip.io)을 사용합니다.

1. 터미널 창에서 다음 명령을 사용하여 애플리케이션 사용자 정의 리소스 정의의 .spec.version 필드를 변경합니다.

   oc patch <project-name> <custom-resource-name> --type='merge' -p '{"spec":{"version":"1.7.1"}}'

   예를 들면 다음과 같습니다.

   oc patch myproject example-fuseconsole --type='merge' -p '{"spec":{"version":"1.7.1"}}'

2. 애플리케이션 상태가 업데이트되었는지 확인합니다.

    oc get myproject

   응답에는 버전 번호를 포함하여 애플리케이션에 대한 정보가 표시됩니다.

   NAME                  AGE   URL                                        IMAGE
   example-fuseconsole   1m    https://fuseconsole.192.168.64.38.nip.io   docker.io/fuseconsole/online:1.7.1

   .spec.version 필드의 값을 변경하면 OpenShift에서 애플리케이션을 자동으로 재배포합니다.

3. 버전 변경으로 트리거되는 재배포 상태를 확인하려면 다음을 수행합니다.

   oc rollout status deployment.v1.apps/example-fuseconsole

   성공적인 배포에는 다음 응답이 표시됩니다.

   deployment "example-fuseconsole" successfully rolled out