OpenShift에 Apicurio 레지스트리 설치 및 배포

프로세스

1. Red Hat 소프트웨어 다운로드 로 이동하여 제품 버전을 선택하고 Apicurio Registry CRD .zip 파일에서 예제를 다운로드합니다.
2. 다운로드한 CRD .zip 파일을 추출하고 apicurio-registry-install-examples 디렉터리로 변경합니다.

3. Apicurio Registry Operator 설치에 대한 OpenShift 프로젝트를 생성합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   export NAMESPACE="apicurio-registry"
   oc new-project "$NAMESPACE"

4. 다음 명령을 입력하여 install/install.yaml 파일에 예제 CRD를 적용합니다.

   Copy to Clipboard Toggle word wrap

   cat install/install.yaml | sed "s/apicurio-registry-operator-namespace/$NAMESPACE/g" | oc apply -f -

5. oc get deployment 를 입력하여 Apicurio Registry Operator의 준비 상태를 확인합니다. 예를 들어 출력은 다음과 같아야 합니다.

   Copy to Clipboard Toggle word wrap

   NAME                     	READY   UP-TO-DATE  AVAILABLE   AGE
   apicurio-registry-operator  1/1 	1        	1       	XmYs

프로세스

1. 편집기에서 examples/apicurioregistry_sql_cr.yaml 파일을 열고 ApicurioRegistry CR(사용자 정의 리소스)을 확인합니다.

   SQL 스토리지를 위한 CR의 예

   Copy to Clipboard Toggle word wrap

   apiVersion: registry.apicur.io/v1
   kind: ApicurioRegistry
   metadata:
     name: example-apicurioregistry-sql
   spec:
     configuration:
       persistence: "sql"
       sql:
         dataSource:
           url: "jdbc:postgresql://<service name>.<namespace>.svc:5432/<database name>"
           userName: "postgres"
           password: "<password>" # Optional

2. dataSource 섹션에서 예제 설정을 데이터베이스 연결 세부 정보로 교체합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   dataSource:
       url: "jdbc:postgresql://postgresql.apicurio-registry.svc:5432/registry"
       userName: "pgadmin"
       password: "pgpass"

3. 다음 명령을 입력하여 Apicurio Registry Operator를 사용하여 네임스페이스에 업데이트된 ApicurioRegistry CR을 적용하고 Apicurio Registry 인스턴스가 배포될 때까지 기다립니다.

   Copy to Clipboard Toggle word wrap

   oc project "$NAMESPACE"
   oc apply -f ./examples/apicurioregistry_sql_cr.yaml

4. oc get deployment 를 입력하여 Apicurio 레지스트리 인스턴스의 준비 상태를 확인합니다. 예를 들어 출력은 다음과 같아야 합니다.

   Copy to Clipboard Toggle word wrap

   NAME                     	        READY UP-TO-DATE AVAILABLE AGE
   example-apicurioregistry-sql-deployment 1/1   1          1         XmYs

5. oc get routes 를 입력하여 브라우저에서 Apicurio Registry 웹 콘솔을 시작하려면 HOST/PORT URL을 가져옵니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   example-apicurioregistry-sql.apicurio-registry.router-default.apps.mycluster.myorg.mycompany.com

프로세스

1. OpenShift Container Platform 웹 콘솔에서 클러스터 관리자 권한이 있는 계정을 사용하여 로그인합니다.

2. 새 OpenShift 프로젝트를 생성합니다.

   1. 왼쪽 탐색 메뉴에서 홈,프로젝트 를 클릭한 다음 프로젝트 만들기를 클릭합니다.
   2. 프로젝트 이름(예: my-project )을 입력하고 생성 을 클릭합니다.
3. 왼쪽 탐색 메뉴에서 Operator를 클릭한 다음 OperatorHub 를 클릭합니다.
4. 키워드로 필터링 텍스트 상자에 레지스트리 를 입력하여 Red Hat Integration - Service Registry Operator 를 찾습니다.
5. Operator에 대한 정보를 읽고 설치를 클릭하여 Operator 서브스크립션 페이지를 표시합니다.

6. 서브스크립션 설정을 선택합니다. 예를 들면 다음과 같습니다.

   • Update Channel: 다음 중 하나를 선택합니다.

     • 2.x: 2.3.0 및 2.0.3과 같은 모든 마이너 및 패치 업데이트가 포함됩니다. 예를 들어 2.0.x에 설치가 2.3.x로 업그레이드됩니다.
     • 2.0.x: 2.0.1 및 2.0.2와 같은 패치 업데이트만 포함합니다. 예를 들어 2.0.x에 대한 설치는 2.3.x를 무시합니다.

   • 설치 모드: 다음 중 하나를 선택합니다.

     • 클러스터의 모든 네임스페이스(기본값)
     • 클러스터의 특정 네임스페이스 및 my-project
   • 승인 전략: 자동 또는 수동선택
7. 설치를 클릭하고 Operator를 사용할 준비가 될 때까지 몇 분 정도 기다립니다.

프로세스

1. OpenShift Container Platform 웹 콘솔에서 클러스터 관리자 권한이 있는 계정을 사용하여 로그인합니다.
2. AMQ Streams를 설치할 OpenShift 프로젝트로 변경합니다. 예를 들어 프로젝트 드롭다운에서 my-project 를 선택합니다.
3. 왼쪽 탐색 메뉴에서 Operator를 클릭한 다음 OperatorHub 를 클릭합니다.
4. 키워드로 필터링 텍스트 상자에 AMQ Streams 를 입력하여 Red Hat Integration - AMQ Streams Operator를 찾습니다.
5. Operator에 대한 정보를 읽고 설치를 클릭하여 Operator 서브스크립션 페이지를 표시합니다.

