6단계: 하이브리드 런타임 구성

구성 재정의 지정

Apigee Hybrid 설치 프로그램은 많은 설정에 기본값을 사용합니다. 하지만 기본값이 없는 몇 가지 설정이 있습니다. 다음에 설명된 대로 이 설정에 값을 제공해야 합니다.

1. 현재 위치가 hybrid-base-directory/hybrid-files/overrides/ 디렉터리인지 확인합니다.

   cd hybrid-base-directory/hybrid-files/overrides

2. 즐겨 찾는 텍스트 편집기에서 overrides.yaml라는 새 파일을 만듭니다. 예를 들면 다음과 같습니다.

   vi overrides.yaml

   overrides.yaml은 고유 Apigee Hybrid 설치에 대한 구성을 제공합니다. 이 단계의 재정의 파일은 첫 번째 설치에 적합한 소규모 하이브리드 런타임 설치를 위한 기본 구성을 제공합니다.

3. overrides.yaml에서 아래 표시된 필요한 속성 값을 추가합니다. 각 속성에 대한 자세한 설명은 다음과 같습니다.

   구문

   overrides.yaml 파일에 다음 구조와 문법이 있는지 확인합니다. red, bold italics의 값은 제공해야 하는 속성 값이며, 다음 표에 설명되어 있습니다.

   Google Cloud 프로젝트 리전과 Kubernetes 클러스터 리전에 대한 플랫폼은 서로 다릅니다. Apigee Hybrid를 설치할 플랫폼을 선택합니다.

   gcp:
     region: analytics-region
     projectID: gcp-project-id
   
   k8sCluster:
     name: cluster-name
     region: analytics-region # Must be the closest Google Cloud region to your cluster
   org: org-name
   
   instanceID: "unique-instance-identifier"
   
   cassandra:
     hostNetwork: false #Set this to `true` for GKE On-prem installations.
   
   virtualhosts:
     - name: environment-group-name
       sslCertPath: ./certs/cert-name.pem
       sslKeyPath: ./certs/key-name.key
   
   envs:
     - name: environment-name
       serviceAccountPaths:
         synchronizer: ./service-accounts/synchronizer-service-account-name.json
         udca: ./service-accounts/udca-service-account-name.json
   
   mart:
     serviceAccountPath: ./service-accounts/mart-service-account-name.json
   
   connectAgent:
     serviceAccountPath: ./service-accounts/mart-service-account-name.json
     # Same account used for mart and connectAgent
   
   metrics:
     serviceAccountPath: ./service-accounts/metrics-service-account-name.json
   
   watcher:
     serviceAccountPath: ./service-accounts/watcher-service-account-name.json
   
   logger:
     enabled: true # set to "false" for GKE.
     serviceAccountPath: ./service-accounts/logger-service-account-name.json
   

   예

   다음 예시에서는 예시 속성 값이 추가된, 완료된 재정의 파일을 보여줍니다.

   gcp:
     region: us-central1
     projectID: hybrid-example
   
   k8sCluster:
     name: apigee-hybrid
     region: us-central1
   
   org: hybrid-example
   
   instanceID: "my_hybrid_example"
   
   cassandra:
     hostNetwork: false # Set this to:
                        #   false for GKE installations.
                        #   true for GKE On-prem GKE on AWS, Anthos on bare metal,
                        #            AKS, EKS, and OpenShift installations.
   
   virtualhosts:
     - name: example-env-group
       sslCertPath: ./certs/keystore.pem
       sslKeyPath: ./certs/keystore.key
   
   envs:
     - name: test
       serviceAccountPaths:
         synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
         udca: ./service-accounts/hybrid-project-apigee-udca.json
   
   mart:
     serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json
   
   connectAgent:
     serviceAccountPath: ./service-accounts/example-hybrid-apigee-mart.json
   
   metrics:
     serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json
   
   watcher:
     serviceAccountPath: ./service-accounts/hybrid-project-apigee-watcher.json
   
   logger:
     enabled: true # set to "false" for GKE.
     serviceAccountPath: ./service-accounts/logger-service-account-name.json
   
   

4. 완료되면 파일을 저장합니다.

다음 표에서는 재정의 파일에 제공해야 하는 각 속성 값을 설명합니다. 자세한 내용은 구성 속성 참조를 참조하세요.

sslCertPath: ./certs/keystore.pem
sslKeyPath: ./certs/keystore.key

ls ../service-accounts/

요약

구성 파일은 하이브리드 구성요소를 클러스터에 배포하는 방법을 Kubernetes에 지정합니다. 다음으로 클러스터에 이 구성을 적용합니다.