OpenShift Container Platform에 온라인 설치 및 운영 체제


Red Hat Fuse 7.9

Fuse Online 설치, 구성 및 업그레이드, CI/CD 파이프라인에 대한 통합 내보내기/가져오기

Red Hat Fuse Documentation Team

초록

고객 관리 환경, 클라우드 또는 하이브리드 클라우드에서 OpenShift Container Platform에 Fuse Online을 설치, 관리 및 운영하기 위한 정보와 지침입니다.

머리말

OCP(OpenShift Container Platform)에 Fuse Online 사이트를 설치하고 작동할 수 있습니다. Fuse Online이 사이트에서 실행되는 경우 Fuse Online이 OpenShift Dedicated에서 실행되는 경우 제공되는 기능 외에도 추가 기능을 사용할 수 있습니다.

현장 이라는 용어는 고객이 관리하는 환경을 의미합니다. Red Hat은 OpenShift 환경을 관리하지 않습니다. 고객 관리 환경은 온프레미스, 클라우드 또는 하이브리드 클라우드에 있을 수 있습니다.

자세한 내용은 다음 항목을 참조하십시오.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지에서 참조하십시오.

1장. OCP 4.x에 Fuse Online 설치

Fuse Online은 핵심 통합 기능을 서비스로 제공하는 유연하고 사용자 지정 가능한 오픈 소스 플랫폼입니다.

Fuse Online의 각 설치를 Fuse Online 인스턴스(또는 환경)라고 합니다. 지정된 OpenShift 프로젝트에는 정확히 하나의 Fuse Online 인스턴스가 있을 수 있습니다. 각 Fuse Online 인스턴스에는 고유한 URL이 있습니다. 단일 OpenShift 클러스터에는 여러 Fuse Online 인스턴스가 있을 수 있습니다.

OperatorHub에서 Operator를 설치할 수 있는 적절한 권한이 있는 경우 OpenShift 개발자 사용자로 Fuse Online을 설치할 수 있습니다. 기본 Fuse Online 인스턴스 또는 사용자 지정 Fuse Online 인스턴스를 설치할 수 있습니다. 사용자 지정 Fuse Online 인스턴스의 경우 기본 사용자 지정 리소스를 편집해야 합니다.

중요

Fuse Online 설치 프로세스에서는 컨테이너 이미지의 Red Hat Ecosystem Catalog인 registry.redhat.io 에 액세스해야 합니다.

다음 주제에서는 Fuse Online 설치에 대한 세부 정보를 제공합니다.

1.1. OCP 4.x에 Fuse Online을 설치하는 데 필요한 단계 개요

OCP 4.x에 Fuse Online을 설치하려면 다음과 같은 주요 단계를 따르십시오.

  1. Red Hat 컨테이너 이미지에 대한 인증을 구성하는 OpenShift 시크릿을 생성합니다.
  2. OperatorHub에서 클러스터의 프로젝트(네임스페이스)에 Fuse Online Operator를 설치합니다.
  3. 선택적으로 연결 및 통합 정의를 유지하기 위해 외부 데이터베이스를 포함하려면 OpenShift 시크릿을 생성합니다.
  4. OpenShift 4.x 프로젝트에 Fuse Online 인스턴스를 추가합니다.

    선택적으로 사용자 지정 리소스를 편집하여 하나 이상의 추가 기능 기능을 활성화하고/또는 하나 이상의 사용자 지정 구성 설정을 구현합니다.

  5. 선택적으로 Fuse Online 웹 콘솔에 액세스할 수 있도록 다른 개발자 사용자에게 권한을 부여합니다.

제한된 환경에 Fuse Online을 설치하기 전에 다음 작업을 완료해야 합니다.

  • 모든 Fuse Online 이미지를 프라이빗 네트워크에서 사용 가능한 위치에 미러링합니다. 제한된 환경에서 OpenShift Operator의 이미지를 설치하는 방법에 대한 자세한 내용은 OpenShift 문서의 제한된 네트워크에서 Operator Lifecycle Manager 사용 섹션을 참조하십시오.
  • Fuse 리포지토리 콘텐츠를 사용하여 사용자 지정 Maven 리포지토리를 설정합니다. 자세한 내용은 Red Hat 솔루션 " Fuse 7용 오프라인 Maven 리포지토리를 생성하는 방법" https://access.redhat.com/solutions/3746581 에서 참조하십시오.
  • Fuse Online을 설치하기 전에 기본 사용자 지정 리소스 파일 편집에 설명된 대로 Fuse Online 사용자 지정 리소스를 편집합니다.

    • mavenRepositories 설정을 사용하여 개발자가 통합을 빌드하고 실행할 때 Fuse Online에서 필요한 종속성을 가져올 수 있도록 오프라인 Maven 리포지토리를 지정합니다.

      다음 예에서 customRepo 를 오프라인 Maven 리포지토리의 이름으로 바꾸고 https://customRepo 를 오프라인 리포지토리의 URL로 바꿉니다.

      components:
        server:
          features:
            maven:
              repositories:
                customRepo: https://customRepo
      Copy to Clipboard Toggle word wrap
    • 활성화된 값을 false 로 변경하여 todo 애드온을 비활성화합니다.

      spec:
        addons:
          todo:
            enabled: false
      Copy to Clipboard Toggle word wrap

제한된 환경에 Fuse Online을 설치한 후 필요한 경우 https://github.com/syndesisio/todo-example 에서 todo 애플리케이션을 다운로드하고 Readme 파일의 단계를 수행하여 리포지토리 URL을 개인 네트워크에서 사용할 수 있는 위치로 변경할 수 있습니다.

Fuse Online 설치에는 구성 가능한 Fuse Online 환경 추가 기능 및 매개 변수 설정에 대한 기본 설정을 지정하는 기본 사용자 지정 리소스가 포함되어 있습니다.

Fuse Online 환경을 다음과 같이 사용하려면 Fuse Online을 설치하기 전에 기본 사용자 지정 리소스를 편집해야 합니다.

  • Fuse Online 콘솔에 도달할 수 있는 OpenShift 경로에 지정하는 URL을 사용합니다. 기본값은 설치 프로세스에서 이 경로를 계산하는 것입니다.
  • 외부 데이터베이스를 사용하여 연결 및 통합 정의를 저장합니다. 기본값은 환경에서 내부 데이터베이스를 사용한다는 것입니다.
  • 연결 및 통합 정의 유지에 사용할 수 있는 내부 스토리지의 양을 늘립니다. 기본적으로 1Gi 는 대부분의 Fuse Online 환경에 충분합니다.

이러한 동작 중 하나에 대해 Fuse Online 환경을 구성하려면 Fuse Online을 설치할 때 사용자 지정 리소스를 편집해야 합니다. 즉, 설치된 Fuse Online 환경의 구성을 변경하여 이러한 동작을 구현할 수 없습니다. 또한 이러한 동작에 맞게 구성된 Fuse Online 환경을 설치한 후에는 설치된 환경의 해당 동작을 변경할 수 없습니다.

1.3. Fuse Online을 구성하는 사용자 정의 리소스 속성에 대한 설명

설치 전에만 지정할 수 있는 사용자 정의 리소스 속성 외에도 설치 전이나 후에 변경할 수 있는 여러 사용자 지정 리소스 속성이 있습니다.

표 1은 구성 가능한 사용자 정의 리소스 설정에 대한 간략한 설명을 제공하고 설치 전 및/또는 설치 후의 변경 시기를 나타냅니다. 원하는 Fuse Online 구성을 달성하려면 이 테이블의 정보를 사용하여 설치 전에 사용자 지정 리소스를 변경하는 방법 또는 설치 후 변경할 방법을 결정합니다. 그런 다음 적절한 절차를 따르십시오.

OCP 4.x의 경우:

OCP 3.11의 경우:

Expand
표 1.1. 구성 가능한 사용자 정의 리소스 설정
기능/설정이 값을 설정할 수 있는 경우사양

향상된 활동 추적

활동 추적 강화에 대한 추가 정보는 이 표를 따릅니다.

설치 전만 설정

addons:
jaeger:
enabled: true
clientOnly: false
operatorOnly: false

향상된 활동 추적이 기본적으로 활성화되어 있습니다. Jaeger 구성을 사용자 지정하려면 clientOnly 또는 operatorOnlytrue 로 설정할 수 있습니다.

외부 데이터베이스

외부 데이터베이스 사용에 대한 추가 정보는 이 표를 따릅니다.

설치 전만 설정

spec:
구성 요소:
database:
externalDbURL: postgresql://custom-postgres:5432
user: db-user-name
name: db-name


custom-postgres:5432 를 PostgreSQL 데이터베이스의 호스트 이름 및 포트로 바꿉니다.
db-user-name 을 해당 데이터베이스에 액세스할 수 있는 사용자 계정 이름으로 교체합니다.
db-name 을 데이터베이스 이름으로 교체합니다.

연결 및 통합을 위한 내부 스토리지 용량.

외부 데이터베이스도 지정하는 경우 무시됩니다.

내부 스토리지 증가에 대한 자세한 내용은 이 표를 따릅니다.

설치 전만 설정

spec:
구성 요소:
데이터베이스:
리소스:
volumeCapacity: 1Gi
volumeName: my-volume


1Gi 를 필요한 스토리지 용량으로 바꿉니다. 기본값은 1Gi 입니다.

my-volume 을 내부 스토리지에 사용할 볼륨의 이름으로 교체합니다. 이 매개변수는 선택 사항입니다.

Fuse Online 콘솔에 액세스하기 위한 OpenShift 경로

설치 전만 설정

spec:
routeHostname: project.route.com


Fuse Online 콘솔에 도달할 수 있는 OpenShift 경로로 project.route.com 을 바꿉니다.
예: north-project.6a63.fuse-online.openshiftapps.com

메모리CPU

하나 이상의 구성 요소에서 사용할 수 있는 기본 메모리 양을 늘립니다.

각 구성 요소는 자체 메모리 요구 사항을 정의합니다. 즉, 각 pod에는 할당된 메모리 양에 제한이 있습니다. 제한 및 요청 설정에 대한 자세한 내용은 OpenShift 문서의 컨테이너 메모리 및 위험 요구 사항을 충족하기 위해 클러스터 메모리 구성 섹션을 참조하십시오.

서버 구성 요소의 CPU 리소스를 지정할 수도 있습니다.

데이터베이스 구성 요소는 연결 및 통합 정의를 저장하는 내부 데이터베이스입니다.

메타 구성 요소는 서버가 로드하는 커넥터와 같은 비즈니스 논리를 제공합니다.

prometheus 구성 요소는 Fuse Online 인프라 구성 요소 및 Fuse Online 통합을 모니터링합니다.

설치 전만 설정

components:
server:
resources:
limit:
memory: "1024Mi"
cpu: "800m"
request:
memory: "512Mi" Cryostat cpu: "500m" Cryostat meta: Cryostat resources: Cryostat limit: Cryostat




memory: "750Mi"
request:
memory: "300Mi"
database: "300Mi"
database:
resources:
limit:
memory: "300Mi"
request:
memory: "300Mi"
prometheus: Cryostat resources: Cryostat limit: Cryostat limit: Cryostat limit

memory: "750Mi"
request:
memory: "750Mi"

3scale 검색

Fuse Online API 공급자 통합을 위한 API를 노출하여 Red Hat 3scale에서 검색할 수 있습니다.

자세한 내용은 API를 3scale 검색을 사용하도록 Fuse Online 구성입니다.

설치 전후 설정

구성 요소:
기능:
managementUrlFor3scale: https://url-for-3scale

3scale 사용자 인터페이스의 URL을 지정합니다.

백업

Fuse Online 환경 백업에 추가 설정 단계를 설명합니다.

설치 전후 설정

spec:
backup:
schedule: interval


을 백업 간에 원하는 기간으로 바꿉니다. 간격사전 정의된 일정에 cron 유틸리티 형식을 사용합니다. 간격 앞에 @ 기호를 지정하지 마십시오.

노드 유사성허용 오차

Fuse Online 인프라 구성 요소의 배치와 클러스터 내 노드에 Pod를 통합하는 방법을 결정합니다.

노드 선호도를 사용하면 사용할 노드 그룹으로 Fuse Online Pod의 선호도를 지정할 수 있습니다.

허용 오차를 사용하면 Fuse Online Pod가 실행되는 노드를 제어하고 다른 워크로드가 해당 노드를 사용하지 못하도록 할 수 있습니다.

Fuse Online Pod 구성 도 참조하십시오.

설치 전후 설정

참고: Fuse Online 인프라 구성 요소 배포에 infraScheduling 을 사용합니다. Fuse Online 통합 배포의 경우 infraScheduling통합 스케줄링으로 교체합니다.

spec:
infraScheduling:
tolerations:
key: value
operator: value
effect: value


spec:
infraScheduling: Cryostat affinity: Cryostat affinity: Cryostat nodeAffinity: Cryostat preferredDuringSchedulingIgnoredDuringExecution: Cryostat weight: Cryostat weight: Cryostat




preference:
matchExpressions:
key: value
operator: value
values:
value1,
value2



통합 제한실행 중인 최대 통합 수를 지정합니다. 기본값은 실행 중인 통합 수를 제한하지 않습니다.

설치 전후 설정

components:
server:
기능:
integrationLimit: 0

데이터베이스 연결 풀

서버 연결 풀 구성을 조정하여 데이터베이스 연결을 관리할 수 있습니다.

데이터베이스 풀 구성에 대한 자세한 내용은 이 표를 따릅니다.

설치 전후 설정

구성 요소:
server:
connectionPool:
connectionTimeout: 30000
idleTimeout: 600000
leakDetectionThreshold: 0
maxLifetime: 1800000
maximumPoolSize: 10
minimumIdle: 10

Java 옵션

syndesis-serversyndesis-meta 구성 요소에 대한 Java 옵션을 지정할 수 있습니다.

Java 옵션에 따라 구성 요소에 대해 다른 값을 지정할 수 있습니다. 예를 들어 syndesis-meta 보다 많은 컴퓨터 리소스가 필요하므로 syndesis-server 에 대한 JVM 관련 매개변수를 설정할 수 있습니다.

설치 전후 설정

components:+ server:
javaOptions:
-option_name=my_value meta:
javaOptions:
-option_name=my_value

-option_name 을 Java 옵션 이름으로 바꿉니다. Java 옵션 접두사(-D,-X 또는 -XX)를 지정할 수 있습니다.

my_value 를 옵션의 값으로 바꿉니다.

예를 들어 HTTP 프록시를 구성하려면 components:+ server:
javaOptions:
-Dhttp.proxyHost=10.0.0.0.0.100 -Dhttp.proxyPort=8800 메타:
javaOptions:
-Dhttp.proxyHost=10.0.0.100 -Dhttp.proxyPort=8800'

Maven 인수

Fuse Online 통합을 빌드할 때 사용할 추가 Maven 옵션을 지정합니다.

설치 전후 설정

components:
server:
features:
maven:
additionalArguments:
"typeA=stringA typeB=stringB"


:
additionalArguments: Cryostat "-Dhttp.proxy=my_proxy -DpropA=valueA"

Maven 리포지토리

Fuse Online 환경에 액세스해야 하는 외부 Maven 리포지토리를 지정합니다.

설치 전후 설정

구성 요소:
server:
features:
mavenRepotories:
customRepo1:
customRepo2:


customRepo 를 리포지토리 이름으로 바꿉니다.
각 리포지토리에 대해 해당 URL을 지정합니다.

Monitoring

도 참조하십시오. Prometheus를 사용하여 OCP에서 Fuse Online 통합 모니터링.

설치 전후 설정

addons:
ops:
enabled: true

퍼블릭 REST API

추가 설정 단계는 외부 툴에서 사용하기 위해 Fuse Online 공용 REST API 끝점을 추가하는 데 설명되어 있습니다.

설치 전후 설정

addons:
publicApi:
enabled: true
routeHostname: public-syndesis.192.168.64.63.nip.io


routeHostname 을 Fuse Online REST API 엔드포인트를 호출하는 공용 주소로 설정합니다. 클러스터 설정에 따라 지정해야 하는 공용 주소가 결정됩니다. 이전 예에서 경로 호스트 이름은 Minishift 클러스터에 유효합니다.

demoData
샘플 PostgreSQL 데이터베이스와 샘플 데이터베이스 커넥터를 제공합니다.

설치 전후 설정

spec:
demoData: false

todo 애드온을 true 로 설정하는 경우 demoData 옵션도 true 로 설정해야 합니다.

Todo 앱
샘플 통합 테스트용.

설치 전후 설정

spec:
addons:
todo:
enabled: false

todo addon을 true 로 설정하면 demoData 옵션이 true 로 설정되어 있는지 확인해야 합니다.
제한된 환경에 Fuse Online을 설치하려면 설치 전에 todo 애드온을 false (기본값)로 설정해야 합니다. Fuse Online을 설치한 후 https://github.com/syndesisio/todo-example 에서 todo 애플리케이션을 다운로드하여 Readme 파일의 단계를 수행하여 리포지토리 URL을 사설 네트워크에서 사용할 수 있는 위치로 변경할 수 있습니다.

OCP에서 실행되는 Fuse Online 환경에 샘플 데이터 추가를 참조하십시오.

감사

커넥터, 연결 및 통합에 대한 기본 변경 사항을 보려면 다음을 수행합니다.

Fuse Fuse Online 구성 요소 감사 도 참조하십시오.

참고: 기술 프리뷰 기능입니다.

설치 전후 설정

구성 요소:
server:
기능:
감사: true

애드온 기능 및 구성 설정 정보

  • 활동 추적 기능 개선

    Fuse Online을 설치할 때 Jaeger를 사용하는 활동 추적은 기본적으로 활성화됩니다. Fuse 온라인 설치( OperatorHub 또는 명령줄 스크립트에서)는 OperatorHub의 존재를 감지하고 OperatorHub의 서브스크립션 기능을 사용하여 Jaeger를 설치합니다. OperatorHub를 사용할 수 없는 제한된 환경의 경우 Fuse Online은 자체 설치 기능을 사용하여 Jaeger를 설치합니다. 선택적으로 Jaeger 모니터링에 Fuse Online 구성 섹션에 설명된 대로 Fuse Online을 설치하기 전에 Jaeger 구성 을 사용자 지정할 수 있습니다.

  • 연결 및 통합을 유지하기 위한 외부 데이터베이스

    기본 설치는 Fuse Online에서 연결 및 통합 정의를 유지하기 위해 사용하는 내부 PostgreSQL 데이터베이스를 제공합니다. 대신 OpenShift에서 기본적으로 제공하는 PostgreSQL 템플릿 중 하나와 같이 외부 PostgreSQL 데이터베이스를 사용하도록 선택할 수 있습니다.

  • 내부 스토리지 용량

    1Gi 의 기본 설정은 대부분의 Fuse Online 환경에 충분합니다. Red Hat 기술 지원을 권장하는 경우에만 새로운 Fuse Online 설치에 대해 이 설정을 늘릴 것으로 예상됩니다. 즉, Fuse Online 서버 오류가 발생한 다른 Fuse Online 환경을 실행하고 있으며 Red Hat 기술 지원은 기본값보다 큰 데이터베이스 볼륨 용량을 사용하여 새 Fuse Online 환경을 설치해야 함을 확인했습니다.

    이미 Fuse Online을 실행 중인 OpenShift 프로젝트에서 Fuse Online 내부 스토리지 용량을 늘리려면 먼저 Fuse Online을 제거해야 합니다. OCP 프로젝트에서 Fuse Online 설치 제거를 참조하십시오.

  • 데이터베이스 연결 풀 구성

    다음과 같은 syndesis-server 데이터베이스 연결 풀 속성을 구성할 수 있습니다.

    • ConnectionTimeout - syndesis-server 가 풀에서 연결을 기다리는 최대 밀리초 수입니다. 허용 가능한 가장 낮은 연결 시간 초과는 250ms입니다. 기본값은 30000(30초)입니다.
    • IdleTimeout - 연결이 제거되기 전에 풀에서 유휴 상태로 유지할 수 있는 최대 시간(밀리초)입니다. 값이 0이면 유휴 연결이 풀에서 제거되지 않습니다. 허용되는 최소 값은 10000(10초)입니다. 기본값은 600000(10분)입니다.
    • leakDetectionThreshold - 메시지가 기록되기 전에 연결이 풀에서 부족할 수 있는 시간(밀리초)입니다. 값이 0이면 누출 탐지가 비활성화되어 있습니다. 누출 탐지를 가능하게 하는 가장 낮은 허용 가능한 값은 2000초(2초)입니다. 기본값은 0입니다.
    • maxLifetime - 풀에 있는 연결의 최대 수명(밀리초)입니다. 허용되는 최소 값은 30000(30초)입니다. 기본값은 1800000 (30 분)입니다.
    • maximumPoolSize - 유휴 연결 및 사용 중인 연결을 모두 포함하여 풀에 연결할 수 있는 최대 크기입니다. 기본값은 10입니다.
    • minimumIdle - 풀에서 유지 관리되는 최소 유휴 연결 수입니다. 기본값은 maximumPoolSize 의 값입니다.

1.4. Jaeger 모니터링을 위한 Fuse Online 구성 정보

Jaeger는 분산 서비스 간의 트랜잭션을 추적하기 위한 오픈 소스 소프트웨어입니다. 특히 복잡한 마이크로 서비스 환경을 모니터링하고 해결하는 데 유용합니다.

OperatorHub에서 또는 명령줄 스크립트를 사용하여 Fuse Online을 설치할 때 Fuse Online 설치는 OperatorHub의 존재를 감지하고 OperatorHub의 서브스크립션 기능을 사용하여 Jaeger를 설치합니다. OperatorHub를 사용할 수 없는 제한된 환경의 경우 Fuse Online은 자체 설치 기능을 사용하여 Jaeger를 설치합니다.

기본 Fuse Online 환경은 필요한 모든 Jaeger 구성 요소를 구성합니다. 선택적으로 Fuse Online 사용자 정의 리소스를 편집하여 클라이언트 전용/독립 실행형 서버 구성 또는 하이브리드 Jaeger 클라이언트 및 Jaeger Operator 구성을 지정할 수 있습니다.

기본 Jaeger 구성

기본 제공되는 기본 구성 요소에는 모든 Jaeger 구성 요소가 포함됩니다. 모니터링 기능을 실험하여 Jaeger의 작동 방식에 대한 교육을 시작할 수 있습니다. 기본 구성은 메모리 전용, 제한된 백엔드 스토리지 기능을 제공합니다.

기본 Jaeger 구성으로 Fuse Online을 설치하면 다음과 같은 결과가 발생합니다.

  • Fuse Online 구성 요소에는 Jaeger 통신 URL이 있습니다.
  • Jaeger Operator가 설치되어 있습니다.
  • Jaeger 사용자 정의 리소스는 활동 모니터링을 위한 기본 구성으로 구성됩니다.

기본 Jaeger 구성이 포함된 Fuse Online 설치에는 다음과 같은 개요 사용자 정의 리소스 사양이 있습니다.

apiVersion: syndesis.io/v1beta2
kind: Syndesis
metadata:
  name: app
spec:
  addons:
    jaeger:
      enabled: true
Copy to Clipboard Toggle word wrap

clientOnlyoperatorOnly 가 지정되지 않은 경우(기본적으로 false 로 설정) Fuse Online에서 제공된 Jaeger 백엔드와 Jaeger 서버 구성에서 제공하는 기본 메모리 전용 스토리지를 사용합니다.

클라이언트 전용/독립 실행형 서버 구성

클라이언트 전용/독립 실행형 서버 구성을 사용하면 클라이언트 URL 연결만 Fuse Online과 외부적으로 구성된 Jaeger 백엔드 간의 통신을 위해 구성됩니다. Jaeger 백엔드의 모든 측면은 외부적이고 Fuse Online 환경 및 syndesis-operator 와 독립적입니다. 여기에는 Jaeger Operator 및 Jaeger 사용자 정의 리소스가 포함됩니다.

클라이언트 전용 Jaeger 구성을 설치하려면 다음과 같이 Fuse Online을 설치하기 전에 사용자 정의 리소스를 편집합니다.

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

apiVersion: syndesis.io/v1beta2
kind: Syndesis
metadata:
  name: app
spec:
  addons:
    jaeger:
      enabled: true
      clientOnly: true
      queryUri: https://jaeger-query-hostname:443/api
      collectorUri: https://jaeger-collector-hostname:14268/api/traces
Copy to Clipboard Toggle word wrap

하이브리드 Jaeger 클라이언트 및 Operator 구성