6. 서브스크립션 설정을 선택합니다. 예를 들면 다음과 같습니다.

   • 채널 업데이트 및 amq-streams-2.6.x

   • 설치 모드: 다음 중 하나를 선택합니다.

     • 클러스터의 모든 네임스페이스(기본값)
     • 클러스터의 특정 네임스페이스 > my-project
   • 승인 전략: 자동 또는 수동선택
7. 설치를 클릭하고 Operator를 사용할 준비가 될 때까지 몇 분 정도 기다립니다.

프로세스

1. OpenShift Container Platform 웹 콘솔에서 클러스터 관리자 권한이 있는 계정을 사용하여 로그인합니다.

2. Kafka 클러스터가 구성되지 않은 경우 AMQ Streams를 사용하여 새 Kafka 클러스터를 생성합니다. 예를 들어 OpenShift OperatorHub에서는 다음을 수행합니다.

   1. Installed Operators 를 클릭한 다음 Red Hat Integration - AMQ Streams 를 클릭합니다.
   2. 제공된 API 에서 Kafka 를 클릭한 다음 인스턴스 생성 을 클릭하여 새 Kafka 클러스터를 생성합니다.

   3. 필요에 따라 사용자 정의 리소스 정의를 편집하고 생성 을 클릭합니다.

      주의

      기본 예제에서는 3개의 Zookeeper 노드와 3개의 Kafka 노드가 있는 클러스터를 생성합니다. 이 임시 스토리지는 개발 및 테스트에만 적합하며 프로덕션에는 적합하지 않습니다. 자세한 내용은 OpenShift에서 AMQ 스트림 배포 및 관리를 참조하십시오.

3. 클러스터가 준비되면 제공된 API > Kafka > my-cluster > YAML 을 클릭합니다.

4. 상태 블록에서 나중에 Apicurio Registry를 배포하는 데 사용할 bootstrapServers 값의 사본을 만듭니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   status:
     ...
     conditions:
     ...
     listeners:
       - addresses:
           - host: my-cluster-kafka-bootstrap.my-project.svc
             port: 9092
         bootstrapServers: 'my-cluster-kafka-bootstrap.my-project.svc:9092'
         type: plain
     ...

5. 설치된 Operators > Red Hat Integration - Service Registry > ApicurioRegistry > Create ApicurioRegistry 를 클릭합니다.

6. 다음 사용자 정의 리소스 정의에 붙여넣지만 이전에 복사한 bootstrapServers 값을 사용합니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: registry.apicur.io/v1
   kind: ApicurioRegistry
   metadata:
     name: example-apicurioregistry-kafkasql
   spec:
     configuration:
       persistence: 'kafkasql'
       kafkasql:
         bootstrapServers: 'my-cluster-kafka-bootstrap.my-project.svc:9092'

7. 생성 을 클릭하고 OpenShift에서 Apicurio 레지스트리 경로가 생성될 때까지 기다립니다.

8. 네트워킹 > 경로를 클릭하여 Apicurio 레지스트리 웹 콘솔의 새 경로에 액세스합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   http://example-apicurioregistry-kafkasql.my-project.my-domain-name.com/

9. Apicurio Registry가 데이터를 저장하는 데 사용하는 Kafka 주제를 구성하려면 Installed Operators > Red Hat Integration - AMQ Streams > Provided API > Kafka Topic > kafkasql-journal > YAML 을 클릭합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: kafka.strimzi.io/v1beta2
   kind: KafkaTopic
   metadata:
     name: kafkasql-journal
     labels:
       strimzi.io/cluster: my-cluster
     namespace: ...
   spec:
     partitions: 3
     replicas: 3
     config:
       cleanup.policy: compact

   주의

   압축 정리 정책을 사용하여 Apicurio Registry(기본적으로 kafkasql-journal )에서 사용하는 Kafka 주제를 구성해야 합니다. 그렇지 않으면 데이터 손실이 발생할 수 있습니다.

프로세스

1. OpenShift 웹 콘솔에서 Installed Operators 를 클릭하고 AMQ Streams Operator 세부 정보를 선택한 다음 Kafka 탭을 선택합니다.
2. Create Kafka 를 클릭하여 Apicurio 레지스트리 스토리지에 대한 새 Kafka 클러스터를 프로비저닝합니다.

3. Kafka 클러스터에 TLS 인증을 사용하도록 권한 부여 및 tls 필드를 구성합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: kafka.strimzi.io/v1beta2
   kind: Kafka
   metadata:
     name: my-cluster
     namespace: registry-example-kafkasql-tls
     # Change or remove the explicit namespace
   spec:
     kafka:
       config:
         offsets.topic.replication.factor: 3
         transaction.state.log.replication.factor: 3
         transaction.state.log.min.isr: 2
         log.message.format.version: '2.7'
         inter.broker.protocol.version: '2.7'
       version: 2.7.0
       storage:
         type: ephemeral
       replicas: 3
       listeners:
         - name: tls
           port: 9093
           type: internal
           tls: true
           authentication:
             type: tls
       authorization:
         type: simple
     entityOperator:
       topicOperator: {}
       userOperator: {}
     zookeeper:
       storage:
         type: ephemeral
       replicas: 3

   데이터를 저장하기 위해 Apicurio Registry에서 자동으로 생성한 기본 Kafka 주제 이름은 kafkasql-journal 입니다. 환경 변수를 설정하여 이 동작 또는 기본 주제 이름을 재정의할 수 있습니다. 기본값은 다음과 같습니다.

   • REGISTRY_KAFKASQL_TOPIC_AUTO_CREATE=true
   • REGISTRY_KAFKASQL_TOPIC=kafkasql-journal

   Kafka 주제를 수동으로 생성하지 않으려면 다음 단계를 건너뜁니다.

4. Kafka Topic 탭을 클릭한 다음 Kafka Topic 생성 을 클릭하여 kafkasql-journal 주제를 생성합니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: kafka.strimzi.io/v1beta1
   kind: KafkaTopic
   metadata:
     name: kafkasql-journal
     labels:
       strimzi.io/cluster: my-cluster
     namespace: registry-example-kafkasql-tls
   spec:
     partitions: 2
     replicas: 1
     config:
       cleanup.policy: compact

5. Kafka 사용자 리소스를 생성하여 Apicurio Registry 사용자에 대한 인증 및 권한 부여를 구성합니다. metadata 섹션에 사용자 이름을 지정하거나 기본 my-user 를 사용할 수 있습니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: kafka.strimzi.io/v1beta1
   kind: KafkaUser
   metadata:
     name: my-user
     labels:
       strimzi.io/cluster: my-cluster
     namespace: registry-example-kafkasql-tls
   spec:
     authentication:
       type: tls
     authorization:
       acls:
         - operation: All
           resource:
             name: '*'
             patternType: literal
             type: topic
         - operation: All
           resource:
             name: '*'
             patternType: literal
             type: cluster
         - operation: All
           resource:
             name: '*'
             patternType: literal
             type: transactionalId
         - operation: All
           resource:
             name: '*'
             patternType: literal
             type: group
       type: simple

   참고

   이 간단한 예제에서는 관리자 권한을 가정하고 Kafka 주제를 자동으로 생성합니다. Apicurio Registry에 필요한 주제 및 리소스에 대해 특별히 권한 부여 섹션을 구성해야 합니다.

   다음 예제에서는 Kafka 주제를 수동으로 생성할 때 필요한 최소 구성을 보여줍니다.

   Copy to Clipboard Toggle word wrap

    ...
     authorization:
       acls:
       - operations:
           - Read
           - Write
         resource:
           name: kafkasql-journal
           patternType: literal
           type: topic
       - operations:
           - Read
           - Write
         resource:
           name: apicurio-registry-
           patternType: prefix
           type: group
       type: simple

6. 워크로드 및 시크릿을 클릭하여 AMQ Streams가 Kafka 클러스터에 연결하기 위해 Apicurio Registry를 위해 생성하는 두 가지 시크릿을 찾습니다.

   • my-cluster-cluster-ca-cert - Kafka 클러스터의 PKCS12 신뢰 저장소 포함

   • my-user - 사용자의 키 저장소 포함

     참고

     시크릿 이름은 클러스터 또는 사용자 이름에 따라 다를 수 있습니다.

7. 수동으로 보안을 생성하는 경우 다음 키-값 쌍을 포함해야 합니다.

   • my-cluster-ca-cert

     • ca.p12 - PKCS12 형식의 신뢰 저장소
     • ca.password - truststore 암호

   • my-user

     • user.p12 - PKCS12 형식의 키 저장소
     • user.password - 키 저장소 암호

8. Apicurio 레지스트리를 배포하도록 다음 예제 구성을 구성합니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: registry.apicur.io/v1
   kind: ApicurioRegistry
   metadata:
     name: example-apicurioregistry-kafkasql-tls
   spec:
     configuration:
       persistence: "kafkasql"
       kafkasql:
         bootstrapServers: "my-cluster-kafka-bootstrap.registry-example-kafkasql-tls.svc:9093"
         security:
           tls:
             keystoreSecretName: my-user
             truststoreSecretName: my-cluster-cluster-ca-cert

프로세스

1. OpenShift 웹 콘솔에서 Installed Operators 를 클릭하고 AMQ Streams Operator 세부 정보를 선택한 다음 Kafka 탭을 선택합니다.
2. Create Kafka 를 클릭하여 Apicurio 레지스트리 스토리지에 대한 새 Kafka 클러스터를 프로비저닝합니다.

3. Kafka 클러스터에 SCRAM-SHA-512 인증을 사용하도록 권한 부여 및 tls 필드를 구성합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: kafka.strimzi.io/v1beta2
   kind: Kafka
   metadata:
     name: my-cluster
     namespace: registry-example-kafkasql-scram
     # Change or remove the explicit namespace
   spec:
     kafka:
       config:
         offsets.topic.replication.factor: 3
         transaction.state.log.replication.factor: 3
         transaction.state.log.min.isr: 2
         log.message.format.version: '2.7'
         inter.broker.protocol.version: '2.7'
       version: 2.7.0
       storage:
         type: ephemeral
       replicas: 3
       listeners:
         - name: tls
           port: 9093
           type: internal
           tls: true
           authentication:
             type: scram-sha-512
       authorization:
         type: simple
     entityOperator:
       topicOperator: {}
       userOperator: {}
     zookeeper:
       storage:
         type: ephemeral
       replicas: 3

   데이터를 저장하기 위해 Apicurio Registry에서 자동으로 생성한 기본 Kafka 주제 이름은 kafkasql-journal 입니다. 환경 변수를 설정하여 이 동작 또는 기본 주제 이름을 재정의할 수 있습니다. 기본값은 다음과 같습니다.

   • REGISTRY_KAFKASQL_TOPIC_AUTO_CREATE=true
   • REGISTRY_KAFKASQL_TOPIC=kafkasql-journal

   Kafka 주제를 수동으로 생성하지 않으려면 다음 단계를 건너뜁니다.

4. Kafka Topic 탭을 클릭한 다음 Kafka Topic 생성 을 클릭하여 kafkasql-journal 주제를 생성합니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: kafka.strimzi.io/v1beta1
   kind: KafkaTopic
   metadata:
     name: kafkasql-journal
     labels:
       strimzi.io/cluster: my-cluster
     namespace: registry-example-kafkasql-scram
   spec:
     partitions: 2
     replicas: 1
     config:
       cleanup.policy: compact