하이브리드 Jaeger 클라이언트 및 Jaeger Operator 구성을 사용하면 Fuse Online에서 Jaeger Operator 및 Jaeger 클라이언트 기능을 설치합니다. Jaeger 사용자 정의 리소스가 설치되지 않았습니다. Jaeger 서버 구성을 정의하는 자체 Jaeger 사용자 정의 리소스를 설치해야 합니다. 이를 통해 Fuse 온라인 제공 기능을 활용하고 자체 환경에 맞게 Jaeger 구성을 조정할 수 있습니다(예: 데이터 스토리지에 Elasticsearch 또는 Cryostat를 사용할 수 있습니다.

하이브리드 Jaeger 클라이언트 및 Jaeger Operator 구성을 설치하려면 다음을 수행합니다.

  • 다음 예와 같이 Fuse Online을 설치하기 전에 사용자 지정 리소스를 편집합니다.

    apiVersion: syndesis.io/v1beta2
    kind: Syndesis
    metadata:
      name: app
    spec:
      addons:
        jaeger:
          enabled: true
          operatorOnly: true
    Copy to Clipboard Toggle word wrap
  • 다음 예와 같이 Jaeger 사용자 정의 리소스 syndesis-jaeger 의 이름을 지정합니다.

    apiVersion: jaegertracing.io/v1
    kind: Jaeger
    metadata:
      name: syndesis-jaeger
      ...
    spec:
       ....
    Copy to Clipboard Toggle word wrap

    참고: 또는 Jaeger 사용자 정의 리소스에 다른 이름을 사용하려면 클라이언트 전용/독립 실행형 서버 구성 섹션에 설명된 대로 Syndesis 사용자 정의 리소스에서 queryUricollectorUri 를 설정합니다.

syndesis-jaeger 이름이 있는 Jaeger 사용자 정의 리소스가 생성되면 Jaeger 인스턴스는 Fuse Online 통합에서 데이터를 수집합니다. 기본적으로 이 데이터는 Fuse Online 활동 로그에서 볼 수 있습니다.

1.5. 외부 데이터베이스를 사용하여 Fuse Online 설치

외부 데이터베이스를 사용하여 연결 및 통합 정의를 유지하는 Fuse Online 환경을 설치하려면 다음을 수행합니다.

  • OpenShift 클러스터가 찾을 수 있는 호스트 이름으로 postgreSQL 데이터베이스를 생성합니다.
  • Fuse Online을 설치하기 전에 외부 데이터베이스에 대해 syndesis-global-config 라는 OpenShift 시크릿을 생성합니다.
  • Fuse Online을 설치합니다.
  • Fuse Online을 배포하기 전에 사용자 지정 리소스를 편집하여 외부 데이터베이스에 대한 연결을 구성합니다.

사전 요구 사항

  • OCP 3.11에만 default-cr.yml 파일을 편집하여 연결 및 통합 정의를 유지하기 위해 외부 데이터베이스 사용을 지정합니다.
  • Fuse Online은 아직 설치되지 않았습니다.
  • oc 클라이언트 툴이 설치되고 Fuse Online을 설치하려는 OCP 클러스터에 연결되어 있습니다.
  • 클러스터 관리 권한이 있는 사용자는 클러스터에서 액세스할 수 있는 권한이 있는 모든 프로젝트에 Fuse Online을 설치할 수 있는 권한을 부여했습니다.

절차

  1. Fuse Online을 설치할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u developer -p developer
    Copy to Clipboard Toggle word wrap
  2. Fuse Online을 설치하고 다음 구성 옵션에 대한 값을 정의하는 OpenShift 클러스터에서 사용할 수 있는 postgreSQL 데이터베이스를 만듭니다.

    • 연결 사용자 이름
    • 데이터베이스 이름
    • 데이터베이스 암호

      다음 예제에서는 OpenShift에서 기본적으로 제공하는 PostgreSQL 템플릿 중 하나를 사용합니다.

      참고: 개발 또는 테스트 목적으로 PostgreSQL 임시(postgresql-ephemeral) 템플릿만 사용합니다. 프로덕션 환경의 경우 PostgreSQL(postgresql) 템플릿을 사용합니다.

      oc new-app postgresql-ephemeral -p POSTGRESQL_USER=syndesis -p POSTGRESQL_PASSWORD=exdb-pwd -p POSTGRESQL_DATABASE=syndesisdb
      Copy to Clipboard Toggle word wrap

      이 명령은 URL과 같이 Fuse Online을 구성할 때 필요한 데이터베이스에 대한 정보를 반환합니다.

      데이터베이스 생성에 대한 자세한 내용은 OpenShift 문서의 PostgreSQL 항목을 참조하십시오.

  3. 다음 콘텐츠가 포함된 리소스 파일(예: my-fuse-online-secret-cr.yml)을 생성하고 저장합니다.

    apiVersion: v1
    kind: Secret
    metadata:
      name: syndesis-global-config
      namespace: my-fuse-online-project
    type: Opaque
    stringData:
      POSTGRESQL_PASSWORD: exdb-pw
    Copy to Clipboard Toggle word wrap

    my-fuse-online-project 를 외부 데이터베이스를 지정하는 Fuse Online 환경을 설치하려는 OpenShift 프로젝트의 이름으로 바꿉니다.

    exdb-pw 를 2 단계의 암호로 바꿉니다. Fuse Online에서는 외부 데이터베이스에 액세스하기 위한 암호로 사용합니다. stringData 는 password 값을 base64로 인코딩된 값으로 변환하므로 변환을 수행할 필요가 없습니다.

    OpenShift 보안에 대한 자세한 내용은 시크릿을 참조하십시오.

  4. 클러스터에 보안을 추가합니다. 예를 들면 다음과 같습니다.

    oc apply -f my-fuse-online-secret-cr.yml
    Copy to Clipboard Toggle word wrap

    OpenShift 클러스터에서는 외부 데이터베이스를 지정하는 사용자 지정 리소스와 함께 설치된 Fuse Online 환경에서 syndesis-global-config 시크릿을 사용할 수 있습니다.

  5. 보안에 대해 YAML 파일에서 지정한 my-fuse-online-project 프로젝트에 Fuse Online을 설치합니다(단계 4).

    • OCP 3.11의 경우 Fuse Online을 설치하기 전에 기본 사용자 지정 리소스 파일 편집의 지침을 따르십시오.
    • OCP 4.6 이상의 경우 OperatorHub에서 Fuse Online Operator 설치 지침을 따르십시오. Fuse Online을 배포하기 전에 OpenShift 4.x 프로젝트에 Fuse Online 인스턴스 추가 에서 사용자 지정 리소스를 편집하여 외부 데이터베이스 사용을 지정합니다. 예를 들면 다음과 같습니다.

      apiVersion: syndesis.io/v1alpha1
      kind: Syndesis
      metadata:
        name: app
      spec:
        components:
          database:
            externalDbURL: "postgresql://syndesis-external-db:5432"
            user: db-user-name
            name: db-name
      Copy to Clipboard Toggle word wrap
    • syndesis-external-db:5432 를 외부 PostgreSQL 데이터베이스의 호스트 이름 및 포트로 바꿉니다.
    • db-user-name 을 연결 사용자 이름으로 바꿉니다.
    • db-name 을 데이터베이스 이름으로 교체합니다.

결과

Fuse Online 설치 프로세스는 사용자 지정 리소스의 설정을 사용하여 설치된 Fuse Online 환경의 구성을 확인합니다.

올바르게 설치 및 배포하면 Fuse Online에서 syndesis-db 를 제외한 모든 필요한 Pod를 가져옵니다. syndesis-db 대신 syndesis-server 는 외부 데이터베이스의 서비스 이름으로 데이터베이스에 연결합니다. 외부 데이터베이스 구성이 올바르지 않으면 syndesis-server 가 초기화되지 않고 Fuse Online 배포가 오류로 끝납니다.

1.6. Fuse Online 설치

Fuse Online은 핵심 통합 기능을 서비스로 제공하는 유연하고 사용자 지정 가능한 오픈 소스 플랫폼입니다. OperatorHub에서 Operator를 설치할 수 있는 적절한 권한이 있는 경우 OpenShift 개발자 사용자로 Fuse Online을 설치할 수 있습니다.

다음은 Operator를 사용하여 Fuse Online을 설치하는 일반적인 단계입니다.

  1. OpenShift 프로젝트(네임스페이스)에 시크릿을 생성하여 registry.redhat.io 를 사용하여 인증을 구성하여 Fuse Online Operator가 필요한 설치 템플릿에 액세스할 수 있도록 합니다.
  2. Fuse Online Operator를 OpenShift 프로젝트(네임스페이스)에 설치합니다. Operator가 설치되면 선택한 네임스페이스에서 Operator가 실행됩니다.
  3. 설치된 Operator에서 Fuse Online 인스턴스를 만듭니다. 기본 설정으로 인스턴스를 생성하거나 인스턴스의 사용자 지정 리소스를 편집하여 인스턴스를 사용자 지정할 수 있습니다. 그런 다음 제공된 URL에서 Fuse Online에 액세스할 수 있습니다.

다음 주제에서는 Operator를 사용하여 OCP 4.x에 Fuse Online을 설치하는 데 필요한 세부 정보를 제공합니다.

1.6.1. 컨테이너 이미지의 경우 registry.redhat.io로 인증

OpenShift에 Fuse 컨테이너 이미지를 배포하기 전에 registry.redhat.io 를 사용하여 인증을 구성합니다.

사전 요구 사항

  • OpenShift Container Platform 클러스터에 대한 클러스터 관리자 액세스
  • OpenShift oc 클라이언트 툴이 설치되어 있습니다. 자세한 내용은 OpenShift CLI 설명서를 참조하십시오.

절차

  1. 관리자로 OpenShift 클러스터에 로그인합니다.

    oc login --user system:admin --token=my-token --server=https://my-cluster.example.com:6443
    Copy to Clipboard Toggle word wrap
  2. Fuse를 배포하려는 프로젝트를 엽니다.

    oc project myproject
    Copy to Clipboard Toggle word wrap
  3. Red Hat Customer Portal 계정을 사용하여 docker-registry 시크릿을 생성하고 PULL_SECRET_NAME 을 시크릿으로 교체하여 다음을 생성합니다.

    oc create secret docker-registry PULL_SECRET_NAME \
      --docker-server=registry.redhat.io \
      --docker-username=CUSTOMER_PORTAL_USERNAME \
      --docker-password=CUSTOMER_PORTAL_PASSWORD \
      --docker-email=EMAIL_ADDRESS
    Copy to Clipboard Toggle word wrap

    다음 출력이 표시되어야 합니다.

    secret/PULL_SECRET_NAME created
    Copy to Clipboard Toggle word wrap
    중요

    registry.redhat.io 에 인증할 모든 OpenShift 프로젝트 네임스페이스에 이 docker-registry 시크릿을 생성해야 합니다.

  4. 이미지를 가져오는 데 시크릿을 사용하도록 서비스 계정에 시크릿을 연결합니다. 다음 예제에서는 default 서비스 계정을 사용합니다.

    oc secrets link default PULL_SECRET_NAME --for=pull
    Copy to Clipboard Toggle word wrap

    서비스 계정 이름은 OpenShift pod에서 사용하는 이름과 일치해야 합니다.

  5. 빌드 이미지를 푸시하고 가져오는 데 보안을 사용하도록 builder 서비스 계정에 보안을 연결합니다.

    oc secrets link builder PULL_SECRET_NAME
    Copy to Clipboard Toggle word wrap
    참고

    Red Hat 사용자 이름과 암호를 사용하여 가져오기 보안을 생성하지 않으려면 레지스트리 서비스 계정을 사용하여 인증 토큰을 생성할 수 있습니다.

1.6.2. OperatorHub에서 Fuse Online Operator 설치

OpenShift Container Platform 웹 콘솔을 사용하여 OperatorHub에서 Fuse Online Operator를 설치할 수 있습니다. Fuse Online을 설치하려는 각 OpenShift 프로젝트(네임스페이스)에 대해 다음 단계를 따르십시오.

사전 요구 사항

절차

  1. 웹 브라우저에서 브라우저에서 OpenShift 콘솔로 이동한 다음 관리자 또는 개발자 인증 정보를 사용하여 콘솔에 로그인합니다.
  2. 관리자로 로그인한 경우 Operator 를 클릭한 다음 OperatorHub 를 클릭합니다.

    개발자로 로그인한 경우 추가 를 클릭하고 카탈로그에서 카드를 클릭합니다.
  3. 키워드로 필터링 필드에 Fuse Online 을 입력합니다.
  4. Red Hat Integration - Fuse 온라인 카드를 클릭합니다. Fuse Online Operator 설치 페이지가 열립니다.
  5. 설치를 클릭합니다. Operator 설치 페이지가 열립니다.

    1. 업데이트 채널은 Operator에 대한 업데이트 스트림을 정의하고 구독자에게 업데이트를 배포하는 데 사용됩니다. 기본 채널 7.n 을 수락합니다. 여기서 n 은 현재 Fuse Online 릴리스 번호입니다.
    2. 설치 모드 의 경우 클러스터의 네임스페이스 목록에서 네임스페이스(프로젝트)를 선택합니다. 컨테이너 이미지의 경우 registry.redhat.io 로 인증에서 docker 레지스트리 시크릿을 생성할 때 사용한 네임스페이스와 동일한 네임스페이스를 선택합니다.
    3. 승인 전략 의 경우 자동 또는 수동 을 선택하여 OpenShift에서 Fuse Online Operator에 대한 업데이트를 처리하는 방법을 구성합니다.

      • 자동 업데이트를 선택하면 새 버전의 Fuse Online Operator를 사용할 수 있는 경우 OpenShift Operator Lifecycle Manager(OLM)는 개입 없이 Fuse Online의 실행 중인 인스턴스를 자동으로 업그레이드합니다.
      • 수동 업데이트를 선택하면 최신 버전의 Operator가 사용 가능할 때 OLM에서 업데이트 요청을 생성합니다. 그러면 클러스터 관리자가 Fuse Online Operator가 새 버전으로 업데이트되도록 해당 업데이트 요청을 수동으로 승인해야 합니다.
  6. 설치를 클릭하여 지정된 네임스페이스(프로젝트)에서 Fuse Online Operator를 사용할 수 있도록 합니다.
  7. Fuse Online이 프로젝트에 설치되었는지 확인하려면 Operator를 클릭한 다음 Installed Operators 를 클릭하여 목록에서 Red Hat Integration - Fuse Online 을 확인합니다.
  8. 터미널 창에서 다음 명령을 입력하여 컨테이너 이미지의 registry.redhat.io 에서 생성한 시크릿을 Fuse Online Operator 서비스 계정에 연결합니다.

    oc secrets link syndesis-operator PULL_SECRET_NAME --for=pull

다음 단계

Fuse Online Operator가 설치되면 OpenShift 프로젝트에 Fuse Online 인스턴스를 추가합니다.

1.6.3. OpenShift 4.x 프로젝트에 Fuse Online 인스턴스 추가

OpenShift 4.x 프로젝트에 Fuse Online Operator를 설치한 후 OpenShift 프로젝트에 Fuse Online 인스턴스를 추가합니다. Fuse Online 인스턴스는 개발자가 Fuse Online에 액세스하는 데 사용하는 URL을 제공합니다.

사전 요구 사항

  • Fuse Online Operator는 현재 OpenShift 프로젝트에 설치됩니다.
  • OCP 환경에서 Fuse Online에서 영구 볼륨을 3개 이상 사용할 수 있습니다. 모든 영구 볼륨에는 다음과 같은 구성 요구 사항이 있어야 합니다.

    • capacity.storage: 1Gi
    • accessMode: ReadWriteOnce
  • 기본 Fuse Online 인스턴스 또는 사용자 지정 인스턴스를 설치할지 여부를 결정합니다. 지정할 수 있는 사용자 지정 리소스 설정에 대한 자세한 내용은 설치 전에 기본 사용자 정의 리소스를 편집해야 하는 경우를 참조하십시오.

절차

  1. 다음 단계에 따라 사용자 역할에 따라 통합 생성 페이지에 액세스합니다.

    • 관리자로 로그인한 경우:

      1. Operators 를 클릭한 다음 Installed Operators 를 클릭합니다.
      2. 이름 열에서 Red Hat Integration - Fuse Online 을 클릭합니다. Operator 세부 정보 페이지가 열립니다.
      3. 제공된 API 에서 인스턴스 생성을 클릭합니다.
    • 개발자로 로그인한 경우:

      1. 추가 를 클릭한 다음 Operator 백업 카드를 클릭합니다.
      2. Syndesis CRD 카드를 클릭합니다. Syndesis CRD 페이지가 열립니다.
      3. 생성을 클릭합니다.

        구문 생성 페이지가 열립니다.
  2. 이름을 입력하거나 앱을 기본값으로 둡니다.
  3. YAML 보기 옵션을 선택하여 기본 사용자 정의 리소스를 확인합니다.
  4. 선택 사항: 사용자 정의 리소스를 편집합니다.

    지정할 수 있는 사용자 지정 리소스 설정에 대한 자세한 내용은 Fuse Online을 구성하는 사용자 지정 리소스 특성을 설치하기 전에 기본 사용자 지정 리소스를 편집해야 하는 경우 를 참조하십시오.

    Fuse Online 설치 프로세스는 사용자 지정 리소스에 지정한 설정을 사용하여 설치된 Fuse Online 환경의 구성을 확인합니다.

  5. 만들기 를 클릭하여 Fuse Online 인스턴스를 만듭니다. OpenShift는 Fuse Online의 포드, 서비스 및 기타 구성 요소를 시작합니다.
  6. Fuse Online의 URL을 가져오려면 다음을 수행합니다.

    1. 네트워킹 > 경로를 클릭합니다.
    2. 올바른 프로젝트가 선택되어 있는지 확인합니다.
    3. 개요 행에서 위치 열에서 Fuse Online의 URL을 클릭합니다.
    4. OpenShift 로그인 자격 증명을 사용하여 Fuse Online 환경에 로그인합니다.
  7. 다른 개발자 사용자가 Fuse Online 웹 콘솔에 액세스할 수 있도록 하려면 다음 명령을 사용하여 각 개발자에게 Fuse Online이 설치된 프로젝트에 대한 view 역할을 부여해야 합니다.

    oc adm policy add-role-to-user view <username> -n <project-name>

    예를 들어 myfuseonline 프로젝트에 대한 보기 권한을 사용자 jdoe 에 부여하려면 다음을 수행합니다.

    oc adm policy add-role-to-user view jdoe -n myfuseonline

2장. OCP 3.11에 Fuse Online 설치

OCP 3.11에 Fuse Online을 설치하려면 클러스터 관리자가 Fuse Online 사용자 정의 리소스 정의를 등록하고 적절한 사용자에게 설치 권한을 부여해야 합니다. Fuse Online을 설치하는 사용자는 기본 Fuse Online 환경 또는 사용자 지정 Fuse Online 환경을 설치할지 여부를 결정해야 합니다. 사용자 지정 Fuse Online 환경의 경우 기본 사용자 지정 리소스 파일을 편집해야 합니다.

각 Fuse Online 설치를 Fuse Online 환경이라고 합니다. 지정된 OpenShift 프로젝트에는 정확히 하나의 Fuse Online 환경이 있을 수 있습니다. 각 Fuse Online 환경에는 고유한 URL이 있습니다. 단일 OpenShift 클러스터에는 여러 Fuse Online 환경이 있을 수 있습니다.

중요

Fuse Online 설치 프로세스에서는 컨테이너 이미지의 Red Hat Ecosystem Catalog인 registry.redhat.io 에 액세스해야 합니다. Fuse Online은 연결이 끊긴 환경에서 외부 컨테이너 레지스트리, 사용자 지정 레지스트리 또는 레지스트리 사용을 지원하거나 테스트하지 않습니다.

다음 주제에서는 Fuse Online 설치에 대한 세부 정보를 제공합니다.

2.1. OCP 3.11에 Fuse Online을 설치하는 데 필요한 단계 개요

OCP 온사이트에 Fuse Online을 설치하려면 클러스터 관리자가 일부 작업을 수행해야 하며 특정 OpenShift 프로젝트에 Fuse Online을 설치할 수 있는 권한이 있는 사용자는 일부 작업을 수행하고 설치 스크립트를 실행해야 합니다. 다음 다이어그램에서는 워크플로우를 보여줍니다.

OCP 3.11 워크플로 이미지에 Fuse Online을 설치하기 위한 개요

OCP에 Fuse Online을 설치하려면 주요 단계는 다음과 같습니다.

  1. 클러스터 관리 권한이 있는 사용자:

    1. 설치 스크립트 및 관련 파일을 다운로드합니다.
    2. OpenShift oc 클라이언트 툴 명령을 사용하여 클러스터 수준에서 CRD(사용자 정의 리소스 정의)를 등록합니다.
    3. OpenShift oc 클라이언트 툴 명령을 사용하여 하나 이상의 사용자가 해당 프로젝트에 Fuse Online을 설치할 수 있는 권한을 부여합니다.
  2. Fuse Online을 설치하려는 각 OpenShift 프로젝트에서 Fuse Online을 설치할 수 있는 권한이 부여된 사용자입니다.

    1. 기본 Fuse Online 환경 또는 사용자 지정 Fuse Online 환경을 설치할지 여부를 결정합니다. 사용자 지정 Fuse Online 환경은 하나 이상의 추가 기능 기능을 활성화하고/또는 하나 이상의 사용자 지정 구성 설정을 구현합니다.
    2. 설치 스크립트 및 관련 파일을 다운로드합니다.
    3. 선택 사항: 사용자 지정된 Fuse Online 환경이 필요한 경우 default-cr.yml 파일( Fuse Online 다운로드 패키지에 제공)을 편집합니다.
    4. 선택 사항: 연결 및 통합 정의를 유지하기 위한 외부 데이터베이스가 필요한 경우 OpenShift 시크릿을 생성합니다.
    5. 설치 스크립트를 호출합니다.
    6. Fuse Online이 실행 중인지 확인합니다.

Fuse Online을 설치해야 하는 OpenShift 프로젝트마다 클러스터 관리자가 해당 특정 프로젝트에 Fuse Online을 설치할 수 있는 권한을 부여해야 합니다.

기본 Fuse Online 환경을 설치하려면 Fuse Online을 설치할 수 있는 권한이 있는 사용자가 설치 스크립트를 다운로드하여 실행합니다. 다른 단계는 필요하지 않습니다.

2.2. Fuse Online 리소스 배포를 위한 사용자 정의 리소스 정의 등록

Fuse Online 설치를 활성화하려면 클러스터 관리자가 사용자 정의 리소스 정의를 등록합니다. 관리자는 OpenShift 클러스터에 대해 이 작업을 한 번만 수행해야 합니다. 그런 다음 관리자가 Fuse Online을 설치하려는 각 프로젝트에 대해 관리자는 해당 프로젝트에 Fuse Online을 설치할 수 있는 적절한 권한을 부여합니다.

사전 요구 사항

  • 클러스터 관리 권한이 있어야 합니다.
  • oc 클라이언트 도구를 설치하고 Fuse Online을 설치할 OCP 클러스터에 연결됩니다.
  • OCP 환경에서 Fuse Online에서 영구 볼륨을 3개 이상 사용할 수 있습니다. 모든 영구 볼륨에는 다음과 같은 구성 요구 사항이 있어야 합니다.

    • capacity.storage: 1Gi
    • accessMode: ReadWriteOnce

절차

  1. 다음 위치에서 Fuse Online 설치 스크립트가 포함된 패키지를 다운로드합니다.

    https://github.com/syndesisio/fuse-online-install/releases/tag/1.12

  2. 파일 시스템의 편리한 위치에 다운로드한 아카이브의 압축을 풉니다. fuse-online-install-1.12 디렉터리에는 Fuse Online 설치를 위한 스크립트 및 지원 파일이 포함되어 있습니다.
  3. 클러스터 관리자 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u admin -p adminpwd

  4. 이 클러스터에 이미 등록된 사용자 정의 리소스 정의를 나열하는 다음 명령을 실행하여 올바르게 연결되어 있는지 확인합니다.

    oc get crd

    오류 메시지가 없는 경우 올바르게 연결되어 있습니다.

  5. fuse-online-install-1.12 디렉터리로 전환하고 다음 명령을 호출하여 클러스터 수준에서 사용자 정의 리소스 정의를 등록합니다.

    bash install_ocp.sh --setup

  6. 다음 명령을 다시 실행하여 등록이 완료되었는지 확인합니다.

    oc get crd

    등록된 사용자 정의 리소스 정의의 출력 목록에는 개요 가 포함되어야 합니다.

  7. Fuse Online을 설치하려는 각 프로젝트에서 사용자에게 설치 권한을 부여합니다. 각 프로젝트에 대해:

    1. 사용자가 Fuse Online을 설치할 수 있는 프로젝트로 변경합니다. 예를 들면 다음과 같습니다.

      oc project fuse-online-project

    2. 사용자에게 해당 프로젝트에 Fuse Online을 설치할 수 있는 권한을 부여합니다. 예를 들어 다음 명령은 Fuse Online을 개발자 사용자에게 설치할 수 있는 권한을 부여합니다. 이 명령을 실행하면 개발자 사용자가 현재 프로젝트에 Fuse Online을 설치할 수 있습니다. 이 예제에서는 fuse-online-project 입니다.

      bash install_ocp.sh --grant developer

      Fuse Online 설치에 대한 권한을 부여하려는 각 OpenShift 프로젝트에 대해 이 두 명령을 반복합니다. 단일 사용자는 클러스터에서 둘 이상의 프로젝트에 Fuse Online을 설치할 수 있습니다. 이를 활성화하려면 다른 프로젝트로 변경하고 동일한 사용자를 지정합니다. 예를 들면 다음과 같습니다.

      oc project another-fuse-online-project
      bash install_ocp.sh --grant 개발자

결과

syndesis 사용자 정의 리소스 정의는 클러스터에 등록됩니다.

다음 단계

Fuse Online을 설치할 수 있는 권한이 있는 사용자는 기본 Fuse Online 환경 또는 사용자 지정 Fuse Online 환경을 설치할지 여부를 결정해야 합니다.

Fuse Online 설치에는 구성 가능한 Fuse Online 환경 추가 기능 및 매개 변수 설정에 대한 기본 설정을 지정하는 기본 사용자 지정 리소스가 포함되어 있습니다.

Fuse Online 환경을 다음과 같이 사용하려면 Fuse Online을 설치하기 전에 기본 사용자 지정 리소스를 편집해야 합니다.

  • Fuse Online 콘솔에 도달할 수 있는 OpenShift 경로에 지정하는 URL을 사용합니다. 기본값은 설치 프로세스에서 이 경로를 계산하는 것입니다.
  • 외부 데이터베이스를 사용하여 연결 및 통합 정의를 저장합니다. 기본값은 환경에서 내부 데이터베이스를 사용한다는 것입니다.
  • 연결 및 통합 정의 유지에 사용할 수 있는 내부 스토리지의 양을 늘립니다. 기본적으로 1Gi 는 대부분의 Fuse Online 환경에 충분합니다.

이러한 동작 중 하나에 대해 Fuse Online 환경을 구성하려면 Fuse Online을 설치할 때 사용자 지정 리소스를 편집해야 합니다. 즉, 설치된 Fuse Online 환경의 구성을 변경하여 이러한 동작을 구현할 수 없습니다. 또한 이러한 동작에 맞게 구성된 Fuse Online 환경을 설치한 후에는 설치된 환경의 해당 동작을 변경할 수 없습니다.

2.4. Fuse Online을 구성하는 사용자 정의 리소스 속성에 대한 설명

설치 전에만 지정할 수 있는 사용자 정의 리소스 속성 외에도 설치 전이나 후에 변경할 수 있는 여러 사용자 지정 리소스 속성이 있습니다.

표 1은 구성 가능한 사용자 정의 리소스 설정에 대한 간략한 설명을 제공하고 설치 전 및/또는 설치 후의 변경 시기를 나타냅니다. 원하는 Fuse Online 구성을 달성하려면 이 테이블의 정보를 사용하여 설치 전에 사용자 지정 리소스를 변경하는 방법 또는 설치 후 변경할 방법을 결정합니다. 그런 다음 적절한 절차를 따르십시오.

OCP 4.x의 경우:

OCP 3.11의 경우:

Expand
표 2.1. 구성 가능한 사용자 정의 리소스 설정
기능/설정이 값을 설정할 수 있는 경우사양

향상된 활동 추적

활동 추적 강화에 대한 추가 정보는 이 표를 따릅니다.

설치 전만 설정

addons:
jaeger:
enabled: true
clientOnly: false
operatorOnly: false

향상된 활동 추적이 기본적으로 활성화되어 있습니다. Jaeger 구성을 사용자 지정하려면 clientOnly 또는 operatorOnlytrue 로 설정할 수 있습니다.

외부 데이터베이스

외부 데이터베이스 사용에 대한 추가 정보는 이 표를 따릅니다.

설치 전만 설정

spec:
구성 요소:
database:
externalDbURL: postgresql://custom-postgres:5432
user: db-user-name
name: db-name


custom-postgres:5432 를 PostgreSQL 데이터베이스의 호스트 이름 및 포트로 바꿉니다.
db-user-name 을 해당 데이터베이스에 액세스할 수 있는 사용자 계정 이름으로 교체합니다.
db-name 을 데이터베이스 이름으로 교체합니다.

연결 및 통합을 위한 내부 스토리지 용량.

외부 데이터베이스도 지정하는 경우 무시됩니다.

내부 스토리지 증가에 대한 자세한 내용은 이 표를 따릅니다.

설치 전만 설정

spec:
구성 요소:
데이터베이스:
리소스:
volumeCapacity: 1Gi
volumeName: my-volume


1Gi 를 필요한 스토리지 용량으로 바꿉니다. 기본값은 1Gi 입니다.

my-volume 을 내부 스토리지에 사용할 볼륨의 이름으로 교체합니다. 이 매개변수는 선택 사항입니다.

Fuse Online 콘솔에 액세스하기 위한 OpenShift 경로

설치 전만 설정

spec:
routeHostname: project.route.com


Fuse Online 콘솔에 도달할 수 있는 OpenShift 경로로 project.route.com 을 바꿉니다.
예: north-project.6a63.fuse-online.openshiftapps.com

메모리CPU

하나 이상의 구성 요소에서 사용할 수 있는 기본 메모리 양을 늘립니다.

각 구성 요소는 자체 메모리 요구 사항을 정의합니다. 즉, 각 pod에는 할당된 메모리 양에 제한이 있습니다. 제한 및 요청 설정에 대한 자세한 내용은 OpenShift 문서의 컨테이너 메모리 및 위험 요구 사항을 충족하기 위해 클러스터 메모리 구성 섹션을 참조하십시오.

서버 구성 요소의 CPU 리소스를 지정할 수도 있습니다.

데이터베이스 구성 요소는 연결 및 통합 정의를 저장하는 내부 데이터베이스입니다.

메타 구성 요소는 서버가 로드하는 커넥터와 같은 비즈니스 논리를 제공합니다.

prometheus 구성 요소는 Fuse Online 인프라 구성 요소 및 Fuse Online 통합을 모니터링합니다.

설치 전만 설정

components:
server:
resources:
limit:
memory: "1024Mi"
cpu: "800m"
request:
memory: "512Mi" Cryostat cpu: "500m" Cryostat meta: Cryostat resources: Cryostat limit: Cryostat




memory: "750Mi"
request:
memory: "300Mi"
database: "300Mi"
database:
resources:
limit:
memory: "300Mi"
request:
memory: "300Mi"
prometheus: Cryostat resources: Cryostat limit: Cryostat limit: Cryostat limit

memory: "750Mi"
request:
memory: "750Mi"

3scale 검색

Fuse Online API 공급자 통합을 위한 API를 노출하여 Red Hat 3scale에서 검색할 수 있습니다.

자세한 내용은 API를 3scale 검색을 사용하도록 Fuse Online 구성입니다.

설치 전후 설정

구성 요소:
기능:
managementUrlFor3scale: https://url-for-3scale

3scale 사용자 인터페이스의 URL을 지정합니다.

백업

Fuse Online 환경 백업에 추가 설정 단계를 설명합니다.

설치 전후 설정

spec:
backup:
schedule: interval


을 백업 간에 원하는 기간으로 바꿉니다. 간격사전 정의된 일정에 cron 유틸리티 형식을 사용합니다. 간격 앞에 @ 기호를 지정하지 마십시오.

노드 유사성허용 오차

Fuse Online 인프라 구성 요소의 배치와 클러스터 내 노드에 Pod를 통합하는 방법을 결정합니다.

노드 선호도를 사용하면 사용할 노드 그룹으로 Fuse Online Pod의 선호도를 지정할 수 있습니다.

허용 오차를 사용하면 Fuse Online Pod가 실행되는 노드를 제어하고 다른 워크로드가 해당 노드를 사용하지 못하도록 할 수 있습니다.

Fuse Online Pod 구성 도 참조하십시오.

설치 전후 설정

참고: Fuse Online 인프라 구성 요소 배포에 infraScheduling 을 사용합니다. Fuse Online 통합 배포의 경우 infraScheduling통합 스케줄링으로 교체합니다.

spec:
infraScheduling:
tolerations:
key: value
operator: value
effect: value


spec:
infraScheduling: Cryostat affinity: Cryostat affinity: Cryostat nodeAffinity: Cryostat preferredDuringSchedulingIgnoredDuringExecution: Cryostat weight: Cryostat weight: Cryostat




preference:
matchExpressions:
key: value
operator: value
values:
value1,
value2



통합 제한실행 중인 최대 통합 수를 지정합니다. 기본값은 실행 중인 통합 수를 제한하지 않습니다.

설치 전후 설정

components:
server:
기능:
integrationLimit: 0

데이터베이스 연결 풀

서버 연결 풀 구성을 조정하여 데이터베이스 연결을 관리할 수 있습니다.

데이터베이스 풀 구성에 대한 자세한 내용은 이 표를 따릅니다.

설치 전후 설정

구성 요소:
server:
connectionPool:
connectionTimeout: 30000
idleTimeout: 600000
leakDetectionThreshold: 0
maxLifetime: 1800000
maximumPoolSize: 10
minimumIdle: 10

Java 옵션

syndesis-serversyndesis-meta 구성 요소에 대한 Java 옵션을 지정할 수 있습니다.

Java 옵션에 따라 구성 요소에 대해 다른 값을 지정할 수 있습니다. 예를 들어 syndesis-meta 보다 많은 컴퓨터 리소스가 필요하므로 syndesis-server 에 대한 JVM 관련 매개변수를 설정할 수 있습니다.

설치 전후 설정

components:+ server:
javaOptions:
-option_name=my_value meta:
javaOptions:
-option_name=my_value

-option_name 을 Java 옵션 이름으로 바꿉니다. Java 옵션 접두사(-D,-X 또는 -XX)를 지정할 수 있습니다.

my_value 를 옵션의 값으로 바꿉니다.

예를 들어 HTTP 프록시를 구성하려면 components:+ server:
javaOptions:
-Dhttp.proxyHost=10.0.0.0.0.100 -Dhttp.proxyPort=8800 메타:
javaOptions:
-Dhttp.proxyHost=10.0.0.100 -Dhttp.proxyPort=8800'

Maven 인수

Fuse Online 통합을 빌드할 때 사용할 추가 Maven 옵션을 지정합니다.

설치 전후 설정

components:
server:
features:
maven:
additionalArguments:
"typeA=stringA typeB=stringB"


:
additionalArguments: Cryostat "-Dhttp.proxy=my_proxy -DpropA=valueA"

Maven 리포지토리

Fuse Online 환경에 액세스해야 하는 외부 Maven 리포지토리를 지정합니다.

설치 전후 설정

구성 요소:
server:
features:
mavenRepotories:
customRepo1:
customRepo2:


customRepo 를 리포지토리 이름으로 바꿉니다.
각 리포지토리에 대해 해당 URL을 지정합니다.

Monitoring

도 참조하십시오. Prometheus를 사용하여 OCP에서 Fuse Online 통합 모니터링.

설치 전후 설정

addons:
ops:
enabled: true

퍼블릭 REST API

추가 설정 단계는 외부 툴에서 사용하기 위해 Fuse Online 공용 REST API 끝점을 추가하는 데 설명되어 있습니다.

설치 전후 설정

addons:
publicApi:
enabled: true
routeHostname: public-syndesis.192.168.64.63.nip.io


routeHostname 을 Fuse Online REST API 엔드포인트를 호출하는 공용 주소로 설정합니다. 클러스터 설정에 따라 지정해야 하는 공용 주소가 결정됩니다. 이전 예에서 경로 호스트 이름은 Minishift 클러스터에 유효합니다.

demoData
샘플 PostgreSQL 데이터베이스와 샘플 데이터베이스 커넥터를 제공합니다.

설치 전후 설정

spec:
demoData: false

todo 애드온을 true 로 설정하는 경우 demoData 옵션도 true 로 설정해야 합니다.

Todo 앱
샘플 통합 테스트용.

설치 전후 설정

spec:
addons:
todo:
enabled: false

todo addon을 true 로 설정하면 demoData 옵션이 true 로 설정되어 있는지 확인해야 합니다.
제한된 환경에 Fuse Online을 설치하려면 설치 전에 todo 애드온을 false (기본값)로 설정해야 합니다. Fuse Online을 설치한 후 https://github.com/syndesisio/todo-example 에서 todo 애플리케이션을 다운로드하여 Readme 파일의 단계를 수행하여 리포지토리 URL을 사설 네트워크에서 사용할 수 있는 위치로 변경할 수 있습니다.

OCP에서 실행되는 Fuse Online 환경에 샘플 데이터 추가를 참조하십시오.

감사

커넥터, 연결 및 통합에 대한 기본 변경 사항을 보려면 다음을 수행합니다.

Fuse Fuse Online 구성 요소 감사 도 참조하십시오.

참고: 기술 프리뷰 기능입니다.

설치 전후 설정

구성 요소:
server:
기능:
감사: true

애드온 기능 및 구성 설정 정보

  • 활동 추적 기능 개선

    Fuse Online을 설치할 때 Jaeger를 사용하는 활동 추적은 기본적으로 활성화됩니다. Fuse 온라인 설치( OperatorHub 또는 명령줄 스크립트에서)는 OperatorHub의 존재를 감지하고 OperatorHub의 서브스크립션 기능을 사용하여 Jaeger를 설치합니다. OperatorHub를 사용할 수 없는 제한된 환경의 경우 Fuse Online은 자체 설치 기능을 사용하여 Jaeger를 설치합니다. 선택적으로 Jaeger 모니터링에 Fuse Online 구성 섹션에 설명된 대로 Fuse Online을 설치하기 전에 Jaeger 구성 을 사용자 지정할 수 있습니다.

  • 연결 및 통합을 유지하기 위한 외부 데이터베이스

    기본 설치는 Fuse Online에서 연결 및 통합 정의를 유지하기 위해 사용하는 내부 PostgreSQL 데이터베이스를 제공합니다. 대신 OpenShift에서 기본적으로 제공하는 PostgreSQL 템플릿 중 하나와 같이 외부 PostgreSQL 데이터베이스를 사용하도록 선택할 수 있습니다.

  • 내부 스토리지 용량

    1Gi 의 기본 설정은 대부분의 Fuse Online 환경에 충분합니다. Red Hat 기술 지원을 권장하는 경우에만 새로운 Fuse Online 설치에 대해 이 설정을 늘릴 것으로 예상됩니다. 즉, Fuse Online 서버 오류가 발생한 다른 Fuse Online 환경을 실행하고 있으며 Red Hat 기술 지원은 기본값보다 큰 데이터베이스 볼륨 용량을 사용하여 새 Fuse Online 환경을 설치해야 함을 확인했습니다.

    이미 Fuse Online을 실행 중인 OpenShift 프로젝트에서 Fuse Online 내부 스토리지 용량을 늘리려면 먼저 Fuse Online을 제거해야 합니다. OCP 프로젝트에서 Fuse Online 설치 제거를 참조하십시오.

  • 데이터베이스 연결 풀 구성

    다음과 같은 syndesis-server 데이터베이스 연결 풀 속성을 구성할 수 있습니다.

    • ConnectionTimeout - syndesis-server 가 풀에서 연결을 기다리는 최대 밀리초 수입니다. 허용 가능한 가장 낮은 연결 시간 초과는 250ms입니다. 기본값은 30000(30초)입니다.
    • IdleTimeout - 연결이 제거되기 전에 풀에서 유휴 상태로 유지할 수 있는 최대 시간(밀리초)입니다. 값이 0이면 유휴 연결이 풀에서 제거되지 않습니다. 허용되는 최소 값은 10000(10초)입니다. 기본값은 600000(10분)입니다.
    • leakDetectionThreshold - 메시지가 기록되기 전에 연결이 풀에서 부족할 수 있는 시간(밀리초)입니다. 값이 0이면 누출 탐지가 비활성화되어 있습니다. 누출 탐지를 가능하게 하는 가장 낮은 허용 가능한 값은 2000초(2초)입니다. 기본값은 0입니다.
    • maxLifetime - 풀에 있는 연결의 최대 수명(밀리초)입니다. 허용되는 최소 값은 30000(30초)입니다. 기본값은 1800000 (30 분)입니다.
    • maximumPoolSize - 유휴 연결 및 사용 중인 연결을 모두 포함하여 풀에 연결할 수 있는 최대 크기입니다. 기본값은 10입니다.
    • minimumIdle - 풀에서 유지 관리되는 최소 유휴 연결 수입니다. 기본값은 maximumPoolSize 의 값입니다.

2.5. Fuse Online을 설치하기 전에 기본 사용자 정의 리소스 파일 편집

기본 Fuse Online 환경을 설치하려면 기본 사용자 지정 리소스 파일을 편집할 필요가 없습니다. OCP 4.x에 Fuse Online 설치 또는 OCP 3.11에 Fuse Online 설치를 참조하십시오.

사용자 지정 Fuse Online 환경을 설치하려면 Fuse Online을 설치하기 전에 default-cr.yml 파일을 편집해야 합니다. 이 파일은 Fuse Online 다운로드 패키지에 있습니다. Fuse Online 설치 전에만 지정할 수 있는 몇 가지 사용자 지정 리소스 설정이 있습니다. 설치하기 전에 기본 사용자 정의 리소스를 편집할 때 를 참조하십시오.

Fuse Online 설치 전이나 후에 지정할 수 있는 기타 사용자 지정 리소스 설정이 있습니다. Fuse Online을 구성하는 사용자 지정 리소스 속성에 대한 설명을 참조하십시오.

Fuse Online 설치 프로세스는 default-cr.yml 파일에 지정하는 설정을 사용하여 syndesis 사용자 지정 리소스를 생성합니다. 개요 사용자 지정 리소스 설정은 설치된 Fuse Online 환경의 구성을 결정합니다.

사전 요구 사항

  • 사용자는 사이트에서 OCP Online을 설치하고 실행할 계획입니다.
  • oc 클라이언트 툴이 설치되고 Fuse Online을 설치하려는 OCP 클러스터에 연결되어 있습니다.
  • 클러스터 관리 권한이 있는 사용자는 클러스터에서 액세스할 수 있는 권한이 있는 모든 프로젝트에 Fuse Online을 설치할 수 있는 권한을 부여했습니다.

절차

  1. Fuse Online 설치 스크립트가 포함된 패키지를 아직 다운로드하지 않은 경우:

    1. 지금 다음 위치에서 다운로드합니다.

      https://github.com/syndesisio/fuse-online-install/releases/tag/1.12

    2. 파일 시스템의 편리한 위치에 다운로드한 아카이브의 압축을 풉니다. fuse-online-install-1.12 디렉터리에는 Fuse Online 설치를 위한 스크립트 및 지원 파일이 포함되어 있습니다.
  2. Fuse Online을 설치할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u developer -p developer

  3. 편집기에서 fuse-online-install-1.12/default-cr.yml 파일을 엽니다.
  4. default-cr.yml 파일을 편집하여 기능을 활성화하고 원하는 매개변수를 설정합니다. 지정할 항목을 확인하려면 Fuse Online을 구성하는 사용자 지정 리소스 속성에 대한 설명을 참조하십시오.
  5. default-cr.yml 파일을 저장합니다.

결과

default-cr.yml 파일에는 새 Fuse Online 설치에 대한 구성 사양이 포함되어 있습니다.

다음 단계

default-cr.yml 파일을 편집하여 외부 데이터베이스를 지정한 경우 Fuse Online을 설치하기 전에 Fuse Online 설치 지침을 따릅니다. 그렇지 않으면 OCP 3.11에 Fuse Online 설치 지침을 따를 준비가 되어 있습니다.

2.6. Jaeger 모니터링을 위한 Fuse Online 구성 정보

Jaeger는 분산 서비스 간의 트랜잭션을 추적하기 위한 오픈 소스 소프트웨어입니다. 특히 복잡한 마이크로 서비스 환경을 모니터링하고 해결하는 데 유용합니다.

OperatorHub에서 또는 명령줄 스크립트를 사용하여 Fuse Online을 설치할 때 Fuse Online 설치는 OperatorHub의 존재를 감지하고 OperatorHub의 서브스크립션 기능을 사용하여 Jaeger를 설치합니다. OperatorHub를 사용할 수 없는 제한된 환경의 경우 Fuse Online은 자체 설치 기능을 사용하여 Jaeger를 설치합니다.

기본 Fuse Online 환경은 필요한 모든 Jaeger 구성 요소를 구성합니다. 선택적으로 Fuse Online 사용자 정의 리소스를 편집하여 클라이언트 전용/독립 실행형 서버 구성 또는 하이브리드 Jaeger 클라이언트 및 Jaeger Operator 구성을 지정할 수 있습니다.

기본 Jaeger 구성

기본 제공되는 기본 구성 요소에는 모든 Jaeger 구성 요소가 포함됩니다. 모니터링 기능을 실험하여 Jaeger의 작동 방식에 대한 교육을 시작할 수 있습니다. 기본 구성은 메모리 전용, 제한된 백엔드 스토리지 기능을 제공합니다.

기본 Jaeger 구성으로 Fuse Online을 설치하면 다음과 같은 결과가 발생합니다.

  • Fuse Online 구성 요소에는 Jaeger 통신 URL이 있습니다.
  • Jaeger Operator가 설치되어 있습니다.
  • Jaeger 사용자 정의 리소스는 활동 모니터링을 위한 기본 구성으로 구성됩니다.

기본 Jaeger 구성이 포함된 Fuse Online 설치에는 다음과 같은 개요 사용자 정의 리소스 사양이 있습니다.

apiVersion: syndesis.io/v1beta2
kind: Syndesis
metadata:
  name: app
spec:
  addons:
    jaeger:
      enabled: true
Copy to Clipboard Toggle word wrap

clientOnlyoperatorOnly 가 지정되지 않은 경우(기본적으로 false 로 설정) Fuse Online에서 제공된 Jaeger 백엔드와 Jaeger 서버 구성에서 제공하는 기본 메모리 전용 스토리지를 사용합니다.

클라이언트 전용/독립 실행형 서버 구성

클라이언트 전용/독립 실행형 서버 구성을 사용하면 클라이언트 URL 연결만 Fuse Online과 외부적으로 구성된 Jaeger 백엔드 간의 통신을 위해 구성됩니다. Jaeger 백엔드의 모든 측면은 외부적이고 Fuse Online 환경 및 syndesis-operator 와 독립적입니다. 여기에는 Jaeger Operator 및 Jaeger 사용자 정의 리소스가 포함됩니다.

클라이언트 전용 Jaeger 구성을 설치하려면 다음과 같이 Fuse Online을 설치하기 전에 사용자 정의 리소스를 편집합니다.

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

apiVersion: syndesis.io/v1beta2
kind: Syndesis
metadata:
  name: app
spec:
  addons:
    jaeger:
      enabled: true
      clientOnly: true
      queryUri: https://jaeger-query-hostname:443/api
      collectorUri: https://jaeger-collector-hostname:14268/api/traces
Copy to Clipboard Toggle word wrap

하이브리드 Jaeger 클라이언트 및 Operator 구성

하이브리드 Jaeger 클라이언트 및 Jaeger Operator 구성을 사용하면 Fuse Online에서 Jaeger Operator 및 Jaeger 클라이언트 기능을 설치합니다. Jaeger 사용자 정의 리소스가 설치되지 않았습니다. Jaeger 서버 구성을 정의하는 자체 Jaeger 사용자 정의 리소스를 설치해야 합니다. 이를 통해 Fuse 온라인 제공 기능을 활용하고 자체 환경에 맞게 Jaeger 구성을 조정할 수 있습니다(예: 데이터 스토리지에 Elasticsearch 또는 Cryostat를 사용할 수 있습니다.

하이브리드 Jaeger 클라이언트 및 Jaeger Operator 구성을 설치하려면 다음을 수행합니다.

  • 다음 예와 같이 Fuse Online을 설치하기 전에 사용자 지정 리소스를 편집합니다.

    apiVersion: syndesis.io/v1beta2
    kind: Syndesis
    metadata:
      name: app
    spec:
      addons:
        jaeger:
          enabled: true
          operatorOnly: true
    Copy to Clipboard Toggle word wrap
  • 다음 예와 같이 Jaeger 사용자 정의 리소스 syndesis-jaeger 의 이름을 지정합니다.

    apiVersion: jaegertracing.io/v1
    kind: Jaeger
    metadata:
      name: syndesis-jaeger
      ...
    spec:
       ....
    Copy to Clipboard Toggle word wrap

    참고: 또는 Jaeger 사용자 정의 리소스에 다른 이름을 사용하려면 클라이언트 전용/독립 실행형 서버 구성 섹션에 설명된 대로 Syndesis 사용자 정의 리소스에서 queryUricollectorUri 를 설정합니다.

syndesis-jaeger 이름이 있는 Jaeger 사용자 정의 리소스가 생성되면 Jaeger 인스턴스는 Fuse Online 통합에서 데이터를 수집합니다. 기본적으로 이 데이터는 Fuse Online 활동 로그에서 볼 수 있습니다.

2.7. 외부 데이터베이스를 사용하여 Fuse Online 설치

외부 데이터베이스를 사용하여 연결 및 통합 정의를 유지하는 Fuse Online 환경을 설치하려면 다음을 수행합니다.

  • OpenShift 클러스터가 찾을 수 있는 호스트 이름으로 postgreSQL 데이터베이스를 생성합니다.
  • Fuse Online을 설치하기 전에 외부 데이터베이스에 대해 syndesis-global-config 라는 OpenShift 시크릿을 생성합니다.
  • Fuse Online을 설치합니다.
  • Fuse Online을 배포하기 전에 사용자 지정 리소스를 편집하여 외부 데이터베이스에 대한 연결을 구성합니다.

사전 요구 사항

  • OCP 3.11에만 default-cr.yml 파일을 편집하여 연결 및 통합 정의를 유지하기 위해 외부 데이터베이스 사용을 지정합니다.
  • Fuse Online은 아직 설치되지 않았습니다.
  • oc 클라이언트 툴이 설치되고 Fuse Online을 설치하려는 OCP 클러스터에 연결되어 있습니다.
  • 클러스터 관리 권한이 있는 사용자는 클러스터에서 액세스할 수 있는 권한이 있는 모든 프로젝트에 Fuse Online을 설치할 수 있는 권한을 부여했습니다.

절차

  1. Fuse Online을 설치할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u developer -p developer
    Copy to Clipboard Toggle word wrap
  2. Fuse Online을 설치하고 다음 구성 옵션에 대한 값을 정의하는 OpenShift 클러스터에서 사용할 수 있는 postgreSQL 데이터베이스를 만듭니다.

    • 연결 사용자 이름
    • 데이터베이스 이름
    • 데이터베이스 암호

      다음 예제에서는 OpenShift에서 기본적으로 제공하는 PostgreSQL 템플릿 중 하나를 사용합니다.

      참고: 개발 또는 테스트 목적으로 PostgreSQL 임시(postgresql-ephemeral) 템플릿만 사용합니다. 프로덕션 환경의 경우 PostgreSQL(postgresql) 템플릿을 사용합니다.

      oc new-app postgresql-ephemeral -p POSTGRESQL_USER=syndesis -p POSTGRESQL_PASSWORD=exdb-pwd -p POSTGRESQL_DATABASE=syndesisdb
      Copy to Clipboard Toggle word wrap

      이 명령은 URL과 같이 Fuse Online을 구성할 때 필요한 데이터베이스에 대한 정보를 반환합니다.

      데이터베이스 생성에 대한 자세한 내용은 OpenShift 문서의 PostgreSQL 항목을 참조하십시오.

  3. 다음 콘텐츠가 포함된 리소스 파일(예: my-fuse-online-secret-cr.yml)을 생성하고 저장합니다.

    apiVersion: v1
    kind: Secret
    metadata:
      name: syndesis-global-config
      namespace: my-fuse-online-project
    type: Opaque
    stringData:
      POSTGRESQL_PASSWORD: exdb-pw
    Copy to Clipboard Toggle word wrap

    my-fuse-online-project 를 외부 데이터베이스를 지정하는 Fuse Online 환경을 설치하려는 OpenShift 프로젝트의 이름으로 바꿉니다.

    exdb-pw 를 2 단계의 암호로 바꿉니다. Fuse Online에서는 외부 데이터베이스에 액세스하기 위한 암호로 사용합니다. stringData 는 password 값을 base64로 인코딩된 값으로 변환하므로 변환을 수행할 필요가 없습니다.

    OpenShift 보안에 대한 자세한 내용은 시크릿을 참조하십시오.

  4. 클러스터에 보안을 추가합니다. 예를 들면 다음과 같습니다.

    oc apply -f my-fuse-online-secret-cr.yml
    Copy to Clipboard Toggle word wrap

    OpenShift 클러스터에서는 외부 데이터베이스를 지정하는 사용자 지정 리소스와 함께 설치된 Fuse Online 환경에서 syndesis-global-config 시크릿을 사용할 수 있습니다.

  5. 보안에 대해 YAML 파일에서 지정한 my-fuse-online-project 프로젝트에 Fuse Online을 설치합니다(단계 4).

    • OCP 3.11의 경우 Fuse Online을 설치하기 전에 기본 사용자 지정 리소스 파일 편집의 지침을 따르십시오.
    • OCP 4.6 이상의 경우 OperatorHub에서 Fuse Online Operator 설치 지침을 따르십시오. Fuse Online을 배포하기 전에 OpenShift 4.x 프로젝트에 Fuse Online 인스턴스 추가 에서 사용자 지정 리소스를 편집하여 외부 데이터베이스 사용을 지정합니다. 예를 들면 다음과 같습니다.

      apiVersion: syndesis.io/v1alpha1
      kind: Syndesis
      metadata:
        name: app
      spec:
        components:
          database:
            externalDbURL: "postgresql://syndesis-external-db:5432"
            user: db-user-name
            name: db-name
      Copy to Clipboard Toggle word wrap
    • syndesis-external-db:5432 를 외부 PostgreSQL 데이터베이스의 호스트 이름 및 포트로 바꿉니다.
    • db-user-name 을 연결 사용자 이름으로 바꿉니다.
    • db-name 을 데이터베이스 이름으로 교체합니다.

결과

Fuse Online 설치 프로세스는 사용자 지정 리소스의 설정을 사용하여 설치된 Fuse Online 환경의 구성을 확인합니다.

올바르게 설치 및 배포하면 Fuse Online에서 syndesis-db 를 제외한 모든 필요한 Pod를 가져옵니다. syndesis-db 대신 syndesis-server 는 외부 데이터베이스의 서비스 이름으로 데이터베이스에 연결합니다. 외부 데이터베이스 구성이 올바르지 않으면 syndesis-server 가 초기화되지 않고 Fuse Online 배포가 오류로 끝납니다.

2.8. OCP 3.11에 Fuse Online을 설치하는 스크립트 실행

Fuse Online 설치 스크립트는 Fuse Online 다운로드 패키지에 있는 default-cr.yml 파일의 사양에 따라 Fuse Online 환경을 설치합니다. 기본 환경을 설치하려면 해당 파일을 편집할 필요가 없습니다. 사용자 지정 환경을 설치하려면 설치 스크립트를 실행하기 전에 default-cr.yml 파일을 편집해야 합니다.

사전 요구 사항

절차

  1. Fuse Online 설치 스크립트가 포함된 패키지를 아직 다운로드하지 않은 경우:

    1. 다음 위치에서 다운로드합니다.

      https://github.com/syndesisio/fuse-online-install/releases/tag/1.12

    2. 파일 시스템의 편리한 위치에 다운로드한 아카이브의 압축을 풉니다. fuse-online-install-1.12 디렉터리에는 Fuse Online 설치를 위한 스크립트 및 지원 파일이 포함되어 있습니다.
  2. Fuse Online을 설치할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u developer -p developer

  3. Fuse Online을 설치하려는 OpenShift 프로젝트로 전환합니다. 예를 들면 다음과 같습니다.

    oc project my-fuse-online-project

    또는 설치 스크립트를 실행할 때 --project my-fuse-online-project )를 지정할 수 있습니다.

  4. 설치 스크립트를 다운로드한 디렉터리에서 설치 스크립트를 호출합니다.

    bash install_ocp.sh

    설치 스크립트 옵션에 대해 알아보려면 bash install_ocp.sh --help 명령을 호출합니다.

  5. Fuse Online을 설치하는 데 사용된 syndesis -operator 에 원하는 콘텐츠가 정확히 포함되어 있는지 확인합니다.

    1. 다음 명령을 호출하여 syndesis 사용자 정의 리소스 콘텐츠를 표시합니다.

      oc describe syndesis/app

    2. 사용자 정의 리소스의 콘텐츠를 확인합니다.

      모든 업데이트가 포함되어 있지 않은 경우 사용자 정의 리소스에 구문 오류가 발생했습니다. Fuse Online을 제거한 후 유효한 사용자 정의 리소스를 정의하려면 다시 시도해야 합니다. OCP 프로젝트에서 Fuse Online 설치 제거를 참조하십시오.

  6. 설치에 성공했는지 확인합니다.

    1. https://openshift-route 에서 OpenShift OAuth 프록시 로그인 페이지를 표시합니다.

      설치 스크립트에서 OpenShift 경로를 계산하도록 선택한 경우 스크립트는 실행 종료 시 계산된 경로를 표시합니다. openshift-route 를 스크립트에서 제공한 값으로 바꿉니다.

      default-cr.yml 파일을 편집하여 Fuse Online의 routeHostname 을 지정하는 경우 openshift-route 를 지정한 경로로 교체합니다.

    2. OpenShift 콘솔에 로그인하지 않은 경우 로그인 페이지가 표시됩니다. 로그인할 OpenShift 사용자 이름과 암호를 입력합니다.

    Fuse Online 홈 페이지가 즉시 또는 OpenShift 콘솔에 로그인한 후 표시됩니다.

3장. Fuse Online 환경의 구성 변경

사이트에서 OpenShift Container Platform (OCP)에 Fuse Online을 설치한 후 Fuse Online 환경의 구성을 변경할 수 있습니다.

자세한 내용은 다음 항목을 참조하십시오.

3.1. 설치 후 Fuse Online 구성 변경 가능

사이트에서 OCP(OpenShift Container Platform)에 Fuse Online을 설치한 후 일부 기능을 활성화/비활성화하거나 일부 구성 설정을 변경하도록 구성을 변경할 수 있습니다. 다음 표에는 변경할 수 있는 기능 및 설정, 변경 사항의 영향, 변경에 대한 지침을 찾을 수 있는 위치가 나열되어 있습니다.

syndesis 사용자 정의 리소스를 변경하면 syndesis-server 가 다시 배포되면 OpenShift에서 새 서버 포드를 생성합니다. 새 서버가 준비될 때까지 최대 1~2분이 걸립니다. 이 기간 동안 Fuse Online 콘솔을 사용할 수 없습니다. 새 서버를 배포하는 동안 실행 중인 통합이 계속 실행됩니다. 새 배포가 준비되면 새 서버가 통합 상태를 로드합니다. syndesis-server pod 상태가 Running 이면 Fuse Online 콘솔을 다시 사용하고 Fuse Online 콘솔을 새로 고치면 통합, 연결, 메시지, 가동 시간에 대한 값이 표시됩니다.

Expand
표 3.1. 변경할 수 있는 기능 및 설정
기능/설정변경의 영향정보

3scale 검색

Redploys syndesis-server

API 3scale 검색을 사용하도록 Fuse Online 구성

백업

syndesis-operator에 백업 작업 추가

Fuse Online 환경 백업

감사

참고: 기술 프리뷰 기능입니다.

실행 중인 syndesis-server 의 구성을 업데이트합니다. 재배포가 필요하지 않습니다.

Fuse Online 구성 요소 감사

모니터링

새 OpenShift 리소스 설치

Prometheus를 사용하여 OCP에서 Fuse Online 통합 모니터링

퍼블릭 Fuse Online REST API 끝점

syndesis-public-oauthproxy Pod 생성

외부 툴에서 사용할 Fuse Online 공용 REST API 노출

통합을 테스트하기 위한 샘플 Todo 앱

todo Pod 생성

OCP에서 실행되는 Fuse Online 환경에 샘플 데이터 추가

demoData

샘플 데이터베이스 및 샘플 데이터베이스 커넥터를 제공합니다. 재배포를 트리거하려면 syndesis-server 및 sydnesis-db Pod를 삭제해야 합니다.

sampledb 라는 PostgreSQL 데이터베이스를 생성하고 Fuse Online 환경에서 SampleDB 커넥터에 PostgresDB 연결을 추가합니다.

Fuse Online을 구성하는 사용자 정의 리소스 속성에 대한 설명

OCP에서 실행되는 Fuse Online 환경에 샘플 데이터 추가

Java 옵션

syndesis-server재배포

Fuse Online을 구성하는 사용자 정의 리소스 속성에 대한 설명

HTTP 프록시 구성

Maven 구성

redeployment을 트리거하려면 syndesis-server Pod를 삭제해야 합니다.

OpenShift 클러스터 노드에 Fuse Online Pod 할당

Fuse Online 인프라 구성 요소 및 통합 Pod 재배포

Fuse Online을 구성하는 사용자 정의 리소스 속성에 대한 설명

Fuse Online Pod 구성

Fuse Online 구성 요소에서 사용 가능한 메모리

변경된 메모리로 구성 요소 재배포

Fuse Online을 구성하는 사용자 정의 리소스 속성에 대한 설명

허용되는 실행 중인 통합 수

redeployment을 트리거하려면 syndesis-server Pod를 삭제해야 합니다.

데이터베이스 연결 풀

Redploys syndesis-server

3.2. Fuse Online 구성 변경 절차

OCP에 설치된 Fuse Online 환경의 경우 syndesis 사용자 정의 리소스를 업데이트하여 구성을 변경할 수 있습니다. 변경 사항을 저장한 후 OpenShift는 구문적으로 올바르면 업데이트와 함께 syndesis-operator 를 업데이트합니다. 구문 오류로 인해 업데이트가 수행되지 않습니다.

syndesis 사용자 정의 리소스를 편집하는 동안 구문적으로 올바른 잘못된 설정을 지정하지 않아야 합니다. syndesis-operator 는 구문이 올바른 설정이 유효하지 않은 경우에도 업데이트된 syndesis 사용자 정의 리소스를 사용합니다. 유효하지 않은 설정을 지정하면 OpenShift가 업데이트를 완료한 후에만 확인할 수 있습니다. 업데이트 중에 OpenShift는 잘못된 설정을 삭제합니다.

사전 요구 사항

절차

  1. Fuse Online을 설치할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u developer -p developer

  2. 구성을 변경하려는 Fuse Online 환경을 실행 중인 OpenShift 프로젝트로 전환합니다. 예를 들면 다음과 같습니다.

    oc project my-fuse-online-project

  3. 선택 사항: 업데이트한 후 잘못된 콘텐츠를 저장하는 경우 구문 분석 사용자 정의 리소스에서 현재 설정의 백업 사본을 생성합니다. 예를 들어 다음 명령을 호출하면 syndesis_app_backup.yml 파일에 백업을 저장합니다.

    oc get syndesis app -o yaml > syndesis_app_backup.yml

  4. 다음 명령을 호출하여 편집기에서 syndesis 사용자 정의 리소스를 엽니다.

    oc edit syndesis/app

    참고: 이 절차에서는 편집기에서 사용자 지정 리소스 파일을 열어 구성을 설정하는 방법을 설명합니다. 또는 oc patch 명령을 사용하여 사용자 정의 리소스를 편집할 수 있습니다.

  5. 필요에 따라 syndesis 사용자 정의 리소스를 편집합니다.
  6. 리소스를 저장합니다.

    편집한 오브젝트 유형에 따라 업데이트로 syndesis-operator 가 트리거되어 리소스를 저장할 때 일부 Fuse Online 구성 요소를 재배포합니다.

  7. 사용자 정의 리소스에서 demoData 옵션을 변경한 경우 다음 명령을 사용하여 syndesis-serversyndesis-db Pod를 삭제하여 재배포를 트리거해야 합니다.

    oc delete $(oc get -o name pod -l syndesis.io/component=syndesis-server)
    
    oc delete $(oc get -o name pod -l syndesis.io/component=syndesis-db)
    Copy to Clipboard Toggle word wrap
  8. 2분 또는 3분 정도 기다린 다음 syndesis 사용자 정의 리소스가 올바르게 업데이트되었는지 확인합니다.

    1. 다음 명령을 호출하여 syndesis 사용자 정의 리소스의 내용을 표시합니다.

      oc describe syndesis/app

    2. 콘텐츠를 확인합니다.

      syndesis 사용자 정의 리소스에 필요한 설정이 포함되어 있지 않은 경우 다시 편집하여 유효한 설정을 지정합니다.

결과

syndesis 사용자 정의 리소스 트리거 syndesis-operator 에 대한 대부분의 변경 사항은 Fuse Online syndesis-server 구성 요소를 재배포합니다. 즉, OpenShift가 새 서버 포드를 생성합니다.

새 서버가 준비될 때까지 최대 1~2분이 걸립니다. 이 기간 동안 Fuse Online 콘솔을 사용할 수 없습니다. 새 서버를 배포하는 동안 실행 중인 통합이 계속 실행됩니다. 새 배포가 준비되면 새 서버가 통합 상태를 로드합니다. 다음과 같은 경우 Fuse Online 콘솔을 다시 사용할 수 있습니다.

  • syndesis-server Pod 상태는 Running 입니다.
  • Fuse Online 콘솔을 새로 고치면 통합, 연결, 메시지, 가동 시간 값이 표시됩니다.

syndesis 사용자 지정 리소스에 대한 일부 변경 사항은 Fuse Online 구성을 업데이트하지만 syndesis-server 를 다시 배포할 필요는 없습니다. 예를 들면 다음과 같습니다.

  • syndesis 사용자 정의 리소스를 업데이트하여 백업을 지정할 때 백업 작업이 시작되기 몇 초 전입니다.

각 구성 변경의 영향은 설치 후 허용되는 Fuse Online 구성 변경 사항에 설명되어 있습니다.

3.3. API에 대한 Fuse Online 및 3scale 검색 구성

API 공급자 통합을 생성하는 경우 Red Hat 3scale에서 해당 통합을 위해 API를 검색할 수 있습니다. 기본 동작은 3scale에서 자동 검색에 대해 API가 노출되지 않는다는 것입니다.

3scale 검색을 활성화하면 나중에 선택적으로 비활성화할 수 있습니다.

3.3.1. API 3scale 검색을 사용하도록 Fuse Online 구성

API 공급자 통합을 생성하는 경우 Red Hat 3scale에서 해당 통합을 위해 API를 검색할 수 있습니다. 기본 동작은 3scale에서 자동 검색에 대해 API가 노출되지 않는다는 것입니다. 검색을 활성화하면 3scale 사용자 인터페이스에 대한 URL을 제공해야 합니다.

Fuse Online을 설치하기 전에 API의 3scale 검색을 사용하도록 Fuse Online을 구성하려면 Fuse Online을 구성하는 사용자 지정 리소스 속성에 대한 설명을 참조하십시오.

설치 후 syndesis 사용자 정의 리소스를 업데이트하여 검색을 활성화할 수 있습니다. 이를 위한 지침은 이 주제에서 확인할 수 있습니다. 검색을 활성화하면 리소스를 업데이트할 때 연결된 OpenShift 프로젝트에만 적용됩니다.

3scale 서비스 검색을 활성화하면 다음을 의미합니다.

  • 기본 동작은 3scale이 API 공급자 통합을 게시하는 것입니다. 3scale에서 API 공급자 통합을 게시하는 경우:

    • Fuse Online에서는 실행 중인 API 공급자 통합을 위한 외부 URL을 제공하지 않습니다.
    • API는 3scale에서만 액세스할 수 있습니다. 엔드포인트를 노출하려면 3scale의 구성이 필요합니다. 자세한 내용은 Red Hat 3scale API Management, Service Discovery 를 참조하십시오.
  • API 공급자 통합 작성자는 해당 통합을 위해 3scale 검색을 비활성화할 수 있습니다. 즉, 각 API 공급자 통합 작성자는 통합의 API를 검색할 수 있는지 여부를 선택할 수 있습니다.

사전 요구 사항

  • Fuse Online은 OCP 현장에 설치됩니다.
  • oc 클라이언트 툴이 설치되고 Fuse Online이 설치된 OCP 클러스터에 연결됩니다.
  • API 검색을 활성화하려는 프로젝트에 Fuse Online을 설치할 수 있는 권한이 있습니다.
  • OpenShift 클러스터에서 3scale 프로젝트의 이름을 알고 있습니다.

절차

  1. Fuse Online을 설치할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u developer -p developer

  2. Fuse Online이 실행 중인 OpenShift 프로젝트로 전환합니다. 이 프로젝트에만 검색을 활성화할 수 있습니다. 예를 들면 다음과 같습니다.

    oc project my-fuse-online-project

  3. 3scale 프로젝트에서 Fuse Online 통합을 볼 수 있는 권한을 추가합니다.

    oc adm policy add-cluster-role-to-user view system:serviceaccount:<3scale-project>:amp

    예를 들어 OpenShift의 3scale 프로젝트 이름이 my3scale 인 경우 다음과 같습니다.

    oc adm policy add-cluster-role-to-user view system:serviceaccount:my3scale:amp

  4. syndesis 사용자 정의 리소스를 편집합니다.

    1. 일반적으로 편집기에서 리소스를 여는 다음 명령을 호출합니다.

      oc edit syndesis

    2. managementUrlFor3scale 을 3scale 사용자 인터페이스의 URL로 설정하여 리소스를 편집합니다. 결과는 다음과 같습니다.

      spec:
        components:
          server:
            features:
              managementUrlFor3scale: https://3scale-admin.apps.mycluster.com
      Copy to Clipboard Toggle word wrap
    3. 리소스를 저장합니다.
  5. 선택 사항: 전환한 프로젝트에 대해 검색이 켜져 있는지 확인하려면 다음 명령을 호출합니다.

    oc describe dc/syndesis-server

    discovery가 켜지면 이 명령의 출력은 OPENSHIFT_MANAGEMENT_URL_FOR3SCALE 환경 변수가 사용자 정의 리소스에서 지정한 URL로 설정되어 있음을 표시합니다.

결과

syndesis 사용자 정의 리소스 트리거의 변경으로 Fuse Online 설치를 담당하는 syndesis-operator 를 트리거하여 syndesis-server 를 재배포합니다. 전환한 OpenShift 프로젝트에서 새로운 기본 동작은 API가 3scale의 검색에 노출된다는 것입니다.

syndesis-server DeploymentConfig 오브젝트를 편집하여 OPENSHIFT_MANAGEMENT_URL_FOR3SCALE 환경 변수를 설정하지 마십시오. syndesis-operator 가 변경 사항을 되돌리기 때문에 이 작업이 작동하지 않습니다. syndesis-operator 는 Fuse Online이 syndesis 사용자 정의 리소스에 따라 배포되고 항상 배포되도록 합니다.

3.3.2. API의 3scale 검색을 비활성화하도록 Fuse Online 구성

API 의 3scale 검색을 활성화하기 위해 Fuse Online 구성에 설명된 절차를 수행한 경우 각 API 공급자 통합 작성자는 통합 API를 검색할 수 있는지 여부를 선택할 수 있습니다. 예를 들어 Fuse Online에서 API 공급자 통합을 편집하고 테스트하려는 경우 예를 들어 통합 API를 3scale에서 검색할 수 없는 기본 동작을 재구성할 수 있습니다. 이렇게 하려면 managementUrlFor3scale 키와 값을 지정하는 줄이 주석 처리되도록 Fuse Online syndesis 사용자 정의 리소스를 업데이트합니다. 이렇게 하면 3scale의 검색이 비활성화됩니다. 그런 다음 검색 가능한 API와 함께 게시된 API 공급자 통합을 다시 게시합니다.

사전 요구 사항

절차

  1. Fuse Online을 설치할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u developer -p developer

  2. 3scale 검색이 활성화된 OpenShift 프로젝트로 전환합니다. 예를 들면 다음과 같습니다.

    oc project my-fuse-online-project

  3. syndesis 사용자 정의 리소스를 편집합니다.

    1. 일반적으로 편집기에서 리소스를 여는 다음 명령을 호출합니다.

      oc edit syndesis

    2. managementUrlFor3scale 키와 값을 지정하는 행 시작 부분에 해시 기호(#)를 삽입하여 리소스를 편집합니다. 이렇게 하면 행이 주석으로 만들어 검색을 비활성화합니다. 결과는 다음과 같아야 합니다.

      spec:
        components:
          server:
            features:
            #  managementUrlFor3scale: https://3scale-admin.apps.mycluster.com
      Copy to Clipboard Toggle word wrap
    3. 리소스를 저장합니다.

      이렇게 하면 syndesis 사용자 정의 리소스가 업데이트됩니다. 이번 업데이트에서는 OPENSHIFT_MANAGEMENT_URL_FOR3SCALE 환경 변수가 제거됩니다. syndesis 사용자 정의 리소스 트리거의 변경으로 Fuse Online 설치를 담당하는 syndesis-operator 를 트리거하여 syndesis-server 를 재배포합니다. 새로운 기본 동작은 API가 더 이상 3scale의 검색에 노출되지 않는다는 것입니다.

    syndesis-server DeploymentConfig 오브젝트를 편집하여 OPENSHIFT_MANAGEMENT_URL_FOR3SCALE 환경 변수의 설정을 제거하지 마십시오. syndesis-operator 가 변경 사항을 되돌리기 때문에 이 작업이 작동하지 않습니다. syndesis-operator 는 Fuse Online이 syndesis 사용자 정의 리소스에 따라 배포되고 항상 배포되도록 합니다.

  4. 검색이 활성화되었으며 검색을 비활성화한 프로젝트에서 생성된 API 공급자 통합을 다시 게시합니다.

    즉, API 공급자 통합이 생성된 프로젝트에 대해 검색을 활성화하는 동안 해당 통합 API 검색을 비활성화한 경우 API 공급자 통합을 다시 게시할 필요가 없습니다.

결과

관련 OpenShift 프로젝트에서 생성된 API 공급자 통합을 위한 API는 더 이상 3scale에서 검색할 수 없습니다.

Fuse Online에서 관련 프로젝트에 있는 API 공급자 통합을 게시(또는 다시 게시)할 때 Fuse Online은 API 공급자 통합 작업을 호출하기 위한 외부 URL을 제공합니다.

3.4. Fuse Online Pod 구성

Fuse Online 사용자 정의 리소스에서 노드 유사성 및 허용 오차 옵션을 설정하여 Fuse Online 인프라 구성 요소의 배치와 OpenShift 클러스터 내의 노드에 Pod를 통합할 수 있습니다. nodeAffinity 옵션을 사용하면 Fuse Online Pod의 선호도를 배치할 노드 그룹으로 지정할 수 있습니다. 허용 오차 옵션을 사용하면 Fuse Online Pod가 실행되는 노드를 제어하고 다른 워크로드가 해당 노드를 사용하지 못하도록 할 수 있습니다.

Fuse Online을 설치하기 전후에 Fuse Online 사용자 지정 리소스를 편집하여 이러한 옵션을 설정합니다.

통합 배포와 별도로 인프라 구성 요소 배포에 대한 노드 유사성 또는 허용 오차 설정을 구성합니다.

  • infraScheduling - 이러한 Fuse Online 인프라 배포에 대한 노드 유사성 및 허용 오차 설정을 구성하려면 infraScheduling 옵션을 지정합니다.

    • syndesis-db
    • syndesis-meta
    • syndesis-prometheus
    • syndesis-ui

      참고: syndesis-operator 배포는 Fuse Online 관리 구성 요소이므로 노드 유사성 또는 허용 오차 변경의 영향을 받지 않습니다.

  • IntegrationScheduling - 통합 스케줄링 옵션을 지정 하여 모든 Fuse Online 통합 배포에 대한 노드 유사성 및 허용 오차 설정을 구성합니다.

    참고: Fuse Online 배포가 통합 배포인지 여부를 확인하려면 배포 이름을 확인합니다. oc get pods 명령을 사용하여 실행 중인 배포 목록을 볼 수 있습니다. 배포 이름에 -i 접두사가 포함된 경우 통합 배포입니다(예: i-my-integration ).

다음 절차에서는 oc patch 명령을 사용하여 사용자 정의 리소스를 편집하는 방법을 설명합니다. 또는 다음 항목에 설명된 대로 사용자 정의 리소스를 편집할 수 있습니다.

사전 요구 사항

  • Fuse Online은 OCP 현장에 설치됩니다.
  • oc 클라이언트 툴이 설치되고 Fuse Online이 설치된 OCP 클러스터에 연결됩니다.

절차

  1. oc patch 명령을 다음 구문과 함께 사용하여 허용 오차 설정을 구성합니다. Fuse Online 인프라 구성 요소 배포에 대한 infra Scheduling 또는 Fuse Online 통합 배포에 대한 통합 스케줄링을 지정합니다.

    oc patch syndesis/app --type=merge -p '{"spec":{"infraScheduling"|"infraScheduling":{"tolerations":[{"key":"_value1_","operator":"_value2_","effect":"_value3_"},{"key":"_value4_","operator":"_value5_","effect":"_value6_"}]}}}'
    Copy to Clipboard Toggle word wrap

    예를 들어 다음 명령은 Fuse Online 인프라 구성 요소에 대한 허용 오차를 추가합니다.

    oc patch syndesis/app --type=merge -p '{"spec":{"infraScheduling":{"tolerations":[{"key":"tol_1","operator":"Equal","effect":"NoSchedule"},{"key":"tol_2","operator":"Equal","value":"value2","effect":"NoSchedule"}]}}}'
    Copy to Clipboard Toggle word wrap
  2. oc patch 명령을 다음 구문과 함께 사용하여 노드 유사성 설정을 구성합니다. Fuse Online 인프라 구성 요소 배포에 대한 infra Scheduling 또는 Fuse Online 통합 배포에 대한 통합 스케줄링을 지정합니다.

     oc patch syndesis/app --type=merge  -p '{"spec":{"infraScheduling"|"infraScheduling":{"affinity":{"nodeAffinity":{"preferredDuringSchedulingIgnoredDuringExecution":[{"weight":_value1_,"preference":{"matchExpressions":[{"key":"_value1_","operator":"_value2_","values":["_value3_","_value4_"]}]}}]}}}'
    Copy to Clipboard Toggle word wrap

    예를 들어 다음 명령은 nodeAffinity를 Fuse Online 인프라 구성 요소 및 통합으로 설정합니다.

     oc patch syndesis/app --type=merge  -p '{"spec":{"infraScheduling":{"affinity":{"nodeAffinity":{"preferredDuringSchedulingIgnoredDuringExecution":[{"weight":11,"preference":{"matchExpressions":[{"key":"_affinity","operator":"In","values":["foo","bar"]}]}}]}}},"integrationScheduling":{"affinity":{"nodeAffinity":{"preferredDuringSchedulingIgnoredDuringExecution":[{"weight":22,"preference":{"matchExpressions":[{"key":"my_affinity2","operator":"In","values":["foo","bar"]}]}}]}}}}}'
    Copy to Clipboard Toggle word wrap
  3. 구성 설정을 제거하려면 다음 예제 명령에 설명된 대로 oc patch 명령에서 remove 옵션을 사용합니다.

    • 다음 예제 명령은 Fuse Online 통합을 위한 nodeAffinity에서 preferredDuringSchedulingIgnoredDuringExecution 설정을 제거합니다.

      oc patch syndesis/app --type=json -p '[{"op": "remove", "path": "/spec/integrationScheduling/affinity/nodeAffinity/preferredDuringSchedulingIgnoredDuringExecution" }]'
      Copy to Clipboard Toggle word wrap
    • 다음 예제에서는 Fuse Online 인프라 구성 요소에서 허용 오차를 제거합니다.

      oc patch syndesis/app --type=json -p '[{"op": "remove", "path": "/spec/infraScheduling/tolerations" }]'
      Copy to Clipboard Toggle word wrap

추가 리소스

허용 오차 및 노드 유사성에 대한 자세한 내용은 OpenShift 설명서의 노드 테인트 섹션을 사용하여 노드 유사성 이해 및 Pod 배치 제어를 참조하십시오.

3.5. HTTP 프록시 구성

많은 서비스에서 HTTP 프록시를 사용하여 다른 서비스 또는 구성 요소와의 통신을 필터링하고 보호합니다. Fuse Online 구성 요소 및 통합에서 HTTP 프록시를 구성하려면 Fuse Online을 설치하기 전이나 후에 Fuse Online 사용자 지정 리소스를 편집합니다.

사전 요구 사항

  • HTTP 프록시의 호스트 및 포트 값을 알고 있습니다.

절차

  1. 편집기에서 사용자 정의 리소스를 엽니다.

    Fuse Online을 이미 설치한 경우 " Fuse Online 구성 변경 절차에 따라 사용자 지정 리소스를 엽니다.

    Fuse Online을 아직 설치하지 않은 경우 OCP 버전에 따라 다음 항목의 단계에 따라 사용자 지정 리소스를 엽니다.

  2. syndesis-serversyndesis-meta 구성 요소의 경우 Java 옵션(javaOptions) 매개변수를 설정하고 HTTP 프록시 호스트 및 포트에 대한 값을 지정합니다. syndesis-serversyndesis-meta 모두에 동일한 HTTP 프록시 값을 사용합니다.

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

    spec:
      components:
        server:
          javaOptions:
    -Dhttp.proxyHost=10.0.0.100 -Dhttp.proxyPort=8800
    
        meta:
          javaOptions:
    -Dhttp.proxyHost=10.0.0.100 -Dhttp.proxyPort=8800
    Copy to Clipboard Toggle word wrap
  3. Fuse Online 통합의 경우 Maven 인수(additionalArguments) 매개변수를 설정합니다. 예를 들면 다음과 같습니다.

    spec:
      components:
        server:
          features:
            maven:
              additionalArguments: "-Dhttp.proxy=10.0.0.100 -Dhttp.proxyPort=8800"
    Copy to Clipboard Toggle word wrap
  4. 사용자 정의 리소스를 저장합니다.

    Fuse Online이 이미 설치된 경우 2단계에서 javaOptions 업데이트에 대한 응답으로 syndesis-server pod가 재배포됩니다.

  5. HTTP 프록시를 사용하는 실행 중인 통합을 다시 게시합니다.

    1. Fuse Online에서 업데이트할 통합을 선택합니다.
    2. 편집을 선택합니다.
    3. 게시 를 선택합니다.

Fuse Online에서는 통합을 다시 빌드할 때 HTTP 프록시 설정을 사용합니다.

3.6. OCP에서 실행되는 Fuse Online 환경에 샘플 데이터 추가

새로운 사용자가 Fuse Online과의 통합을 생성하는 방법을 배울 수 있도록 Fuse Online 환경에 샘플 데이터를 추가할 수 있습니다.

  • ToDo
  • 샘플 PostgresDB 데이터베이스 및 PostgresDB 연결

Cryostat to Database, AMQ to REST API 및 API 공급자 빠른 시작 샘플 통합에는 이 샘플 데이터가 필요합니다.

기본적으로 샘플 PostgresDB 데이터베이스 및 연결 및 ToDo 앱은 비활성화되어 있습니다(설치되지 않음).

Fuse Online을 설치하기 전에 샘플 데이터를 포함하도록 Fuse Online을 구성하려면 Fuse Online을 구성하는 사용자 지정 리소스 속성에 대한 설명을 참조하십시오.

사전 요구 사항

  • Fuse Online은 OCP 현장에 설치되어 실행됩니다.
  • oc 클라이언트 툴이 설치되고 Fuse Online이 설치된 OCP 클러스터에 연결됩니다.
  • Fuse Online 사용자 정의 리소스를 편집할 수 있는 권한이 있습니다.

절차

  1. Fuse Online 사용자 지정 리소스를 편집할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u developer -p developer

  2. Fuse Online이 실행 중인 프로젝트로 전환합니다. 예를 들면 다음과 같습니다.

    oc project my-fuse-online-project

  3. syndesis 사용자 정의 리소스를 편집합니다.

    1. 일반적으로 편집기에서 리소스를 여는 다음 명령을 호출합니다.

      oc edit syndesis

    2. demoData 필드를 추가하고 addons:todo:enabled 필드를 true 로 변경하여 사용자 정의 리소스를 편집합니다.

      spec:
        demoData: true
        addons:
          todo:
            enabled: true
      Copy to Clipboard Toggle word wrap
    3. 리소스를 저장합니다.

      syndesis 사용자 정의 리소스 트리거 syndesis-operator 에 이러한 변경 사항을 저장하여 새 todo Pod를 생성합니다.

  4. 사용자 정의 리소스의 demoData 옵션과 관련된 변경 사항을 업데이트하려면 다음 명령을 사용하여 syndesis-serversyndesis-db Pod를 삭제하여 재배포를 트리거해야 합니다.

    oc delete $(oc get -o name pod -l syndesis.io/component=syndesis-server)
    
    oc delete $(oc get -o name pod -l syndesis.io/component=syndesis-db)
    Copy to Clipboard Toggle word wrap

4장. OCP에서 Fuse Online 관리

Fuse Online을 OCP(OpenShift Container Platform) 현장에 설치한 후 Prometheus를 사용하여 통합 활동을 모니터링할 수 있으며 Fuse Online 환경을 복원하는 데 사용할 수 있는 주기적인 Fuse Online 백업을 설정할 수 있습니다. 필요에 따라 Fuse Online을 업그레이드하거나, Fuse Online을 제거하거나, Fuse Online이 포함된 OCP 프로젝트를 삭제할 수 있습니다.

자세한 내용은 다음 항목을 참조하십시오.

4.1. Fuse Online 구성 요소 감사

중요

Fuse Online 감사는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. Red Hat은 프로덕션 환경에서 사용하지 않는 것이 좋습니다. 이러한 기능은 향후 제품 기능에 조기 액세스할 수 있으므로 개발 프로세스 중에 기능을 테스트하고 피드백을 제공할 수 있습니다. Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 https://access.redhat.com/support/offerings/techpreview/에서 참조하십시오.

Fuse Online에서는 사용자가 Fuse Online 구성 요소로 변경한 기본 감사( 연결 - Fuse Online 웹 콘솔의 커넥터 세부 정보 페이지에 표시된 이름 및 기타 필드)를 지원합니다. * Connectors - 이름 필드 * 통합 - 이름 필드입니다.

개발자가 이러한 구성 요소 필드 중 하나를 업데이트하는 경우(예: 통합 이름 변경) Fuse Online에서 ID, 사용자, 타임스탬프, 구성 요소(연결,커넥터 또는 통합)와 같은 정보를 포함하는 표준 출력과 변경 유형(생성,수정 또는 삭제)을 포함하는 표준 출력으로 AUDIT 메시지를 보냅니다. 감사 메시지의 필드 값은 30자로 잘립니다.

기본적으로 Fuse Online 감사는 비활성화되어 있습니다. Fuse Online 사용자 지정 리소스를 편집하여 활성화할 수 있습니다. Fuse Online을 설치하기 전에 감사를 활성화하려면 Fuse Online을 구성하는 사용자 지정 리소스 속성에 대한 설명을 참조하십시오.

사전 요구 사항

  • oc 클라이언트 툴이 설치되고 Fuse Online이 설치된 OCP 클러스터에 연결됩니다.
  • Fuse Online 사용자 정의 리소스를 편집할 수 있는 권한이 있습니다.

절차

  1. Fuse Online 사용자 지정 리소스를 편집할 수 있는 권한을 부여하는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u admin -p admin-password

  2. Fuse Online 환경을 실행 중인 프로젝트로 전환합니다. 예를 들면 다음과 같습니다.

    oc project my-fuse-online-project

  3. syndesis 사용자 정의 리소스를 편집합니다.

    1. 일반적으로 편집기에서 리소스를 여는 다음 명령을 호출합니다.

      oc edit syndesis

    2. 다음 행이 리소스에 있는지 확인합니다. 필요에 따라 편집합니다.

      components:
        server:
          features:
            auditing: true
      Copy to Clipboard Toggle word wrap
  4. 리소스를 저장합니다.

    syndesis 사용자 정의 리소스에서 감사 기능을 활성화하면 실행 중인 syndesis-server 구성이 다시 로드되고 Fuse Online 구성 요소에 대한 관련 변경 사항을 로깅하기 시작합니다.

  5. Fuse Online 감사 로그 메시지를 보려면 다음 명령을 입력합니다.

oc logs -l syndesis.io/component=syndesis-server

4.2. Prometheus를 사용하여 Fuse Online 통합 및 인프라 구성 요소 모니터링

Prometheus를 사용하여 Fuse Online 인프라 구성 요소 및 Fuse Online 통합을 모니터링할 수 있습니다. Grafana 대시보드를 사용하여 Prometheus에서 수집한 지표를 시각화할 수도 있습니다.

중요

Prometheus에 대한 Red Hat 지원은 Red Hat 제품 설명서에 제공된 설정 및 구성 권장 사항으로 제한됩니다.

Grafana는 커뮤니티에서 지원하는 기능입니다. Red Hat Fuse 제품을 모니터링하기 위해 Grafana를 배포하는 것은 Red Hat 프로덕션 SLA(서비스 수준 계약)에서 지원되지 않습니다.

Fuse Online 통합 모니터링 외에도 Prometheus를 사용하여 다음 Fuse Online 인프라 구성 요소가 노출하는 메트릭을 모니터링할 수 있습니다.

통합 서버
syndesis-server 구성 요소는 Micrometer로 조정되어 기본적으로 모든 JVM Micrometer 메트릭을 자동으로 노출합니다. 또한 syndesis-server 는 요청 속도, 오류 속도 및 대기 시간과 같은 REST API 끝점에 대한 지표를 표시합니다.
syndesis Meta
syndesis-meta 구성 요소는 Micrometer로 조정되어 기본적으로 모든 JVM Micrometer 메트릭을 자동으로 노출합니다. 또한 REST API 엔드포인트에 대한 지표를 노출합니다.
Syndesis DB
Fuse Online Postgres 데이터베이스의 메트릭은 타사 Prometheus 내보내기를 사용하여 내보냅니다.
통합
통합 지표는 통합이 생성된 후 표시되고 기본적으로 여러 JVM 지표를 노출하는 공식 Cryostat 내보내기를 사용하여 내보냅니다. 또한 통합 메트릭은 메시지 속도 및 오류 비율과 같은 Apache Camel에 고유한 지표를 노출합니다.

사전 요구 사항

  • Fuse Online은 OCP 현장에 설치되어 실행됩니다.
  • oc 클라이언트 툴이 설치되고 Fuse Online이 설치된 OCP 클러스터에 연결됩니다.
  • Fuse Online 네임스페이스에 대한 관리자 액세스 권한이 있습니다.
  • 사용자 이름과 암호를 알고 있는 Red Hat 개발자 계정이 있습니다. 설치 스크립트에서 https://developers.redhat.com 에 대해 인증할 수 있도록 이러한 인증 정보를 입력하라는 메시지를 표시합니다. 계정 생성에 대한 자세한 내용은 Red Hat Registry 액세스 및 구성을 참조하십시오.
  • 클러스터 관리자 액세스 권한이 있는 사용자는 이러한 설치 지침에 따라 Application Monitoring Operator(특히 태그 v1.1.6)를 사용하여 Prometheus 및 Grafana를 배포했습니다.

절차

  1. Fuse Online 네임스페이스에서 다음 명령을 사용하여 monitoring-key=middleware 레이블을 설정합니다.

    oc label namespace <fuse-online-namespace> monitoring-key=middleware
    Copy to Clipboard Toggle word wrap
  2. Fuse Online 설치에 애플리케이션 모니터링 구성 리소스가 OpenShift 클러스터에 추가되었는지 확인합니다.

    1. OpenShift 웹 콘솔에서 application-monitoring 프로젝트로 이동한 다음 prometheus-route URL을 엽니다.
    2. Prometheus 콘솔에서 상태대상 페이지로 이동합니다.

      통합 대상이 나열된 경우 모니터링용으로 Fuse Online이 구성되어 4단계로 건너뛸 수 있습니다.

      통합 대상이 나열되지 않은 경우 3 단계로 진행합니다.

  3. 별도의 OpenShift 프로젝트에 설치된 Prometheus 인스턴스의 모니터링을 위해 Fuse Online을 공개하려면 syndesis 사용자 정의 리소스에서 ops 애드온을 활성화합니다.

    1. Fuse Online 네임스페이스로 이동합니다.

      Expand
      OpenShift 4.xOpenShift 3.11
      1. OpenShift 웹 콘솔에서 Fuse Online(대시) 프로젝트로이동합니다.
      2. Catalog > Installed Operators 를 선택한 다음 Fuse Online Operator 를 클릭합니다.
      3. Syndesis CRD 를 클릭한 다음 app 을 클릭합니다.
      4. Yaml 을 클릭하여 편집기에서 yaml 파일을 엽니다.
      1. 리소스 > 기타 리소스 를 선택합니다.
      2. 드롭다운 메뉴에서 Syndesis 리소스 유형을 선택합니다.
      3. app 리소스의 경우 Actions 를 클릭한 다음 Edit YAML 을 선택하여 편집기에서 yaml 파일을 엽니다.
    2. 다음 행을 추가하여 yaml 파일을 편집하여 Syndesis.Spec.Addons.Ops.Enable 값을 true 로 설정합니다.

      spec:
        addons:
          ops:
            enabled: true
      Copy to Clipboard Toggle word wrap
    3. 파일을 저장합니다.
    4. Pod가 다시 시작될 때까지 기다립니다.

      참고

      설치 명령을 실행한 직후 Fuse Online 인프라 리소스를 사용할 수 없습니다. Prometheus Targets 페이지에서 Fuse Online(Syndesis) 대상을 보기 전에 기다려야 할 수 있습니다.

  4. Prometheus에 액세스하려면 다음을 수행합니다.

    1. 애플리케이션 모니터링 Operator가 설치된 프로젝트의 OpenShift 콘솔에서 경로 목록을 엽니다.
    2. prometheus-route 항목 옆에 있는 호스트 이름 URL을 클릭하여 Prometheus 콘솔을 엽니다.
    3. Fuse Online 인프라 구성 요소에 대해 구성된 경고 규칙 목록을 보려면 경고 메뉴 항목을 클릭합니다.
  5. Grafana 대시보드에 액세스하려면 다음을 수행합니다.

    1. 애플리케이션 모니터링 Operator가 설치된 프로젝트의 OpenShift 콘솔에서 경로 목록을 엽니다.
    2. grafana-route 항목 옆에 있는 호스트 이름 URL을 클릭하여 Grafana 콘솔을 엽니다.
    3. Grafana 콘솔 상단에서 대시보드 선택기를 클릭합니다.

      • Fuse Online 통합의 경우 Integration - Camel 을 선택합니다. 이 대시보드에는 Apache Camel 통합 애플리케이션에서 노출하는 표준 지표가 표시됩니다.
      • Fuse Online 인프라 구성 요소의 경우 다음 인프라 대시보드 중 하나를 선택합니다.

        인프라 - DB
        Fuse Online Postgres 인스턴스와 관련된 지표를 표시합니다.
        인프라 - JVM
        syndesis-meta 또는 syndesis-server 애플리케이션에 대해 실행 중인 JVM에 대한 지표를 표시합니다. 대시보드 상단에 있는 애플리케이션 드롭다운 목록에서 모니터링할 애플리케이션을 선택합니다.
        인프라 - REST API
        요청 처리량대기 시간과 같은 Fuse Online 인프라 API 끝점과 관련된 메트릭을 표시합니다. 대시보드 상단에 있는 애플리케이션 드롭다운 목록에서 모니터링할 애플리케이션을 선택합니다.
  6. Prometheus Alertmanager에 액세스하려면 다음을 수행합니다.

    1. 애플리케이션 모니터링 Operator가 설치된 프로젝트의 OpenShift 콘솔에서 경로 목록을 엽니다.
    2. alertmanager-route 항목 옆에 있는 호스트 이름 URL을 클릭하여 Alertmanager 콘솔을 엽니다.

      Fuse Online 인프라가 정상이면 기본 보기가 비어 있습니다.

      인프라 구성 요소가 비정상이면 실행 중인 활성 경고가 모두 나열되고 해당 구성 요소를 음소거하는 옵션이 나열됩니다.

추가 리소스

Prometheus를 시작하는 방법에 대한 자세한 내용은 https://prometheus.io/docs/prometheus/latest/getting_started/로 이동하십시오.

4.3. Fuse Online Metering 레이블

OpenShift Metering Operator를 사용하여 설치된 Fuse Online Operator 및 구성 요소를 분석하여 Red Hat 서브스크립션을 준수하는지 확인할 수 있습니다. 미터링에 대한 자세한 내용은 OpenShift 설명서 를 참조하십시오.

다음 표에는 Fuse Online 인프라 구성 요소 및 통합에 대한 미터링 레이블이 나열되어 있습니다.

Expand
표 4.1. Fuse Online의 미터링 라벨
레이블가능한 값

com.company

Red_Hat

rht.prod_name

Red_Hat_Integration

rht.prod_ver

7.8

rht.comp

Fuse

rht.comp_ver

7.8

rht.subcomp

syndesis-db

syndesis-server

syndesis-meta

syndesis-ui

syndesis-prometheus

syndesis-operator

i-<integration name>

rht.subcomp_t

인프라 ( rht.subcomp = syndesis-*)

애플리케이션 ( rht.subcomp = i-*)

  • infrastructure 예제(인프라 구성 요소가 syndesis-db인 경우)

    com.company: Red_Hat
    rht.prod_name: Red_Hat_Integration
    rht.prod_ver: 7.8
    rht.comp: Fuse
    rht.comp_ver: 7.8
    rht.subcomp: syndesis-db
    rht.subcomp_t: infrastructure
    Copy to Clipboard Toggle word wrap
  • 애플리케이션 예(통합 배포 이름이 mytestapp인 경우 )

    com.company: Red_Hat
    rht.prod_name: Red_Hat_Integration
    rht.prod_ver: 7.8
    rht.comp: Fuse
    rht.comp_ver: 7.8
    rht.subcomp: i-mytestapp
    rht.subcomp_t: application
    Copy to Clipboard Toggle word wrap

4.4. Fuse Online 환경 백업

정기적으로 백업하도록 Fuse Online을 구성할 수 있습니다.

  • Fuse Online에서 연결 및 통합을 저장하는 내부 PostgreSQL 데이터베이스입니다.
  • syndesis-operator 에서 생성하고 Fuse Online을 실행하는 데 필요한 OpenShift 리소스입니다. 여기에는 구성 맵, 배포 구성 및 서비스 계정이 포함되며 이에 국한되지 않습니다.

Fuse Online을 설치하기 전에 Fuse Online 환경에 대한 백업을 구성하거나 Fuse Online 환경의 구성을 변경하여 백업을 활성화할 수 있습니다.

Fuse Online이 백업을 수행하도록 구성된 경우 Fuse Online은 데이터를 하나의 파일에 압축하고 사용자가 지정한 Amazon S3 버킷에 해당 파일을 업로드합니다. 새 Fuse Online 환경(연결 또는 정의된 통합 없음)에 백업을 적용하여 백업된 Fuse Online 환경을 복원할 수 있습니다.

사전 요구 사항

  • OCP는 현장에서 실행되고 있습니다.
  • oc 클라이언트 툴이 설치되어 Fuse Online이 실행 중이거나 실행 중인 OCP 클러스터에 연결되어 있습니다.
  • 클러스터 관리 권한이 있는 사용자는 클러스터에서 액세스할 수 있는 권한이 있는 모든 프로젝트에 Fuse Online을 설치할 수 있는 권한을 부여했습니다.
  • AWS 액세스 키와 AWS 시크릿 키가 있습니다. 이러한 인증 정보를 얻는 방법에 대한 자세한 내용은 IAM 사용자의 액세스 키 관리에 대한 AWS 문서를 참조하십시오.
  • 업로드하려는 S3 버킷이 상주하는 AWS 리전을 알고 있습니다.
  • 백업을 업로드할 S3 버킷의 이름을 알고 있습니다.

절차

  1. Fuse Online을 설치할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u developer -p developer

  2. 백업을 구성하려는 Fuse Online 환경을 실행 중이거나 실행 중인 OpenShift 프로젝트로 전환합니다. 예를 들면 다음과 같습니다.

    oc project my-fuse-online-project

  3. OpenShift 시크릿을 생성합니다. 명령줄에서 다음을 수행합니다.

    • 다음 명령 형식에 표시된 대로 syndesis-backup-s3 을 지정합니다.
    • AWS 변수를 AWS 액세스 키, AWS 시크릿 키, 버킷이 있는 AWS 리전 및 버킷 이름으로 교체합니다.

      다음 명령 형식을 사용하여 보안을 생성합니다.

      oc create secret generic syndesis-backup-s3 \
      --from-literal=secret-key-id="my-aws-access-key" \
      --from-literal=secret-access-key="my-aws-secret-key" \
      --from-literal=region="aws-region" \
      --from-literal=bucket-name="aws-bucket-name"
      Copy to Clipboard Toggle word wrap

      백업 작업이 실행 중인 경우 이 시크릿이 있어야 합니다.

  4. Fuse Online 이 아직 설치되지 않은 경우 default-cr.yml 파일을 편집하여 백업을 활성화해야 합니다. Fuse Online을 설치하기 전에 syndesis 사용자 정의 리소스 편집을 참조하십시오. Fuse Online이 설치되면 사용자 정의 리소스에서 지정한 일정에 따라 백업 작업이 있습니다.

    Fuse Online 이 실행 중인 경우 syndesis 사용자 정의 리소스를 편집해야 합니다.

    1. 다음 명령을 호출하여 편집기에서 syndesis 사용자 정의 리소스를 엽니다.

      oc edit syndesis

    2. spec 아래에 다음을 추가합니다.

      backup:
        schedule: my-backup-interval
      Copy to Clipboard Toggle word wrap

      my-backup-interval 을 백업 사이에 원하는 기간으로 바꿉니다. 백업 간 간격을 지정하는 방법을 확인하려면 다음 리소스를 참조하십시오.

      • 사전 정의된 Cron 스케줄
      • Cron 간격

        간격 앞에 @ 기호를 지정하지 마십시오. 예를 들어 일별 백업을 구성하려면 사용자 정의 리소스에 다음과 같은 내용이 포함됩니다.

        apiVersion: syndesis.io/v1beta1
        kind: Syndesis
        metadata:
          name: app
        spec:
          backup:
            schedule: daily
        Copy to Clipboard Toggle word wrap
  5. 파일을 저장합니다.

    그러면 syndesis-operator 에 백업 작업이 추가됩니다.

결과

Fuse Online이 이미 실행 중인 경우 사용자가 정의한 일정에 따라 Fuse Online 백업 작업이 있습니다.

다음 단계

Fuse Online을 설치해야 하는 경우 default-cr.yml 파일을 편집하여 원하는 다른 기능을 활성화하거나 기타 다른 매개 변수를 설정합니다. default-cr.yml 파일에 원하는 모든 설정이 있는 경우 OpenShift 시크릿을 생성할 때 지정한 프로젝트에 Fuse Online을 설치합니다.

4.5. Fuse Online 환경 복원

연결 또는 통합을 아직 생성하지 않은 새 Fuse Online 환경에서는 Fuse Online 환경의 백업을 복원할 수 있습니다. Fuse Online 환경을 복원한 후에는 복원된 연결을 편집하여 암호를 업데이트해야 합니다. 그런 다음 복원된 통합을 게시할 수 있습니다.

사전 요구 사항

  • OCP는 현장에서 실행되고 있습니다.
  • oc 클라이언트 툴이 설치되어 Fuse Online 환경을 복원하려는 OCP 클러스터에 연결되어 있습니다.
  • 클러스터 관리 권한이 있는 사용자는 클러스터에서 액세스할 수 있는 권한이 있는 모든 프로젝트에 Fuse Online을 설치할 수 있는 권한을 부여했습니다.
  • 데이터를 정기적으로 백업하고 Amazon S3에 데이터를 업로드하도록 구성된 Fuse Online 환경이 있습니다.
  • Fuse Online 릴리스 번호(예: 7.6)는 백업된 Fuse Online 환경과 백업을 복원하려는 Fuse Online 환경과 동일합니다.
  • Fuse Online 백업이 포함된 AWS 버킷에 액세스할 수 있는 권한이 있습니다.
  • 백업을 복원하려는 Fuse Online 환경은 새로운 Fuse Online 설치입니다. 즉, 사용자가 정의한 연결 또는 통합이 없습니다. 연결 및 통합이 있는 Fuse Online 환경이 있는 프로젝트에서 Fuse Online을 복원하려면 해당 Fuse Online 환경을 제거하고 새 Fuse Online 환경을 설치해야 합니다.

절차

  1. Amazon S3에서 원하는 백업 파일을 다운로드합니다. 이에 대한 자세한 내용은 AWS 문서에서 S3 버킷에서 오브젝트를 다운로드하는 방법에 대한 것입니다.
  2. zip 파일의 내용을 추출합니다. 예를 들어 다음 명령줄은 7.6-2020-03-15-23:30:00.zip 파일의 압축을 해제하고 콘텐츠를 /tmp/fuse-online-backup 폴더에 복사합니다.

    unzip 7.6-2020-03-15-23:30:00.zip -d /tmp/fuse-online-backup

  3. Fuse Online 데이터베이스를 디코딩합니다. 예를 들면 다음과 같습니다.

    base64 -d /tmp/fuse-online-backup/syndesis-db.dump > /tmp/fuse-online-backup/syndesis-db
    Copy to Clipboard Toggle word wrap
  4. 새 Fuse Online 환경을 실행 중인 OpenShift 프로젝트로 전환합니다. 예를 들어 새 Fuse Online 환경이 my-fuse-online-project 인 경우 다음 명령을 호출합니다.

    oc project my-fuse-online-project

    이 절차의 나머지 부분에서는 새 Fuse Online 환경이 포함된 프로젝트로 전환했다고 가정합니다.

  5. 데이터베이스 pod의 이름을 가져옵니다.

    복원된 Fuse Online 환경에서 제공된 내부, PostgreSQL 데이터베이스를 사용하는 경우 다음 명령을 호출하여 데이터베이스 포드의 이름을 가져옵니다.

    oc get pods -l deploymentconfig=syndesis-db -o jsonpath='{.items[*].metadata.name}'
    Copy to Clipboard Toggle word wrap

    복원된 Fuse Online 환경에서 외부 데이터베이스를 사용하는 경우 해당 데이터베이스의 포드 이름을 가져오는 방법을 알고 있다고 가정합니다.

    DATABASE_POD_NAME 이 표시되는 나머지 명령에서 복원된 Fuse Online 환경에 대한 데이터베이스 포드 이름을 삽입합니다.

  6. 어떤 방식으로든 데이터베이스에 액세스하는 구성 요소를 축소합니다.

    1. 다른 구성 요소를 축소할 수 있도록 축소된 syndesis-operator 를 축소합니다.

      oc scale deployment syndesis-operator --replicas 0

    2. syndesis-serversyndesis-meta 구성 요소를 축소합니다.

      oc scale dc syndesis-server --replicas 0
      oc scale dc syndesis-meta --replicas 0

  7. 데이터베이스 백업 파일을 Fuse Online 데이터베이스 Pod로 보냅니다.

    oc cp /tmp/fuse-online-backup/syndesis-db DATABASE_POD_NAME:/tmp/syndesis-db
    Copy to Clipboard Toggle word wrap
  8. Fuse Online 데이터베이스 포드에서 원격 쉘 세션을 엽니다.

    oc rsh DATABASE_POD_NAME

  9. 다음 명령을 호출하여 Fuse Online 데이터베이스를 복원합니다.

    psql 명령이 데이터베이스 암호를 입력하라는 메시지를 표시하고 복원된 Fuse Online 환경에서 제공된 내부 PostgreSQL 데이터베이스를 사용하는 경우 syndesis-db 배포 구성에서 POSTGRESQL_PASSWORD 환경 변수에서 암호를 찾을 수 있습니다. 복원된 Fuse Online 환경에서 외부 데이터베이스를 사용하는 경우 암호를 알고 있다고 가정합니다.

    cd /tmp
    psql -c 'DROP database if exists syndesis_restore'
    psql -c 'CREATE database syndesis_restore'
    pg_restore -v -d syndesis_restore /tmp/syndesis-db
    psql -c "SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE datname = 'syndesis'"
    psql -c 'DROP database if exists syndesis'
    psql -c 'ALTER database syndesis_restore rename to syndesis'
    Copy to Clipboard Toggle word wrap

    이제 Fuse Online을 복원해야 합니다. RSH 세션을 종료할 수 있습니다.

    exit

  10. Fuse Online 구성 요소를 확장합니다.

    oc scale deployment syndesis-operator --replicas 1

    syndesis-operator1 로 스케일링하면 축소된 다른 Pod가 표시되어야 합니다. 그러나 이러한 상황이 발생하지 않으면 수동으로 확장할 수 있습니다.

    oc scale dc syndesis-server --replicas 1
    oc scale dc syndesis-meta --replicas 1

  11. 서버는 복원된 각 통합을 시작하려고 하지만 먼저 연결을 업데이트해야 합니다. 결과적으로 복원된 통합이 실행되고 있지 않은지 확인합니다.

    1. Fuse Online 콘솔 경로를 가져옵니다.

      echo "https://$(oc get route/syndesis -o jsonpath='{.spec.host}' )"
      Copy to Clipboard Toggle word wrap
    2. Fuse Online을 설치할 수 있는 권한이 있는 OpenShift 사용자 계정으로 Fuse Online 콘솔에 로그인합니다.
    3. 통합 목록을 표시하고 모든 통합이 중지되었는지 확인합니다. 통합이 실행 중인 경우 중지합니다.
  12. 암호가 있는 각 연결에 대해 이 Fuse Online 환경에 대해 올바른 암호를 갖도록 연결을 업데이트해야 합니다. 다음 단계에서는 제공된 PostgresDB 연결에 대해 이 작업을 수행하는 방법을 보여줍니다.

    1. 복원된 Fuse Online 환경이 실행되는 프로젝트에 대한 OpenShift 콘솔에서 PostgresDB 연결의 암호를 검색합니다. syndesis-db 배포에서 이 암호는 환경 변수에서 사용할 수 있습니다.
    2. Fuse Online 콘솔에서 연결을 표시합니다.
    3. PostgresDB 연결을 편집합니다.
    4. PostgresDB 연결의 연결 세부 정보에서 검색된 암호를 Password 필드에 붙여넣습니다.
  13. 각 통합에 대해 구성 필수 지표가 없는지 확인합니다. 통합이 있는 경우 통합을 편집하여 문제를 해결합니다. 통합의 모든 단계가 올바르면 통합을 게시합니다.

    빌드 단계 직후 Fuse Online에서 통합을 중지 상태로 되돌리는 경우 배포를 삭제하고 구성이 필요하지 않은지 확인한 후 통합을 다시 게시하십시오.

    로그에 표시되는 경우 다음 메시지는 무시해도 됩니다.

    Error performing GET request to https://syndesis-my-fuse-online-project.my-cluster-url/api/v1/metrics/integrations
    Copy to Clipboard Toggle word wrap

4.6. Fuse Online 업그레이드

경우에 따라 패치 및 보안 수정 사항을 통합하는 새로운 애플리케이션 이미지가 Fuse Online용으로 릴리스됩니다. Red Hat의 에라타 업데이트 채널을 통해 이러한 업데이트에 대한 알림을 받습니다. 그런 다음 Fuse Online 이미지를 업그레이드할 수 있습니다.

OCP 4.x의 경우 OperatorHub를 사용하여 Fuse Online Online 업그레이드 단계에 따라 Fuse Online 7.8에서 7.9로 업그레이드합니다. 설치 스크립트 또는 OperatorHub를 사용하여 Fuse Online 7.8을 설치하는 방법에 관계없이 OpenShift OperatorHub를 사용하여 Fuse Online 7.8에서 7.9로 업그레이드하십시오.

OCP 3.11의 경우 설치 스크립트를 사용하여 설치 스크립트를 사용하여 설치 스크립트를 사용하여 Fuse Online 7.8에서 7.9로 업그레이드합니다.

Fuse Online 7.9로 업그레이드하려면 기존 통합을 변경해야 하는지 확인해야 합니다. 변경 사항이 필요하지 않은 경우에도 Fuse Online을 업그레이드할 때 실행 중인 통합을 다시 게시해야 합니다.

4.6.1. OperatorHub를 사용하여 Fuse Online 업그레이드 (OCP 4.x)

설치 스크립트 또는 OperatorHub를 사용하여 Fuse Online 7.8을 설치하는 방법과 관계없이 OpenShift OperatorHub를 사용하여 Fuse Online 7.8에서 7.9로 업그레이드하십시오.

Fuse Online 7.9로 업그레이드하는 절차는 기존 Fuse Online을 설치하는 방법에 따라 다릅니다.

  • OperatorHub를 사용하여 Fuse Online 7.8 또는 이전 7.9 버전을 설치했습니다.
  • 설치 스크립트를 사용하여 Fuse Online 7.8을 설치했습니다.

참고: Fuse Online 7.9에는 OCP(OpenShift Container Platform) 4.6 이상이 필요합니다. OCP 4.5 이하를 사용하는 경우 Fuse Online 7.9로 업그레이드하려면 OCP 4.6 이상으로 업그레이드해야 합니다.

이전 Fuse Online OperatorHub 설치에서 업그레이드

Fuse Online 7.8 또는 이전 7.9 버전의 업그레이드 프로세스는 Fuse Online을 설치할 때 선택한 승인 전략에 따라 다릅니다.

  • 자동 업데이트의 경우 새 버전의 Fuse Online Operator를 사용할 수 있는 경우 OpenShift Operator Lifecycle Manager(OLM)는 개입 없이 Fuse Online의 실행 중인 인스턴스를 자동으로 업그레이드합니다.
  • 수동 업데이트의 경우 최신 버전의 Operator를 사용할 수 있으면 OLM에서 업데이트 요청을 생성합니다. 그런 다음 클러스터 관리자는 OpenShift 문서의 보류 중인 Operator 업그레이드 섹션에 설명된 대로 Fuse Online Operator 가 새 버전으로 업데이트되도록 해당 업데이트 요청을 수동으로 승인해야 합니다.

인프라 업그레이드 중 및 이후에 기존 통합은 이전 버전의 Fuse Online 라이브러리 및 종속 항목을 계속 실행합니다.

업데이트된 Fuse Online 버전과 함께 기존 통합을 실행하려면 통합을 다시 게시해야 합니다.

Fuse Online 7.8 설치 스크립트 설치에서 업그레이드

설치 스크립트를 사용하여 Fuse Online 7.8을 설치한 경우 이 절차의 단계에 따라 OperatorHub를 사용하여 Fuse Online 7.9로 업그레이드하십시오.

사전 요구 사항

  • 기존 Fuse Online 7.8 설치 스크립트 설치에는 operator, operands 및 syndesis 사용자 정의 리소스가 포함됩니다.

절차

Fuse Online Operator를 사용하여 업그레이드하려면 다음을 수행합니다.

  1. OpenShift 웹 콘솔에서 Operator > OperatorHub 를 클릭합니다.
  2. Fuse Online 7.9 Operator를 선택한 다음 설치를 클릭합니다.
  3. Fuse Online 7.8 설치가 포함된 네임스페이스를 선택한 다음 설치를 클릭합니다.
  4. 업그레이드 후 기존 통합을 모두 다시 게시해야 합니다.

4.6.2. 설치 스크립트(OCP 3.11)를 사용하여 Fuse Online 업그레이드

OCP 4.x의 경우 설치 스크립트를 사용하여 Fuse Online 7.8을 설치한 경우 OperatorHub를 사용하여 OperatorHub Online에 설명된 대로 OperatorHub를 사용하여 버전 7.9로 업그레이드 합니다.

OCP 3.11의 경우 다음 업그레이드에 대한 설치 스크립트 절차는 동일합니다.

  • Fuse Online 7.8에서 Fuse Online 7.9로
  • Fuse Online 7.9 버전에서 최신 Fuse Online 7.9 버전으로 사용

사전 요구 사항

  • OCP 3.11 사이트에 Fuse Online 버전을 설치 및 실행 중이거나 OCP 3.11에서 Fuse Online 버전을 설치 및 실행 중이며 새로운 애플리케이션 이미지로 업그레이드하려고 합니다.

    이전 버전의 경우:

    • OCP에서 버전 7.7 of Fuse Online을 실행 중인 경우 7.8로 업그레이드한 다음 7.9로 업그레이드할 수 있습니다.
    • OCP에서 Fuse Online 버전 7.6을 실행 중인 경우 7.7로 업그레이드해야 하며 7.8로 업그레이드할 수 있습니다.
    • OCP에서 Fuse Online 버전 7.5를 실행 중인 경우 7.6로 업그레이드한 다음 7.7로 업그레이드할 수 있습니다.
    • OCP에서 7.4 of Fuse Online 버전을 실행 중인 경우 7.5로 업그레이드해야 하며 7.6로 업그레이드할 수 있습니다.
    • OCP에서 Fuse Online 버전 7.3을 실행 중인 경우 7.4로 업그레이드해야 하며 7.5로 업그레이드할 수 있습니다.
    • OCP에서 7.2 버전의 Fuse Online을 실행 중인 경우 7.3 버전으로 업그레이드해야 합니다.
    • OCP에서 7.1 버전의 Fuse Online을 실행 중인 경우 7.2로 업그레이드해야 합니다.
  • oc 클라이언트 도구를 설치하고 Fuse Online이 설치된 OCP 클러스터에 연결되어 있습니다.
  • 이 절차의 처음 두 단계에 필요한 클러스터 관리 권한이 있습니다.

절차

  1. Docker 제한 오류가 발생하지 않도록 클러스터 관리자는 업그레이드하기 전에 Access Docker 이미지에 설명된 대로 Docker 이미지에 대한 액세스를 설정합니다.
  2. 클러스터 관리자는 Fuse Online 패키지를 다운로드하고 사용자가 특정 프로젝트에서 Fuse Online을 업그레이드할 수 있는 권한을 부여합니다.

    1. 다음 위치에서 Fuse Online 설치 스크립트가 포함된 패키지를 다운로드합니다.

      https://github.com/syndesisio/fuse-online-install/releases/tag/1.12

      파일 시스템의 편리한 위치에 다운로드한 아카이브의 압축을 풉니다. fuse-online-install-1.12 디렉터리에는 Fuse Online 업그레이드를 위한 스크립트 및 지원 파일이 포함되어 있습니다.

    2. 추출된 아카이브가 포함된 디렉터리로 변경합니다. 예를 들면 다음과 같습니다.

      CD fuse-online-install-1.12

    3. 클러스터 관리 계정을 사용하여 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

      oc login -u admin -p admin

    4. Fuse Online을 업그레이드해야 하는 OpenShift 프로젝트로 변경합니다. 예를 들면 다음과 같습니다.

      oc project fuse-online-project

    5. Fuse Online 사용자 정의 리소스 정의를 업데이트합니다.

      bash install_ocp.sh --setup

    6. 이 프로젝트에서만 Fuse Online 업그레이드 권한을 부여합니다. 예를 들어 다음 명령은 Fuse Online을 developer 사용자로 업그레이드할 수 있는 권한을 부여합니다. 클러스터 관리자가 이 명령을 실행한 후 developer 사용자는 이 프로젝트에서만 Fuse Online을 업그레이드할 수 있습니다(예: fuse-online-project ).

      bash install_ocp.sh --grant developer

  3. Fuse Online 업그레이드 권한이 부여된 사용자는 업그레이드를 수행합니다.

    1. OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

      oc login -u developer

    2. Fuse Online을 업그레이드하려는 프로젝트로 전환합니다. 예를 들면 다음과 같습니다.

      oc project fuse-online-project

    3. 업그레이드할 버전을 확인하려면 다음과 같이 --version 옵션을 사용하여 업데이트 스크립트를 실행합니다.

      bash update_ocp.sh --version

    4. 다음과 같이 업데이트 스크립트를 호출합니다.

      bash update_ocp.sh

      스크립트에 대해 자세히 알아보려면 bash update_ocp.sh --help 를 호출합니다.

      인프라 업그레이드 중 및 이후에 기존 통합은 이전 버전의 Fuse Online 라이브러리 및 종속 항목을 계속 실행합니다.

  4. 다음과 같이 실행 중인 Fuse Online 통합 업그레이드:

    1. Fuse Online에서 업그레이드할 통합을 선택합니다.
    2. 편집을 선택합니다.
    3. 게시 를 선택하여 통합을 다시 게시합니다.

    통합을 다시 게시하면 최신 Fuse Online 종속성을 사용하는 다시 빌드가 수행됩니다.

4.6.3. Fuse Online 통합 업그레이드

Fuse Online 7.9로 업그레이드할 때 기존 통합을 변경해야 하는지 확인해야 합니다.

Camel 마이그레이션 고려 사항에 설명된 Apache Camel 업데이트를 검토합니다.

통합에는 변경 사항이 필요하지 않은 경우에도 인프라 업그레이드 중 및 이후에 기존 통합은 이전 버전의 Fuse Online 라이브러리 및 종속 항목과 함께 계속 실행되므로 실행 중인 통합을 다시 게시해야 합니다. 업데이트된 버전으로 실행하려면 해당 버전을 다시 게시해야 합니다.

절차

Fuse Online 환경에서 통합을 다시 게시하려면 다음을 수행합니다.

  1. Fuse Online 왼쪽 탐색 패널에서 통합을 클릭합니다.
  2. 각 통합의 경우:

    1. 통합 항목 오른쪽에 있는 three vertical dots 을 클릭하고 편집을 선택합니다.
    2. Fuse Online에서 편집하기 위한 통합이 표시되면 오른쪽 상단에 게시 를 클릭합니다.

게시하면 최신 Fuse Online 종속성을 사용하는 다시 빌드가 수행됩니다.

참고

Fuse Online 사용자 인터페이스에서는 통합 요소에 업데이트해야 하는 최신 종속성이 있는 경우 경고가 표시됩니다.

4.7. OCP 프로젝트에서 Fuse Online 설치 제거

프로젝트를 삭제하지 않고 OCP 프로젝트에서 Fuse Online을 제거할 수 있으며 해당 프로젝트의 다른 항목은 삭제할 수 있습니다. Fuse Online을 제거한 후 실행 중인 통합은 계속 실행되지만 더 이상 편집하거나 다시 게시할 수 없습니다.

사전 요구 사항

  • Fuse Online이 설치된 OCP 프로젝트가 있습니다.
  • Fuse Online이 설치된 다른 OpenShift 프로젝트에서 사용할 모든 통합을 내보냈습니다. 필요한 경우 통합 내보내기 를 참조하십시오.

절차

  1. Fuse Online을 설치할 수 있는 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u developer -p developer

  2. 제거하려는 Fuse Online 환경을 실행 중인 OpenShift 프로젝트로 전환합니다. 예를 들면 다음과 같습니다.

    oc project my-fuse-online-project

  3. Fuse Online 인프라 삭제:

    oc delete syndesis 앱

  4. syndesis-operator DeploymentConfigImageStream 리소스를 삭제합니다.

    oc delete deployment/syndesis-operator
    oc delete is/syndesis-operator

4.8. Fuse Online이 포함된 OCP 프로젝트 삭제

Fuse Online이 설치된 OpenShift 프로젝트를 삭제하면 프로젝트의 모든 항목이 삭제됩니다. 여기에는 실행된 모든 통합뿐만 아니라 정의된 모든 통합이 포함됩니다.

사전 요구 사항

  • Fuse Online이 설치된 OCP 프로젝트가 있습니다.
  • Fuse Online이 설치된 다른 OpenShift 프로젝트에서 사용할 모든 통합을 내보냈습니다. 필요한 경우 통합 내보내기를 참조하십시오.

절차

oc delete project 명령을 호출합니다. 예를 들어 이름이 fuse-online-project 인 OpenShift 프로젝트를 삭제하려면 다음 명령을 입력합니다.

oc delete project fuse-online-project

5장. Fuse Online 공용 REST API 엔드포인트를 호출하는 방법

OCP에서 Fuse Online을 실행하는 경우 각 Fuse Online 환경에서 퍼블릭 REST API 엔드포인트를 노출할 수 있습니다. CI/CD(외부 지속적 통합/지속적 제공) 툴은 이러한 엔드포인트를 호출하여 Fuse Online 환경에 있는 리소스에서 작동할 수 있습니다.

각 Fuse Online 환경에서 OpenShift 관리자는 외부 툴에서 해당 엔드포인트를 호출하기 전에 Fuse Online 공용 REST API 엔드포인트를 노출해야 합니다. API 엔드포인트를 호출하는 명령은 엔드포인트가 작동하는 Fuse Online 환경의 URL, 시크릿 토큰 및 권한 부여 토큰을 지정합니다.

자세한 내용은 다음 항목을 참조하십시오.

5.1. 외부 툴에서 사용할 Fuse Online 공용 REST API 노출

사이트에서 Fuse Online을 실행하는 경우 외부 툴을 사용하여 Fuse Online 환경에서 다른 Fuse Online 환경으로 Fuse Online 통합을 복사할 수 있습니다. 외부 CI/CD 툴은 Jenkins 작업, Ansible 플레이북, cron- 기반 쉘 스크립트 또는 기타 작업일 수 있습니다. 예를 들어 Ansible Playbook은 Fuse Online 개발 환경에서 통합을 내보내 Fuse Online 테스트 환경으로 가져올 수 있습니다.

이 기능을 사용하려면 각 Fuse Online 환경에 대해 Fuse Online 공용 REST API 엔드포인트를 공개해야 합니다. 즉, Fuse Online이 설치된 각 OpenShift 프로젝트에서 이 절차를 반복해야 합니다.

사전 요구 사항

  • Fuse Online이 설치된 OCP 프로젝트가 있습니다.
  • oc 클라이언트 툴이 설치되고 Fuse Online이 설치된 OCP 클러스터에 연결됩니다.
  • 외부 CI/CD 툴을 사용하며 하나의 Fuse Online 환경에서 다른 Fuse Online 환경으로 마크된 통합을 복사하려고 합니다.
  • syndesis-operator grant 명령을 실행하려면 클러스터 관리 권한이 필요합니다. 클러스터 관리 권한이 없지만 OpenShift 프로젝트에 대한 관리 권한이 있는 사용자는 다른 명령을 실행할 수 있습니다.

절차

  1. 클러스터 관리 권한이 있는 계정으로 OpenShift에 로그인합니다. 예를 들면 다음과 같습니다.

    oc login -u admin -p admin

    이 절차에서는 syndesis-operator grant 명령에만 클러스터 관리 권한이 필요하지만 클러스터 관리자가 모든 단계를 수행하는 것으로 가정합니다.

  2. Fuse Online이 실행 중인 OpenShift 프로젝트로 전환합니다. 이 프로젝트에서만 공용 API를 노출하고 있습니다. 예를 들면 다음과 같습니다.

    oc project fuse-online-north

  3. syndesis-public-oauthproxy 서비스 계정에 역할을 부여합니다. OpenShift 프로젝트에서는 이 서비스 계정을 사용하여 OAuth 프록시 서비스를 실행합니다. 클러스터 관리 권한이 있는 사용자 계정을 지정합니다. 예를 들면 다음과 같습니다.

    syndesis-operator grant --user developer

    이 명령은 클러스터 역할 및 클러스터 역할 바인딩을 syndesis-public-oauthproxy 서비스 계정에 생성하고 할당합니다. ClusterRoleBinding 은 이 예에서 fuse-online-north 인 API를 노출하는 OpenShift 프로젝트의 이름을 지정합니다.

    • ClusterRole:syndesis-auth-delegator
    • ClusterRoleBinding:syndesis-fuse-online-north-auth-delegator
  4. 클라이언트 서비스 계정을 생성하고 Fuse Online 공용 API에 액세스할 수 있는 권한을 부여합니다.

    1. 원하는 이름으로 OpenShift 서비스 계정을 생성합니다. 예를 들어 다음 명령은 cicd-client 서비스 계정을 생성합니다.

      oc create serviceaccount cicd-client

      공용 API 엔드포인트를 호출하는 명령은 이 계정을 사용하여 공용 API에 액세스합니다. 또한 API 엔드포인트에 대한 호출에 지정해야 하는 시크릿 토큰을 얻으려면 이 서비스 계정이 필요합니다. 이는 REST API 엔드포인트를 호출하기 위한 시크릿 토큰을 가져오는 데 사용됩니다.

    2. 클라이언트 서비스 계정에 Fuse Online 공용 API에 액세스할 수 있는 권한을 부여합니다. fuse-online-north 가 Fuse Online이 설치된 OpenShift 프로젝트의 이름이며 cicd-client 가 API 서비스 액세스를 위해 생성한 서비스 계정의 이름이면 다음 명령을 호출합니다.

      oc policy add-role-to-user edit system:serviceaccount:fuse-online-north:cicd-client`
      Copy to Clipboard Toggle word wrap
  5. syndesis 사용자 정의 리소스를 편집합니다.

    1. 일반적으로 편집기에서 리소스를 여는 다음 명령을 호출합니다.

      oc edit syndesis

    2. 공용 API를 사용하도록 리소스를 편집하고 routeHostname 의 설정으로 엔드포인트를 호출하는 Fuse Online 환경의 공용 주소를 지정합니다. ( Fuse Online을 설치하는 데 사용된 default-cr.yml 파일을 편집하고 공용 API를 활성화하고 엔드포인트의 경로 호스트 이름을 지정한 경우 리소스를 편집할 필요가 없습니다.)

      클러스터 설정에 따라 지정해야 하는 공용 주소가 결정됩니다. 자세한 내용은 경로에 대한 OpenShift 설명서를 참조하십시오. 다음 예에서 경로 호스트 이름은 Minishift 클러스터에 유효합니다.

      spec:
        addons:
          publicApi:
            enabled: true
            routeHostname: public-syndesis.192.168.64.63.nip.io
      Copy to Clipboard Toggle word wrap
    3. 리소스를 저장(또는 닫기)합니다.

      syndesis 사용자 정의 리소스 트리거를 저장하면 Fuse Online 설치를 담당하는 syndesis-operator 가 공용 API OAuth 프록시 서비스를 배포합니다.

      syndesis 사용자 정의 리소스를 편집할 필요가 없는 경우 공용 API OAuth 프록시 서비스가 이미 배포되었습니다. 이는 publicApi 가 활성화되고 Fuse Online을 설치하는 데 사용된 default-cr.yml 파일에 지정된 경로가 있기 때문일 수 있습니다.

결과

OpenShift에서 다음을 확인할 수 있습니다.

  • syndesis-public-oauthproxy 배포 구성을 위한 Pod입니다.
  • syndesis-public-oauthproxy 서비스입니다.
  • syndesis-public-api 경로입니다.

이 절차를 수행한 OpenShift 프로젝트에서 외부 CI/CD 툴에서는 Fuse Online 공용 REST API 엔드포인트를 사용하여 Fuse Online 통합을 내보내거나 가져올 수 있습니다.

다음 단계

5.2. Fuse Online 공용 REST API 엔드 포인트의 기본 URL 설명

Fuse Online 공용 REST API 엔드포인트의 기본 URL은 다음과 같습니다.

https://public-syndesis.192.168.64.42.nip.io/api/v1/public

기본 URL의 첫 번째 부분은 Fuse Online 환경에 따라 다릅니다. 공용 REST API 엔드포인트에 액세스할 수 있는 Fuse Online 공용 OAuth 프록시를 실행하는 OpenShift 애플리케이션을 생성하면 Fuse Online 환경의 공용 주소를 지정합니다. 이 주소는 해당 Fuse Online 환경에서 작동하는 엔드포인트를 호출하는 기본 URL의 첫 번째 부분입니다. 예를 들면 다음과 같습니다.

https://public-syndesis.192.168.64.42.nip.io

기본 URL의 두 번째 부분은 모든 Fuse Online 환경에서 동일합니다.

/api/v1/public

Fuse Online 공용 REST API는 세 가지 리소스에서 작동하는 끝점을 제공합니다.

  • /integrations 는 기본 URL에서 식별되는 Fuse Online 환경에 있는 통합입니다.
  • /connections 는 기본 URL에서 식별되는 Fuse Online 환경에 있는 연결입니다.
  • /environments 는 기본 URL에서 식별되는 Fuse Online 환경에 있는 환경 레이블 세트입니다.

5.3. 공용 REST API 끝점 호출을 위한 시크릿 토큰 가져오기

Fuse Online 공용 REST API 엔드포인트를 호출하는 명령은 시크릿 토큰을 지정해야 합니다. 이 토큰은 지정된 Fuse Online 환경에서 Fuse Online 공용 REST API를 노출할 때 생성한 서비스 계정을 위한 토큰입니다.

사전 요구 사항

  • OCP 온-사이트에서 Fuse Online을 실행하고 있습니다.
  • 엔드포인트를 호출하려는 Fuse Online 환경에서 제공하는 공용 REST API를 노출했습니다.

절차

  1. 이 Fuse Online 환경의 공용 REST API를 노출할 때 생성한 서비스 계정에 대한 시크릿 토큰의 이름을 가져옵니다. 예를 들어 cicd-client 가 서비스 계정의 이름인 경우 다음 명령을 호출합니다.

    oc describe serviceaccount cicd-client

    그러면 다음 두 토큰의 이름을 포함하여 cicd-client 서비스 계정에 대한 정보 목록이 표시됩니다.

    Tokens:      cicd-client-token-gxb25
                 cicd-client-token-gxdnv
    Copy to Clipboard Toggle word wrap
  2. 토큰 중 하나의 콘텐츠를 표시합니다. 예를 들면 다음과 같습니다.

    oc describe secret cicd-client-token-gxb25

    그러면 토큰을 표시하는 데이터 섹션이 포함된 정보 목록이 표시되고 그 뒤에 긴 임의 문자가 표시됩니다. 이는 서비스 계정의 두 가지 시크릿 토큰 중 하나입니다.

  3. 시크릿 토큰을 복사하여 파일에 붙여넣어 저장합니다.

결과

curl 명령에서 시크릿 토큰의 사양은 다음과 같습니다.

-H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJzeW5kZXNpcyIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJzeW5kZXNpcy1jZC1jbGllbnQtdG9rZW4tMnZjNmwiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC5uYW1lIjoic3luZGVzaXMtY2QtY2xpZW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQudWlkIjoiNjUxMjYxNGMtMmYwMS0xMWU5LTk3OWEtNDI1YWNlMzY3MTcyIiwic3ViIjoic3lzdGVtOnNlcnZpY2VhY2NvdW50OnN5bmRlc2lzOnN5bmRlc2lzLWNkLWNsaWVudCJ9.uKsri0JSKJDbgHoQwAhBJSNuWKwJgjegf2QlrCkhxVssSK1zIMZQaF9P5a4R7ZcWRnrZ_345UTqxYVeRlfHWVH0PqBkD-n7PAS9dcKJIFdS1jUHOmL1FTGgc3YW-bz1SlWT93tvK1EhorZ4_-EBfXhSAP4Uumi5qAg3_QUTMDstq233NSwBKYtFOw3Pp1ys3p3y0hcaiLMimeCH60vR4iWvptqqzc5QDigHiPySZNWxs_5awZlwdoIDvR-nSj690aC-49UKFgyEEdzdFU4bI2W4hOyDyhN9fVaIAZQKeJUrJBU-lnFTHI_NAd2OwzOEBpWZuj31Za5w9fU4kf4UDGA'
Copy to Clipboard Toggle word wrap

다음 단계

저장된 파일에서 토큰을 지정된 Fuse Online 환경에서 공용 REST API 엔드포인트를 호출하는 명령으로 복사합니다.

5.4. 통합 ID 찾기 방법

특정 통합에서만 작동하는 Fuse Online 공용 REST API 엔드포인트를 호출하는 명령에서 끝점이 작동하도록 통합 ID를 지정해야 합니다. 다음 중 하나를 지정합니다.

  • 통합의 이름

    Fuse Online 콘솔에 표시되는 대로 정확하게 지정해야 합니다(예: timer-to-log ). 통합 이름에 공백 또는 특수 문자가 있는 경우 HTML 이스케이프 문자를 지정해야 합니다.

  • 내부 통합 ID

    통합 요약을 보면 이 ID는 Fuse Online 콘솔 URL에 있습니다. 통합 요약을 보려면 왼쪽 탐색 패널에서 통합을 클릭합니다. 통합 목록에서 필요한 ID가 있는 통합 항목을 클릭합니다.

    브라우저에 통합 요약이 표시되면 URL 끝에 다음과 같은 내용이 표시됩니다. /integrations/i-Lauq5ShznJ4LcuWwiwcz. 이 통합 ID는 i-Lauq5ShznJ4LcuWwiwcz 입니다.

5.5. Fuse Online 공용 엔드포인트를 호출할 curl 명령을 지정하는 형식

Fuse Online 공용 REST API 엔드포인트를 호출하는 curl 명령의 형식은 다음과 같습니다.

curl [options] \
     -H "Content-Type: <media-type>" \
     -H "SYNDESIS-XSRF-TOKEN: awesome" \
     -H `Authorization: Bearer <token>` \
     <base-url><endpoint> \
     [--request <HTTP-method>] \
     [-d <data>] \
     [-o <filename>]
Copy to Clipboard Toggle word wrap
Expand
표 5.1. curl 명령 옵션
옵션설명

[options]

선택한 curl 옵션을 지정합니다.

<media-type>

내보내기 및 가져오기 끝점의 경우 multipart/form-data 를 지정합니다. 기타 모든 끝점의 경우 application/json 을 지정합니다.

<token>

공용 REST API를 노출할 때 생성한 OpenShift 서비스 계정에 대한 시크릿 토큰을 지정합니다.

<base-url>

엔드포인트가 작동하도록 하는 통합, 연결 또는 환경 레이블이 있는 Fuse Online 환경의 기본 URL을 지정합니다.

<endpoint>

호출할 끝점을 지정합니다.

[--request <HTTP-method>]

선택적으로 HTTP 메서드를 지정합니다(예: --request POST ).

[-d <data>]

호출 중인 끝점에 따라 끝점에 필요한 인수를 지정합니다. 예를 들어 테스트하도록 통합의 환경 레이블을 변경하려면 -d ' test '를 지정합니다.

[-o <filename>]

선택적으로 출력이 포함된 파일의 이름을 지정해야 하는 경우 파일 이름으로 -o curl 옵션을 지정합니다(예: -o export.zip ).

다음 curl 명령은 지정한 하나 이상의 환경에 대한 통합을 표시하는 Fuse Online 공용 API 엔드포인트를 호출합니다.

curl -v -k -L -H "Content-Type: application/json" -H "SYNDESIS-XSRF-TOKEN: awesome" -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJzeW5kZXNpcyIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJzeW5kZXNpcy1jZC1jbGllbnQtdG9rZW4tMnZjNmwiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC5uYW1lIjoic3luZGVzaXMtY2QtY2xpZW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQudWlkIjoiNjUxMjYxNGMtMmYwMS0xMWU5LTk3OWEtNDI1YWNlMzY3MTcyIiwic3ViIjoic3lzdGVtOnNlcnZpY2VhY2NvdW50OnN5bmRlc2lzOnN5bmRlc2lzLWNkLWNsaWVudCJ9.uKsri0JSKJDbgHoQwAhBJSNuWKwJgjegf2QlrCkhxVssSK1zIMZQaF9P5a4R7ZcWRnrZ_345UTqxYVeRlfHWVH0PqBkD-n7PAS9dcKJIFdS1jUHOmL1FTGgc3YW-bz1SlWT93tvK1EhorZ4_-EBfXhSAP4Uumi5qAg3_QUTMDstq233NSwBKYtFOw3Pp1ys3p3y0hcaiLMimeCH60vR4iWvptqqzc5QDigHiPySZNWxs_5awZlwdoIDvR-nSj690aC-49UKFgyEEdzdFU4bI2W4hOyDyhN9fVaIAZQKeJUrJBU-lnFTHI_NAd2OwzOEBpWZuj31Za5w9fU4kf4UDGA'
https://public-syndesis.192.168.64.42.nip.io/api/v1/public/integrations/timer-to-log/tags -d '["test","staging"]' --request PUT
Copy to Clipboard Toggle word wrap

샘플 curl 명령에서 다음을 수행합니다.

  • 명령 끝에 있는 URL은 호출 중인 엔드포인트가 있는 Fuse Online 환경을 식별합니다.
  • timer-to-log 는 지정된 환경에 대한 timer-to-log 통합을 표시 중임을 나타냅니다.
  • 테스트스테이징 의 사양은 해당 환경의 타이머에서 로그 간 통합을 표시합니다.

OCP 사이트에서 Fuse Online을 실행하는 경우 특정 통합에서 작업하려는 CI/CD(Continuous Integration/Continuous Deployment) 파이프라인이 있을 수 있습니다. 이를 구현하려면 다음 작업을 완료해야 합니다.

  • Fuse Online 콘솔에서 CI/CD 파이프라인에 대한 통합을 표시합니다.
  • OpenShift에서 Fuse Online 공용 API를 노출 합니다.
  • 외부 툴을 사용하여 통합을 내보내고 가져오는 Fuse Online 공용 API 엔드포인트를 호출합니다.

자세한 내용은 다음 항목을 참조하십시오.

6.1. CI/CD 통합 정보

사이트에서 OCP Online을 실행하는 경우 파이프라인 통합을 식별하기 위해 지정한 CI/CD 환경에 대한 통합을 표시합니다. 이렇게 하면 타임스탬프가 통합에 적용됩니다. 백엔드 CI/CD Fuse Online 공용 API는 레이블과 타임스탬프를 사용하여 파이프라인이 작동하는 통합을 찾기 위해 통합을 필터링합니다.

예를 들어 Fuse Online에서는 test1 환경에 대한 통합을 표시한다고 가정합니다. 그런 다음 Fuse Online 공용 API 내보내기 엔드포인트를 호출하여 test1 환경 레이블이 있는 통합을 내보낼 수 있습니다. 엔드포인트 패키지 test1 은 내보내기 파일에 통합되고 해당 파일을 반환합니다. test1 통합을 Fuse Online 테스트 환경으로 복사하려면 공개 API 가져오기 엔드포인트를 호출하고 내보낸 test1 통합 파일이 포함된 파일을 제공합니다.

이제 이전에 test1 환경에 표시된 통합을 반복적으로 업데이트하고 게시한다고 가정합니다. 이제 통합의 새 버전이 있으며 업데이트된 버전을 test1 환경으로 내보내려고 합니다. 이미 test1 환경에 표시된 경우에도 통합을 다시 표시해야 합니다. 통합을 다시 표시하면 test1 환경 레이블의 타임스탬프가 업데이트됩니다. 이는 통합이 업데이트되었으며 내보낼 준비가 되었음을 외부 툴에 나타냅니다.

즉, 통합에 이미 할당된 환경 레이블의 타임스탬프를 새로 고치려면 CI/CD 에 대한 통합 표시를 시작하는 절차를 시작합니다. CI/CD 대화 상자에서 원하는 환경의 확인란이 이미 선택되어 있으므로 저장을 클릭합니다.

6.2. CI/CD 통합 표시

사이트에서 OCP Online을 실행하는 경우 파이프라인 통합을 식별하기 위해 지정한 CI/CD 환경에 대한 통합을 표시합니다. 이렇게 하면 통합에 레이블이 적용됩니다.

사전 요구 사항

Fuse Online이 설치된 OCP 프로젝트가 있습니다.

절차

  1. 왼쪽의 Fuse Online 탐색 패널에서 통합을 클릭합니다.
  2. 통합 목록에서 표시할 통합 항목 오른쪽에 있는 More Options 를 클릭하여 팝업 메뉴를 표시하고 CI/CD 관리를 클릭합니다.
  3. 표시되는 대화 상자에서 다음 중 하나 이상을 수행합니다.

    • 이 통합을 표시할 환경이 이미 표시되면 해당 환경 왼쪽에 있는 확인란을 선택합니다.
    • 이 통합을 표시할 환경이 이미 선택되어 있으면 선택한 상태로 둡니다.
    • 환경의 레이블을 생성해야 하는 경우 CI/CD 관리를 클릭하면 새 환경 레이블을 생성하기 위한 대화 상자가 표시됩니다. 필요한 레이블을 생성한 다음 이 절차로 돌아가 통합을 표시합니다.

    Fuse Online은 선택한 환경 레이블을 통합에 적용합니다. 통합에 원하는 수의 환경 레이블을 적용할 수 있습니다.

  4. 저장을 클릭합니다.

결과

Fuse Online은 선택한 환경의 릴리스 통합에 레이블을 지정합니다. 백엔드 API는 통합을 필터링하여 (예: test1 레이블)가 있는 통합을 찾을 수 있습니다.

다음 단계

파이프라인이 특정 환경에 표시된 통합 작업을 수행하기 전에 Fuse Online 공용 API 끝점을 공개해야 합니다. 외부 툴에서 사용할 수 있는 Fuse Online 공용 REST API 사용을 참조하십시오.

6.3. CI/CD의 환경 레이블 관리

Fuse Online 콘솔에서 CI/CD 환경 레이블을 생성, 변경 또는 제거할 수 있습니다. CI/CD 환경 레이블은 통합에 적용하여 CI/CD 파이프라인에 대해 식별할 수 있는 태그입니다.

사전 요구 사항

  • Fuse Online은 OCP 현장에서 실행되고 있습니다.
  • 외부 툴은 Fuse Online 환경 레이블을 사용하여 CI/CD 파이프라인의 통합을 식별합니다.

절차

  1. Fuse Online의 왼쪽 탐색 패널에서 통합을 클릭합니다.
  2. 오른쪽 상단에서 CI/CD 관리를 클릭합니다.
  3. CI/CD 관리 페이지에서 다음을 수행합니다.

    • CI/CD 환경 레이블을 생성하려면 다음을 수행합니다.

      1. 새 추가를 클릭합니다.
      2. 태그 이름 추가 대화 상자의 Tag Name 입력 필드에 새 환경 레이블의 이름을 입력합니다(예: test1 ).
      3. 저장을 클릭합니다. CI/CD 관리 페이지에는 방금 추가한 환경 레이블의 새 항목이 있습니다.
    • CI/CD 환경 레이블을 변경하려면 다음을 수행합니다.

      1. CI/CD 환경 레이블 목록에서 변경하려는 라벨의 항목에서 편집 을 클릭합니다.
      2. Edit Tag (태그 편집) 대화 상자에서 필요에 따라 이름을 변경합니다.
      3. 저장을 클릭하여 환경 레이블 목록에서 업데이트된 이름을 확인합니다. Fuse Online은 변경된 환경 레이블로 이미 표시된 모든 통합에 업데이트된 이름을 적용합니다.
    • CI/CD 환경 레이블을 삭제하려면 다음을 수행합니다.

      1. CI/CD 환경 레이블 목록에서 삭제하려는 라벨 항목의 제거를 클릭합니다.
      2. 확인 대화 상자에서 예를 클릭합니다. Fuse Online은 환경 레이블을 삭제하고 해당 레이블로 표시된 통합에서 삭제된 환경 레이블도 제거합니다.

다음 단계

새 환경 레이블과의 통합을 표시합니다. CI/CD에 대한 통합 표시를 참조하십시오.

6.4. Fuse Online 공용 API 내보내기 끝점 호출

외부 도구를 사용하여 Fuse Online 환경에서 다른 Fuse Online 환경으로 Fuse Online 통합을 복사하려면 먼저 다음 작업을 완료해야 합니다.

  • Fuse Online에서는 CI/CD 파이프라인을 위해 내보내려는 통합이 특정 환경에 맞게 표시되어야 합니다. CI/CD에 대한 통합 표시를 참조하십시오.

    이 요구 사항에는 예외가 있습니다. 하나의 내보내기 작업으로 Fuse Online 환경의 모든 통합을 내보내려는 경우 통합이 특정 환경에 대해 이미 표시되어 있는지 여부는 중요하지 않습니다.

  • Fuse Online 공용 API를 노출했습니다. 외부 툴은 Fuse Online 공용 API 끝점 사용을 참조하십시오.

특정 환경의 통합 내보내기를 위한 끝점

특정 환경에 대해 표시된 통합을 내보내기 위해 Fuse Online에서는 다음과 같은 GET 메서드 엔드포인트를 제공합니다.

/public​/integrations​/{env}​/export.zip

{env} 를 이미 생성한 CI/CD 환경 레이블로 교체합니다. 특정 환경에 대한 통합이 표시되면 Fuse Online에서 표시 시기를 나타내는 타임스탬프를 유지 관리합니다. 기본 동작은 엔드포인트가 표시된 이후 내보낸 경우에만 통합을 내보낼 수 있다는 것입니다. 예를 들어 test1 환경에 표시된 통합을 내보내려면 끝점은 다음과 같습니다.

/public/integrations/test1/export.zip

이 끝점은 test1 환경 레이블이 있고 다음 조건 중 하나를 충족하는 각 통합을 내보냅니다.

  • 마지막으로 내보낸 이후 test1 환경에 대한 통합이 표시되었습니다.
  • 통합이 test1 환경에 대해 표시되었으며 내보낸 적이 없습니다.

엔드포인트는 export.zip 파일에 통합을 패키지하고 해당 파일을 반환합니다.

통합이 마지막으로 내보낸 후 지정된 환경에 대해 표시된 통합이 없는 경우 끝점은 HTTP 204 응답을 반환하지 않음을 나타냅니다.

지정된 환경에 태그된 모든 통합을 내보내기 위한 끝점

지정한 환경 레이블로 태그된 Fuse Online 환경의 모든 통합을 내보내도록 내보내기 엔드포인트를 호출할 수 있습니다. 엔드포인트는 통합이 마지막으로 내보낸 이후 지정된 환경에 대해 표시되었는지 여부에 관계없이 통합을 내보냅니다. 이를 통해 다른 Fuse Online 환경에서 특정 태그가 있는 모든 통합을 쉽게 복제할 수 있습니다. 이렇게 하려면 다음을 수행합니다.

  • 환경 레이블이 이미 생성되어 있어야 합니다. CI/CD에 대한 통합 표시를 참조하십시오.
  • ignoreTimestamp=true 옵션을 내보내기 엔드포인트 호출에 추가합니다.

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

/public/integrations/test1/export.zip?ignoreTimestamp=true -o export.zip

모든 통합을 내보내기 위한 끝점

내보내기 엔드포인트를 호출하여 하나의 Fuse Online 환경에서 모든 통합을 내보낼 수 있습니다. 따라서 다른 Fuse Online 환경에서 모든 통합을 쉽게 복제할 수 있습니다. 이렇게 하려면 다음을 수행합니다.

  • 환경 레이블이 이미 생성되어 있어야 합니다. CI/CD에 대한 통합 표시를 참조하십시오.
  • all=true 옵션을 내보내기 엔드포인트 호출에 추가합니다.

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

/public/integrations/{env}/export.zip?all=true

{env} 를 CI/CD 환경 레이블로 교체합니다. 엔드포인트는 해당 환경에 아직 표시되지 않은 각 통합에 지정된 환경 레이블을 할당합니다.

all=true 옵션을 추가할 때 내보낸 통합을 export.zip 파일에 패키징하도록 명시적으로 지정해야 합니다. 예를 들면 다음과 같습니다.

/public/integrations/test1/export.zip?all=true -o export.zip

이 끝점 호출:

  • test1 환경에 대한 각 통합을 표시합니다.
  • export.zip 파일의 모든 통합을 반환합니다.

    -o export.zip 옵션을 지정하지 않으면 엔드포인트에서 이름이 export.zip?all=true 인 파일을 반환합니다.

내보내기 끝점에 필요한 사용자 정의 헤더

내보내기 끝점을 호출하는 명령은 다음과 같이 이러한 사용자 지정 헤더를 지정해야 합니다.

  • -h "Content-Type: multipart/form-data"
  • -h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

    Fuse Online 공용 API를 사용하려면 이 헤더가 요청을 인증해야 합니다.

  • -h 'Authorization: Bearer <token>'

    & lt;token >을 Fuse Online 공용 API를 노출하는 데 사용되는 OpenShift 서비스 계정을 생성할 때 파일에 복사한 시크릿 토큰으로 바꿉니다.

통합을 내보내는 샘플 curl 명령

다음은 통합을 내보내는 Fuse Online API 엔드포인트를 호출하는 curl 명령의 예입니다.

curl -v -k -L -H "Content-Type: multipart/form-data" -H "SYNDESIS-XSRF-TOKEN: awesome" -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJzeW5kZXNpcyIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJzeW5kZXNpcy1jZC1jbGllbnQtdG9rZW4tMnZjNmwiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC5uYW1lIjoic3luZGVzaXMtY2QtY2xpZW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQudWlkIjoiNjUxMjYxNGMtMmYwMS0xMWU5LTk3OWEtNDI1YWNlMzY3MTcyIiwic3ViIjoic3lzdGVtOnNlcnZpY2VhY2NvdW50OnN5bmRlc2lzOnN5bmRlc2lzLWNkLWNsaWVudCJ9.uKsri0JSKJDbgHoQwAhBJSNuWKwJgjegf2QlrCkhxVssSK1zIMZQaF9P5a4R7ZcWRnrZ_345UTqxYVeRlfHWVH0PqBkD-n7PAS9dcKJIFdS1jUHOmL1FTGgc3YW-bz1SlWT93tvK1EhorZ4_-EBfXhSAP4Uumi5qAg3_QUTMDstq233NSwBKYtFOw3Pp1ys3p3y0hcaiLMimeCH60vR4iWvptqqzc5QDigHiPySZNWxs_5awZlwdoIDvR-nSj690aC-49UKFgyEEdzdFU4bI2W4hOyDyhN9fVaIAZQKeJUrJBU-lnFTHI_NAd2OwzOEBpWZuj31Za5w9fU4kf4UDGA'
https://public-syndesis.192.168.64.42.nip.io/api/v1/public/integrations/dev1/export.zip
Copy to Clipboard Toggle word wrap

명령에서 다음을 수행합니다.

  • 명령 끝에 있는 URL은 통합을 내보낼 Fuse Online 환경을 식별합니다.
  • dev1 환경 레이블의 사양은 dev1 환경에 대해 표시된 통합을 내보내고 표시된 이후 아직 내보내지 않았음을 나타냅니다.

6.5. Fuse Online 공용 API 가져오기 끝점 호출

Fuse Online 공용 API 내보내기 엔드포인트를 호출하여 하나 이상의 통합을 가져올 수 있습니다. 내보낸 통합을 다른 Fuse Online 환경에 복사하려면 Fuse Online 공용 API 가져오기 엔드포인트를 호출합니다.

통합을 가져오기 위한 끝점

통합을 가져오기 위해 Fuse Online에서는 다음과 같은 POST 메서드 끝점을 제공합니다.

​/public​/integrations

다음 예에서 끝점은 export.zip 파일에 있는 통합을 가져와서 테스트 환경에 태그를 지정합니다.

/public/integrations -F data=@export.zip -F environment=testing --request POST

가져오기 끝점은 항상 제공된 통합을 가져옵니다. 즉, 마지막으로 가져온 이후 통합이 변경되지 않았더라도 끝점은 여전히 이를 가져옵니다.

가져오기 끝점에 필요한 사용자 정의 헤더

가져오기 끝점을 호출하는 명령은 다음과 같이 이러한 사용자 지정 헤더를 정확히 지정해야 합니다.

  • -h "Content-Type: multipart/form-data"
  • -h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

    Fuse Online 공용 API를 사용하려면 이 헤더가 요청을 인증해야 합니다.

  • -h 'Authorization: Bearer <token>'

    & lt;token >을 Fuse Online 공용 API를 노출하는 데 사용되는 OpenShift 서비스 계정을 생성할 때 파일에 복사한 시크릿 토큰으로 바꿉니다.

통합을 가져오는 샘플 curl 명령

다음은 통합을 가져오는 Fuse Online API 엔드포인트를 호출하는 curl 명령의 예입니다.

curl -v -k -L -H "Content-Type: multipart/form-data" -H "SYNDESIS-XSRF-TOKEN: awesome" -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJzeW5kZXNpcyIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJzeW5kZXNpcy1jZC1jbGllbnQtdG9rZW4tMnZjNmwiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC5uYW1lIjoic3luZGVzaXMtY2QtY2xpZW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQudWlkIjoiNjUxMjYxNGMtMmYwMS0xMWU5LTk3OWEtNDI1YWNlMzY3MTcyIiwic3ViIjoic3lzdGVtOnNlcnZpY2VhY2NvdW50OnN5bmRlc2lzOnN5bmRlc2lzLWNkLWNsaWVudCJ9.uKsri0JSKJDbgHoQwAhBJSNuWKwJgjegf2QlrCkhxVssSK1zIMZQaF9P5a4R7ZcWRnrZ_345UTqxYVeRlfHWVH0PqBkD-n7PAS9dcKJIFdS1jUHOmL1FTGgc3YW-bz1SlWT93tvK1EhorZ4_-EBfXhSAP4Uumi5qAg3_QUTMDstq233NSwBKYtFOw3Pp1ys3p3y0hcaiLMimeCH60vR4iWvptqqzc5QDigHiPySZNWxs_5awZlwdoIDvR-nSj690aC-49UKFgyEEdzdFU4bI2W4hOyDyhN9fVaIAZQKeJUrJBU-lnFTHI_NAd2OwzOEBpWZuj31Za5w9fU4kf4UDGA'
https://public-syndesis.192.168.64.45.nip.io/api/v1/public/integrations -F data=@export.zip -F environment=testing --request POST
Copy to Clipboard Toggle word wrap

이 명령에서는 다음을 수행합니다.

  • 명령 끝에 있는 URL은 통합을 가져올 Fuse Online 환경을 식별합니다.
  • export.zip 파일에는 가져올 통합이 포함되어 있습니다.
  • environment=testing 의 사양으로 인해 끝점에서 테스트 환경에 가져온 각 통합이 표시됩니다.
  • 이 명령은 multipart/form-data 를 생성합니다.

7장. Fuse Online 공용 REST API 엔드포인트 참조

이 섹션에서는 각 Fuse Online 공용 REST API 엔드포인트에 대한 참조 정보를 제공합니다. 자세한 내용은 Fuse Online 공용 REST API 엔드포인트를 호출하는 방법을 참조하십시오.

퍼블릭 REST API 엔드포인트를 정의하는 OpenAPI 문서는 Fuse Online 환경에서 https://<fuse-online-host>/api/v1/openapi.json 에서 사용할 수 있습니다. 그러나 이 문서에서는 tags 오브젝트를 public-api,extensions, integration-support 라는 세 가지 태그로 정의합니다. Fuse Online에 OpenShift 공용 OAuth 프록시 프로세스를 사용하는 경우에만 public-api 태그에 액세스할 수 있습니다. 나머지 두 태그는 무시해야 합니다.

7.1. 통합 상태를 가져오기 위한 끝점

이 끝점은 지정된 통합의 상태를 반환합니다. 상태는 Running,Stopped,Pending 또는 Error 입니다.

방법 및 끝점

GET

/public/integrations/{id}/state

Expand
표 7.1. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{id}

string

필수 path 매개변수입니다. 가져올 상태를 가진 통합의 이름 또는 내부 ID입니다. 통합 ID를 찾는 방법을 참조하십시오.

요청 예

다음 예에서 끝점은 timer-to-log 통합 상태를 반환합니다.

/public/integrations/timer-to-log/state

생성

application/json

응답 예

{"currentState":"Unpublished","state Details":{"id":"i-Lc0JLrsUFtBJfR_ylfEz:5","integrationId":"i-Lc0JLrsUFtBJfR_ylfEz","deploymentVersion":5,"detailedState":{"ING" "totalSteps":4},"namespace":"syndesis","podName":"i-timer-to-log-5-build","linkType":"LOGS"}}'

7.2. 통합 환경 레이블 목록을 가져오는 끝점

이 엔드포인트는 지정된 통합에 적용된 환경 레이블(태그)을 반환합니다.

방법 및 끝점

GET

/public/integrations/{id}/tags

Expand
표 7.2. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{id}

string

필수 path 매개변수입니다. 가져올 환경 레이블이 있는 통합의 이름 또는 내부 ID입니다. 통합 ID를 찾는 방법.

요청 예

다음 예에서 끝점은 timer-to-log 통합의 환경 레이블을 반환합니다.

/public/integrations/timer-to-log/tags

생성

application/json

응답 예

{"test":{"name":"releaseTag":"i-Lc5WI16UFtBJfilggz","lastTaggedAt1554887553159,"lastExportedAt1554887330152""lastImportedAt1554887330152,"lastImportedAt155488733015},"staging":15548047271},"staging": "staging":{"

7.3. 통합 표시 및 지정되지 않은 태그 유지를 위한 끝점

이 엔드포인트는 PATCH 메서드를 사용하여 지정된 환경에 대해 지정된 통합을 표시합니다. 통합이 지정된 환경에 이미 표시된 경우 끝점은 해당 환경 레이블의 타임 스탬프를 업데이트합니다. 이전에 새 요청에 지정되지 않은 환경에 대한 통합이 표시된 경우 끝점은 해당 태그를 그대로 두고 타임스탬프를 업데이트하지 않습니다.

PATCH 엔드포인트는 다른 기존 태그 없이 태그를 추가하므로 CI/CD 툴의 편의를 위한 방법입니다. 이는 지정된 환경의 통합을 표시하고 요청에 지정되지 않은 환경의 태그를 제거하는 PUT 엔드포인트와 다릅니다.

방법 및 끝점

PATCH

/public/integrations/{id}/tags

Expand
표 7.3. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{id}

string

필수 항목입니다. 지정된 환경에 표시할 통합의 이름 또는 내부 ID입니다. 통합 ID를 찾는 방법을 참조하십시오.

추가 매개변수

--request PATCH

 

PATCH 방법을 지정합니다.

-d [env{,…​}]

string

필수 항목입니다. 지정된 통합에 추가할 하나 이상의 쉼표로 구분된 환경 레이블을 지정합니다. 환경 레이블을 이미 생성해야 합니다. 끝점에서 레이블을 생성할 수 없습니다. CI/CD의 통합 표시를 참조하십시오.

요청 예

다음 예에서 엔드포인트는 test2test3 환경의 timer-to-log 통합을 표시합니다.

public/integrations/timer-to-log/tags --request PATCH -d '["test2","test3"]'

생성

application/json

응답 예

{"test2":{"name":"test2","releaseTag":"i-LcXydouUFcXydouUFcXydouUFtBJfR_ylgrz","lastT tag":1555365010746},"test3":{"name":"test3","releaseTag":"i-LcXydouUFtBJfilz","{cXydouUFt "lastImportedAt":15548880471},"staging":{"name":"staging","releaseTag":"i-Lc5WI16UFtBJfz"","lastTaggedAt":1554887553159}}

7.4. 통합 표시 및 지정되지 않은 태그 제거를 위한 끝점

이 엔드포인트는 PUT 메서드를 사용하여 지정된 환경에 대해 지정된 통합을 표시합니다. 이전에 새 요청에 지정되지 않은 환경에 대한 통합이 표시된 경우 끝점은 통합에서 해당 환경 레이블을 제거합니다.

지정되지 않은 환경 레이블을 제거하지 않고 통합을 표시하려면 PATCH 메서드 끝점 을 대신 호출합니다.

방법 및 끝점

PUT

/public/integrations/{id}/tags

Expand
표 7.4. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{id}

string

필수 항목입니다. 표시할 통합의 이름 또는 내부 ID입니다. 통합 ID를 찾는 방법을 참조하십시오.

추가 매개변수

--request PUT

 

PUT 메서드를 지정합니다.

-d [env{,…​}]

string

필수 항목입니다. 하나 이상의 쉼표로 구분된 환경 레이블을 지정합니다. 엔드포인트는 이러한 환경에 대해 지정된 통합을 표시합니다. 환경 레이블을 이미 생성해야 합니다. 끝점에서 레이블을 생성할 수 없습니다. CI/CD의 통합 표시를 참조하십시오.

요청 예

다음 예에서 엔드포인트는 test2test3 환경의 timer-to-log 통합을 표시합니다. 이전에 다른 환경에 대해 통합이 표시된 경우 엔드포인트는 통합에서 해당 태그를 제거합니다.

public/integrations/timer-to-log/tags --request PUT -d '["test2","test3"]'

생성

application/json

응답 예

{"test2":{"name":"releaseTag":"i-LcXyw7GUFtBJfR_ylgtz","lastTaggedAt1555365085713},"test3":{"name":"test3","releaseTag":"releaseTag":"i-LcXyw7GGUBJfR_ylgtz","lastTaggedAt1555365085713},"test3":{"name":"releaseTag":"i-LcXyw7GftBJftBJf_ylt>

7.5. 통합을 게시하기 위한 끝점

이 엔드포인트는 지정된 통합을 게시합니다. 통합이 이미 실행 중인 경우 엔드포인트에서 통합을 중지하고 다시 게시합니다.

방법 및 끝점

POST

/public/integrations/{id}/deployments

Expand
표 7.5. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{id}

string

필수 항목입니다. 게시하려는 통합의 이름 또는 내부 ID입니다. 통합 ID를 찾는 방법을 참조하십시오.

요청 예

다음 예에서 끝점은 timer-to-log 통합을 게시합니다.

/public/integrations/timer-to-log/deployments

생성

application/json

응답 예

이 예제에서is는 응답 중 일부의 누락을 나타냅니다.

{"ID":"i-Lc0JLrsUFt0JfrUFtBJfz:8","createdAt1555365135324,"updatedAt":1555365135324,"userId":"system:serviceaccount:syndesis:syndesis:syndesis:syndesis-cd-client","StateState": "ylfEz:8" createdAt":1555365135324,"userId": "system:serviceaccount:syndesis:syndesis:synState":"Pending","State":Jfending" ". .2C+PC9zdmc+","description":"Cellion": "Cellt": "Cellt":false},"단계Kind": "endpoint"",{"id":"-Lc0I7wqEVfKCDDHC8Jv","인증됨."Adescription": "Cellt": "Cellt"."

7.6. 통합을 중지하기 위한 끝점

이 끝점은 지정된 통합을 중지합니다.

방법 및 끝점

PUT

/public/integrations/{id}/deployments/stop

Expand
표 7.6. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{id}

string

필수 항목입니다. 중지할 통합의 이름 또는 내부 ID입니다. 통합 ID를 찾는 방법을 참조하십시오.

요청 예

다음 예에서 끝점은 timer-to-log 통합을 중지합니다.

/public/integrations/timer-to-log/deployments stop

생성

application/json

응답 예

204 상태 코드가 있는 콘텐츠 없음

7.7. 통합을 내보내기 위한 끝점

이 엔드포인트는 통합을 내보냅니다. 기본 동작은 지정된 환경에 대해 표시되어 내보낸 적이 없거나 해당 환경에 마지막으로 표시된 이후 내보내지 않은 통합을 내보내는 것입니다. 다음 중 하나를 수행할 때 옵션을 지정할 수 있습니다.

  • Fuse Online 환경에서 모든 통합을 내보내고 지정된 환경 레이블을 사용하여 태그를 지정합니다.
  • 통합이 마지막으로 내보낸 이후 태그되었는지 여부에 관계없이 지정된 환경 레이블로 태그가 지정된 모든 통합을 내보냅니다.

Fuse Online 공용 API 내보내기 끝점 도 참조하십시오.

방법 및 끝점

GET

/public/integrations/{env}/export.zip

Expand
표 7.7. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

multipart/form-data

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{env}

string

필수 항목입니다. Fuse Online 콘솔에서 생성한 환경 레이블입니다. 엔드포인트는 이 환경에 표시된 통합을 내보냅니다.

쿼리 매개변수

all=true

string

선택 사항: Fuse Online 환경에 있는 모든 통합을 내보내려면 이 옵션을 지정합니다. 엔드포인트는 각 통합의 현재 버전을 내보냅니다. 지정된 환경에 대해 통합이 표시되지 않은 경우 엔드포인트에서 지정된 환경 레이블을 통합에 추가합니다. 환경 레이블을 이미 생성해야 합니다. 끝점에서 레이블을 생성할 수 없습니다.

ignoreTimestamp=true

string

지정된 환경 레이블로 태그된 모든 통합을 내보냅니다. 통합이 마지막으로 내보낸 이후 통합 편집 및 태그 지정 여부에 관계없이 이 작업을 수행합니다.

추가 매개변수

-o export.zip

string

쿼리 매개변수를 지정하는 경우 필수 항목입니다. 이 옵션이 없으면 내보낸 통합은 이름이 export.zip?all=true 인 파일에 있습니다.

요청 예

첫 번째 예에서 엔드포인트는 test1 환경에 대해 표시되었으며 내보낸 적이 없거나 해당 환경에 대해 마지막으로 표시된 이후 내보내지 않은 통합을 내보냅니다.

/public/integrations/test1/export.zip

다음 예에서 엔드포인트는 test1 환경에 대해 표시된 모든 통합을 내보냅니다. 통합이 마지막으로 내보낸 이후 업데이트되었는지는 중요하지 않습니다.

/public/integrations/test1/export.zip?ignoreTimestamp=true -o export.zip

마지막 예에서 끝점은 test1 환경에 대해 각 통합이 표시되고 export.zip 파일의 모든 통합을 반환합니다.

/public/integrations/test1/export.zip?all=true -o export.zip

생성

application/octet-stream

응답

내보낸 통합이 포함된 export.zip 파일입니다. 내보낼 통합이 없는 경우 끝점은 HTTP 상태를 204 로 반환합니다.

7.8. 통합을 가져오기 위한 끝점

이 엔드포인트는 제공된 파일에 있는 통합을 가져옵니다. Fuse Online 공용 REST API 가져오기 끝점 도 참조하십시오.

방법 및 끝점

POST

/public/integrations

Expand
표 7.8. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

multipart/form-data

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

추가 매개변수

data=@export.zip

string

필수 항목입니다. 이는 가져올 통합이 포함된 파일입니다. 이 파일을 가져오려면 이전에 내보내기 엔드포인트를 호출해야 합니다.

environment={env}

string

필수 항목입니다. 가져온 각 통합에 추가할 환경 레이블입니다. 환경 레이블을 이미 생성해야 합니다. 끝점에서 레이블을 생성할 수 없습니다.

요청 예

다음 예에서 끝점은 export.zip 파일에 있는 통합을 가져와서 테스트 환경에 표시합니다.

/public/integrations -F data=@export.zip -F environment=testing --request POST

생성

multipart/form-data

응답 예

응답은 가져온 리소스 목록으로, 통합 및 연결이 포함됩니다. 다음 예제에서는 응답의 일부가 여기에 생략됨을 나타냅니다.

{"lastImportedAt":1554888047271,"results":[{"id":"i-Lc0JLrsUFtBJfrsUFtBJfz","version":5"createdAt":1554800274935,"updatedAt":0,"tags":["timer","name": "timer-to-log","{j"id":"i-Lc0JfrsUFtB",""createdAt":1554800274935,"updatedAt", "tags":["timetimer", "name":["time-to-log","{jid":"{jid":" 간격 또는 cron 표현식을 기반으로 하는 이벤트","isDerived":false},"stepKind":"endpoint"}, {"ID":"-Lc0I7wqEVfKCDDHC8Jv","configuredProperties":{"bodyLoggingEnabled":"true""true"},"metadata":{"configured":"stepKind":"log":"Log",""Log",""Log"},"{tinuousDelivery":State","{"10." "lastImportedAt":1554887859824}}}]}

7.9. 특정 통합에서 환경 레이블을 제거하기 위한 끝점

이 끝점은 지정된 통합에서 지정된 환경 레이블을 제거합니다. 환경 레이블 자체는 계속 존재하지만 지정된 통합은 더 이상 표시하지 않습니다.

방법 및 끝점

DELETE

/public/integrations/{id}/tags/{env}

Expand
표 7.9. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{id}

string

필수 path 매개변수입니다. 표시 해제하려는 통합의 이름 또는 내부 ID입니다. 통합 ID를 찾는 방법을 참조하십시오.

{env}

string

필수 path 매개변수입니다. 지정된 통합에서 제거할 환경 레이블입니다.

추가 매개변수

--request DELETE

 

DELETE 메서드를 지정합니다.

요청 예

다음 예에서 엔드포인트는 timer-to-log 통합에서 dev1 환경 레이블을 제거합니다.

/public/integrations/timer-to-log/tags/dev1 --request DELETE

응답 예

204 상태 코드가 있는 콘텐츠 없음

7.10. 환경 레이블을 생성하기 위한 끝점

이 엔드포인트는 환경 레이블을 생성합니다. Fuse Online 콘솔에서 명시적으로 표시하거나 공용 API 엔드포인트를 호출하여 통합할 때까지 이 레이블과 통합이 표시되지 않습니다.

방법 및 끝점

POST

/public/environments/{env}

Expand
표 7.10. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{env}

string

필수 항목입니다. 생성할 환경 레이블입니다.

생성

다음과 같이 응답하지만 아무것도 생성하지 않습니다.

Expand
응답설명

204 콘텐츠 없음

성공.

400 잘못된 요청

지정한 환경 이름이 이미 존재합니다.

5xx 오류

서버가 요청을 수행할 수 없습니다.

요청 예

다음 예에서 엔드포인트는 dev1 환경 레이블을 생성합니다.

/public/environments/dev1 --request POST

이제 이 엔드포인트를 호출한 Fuse Online 환경에 dev1 환경 레이블이 있습니다. 이 레이블로 표시된 통합은 아직 없습니다.

응답 예

응답 상태 코드 204가 있는 콘텐츠 없음

7.11. 환경 라벨 목록을 가져오는 끝점

이 엔드포인트는 Fuse Online 환경에 있는 환경 레이블 목록을 반환합니다. Fuse Online 콘솔에서 환경 레이블을 생성합니다. CI/CD의 환경 레이블 관리를 참조하십시오.

방법 및 끝점

GET

/public/environments[?withUses=true]

Expand
표 7.11. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

withUses

부울

선택 사항: 명령이 Uses=true로 지정하는 경우 끝점은 환경 레이블과 해당 레이블로 표시된 통합 수를 반환합니다. 지정하지 않거나 false 로 설정하면 엔드포인트에서 환경 레이블만 반환합니다.

생성

application/json

요청 예

  • /public/environments

    응답 예:
    ["env-label-1", "env-label-2"]

  • /public/environments/?withUses=true

    응답 예제
    [{"name":"env-label-1","uses":1},
    {"name":"env-label-2","uses":0}]

7.12. 환경 레이블 변경을 위한 끝점

이 끝점은 환경 레이블을 변경합니다. 이제 원래 환경 레이블로 표시된 통합이 새 환경 레이블로 표시됩니다.

방법 및 끝점

PUT

/public/environments/{env}

Expand
표 7.12. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{env}

string

필수 항목입니다. 변경할 환경 레이블입니다.

추가 매개변수

-d {env}

string

필수 항목입니다. 환경에 대한 새 레이블을 지정합니다. 환경 레이블을 이미 생성해야 합니다. 끝점에서 레이블을 생성할 수 없습니다.

--request PUT

 

PUT 메서드를 지정합니다.

요청 예

다음 예에서 끝점은 dev1 환경 레이블을 dev2 로 변경합니다.

/public/environments/dev1 -d ‘dev2’ --request PUT

dev1 환경에 대해 표시된 통합에는 더 이상 해당 태그가 없습니다. 이러한 통합은 이제 dev2 환경에 대해 표시됩니다.

응답 예

응답 상태 코드 204가 있는 콘텐츠 없음

7.13. 모든 통합에서 환경 레이블을 제거하는 끝점

이 끝점은 적용된 각 통합에서 지정된 환경 레이블을 제거합니다.

방법 및 끝점

DELETE

/public/environments/{env}

Expand
표 7.13. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{env}

string

필수 항목입니다. 통합에서 제거할 환경 레이블입니다.

추가 매개변수

--request DELETE

 

DELETE 메서드를 지정합니다.

요청 예

다음 예에서 엔드포인트는 통합에서 dev1 태그를 제거합니다.

/public/environments/dev1 --request DELETE

응답 예

응답 상태 코드 204가 있는 콘텐츠 없음

7.14. 연결의 속성을 변경하기 위한 끝점

이 끝점은 지정된 연결의 속성을 변경합니다. 이 기능은 구성이 필요한 연결이 있는 통합을 가져온 후 유용합니다. 예를 들어 연결에 사용하는 자격 증명을 변경해야 할 수 있습니다.

방법 및 끝점

POST

​/public​/connections​/{id}​/properties

Expand
표 7.14. 매개 변수
이름유형설명

필수 헤더 매개변수

-h "Content-Type: <media-type>"

application/json

끝점에 필요한 미디어 유형입니다.

-h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"

사용자 지정

인증에 필요합니다.

-h 'Authorization: Bearer <token> '

사용자 지정

Fuse Online 공용 REST API를 노출하는 OpenShift 서비스 계정의 시크릿 토큰입니다. 시크릿 토큰 받기를 참조하십시오.

경로 매개변수

{id}

string

필수 항목입니다. {id} 를 변경하려는 속성의 ID로 바꿉니다. 연결 ID에 대해 다음 중 하나를 지정합니다.

  • 연결의 이름입니다(예: PostgresDB ). 연결 이름에 공백 또는 특수 문자가 있는 경우 HTML 이스케이프 문자를 지정해야 합니다.
  • 연결 세부 정보를 볼 때 Fuse Online 콘솔 URL에 있는 내부 연결 ID입니다. 연결의 세부 정보를 보려면 왼쪽 탐색 패널에서 연결을 클릭합니다. 그런 다음 세부 정보를 확인하려는 연결을 클릭합니다. 연결 세부 정보가 브라우저에 표시되면 URL 끝에 다음과 같은 내용이 표시됩니다. /connections/i-LaupI8XznJ4LcuWwiwaz. 이 연결의 ID는 i-LaupI8XznJ4LcuWwiwaz 입니다.

요청 예

다음 예제에서는 PostgresDB 연결의 속성을 변경합니다. user 속성의 새 값은 myuser 이고 password 속성의 새 값은 mypassword 입니다.

/public/connections/PostgresDB/properties --request POST -d '{ "user": "myuser", "password": "mypassword" }'

생성

application/json

샘플 응답

이 예에서는 응답의 많은 부분이 누락되었음을 나타내는is가 있습니다.

"Causes":0,"id":"i-LaOziQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQMACMACMAVERA"," "TODOCz"," 구성된Properties":{"password":"9991046372aefa061f79b43fb791fb43fb791fb99e."Catype"Qfwn." "errors":0},"isDerived":false}

8장. Fuse 온라인 사용자 인터페이스 교체

Fuse Online 애플리케이션 이름, 로고, 아이콘 및 기타 사용자 인터페이스 세부 정보를 교체하여 Fuse Online을 교체할 수 있습니다. 이 작업은 syndesis-ui 배포 파일에서 ConfigMap 오브젝트로 사용자 지정 리소스를 마운트하여 수행합니다.

사전 요구 사항

  • Fuse Online은 고객 관리 환경의 OpenShift Container Platform에 설치되어 실행 중입니다.
  • oc 클라이언트 툴은 Fuse Online이 설치된 OCP 클러스터에 연결되어 있습니다.
  • Fuse Online을 설치할 수 있는 권한이 있습니다.

절차

  1. 다음 명령을 호출하여 Fuse Online이 설치된 syndesis-ui Pod의 이름을 가져옵니다.

    oc get pods

  2. 다음 명령을 호출하고 SYNDESIS_UI_POD_NAMEsyndesis-ui 를 실행하는 Pod의 실제 이름으로 교체하여 사용자 지정할 수 있는 로고, 아이콘, 글꼴 및 배경을 가져옵니다.

    oc rsync SYNDESIS_UI_POD_NAME:/opt/app-root/src/static/media ~/

    그러면 사용자 인터페이스 리소스가 ~/media/ 폴더에 배치됩니다.

  3. ~/media/syndesis_logo_full_darkb Cryostat.9c467d96.svg 인 헤더 로고가 포함된 파일을 편집하고 저장합니다.
  4. 업데이트된 로고 파일이 포함된 ConfigMap 오브젝트를 생성하여 수정된 파일을 클러스터에 업로드합니다.

    cd ~/
    oc create configmap syndesis-ui-custom-logo --from-file=media/syndesis_logo_full_darkbkg.9c467d96.svg
    Copy to Clipboard Toggle word wrap
  5. syndesis-ui 배포 파일을 수정하여 syndesis-ui-custom-logo ConfigMap 오브젝트를 마운트합니다. oc edit dc/syndesis-ui 를 호출하거나 OpenShift 웹 콘솔을 사용하여 애플리케이션 > Deployments > syndesis-ui > Actions > Edit YAML 을 선택하여 이 작업을 수행합니다.

    1. spec.template.containers.volumeMounts 에서 다음을 추가합니다.

      -name: syndesis-ui-custom-logo-volume
       mountPath: /opt/app-root/src/static/media/syndesis_logo_full_darkbkg.9c467d96.svg
       subPath: syndesis_logo_full_darkbkg.9c467d96.svg
      Copy to Clipboard Toggle word wrap
    2. spec.template.volumes 에서 다음을 추가합니다.

      -name: syndesis-ui-custom-logo-volume
       configMap:
        name: syndesis-ui-custom-logo
      Copy to Clipboard Toggle word wrap
    3. syndesis-ui 배포 파일을 저장합니다.
  6. '~/media 폴더에 있고 사용자 지정할 각 파일에 대해 3~5단계를 반복합니다.
  7. 편집 후 애플리케이션 제목이 포함된 파일을 저장합니다.

    1. 파일을 업데이트할 디렉터리를 만듭니다.

      mkdir ~/syndesis-custom/src

    2. 다음 명령을 호출하고 SYNDESIS_UI_POD_NAMEsyndesis-ui 를 실행하는 Pod의 실제 이름으로 교체하여 애플리케이션 제목 파일을 가져옵니다.

      oc rsync SYNDESIS_UI_POD_NAME:/opt/app-root/src/index.html ~/syndesis-custom/src
      Copy to Clipboard Toggle word wrap
    3. 애플리케이션 제목을 바꿉니다. 예를 들면 다음과 같습니다.

      sed -i 's/<title>.*<\/title>/<title>NEW_TITLE<\/title>/g' ~/syndesis-custom/src/index.html
      Copy to Clipboard Toggle word wrap
  8. 업데이트된 파일이 포함된 ConfigMap 오브젝트를 생성하여 수정된 애플리케이션 제목 파일을 클러스터에 업로드합니다.

    cd ~/syndesis-custom/src
    oc create configmap syndesis-ui-custom-index --from-file=index.html
    Copy to Clipboard Toggle word wrap
  9. syndesis-ui - custom-index ConfigMap 오브젝트를 마운트하여 syndesis-ui- ui 배포를 수정합니다.

    1. spec.template.containers.volumeMounts 에서 다음을 추가합니다.

      -name: syndesis-ui-custom-vindex-olume
       mountPath: /opt/app-root/src/index.html
       subPath: index.html
      Copy to Clipboard Toggle word wrap
    2. spec.template.volumes 에서 다음을 추가합니다.

      -name: syndesis-ui-custom-index-volume
       configMap:
        name: syndesis-ui-custom-index
      Copy to Clipboard Toggle word wrap
    3. syndesis-ui 배포 파일을 저장합니다.

결과

syndesis-ui 배포 파일을 저장하면 변경 사항을 반영하는 사용자 인터페이스를 사용하여 Fuse Online이 자동으로 재배포됩니다. 이후 Fuse Online 재배포에는 변경 사항도 반영됩니다.

법적 공지

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat
맨 위로 이동