5. Kafka 사용자 리소스를 생성하여 Apicurio Registry 사용자에 대한 SCRAM 인증 및 권한 부여를 구성합니다. metadata 섹션에 사용자 이름을 지정하거나 기본 my-user 를 사용할 수 있습니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: kafka.strimzi.io/v1beta1
   kind: KafkaUser
   metadata:
     name: my-user
     labels:
       strimzi.io/cluster: my-cluster
     namespace: registry-example-kafkasql-scram
   spec:
     authentication:
       type: scram-sha-512
     authorization:
       acls:
         - operation: All
           resource:
             name: '*'
             patternType: literal
             type: topic
         - operation: All
           resource:
             name: '*'
             patternType: literal
             type: cluster
         - operation: All
           resource:
             name: '*'
             patternType: literal
             type: transactionalId
         - operation: All
           resource:
             name: '*'
             patternType: literal
             type: group
       type: simple

   참고

   이 간단한 예제에서는 관리자 권한을 가정하고 Kafka 주제를 자동으로 생성합니다. Apicurio Registry에 필요한 주제 및 리소스에 대해 특별히 권한 부여 섹션을 구성해야 합니다.

   다음 예제에서는 Kafka 주제를 수동으로 생성할 때 필요한 최소 구성을 보여줍니다.

   Copy to Clipboard Toggle word wrap

    ...
     authorization:
       acls:
       - operations:
           - Read
           - Write
         resource:
           name: kafkasql-journal
           patternType: literal
           type: topic
       - operations:
           - Read
           - Write
         resource:
           name: apicurio-registry-
           patternType: prefix
           type: group
       type: simple

6. 워크로드 및 시크릿을 클릭하여 AMQ Streams가 Kafka 클러스터에 연결하기 위해 Apicurio Registry를 위해 생성하는 두 가지 시크릿을 찾습니다.

   • my-cluster-cluster-ca-cert - Kafka 클러스터의 PKCS12 신뢰 저장소 포함

   • my-user - 사용자의 키 저장소 포함

     참고

     시크릿 이름은 클러스터 또는 사용자 이름에 따라 다를 수 있습니다.

7. 수동으로 보안을 생성하는 경우 다음 키-값 쌍을 포함해야 합니다.

   • my-cluster-ca-cert

     • ca.p12 - PKCS12 형식의 신뢰 저장소
     • ca.password - truststore 암호

   • my-user

     • 암호 - 사용자 암호

8. Apicurio 레지스트리를 배포하도록 다음 예제 설정을 구성합니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: registry.apicur.io/v1
   kind: ApicurioRegistry
   metadata:
     name: example-apicurioregistry-kafkasql-scram
   spec:
     configuration:
       persistence: "kafkasql"
       kafkasql:
         bootstrapServers: "my-cluster-kafka-bootstrap.registry-example-kafkasql-scram.svc:9093"
         security:
           scram:
             truststoreSecretName: my-cluster-cluster-ca-cert
             user: my-user
             passwordSecretName: my-user

프로세스

1. OpenShift Container Platform 웹 콘솔에서 클러스터 관리자 권한이 있는 계정을 사용하여 로그인합니다.
2. PostgreSQL Operator를 설치할 OpenShift 프로젝트로 변경합니다. 예를 들어 프로젝트 드롭다운에서 my-project 를 선택합니다.
3. 왼쪽 탐색 메뉴에서 Operator를 클릭한 다음 OperatorHub 를 클릭합니다.
4. 키워드로 필터링 텍스트 상자에 PostgreSQL 을 입력하여 환경에 적합한 Operator를 찾습니다(예: Crunchy PostgreSQL for OpenShift ).
5. Operator에 대한 정보를 읽고 설치를 클릭하여 Operator 서브스크립션 페이지를 표시합니다.

6. 서브스크립션 설정을 선택합니다. 예를 들면 다음과 같습니다.

   • 업데이트 채널:stable
   • 설치 모드:클러스터의 특정 네임스페이스 및 my-project
   • 승인 전략: 자동 또는 수동선택

7. 설치를 클릭하고 Operator를 사용할 준비가 될 때까지 몇 분 정도 기다립니다.

   중요

   데이터베이스를 생성하고 관리하는 방법에 대한 자세한 내용은 선택한 PostgreSQL Operator에서 문서를 읽어야 합니다.

프로세스

1. OpenShift Container Platform 웹 콘솔에서 클러스터 관리자 권한이 있는 계정을 사용하여 로그인합니다.
2. Apicurio Registry 및 PostgreSQL Operator가 설치된 OpenShift 프로젝트로 변경합니다. 예를 들어 프로젝트 드롭다운에서 my-project 를 선택합니다.
3. Apicurio 레지스트리 스토리지를 위한 PostgreSQL 데이터베이스를 생성합니다. 예를 들어 설치된 Operator , Dev4Ddevs.com의 PostgreSQL Operator 를 클릭한 다음 데이터베이스 만들기를 클릭합니다.

4. YAML 을 클릭하고 다음과 같이 데이터베이스 설정을 편집합니다.

   • name: registry로 값 변경
   • image: 값을 centos/postgresql-12-centos7로 변경합니다.

5. 환경에 따라 필요에 따라 다른 데이터베이스 설정을 편집합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: postgresql.dev4devs.com/v1alpha1
   kind: Database
   metadata:
     name: registry
     namespace: my-project
   spec:
     databaseCpu: 30m
     databaseCpuLimit: 60m
     databaseMemoryLimit: 512Mi
     databaseMemoryRequest: 128Mi
     databaseName: example
     databaseNameKeyEnvVar: POSTGRESQL_DATABASE
     databasePassword: postgres
     databasePasswordKeyEnvVar: POSTGRESQL_PASSWORD
     databaseStorageRequest: 1Gi
     databaseUser: postgres
     databaseUserKeyEnvVar: POSTGRESQL_USER
     image: centos/postgresql-12-centos7
     size: 1

6. 생성을 클릭하고 데이터베이스가 생성될 때까지 기다립니다.
7. 설치된 Operators > Red Hat Integration - Service Registry > ApicurioRegistry > Create ApicurioRegistry 를 클릭합니다.

8. 다음 사용자 정의 리소스 정의에 붙여넣고 데이터베이스 URL 및 인증 정보의 값을 환경에 맞게 편집합니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: registry.apicur.io/v1
   kind: ApicurioRegistry
   metadata:
     name: example-apicurioregistry-sql
   spec:
     configuration:
       persistence: 'sql'
       sql:
         dataSource:
           url: 'jdbc:postgresql://<service name>.<namespace>.svc:5432/<database name>'
           # e.g. url: 'jdbc:postgresql://acid-minimal-cluster.my-project.svc:5432/registry'
           userName: 'postgres'
           password: '<password>' # Optional

9. 생성 을 클릭하고 OpenShift에서 Apicurio 레지스트리 경로가 생성될 때까지 기다립니다.

10. 네트워킹 > 경로를 클릭하여 Apicurio 레지스트리 웹 콘솔의 새 경로에 액세스합니다. 예를 들면 다음과 같습니다.

    Copy to Clipboard Toggle word wrap

    http://example-apicurioregistry-sql.my-project.my-domain-name.com/

프로세스

1. 다음 명령을 입력하여 데이터베이스를 생성합니다.

   Copy to Clipboard Toggle word wrap

    $ createdb -T template0 dbname

2. 다음 명령을 입력하여 SQL 덤프를 복원합니다.

   Copy to Clipboard Toggle word wrap

    $ psql dbname < dumpfile

3. 쿼리 최적화에 유용한 통계가 있도록 각 데이터베이스에서 ANALYZE 를 실행합니다.

프로세스

1. OpenShift 웹 콘솔에서 설치된 Operator 및 Red Hat Single Sign-On Operator 를 클릭한 다음 Keycloak 탭을 클릭합니다.

2. Apicurio 레지스트리 배포 보안을 위해 Create Keycloak 을 클릭하여 새 Red Hat Single Sign-On 인스턴스를 프로비저닝합니다. 예를 들어 기본값을 사용할 수 있습니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: keycloak.org/v1alpha1
   kind: Keycloak
   metadata:
     name: example-keycloak
     labels:
       app: sso
   spec:
     instances: 1
     externalAccess:
       enabled: True
     podDisruptionBudget:
       enabled: True

3. 인스턴스가 생성될 때까지 기다린 다음 Networking 을 클릭한 다음 Routes 를 클릭하여 keycloak 인스턴스의 새 경로에 액세스합니다.
4. 위치 URL을 클릭하고 Apicurio Registry를 배포할 때 나중에 사용할 수 있도록 표시된 URL 값을 복사합니다.

5. 설치된 Operator 및 Red Hat Single Sign-On Operator 를 클릭하고 Keycloak 을 클릭한 다음 Keycloak 만들기를 클릭하여 레지스트리 예제 영역을 생성합니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: keycloak.org/v1alpha1
   kind: KeycloakRealm
   metadata:
     name: registry-keycloakrealm
     labels:
       app: sso
   spec:
     instanceSelector:
       matchLabels:
         app: sso
     realm:
       displayName: Registry
       enabled: true
       id: registry
       realm: registry
       sslRequired: none
       roles:
         realm:
           - name: sr-admin
           - name: sr-developer
           - name: sr-readonly
       clients:
         - clientId: registry-client-ui
           implicitFlowEnabled: true
           redirectUris:
             - '*'
           standardFlowEnabled: true
           webOrigins:
             - '*'
           publicClient: true
         - clientId: registry-client-api
           implicitFlowEnabled: true
           redirectUris:
             - '*'
           standardFlowEnabled: true
           webOrigins:
             - '*'
           publicClient: true
       users:
         - credentials:
             - temporary: false
               type: password
               value: changeme
           enabled: true
           realmRoles:
             - sr-admin
           username: registry-admin
         - credentials:
             - temporary: false
               type: password
               value: changeme
           enabled: true
           realmRoles:
             - sr-developer
           username: registry-developer
         - credentials:
             - temporary: false
               type: password
               value: changeme
           enabled: true
           realmRoles:
             - sr-readonly
           username: registry-user

   중요

   프로덕션에 배포하는 경우 환경에 적합한 값으로 이 KeycloakRealm 리소스를 사용자 지정해야 합니다. Red Hat Single Sign-On 웹 콘솔을 사용하여 영역을 생성하고 관리할 수도 있습니다.

6. 클러스터에 유효한 HTTPS 인증서가 구성되지 않은 경우 임시 해결 방법으로 다음 HTTP Service 및 Ingress 리소스를 생성할 수 있습니다.

   1. 네트워킹 및 서비스를 클릭하고 다음 예제를 사용하여 서비스 생성 을 클릭합니다.

      Copy to Clipboard Toggle word wrap

      apiVersion: v1
      kind: Service
      metadata:
        name: keycloak-http
        labels:
          app: keycloak
      spec:
        ports:
          - name: keycloak-http
            protocol: TCP
            port: 8080
            targetPort: 8080
        selector:
          app: keycloak
          component: keycloak
        type: ClusterIP
        sessionAffinity: None
      status:
        loadBalancer: {}

   2. 네트워킹을 클릭한 다음 Ingress 를 클릭하고 다음 예제를 사용하여 Ingress 생성 을 클릭합니다.

      Copy to Clipboard Toggle word wrap

      apiVersion: networking.k8s.io/v1
      kind: Ingress
      metadata:
        name: keycloak-http
        labels:
          app: keycloak
      spec:
        rules:
          - host: KEYCLOAK_HTTP_HOST
            http:
              paths:
                - path: /
                  pathType: ImplementationSpecific
                  backend:
                    service:
                      name: keycloak-http
                      port:
                        number: 8080

      호스트 값을 수정하여 Apicurio Registry 사용자에게 액세스할 수 있는 경로를 생성하고 Red Hat Single Sign-On Operator에서 생성한 HTTPS 경로 대신 사용합니다.

7. Apicurio Registry Operator 를 클릭하고 ApicurioRegistry 탭에서 다음 예제를 사용하여 ApicurioRegistry 만들기 를 클릭하고 keycloak 섹션의 값을 바꿉니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: registry.apicur.io/v1
   kind: ApicurioRegistry
   metadata:
     name: example-apicurioregistry-kafkasql-keycloak
   spec:
     configuration:
       security:
         keycloak:
           url: "http://keycloak-http-<namespace>.apps.<cluster host>"
           # ^ Required
           # Use an HTTP URL in development.
           realm: "registry"
           # apiClientId: "registry-client-api"
           # ^ Optional (default value)
           # uiClientId: "registry-client-ui"
           # ^ Optional (default value)
       persistence: 'kafkasql'
       kafkasql:
         bootstrapServers: '<my-cluster>-kafka-bootstrap.<my-namespace>.svc:9092'

프로세스

1. Red Hat Single Sign-On 관리 콘솔에서 Apicurio Registry를 위한 Red Hat Single Sign-On 영역을 생성합니다. 기본적으로 Apicurio Registry에는 레지스트리 의 영역 이름이 필요합니다. 영역 생성에 대한 자세한 내용은 Red Hat Single Sign-On 사용자 설명서를 참조하십시오.

2. Apicurio 레지스트리 API에 대한 Red Hat Single Sign-On 클라이언트를 생성합니다. 기본적으로 Apicurio Registry에는 다음과 같은 설정이 필요합니다.

   • 클라이언트 ID:registry-api
   • 클라이언트 프로토콜:openid-connect

   • 액세스 유형:베어러 전용

     다른 클라이언트 설정에 기본값을 사용할 수 있습니다.

     참고

     Red Hat Single Sign-On 서비스 계정을 사용하는 경우 전달자 전용 대신 클라이언트 액세스 유형을 기밀로 유지해야 합니다.

3. Apicurio 레지스트리 웹 콘솔용 Red Hat Single Sign-On 클라이언트를 생성합니다. 기본적으로 Apicurio Registry에는 다음과 같은 설정이 필요합니다.

   • 클라이언트 ID:apicurio-registry
   • 클라이언트 프로토콜:openid-connect
   • 액세스 유형:public
   • 유효한 리디렉션 URL:http://my-registry-url:8080/*

   • 웹 출처:+

     다른 클라이언트 설정에 기본값을 사용할 수 있습니다.

4. OpenShift의 Apicurio Registry 배포에서 다음 Apicurio Registry 환경 변수를 설정하여 Red Hat Single Sign-On을 사용하여 인증을 구성합니다.

   표 5.2. Red Hat Single Sign-On을 사용한 Apicurio 레지스트리 인증 구성

   환경 변수	설명	유형	기본
   AUTH_ENABLED	Apicurio 레지스트리에 대한 인증을 활성화합니다. true 로 설정하면 Red Hat Single Sign-On을 사용한 인증에 적용되는 환경 변수가 필요합니다.	문자열	false
   KEYCLOAK_URL	Red Hat Single Sign-On 인증 서버의 URL입니다. 예: http://localhost:8080.	문자열	-
   KEYCLOAK_REALM	인증을 위한 Red Hat Single Sign-On 영역. 예: registry.	문자열	-
   KEYCLOAK_API_CLIENT_ID	Apicurio 레지스트리 REST API의 클라이언트 ID입니다.	문자열	registry-api
   KEYCLOAK_UI_CLIENT_ID	Apicurio 레지스트리 웹 콘솔의 클라이언트 ID입니다.	문자열	apicurio-registry

   작은 정보

   OpenShift에서 환경 변수를 설정하는 예는 6.1절. “OpenShift에서 Apicurio 레지스트리 상태 점검 구성” 을 참조하십시오.

5. Red Hat Single Sign-On에서 Apicurio Registry 사용자 역할을 활성화하려면 다음 옵션을 true 로 설정합니다.

   표 5.3. Apicurio 레지스트리 역할 기반 권한 부여 구성

   환경 변수	Java 시스템 속성	유형	기본값
   ROLE_BASED_AUTHZ_ENABLED	registry.auth.role-based-authorization	부울	false

6. Apicurio Registry 사용자 역할이 활성화되면 Red Hat Single Sign-On 영역에서 다음 기본 사용자 역할 중 하나 이상에 Apicurio Registry 사용자를 할당해야 합니다.

   표 5.4. 레지스트리 인증 및 권한 부여를 위한 기본 사용자 역할

   Role	아티팩트 읽기	아티팩트 작성	글로벌 규칙	요약
   sr-admin	제공됨	제공됨	제공됨	모든 생성, 읽기, 업데이트 및 삭제 작업에 대한 전체 액세스 권한
   sr-developer	제공됨	제공됨	없음	글로벌 규칙 구성을 제외하고 생성, 읽기, 업데이트 및 삭제 작업에 대한 액세스 권한이 있어야 합니다. 이 역할은 아티팩트별 규칙을 구성할 수 있습니다.
   SR-readonly	제공됨	없음	없음	읽기 및 검색 작업만 액세스할 수 있습니다. 이 역할은 규칙을 구성할 수 없습니다.

7. Apicurio Registry의 스키마 및 API 아티팩트 업데이트에 대한 소유자 전용 권한을 활성화하려면 다음을 true 로 설정합니다.

   표 5.5. 소유자 전용 권한 부여 구성

   환경 변수	Java 시스템 속성	유형	기본값
   REGISTRY_AUTH_OBAC_ENABLED	registry.auth.owner-only-authorization	부울	false

프로세스

1. 이메일 주소 또는 GitHub 계정을 사용하여 Azure AD 포털에 로그인합니다.

2. 탐색 메뉴에서 관리 > 앱 등록 > 새 등록 을 선택하고 다음 설정을 완료합니다.In the navigation menu, select Manage > App registrations > New registration, and complete the following settings:

   • Name: 애플리케이션 이름을 입력합니다. 예: apicurio-registry-example
   • 지원되는 계정 유형: 조직 디렉터리의 계정을 클릭합니다.

   • URI 리디렉션: 목록에서 단일 페이지 애플리케이션을 선택하고 Apicurio Registry 웹 콘솔 애플리케이션 호스트를 입력합니다. 예: https://test-registry.com/ui/

     중요

     Apicurio 레지스트리 애플리케이션 호스트를 리디렉션 URI 로 등록해야 합니다. 로그인할 때 사용자는 인증을 위해 Apicurio Registry에서 Azure AD로 리디렉션되고 나중에 애플리케이션에 다시 보내려고 합니다. Azure AD는 등록되지 않은 리디렉션 URL을 허용하지 않습니다.

3. 등록을 클릭합니다. Manage > App registrations > apicurio-registry-example 을 선택하여 앱 등록 세부 정보를 볼 수 있습니다.

4. 관리 > 인증을 선택하고 애플리케이션이 다음과 같이 리디렉션 URL 및 토큰으로 구성되어 있는지 확인합니다.

   • 리디렉션 URI: 예: https://test-registry.com/ui/
   • 암시적 부여 및 하이브리드 흐름: ID 토큰을 클릭합니다(Implicit및 하이브리드 흐름에 사용됨)
5. Azure AD > Admin > App registrations > your app > Application (client) ID 를 선택합니다. 예: 123456a7-b8c9-012d-e3f4-5fg67h8i901
6. Azure AD > Admin > App registrations > your app > Directory (tenant) ID 를 선택합니다. 예: https://login.microsoftonline.com/1a2bc34d-567e-89f1-g0hi-1j2kl3m4no56/v2.0

7. Apicurio 레지스트리에서 Azure AD 설정을 사용하여 다음 환경 변수를 구성합니다.

   표 5.6. Apicurio 레지스트리의 Azure AD 설정 구성

   환경 변수	설명	설정
   KEYCLOAK_API_CLIENT_ID	Apicurio Registry REST API의 클라이언트 애플리케이션 ID	5단계에서 가져온 Azure AD 애플리케이션(클라이언트) ID입니다. 예: 123456a7-b8c9-012d-e3f4-5fg67h8i901
   REGISTRY_OIDC_UI_CLIENT_ID	Apicurio 레지스트리 웹 콘솔의 클라이언트 애플리케이션 ID입니다.	5단계에서 가져온 Azure AD 애플리케이션(클라이언트) ID입니다. 예: 123456a7-b8c9-012d-e3f4-5fg67h8i901
   REGISTRY_AUTH_URL_CONFIGURED	Azure AD의 인증을 위한 URL입니다.	6단계에서 가져온 Azure AD 애플리케이션(테넌트) ID입니다. 예: https://login.microsoftonline.com/1a2bc34d-567e-89f1-g0hi-1j2kl3m4no56/v2.0.

8. Apicurio Registry에서 Apicurio 레지스트리별 설정에 대해 다음 환경 변수를 구성합니다.

   표 5.7. Apicurio 레지스트리별 설정 구성

   환경 변수	설명	설정
   REGISTRY_AUTH_ENABLED	Apicurio 레지스트리에 대한 인증을 활성화합니다.	true
   REGISTRY_UI_AUTH_TYPE	Apicurio 레지스트리 인증 유형입니다.	OIDC
   CORS_ALLOWED_ORIGINS	CORS(Cross-origin resource sharing)를 위한 Apicurio 레지스트리 배포를 위한 호스트입니다.	예: https://test-registry.com
   REGISTRY_OIDC_UI_REDIRECT_URL	Apicurio 레지스트리 웹 콘솔의 호스트입니다.	예: https://test-registry.com/ui
   ROLE_BASED_AUTHZ_ENABLED	Apicurio Registry에서 역할 기반 인증을 활성화합니다.	true
   QUARKUS_OIDC_ROLES_ROLE_CLAIM_PATH	Azure AD가 역할을 저장하는 클레임의 이름입니다.	역할

   참고

   Apicurio 레지스트리에서 역할을 활성화하면 Azure AD에서 애플리케이션 역할과 동일한 역할을 생성해야 합니다. Apicurio Registry에서 예상되는 기본 역할은 sr-admin,sr-developer, sr-readonly 입니다.

프로세스

1. 자체 서명된 인증서를 사용하여 키 저장소를 생성합니다. 자체 인증서를 사용하는 경우 이 단계를 건너뛸 수 있습니다.

   Copy to Clipboard Toggle word wrap

   openssl req -newkey rsa:2048 -new -nodes -x509 -days 3650 -keyout tls.key -out tls.crt

2. 인증서 및 개인 키를 저장할 새 보안을 생성합니다.

   1. OpenShift 웹 콘솔의 왼쪽 탐색 메뉴에서 워크로드 > 시크릿 > Create Key/Value Secret 을 클릭합니다.
   2. 다음 값을 사용합니다.
      Name: https-cert-secret
      키 1: tls.key
      값 1: tls.key (uploaded file)
      키 2: tls.crt
      값 2: tls.crt (uploaded file)

   또는 다음 명령을 사용하여 시크릿을 생성합니다.

   Copy to Clipboard Toggle word wrap

   oc create secret generic https-cert-secret --from-file=tls.key --from-file=tls.crt

3. Apicurio Registry 배포를 위해 ApicurioRegistry CR의 spec.configuration.security.https 섹션을 편집합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   apiVersion: registry.apicur.io/v1
   kind: ApicurioRegistry
   metadata:
     name: example-apicurioregistry
   spec:
     configuration:
       # ...
       security:
         https:
           secretName: https-cert-secret

4. 연결이 작동하는지 확인합니다.

   1. SSH를 사용하여 클러스터의 Pod에 연결합니다(Apicurio 레지스트리 Pod를 사용할 수 있음).

      Copy to Clipboard Toggle word wrap

      oc rsh example-apicurioregistry-deployment-6f788db977-2wzpw

   2. 서비스 리소스에서 Apicurio 레지스트리 Pod의 클러스터 IP를 찾습니다(웹 콘솔의 위치 열 참조). 이후 테스트 요청을 실행합니다. 자체 서명된 인증서를 사용하므로 비보안 플래그가 필요합니다.

      Copy to Clipboard Toggle word wrap

      curl -k https://172.30.230.78:8443/health

프로세스

1. Apicurio Registry Operator가 생성한 HTTP 경로 외에 두 번째 경로를 추가합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   kind: Route
   apiVersion: route.openshift.io/v1
   metadata:
     [...]
     labels:
       app: example-apicurioregistry
       [...]
   spec:
     host: example-apicurioregistry-default.apps.example.com
     to:
       kind: Service
       name: example-apicurioregistry-service-9whd7
       weight: 100
     port:
       targetPort: 8080
     tls:
       termination: edge
       insecureEdgeTerminationPolicy: Redirect
     wildcardPolicy: None

   참고

   insecureEdgeTerminationPolicy: Redirect 구성 속성이 설정되어 있는지 확인합니다.

   인증서를 지정하지 않으면 OpenShift에서 기본값을 사용합니다. 또는 다음 명령을 사용하여 사용자 정의 자체 서명 인증서를 생성할 수 있습니다.

   Copy to Clipboard Toggle word wrap

   openssl genrsa 2048 > tls.key &&
   openssl req -new -x509 -nodes -sha256 -days 365 -key tls.key -out tls.crt

   그런 다음 OpenShift CLI를 사용하여 경로를 생성합니다.

   Copy to Clipboard Toggle word wrap

   oc create route edge \
     --service=example-apicurioregistry-service-9whd7 \
     --cert=tls.crt --key=tls.key \
     --hostname=example-apicurioregistry-default.apps.example.com \
     --insecure-policy=Redirect \
     -n default

프로세스

1. OpenShift Container Platform 웹 콘솔에서 클러스터 관리자 권한이 있는 계정을 사용하여 로그인합니다.
2. 설치된 Operators > Red Hat Integration - Service Registry Operator 를 클릭합니다.
3. ApicurioRegistry 탭에서 배포에 대한 Operator 사용자 정의 리소스를 클릭합니다(예: example-apicurioregistry ).
4. 기본 개요 페이지에서 Apicurio Registry 배포의 Deployment Name 섹션 및 해당 DeploymentConfig 이름을 찾습니다(예: example-apicurioregistry ).
5. 왼쪽 탐색 메뉴에서 워크로드 > 배포 구성을 클릭하고 DeploymentConfig 이름을 선택합니다.

6. 환경 탭을 클릭하고 Single values env 섹션에 환경 변수를 입력합니다. 예를 들면 다음과 같습니다.

   • NAME:LIVENESS_STATUS_RESET
   • VALUE: 350

7. 아래쪽에서 저장을 클릭합니다.

   또는 OpenShift oc 명령을 사용하여 이러한 단계를 수행할 수 있습니다. 자세한 내용은 OpenShift CLI 설명서를 참조하십시오.

프로세스

1. 이 curl 명령을 사용하여 로거 io.apicurio.registry.storage 에 대한 현재 로그 수준을 가져옵니다.

   Copy to Clipboard Toggle word wrap

   $ curl -i localhost:8080/apis/registry/v2/admin/loggers/io.apicurio.registry.storage
   HTTP/1.1 200 OK
   [...]
   Content-Type: application/json
   {"name":"io.apicurio.registry.storage","level":"INFO"}

2. 이 curl 명령을 사용하여 로거 io.apicurio.registry.storage 의 로그 수준을 DEBUG:로 변경합니다.

   Copy to Clipboard Toggle word wrap

   $ curl -X PUT -i -H "Content-Type: application/json" --data '{"level":"DEBUG"}' localhost:8080/apis/registry/v2/admin/loggers/io.apicurio.registry.storage
   HTTP/1.1 200 OK
   [...]
   Content-Type: application/json
   {"name":"io.apicurio.registry.storage","level":"DEBUG"}

3. 이 curl 명령을 사용하여 로거 io.apicurio.registry.storage 의 로그 수준을 기본값으로 되돌립니다.

   Copy to Clipboard Toggle word wrap

   $ curl -X DELETE -i localhost:8080/apis/registry/v2/admin/loggers/io.apicurio.registry.storage
   HTTP/1.1 200 OK
   [...]
   Content-Type: application/json
   {"name":"io.apicurio.registry.storage","level":"INFO"}

프로세스

1. HTTP 프로토콜을 사용할 때 다음과 같이 애플리케이션에 이벤트를 보내도록 Apicurio 레지스트리 구성을 설정합니다.

   • registry.events.sink.my-custom-consumer=http://my-app-host:8888/events

2. 필요한 경우 다음과 같이 여러 이벤트 소비자를 구성할 수 있습니다.

   • registry.events.sink.my-custom-consumer=http://my-app-host:8888/events
   • registry.events.sink.other-consumer=http://my-consumer.com/events

프로세스

1. Kafka 프로토콜을 사용할 때 다음과 같이 Kafka 주제를 설정합니다.

   • registry.events.kafka.topic=my-registry-events

2. KAFKA_BOOTSTRAP_SERVERS 환경 변수를 사용하여 Kafka 생산자에 대한 구성을 설정할 수 있습니다.

   • KAFKA_BOOTSTRAP_SERVERS=my-kafka-host:9092

     또는 registry.events.kafka.config 접두사를 사용하여 kafka 생산자의 속성을 설정할 수 있습니다(예: registry.events.kafka.config.bootstrap.servers=my-kafka-host:9092).

3. 필요한 경우 Kafka 주제 파티션을 설정하여 이벤트를 생성할 수도 있습니다.

   • registry.events.kafka.topic-partition=1