Red Hat 3scale API Management 설치

절차

1. OpenShift Container Platform 콘솔에서 관리자 권한이 있는 계정을 사용하여 로그인합니다.
2. Operators > OperatorHub를 클릭합니다.
3. 키워드로 필터링 상자에 3scale 연산자 를 입력하여 Red Hat Integration - 3scale 을 찾습니다.
4. Red Hat Integration - 3scale 을 클릭합니다. Operator에 대한 정보가 표시됩니다.
5. Operator에 대한 정보를 읽고 설치를 클릭합니다. Operator 설치 페이지가 열립니다.
6. Operator 설치 페이지의 채널 업데이트 섹션에서 업데이트할 채널을 선택합니다.

7. 설치 모드 섹션에서 Operator를 설치할 위치를 선택합니다.

   1. 클러스터의 모든 네임스페이스(기본값) - 클러스터의 모든 네임스페이스에서 Operator를 사용할 수 있습니다.
   2. 클러스터의 특정 네임스페이스 - Operator는 선택한 클러스터의 특정 단일 네임 스페이스에서만 사용할 수 있습니다.
8. 설치를 클릭합니다.
9. 설치가 완료되면 시스템에 Operator를 사용할 준비가 되었음을 나타내는 확인 메시지가 표시됩니다.

10. 3scale Operator CSV(ClusterServiceVersion)가 올바르게 설치되었는지 확인합니다. 또한 Operator 설치가 성공했는지도 확인합니다.

    • Operators > 설치된 Operators를 클릭합니다.
    • Red Hat Integration - 3scale Operator를 클릭합니다.
    • 세부 정보 탭에서 Conditions 섹션까지 아래로 스크롤합니다. 여기서 Succeeded 조건이 Reason 열에서 InstallSucceeded 되어야 합니다.

프로세스

1. OpenShift Container Platform 콘솔에서 관리자 권한이 있는 계정을 사용하여 로그인합니다.
2. Operators > OperatorHub를 클릭합니다. 설치된 Operator 페이지가 표시됩니다.
3. 이름으로 필터링 에 3scale 을 입력하여 Operator를 찾아 클릭합니다.
4. Operator 세부 정보 페이지의 작업 드롭다운 메뉴에서 Operator 설치 제거를 선택하여 특정 네임스페이스에서 제거합니다.

5. Operator 설치 제거? 대화 상자가 표시되고 다음이 표시됩니다.

   Removing the operator will not remove any of its custom resource definitions or managed resources. If your operator has deployed applications on the cluster or configured off-cluster resources, these will continue to run and need to be cleaned up manually.
   This action removes the operator as well as the Operator deployments and pods, if any. Any operands and resources managed by the operator, including CRDs and CRs, are not removed. The web console enables dashboards and navigation items for some operators. To remove these after uninstalling the operator, you might need to manually delete the operator CRDs.

   Copy to Clipboard
6. 설치 제거를 선택합니다. 이 Operator는 실행을 중지하고 더 이상 업데이트를 수신하지 않습니다.
7. OpenShift Container Platform 콘솔에서 Operator > OperatorHub를 클릭합니다.
8. 키워드로 필터링 상자에 3scale 연산자 를 입력하여 Red Hat Integration - 3scale 을 찾습니다.
9. Red Hat Integration - 3scale 을 클릭합니다. Operator에 대한 정보가 표시됩니다.
10. 설치를 클릭합니다. Operator 설치 페이지가 열립니다.
11. Operator 설치 페이지의 채널 업데이트 섹션에서 업데이트할 채널을 선택합니다.
12. 설치 모드 섹션에서 클러스터의 모든 네임스페이스(기본값)를 선택합니다. Operator는 클러스터의 모든 네임스페이스에서 사용할 수 있습니다.
13. Subscribe를 클릭합니다. 3scale Operator 세부 정보 페이지가 표시되고 서브스크립션 개요를 볼 수 있습니다.
14. 서브스크립션 업그레이드 상태가 업데이트로 표시되는지 확인합니다.
15. 3scale Operator CSV(ClusterServiceVersion)가 표시되는지 확인합니다.

프로세스

1. Operators > 설치된 Operators를 클릭합니다.

   1. 설치된 Operator 목록에서 Red Hat Integration - 3scale 을 클릭합니다.
2. API Manager 탭을 클릭합니다.
3. APIManager 생성을 클릭합니다.

4. 샘플 콘텐츠를 지우고 편집기에 다음 YAML 정의를 추가한 다음 생성 을 클릭합니다.

   • 3scale 2.8 이전에는 highAvailability 필드를 true 로 설정하여 복제본을 자동으로 추가할 수 있습니다. 3scale 2.8의 다음 예와 같이 복제본 추가는 APIManager CR의 replicas 필드를 통해 제어됩니다.

     참고

     wildcardDomain 매개변수의 값은 OCP(OpenShift Container Platform) 라우터 주소로 확인되는 유효한 도메인 이름이어야 합니다. 예를 들면 apps.mycluster.example.com 입니다.

   • 최소 요구사항이 있는 APIManager CR:

     apiVersion: apps.3scale.net/v1alpha1
     kind: APIManager
     metadata:
       name: apimanager-sample
     spec:
       wildcardDomain: example.com

     Copy to Clipboard

   • 복제본이 구성된 APIManager CR:

     apiVersion: apps.3scale.net/v1alpha1
     kind: APIManager
     metadata:
       name: apimanager-sample
     spec:
       system:
         appSpec:
           replicas: 1
         sidekiqSpec:
           replicas: 1
       zync:
         appSpec:
           replicas: 1
         queSpec:
           replicas: 1
       backend:
         cronSpec:
           replicas: 1
         listenerSpec:
           replicas: 1
         workerSpec:
           replicas: 1
       apicast:
         productionSpec:
           replicas: 1
         stagingSpec:
           replicas: 1
       wildcardDomain: example.com

     Copy to Clipboard

1. 다음 명령을 실행하여 관리 포털 인증 정보를 가져옵니다.

   $ oc get secret system-seed -n <namespace> -o json | jq -r .data.ADMIN_USER | base64 -d
   $ oc get secret system-seed -n <namespace> -o json | jq -r .data.ADMIN_PASSWORD | base64 -d

   Copy to Clipboard
   1. 관리 포털 관리자로 로그인하여 이러한 인증 정보가 작동하는지 확인합니다.

2. 다음 명령을 실행하여 마스터 관리 포털 인증 정보를 가져옵니다.

   $ oc get secret system-seed -n <namespace> -o json | jq -r .data.MASTER_USER | base64 -d
   $ oc get secret system-seed -n <namespace> -o json | jq -r .data.MASTER_PASSWORD | base64 -d

   Copy to Clipboard
   1. 마스터 관리 포털 관리자로 로그인하여 이러한 인증 정보가 작동하는지 확인합니다.

절차

1. 삽입할 사용자 지정 환경을 정의하는 Lua 코드를 작성합니다. 예를 들어 다음 env1.lua 파일은 3scale 운영자가 모든 서비스에 대해 로드하는 사용자 지정 로깅 정책을 보여줍니다.

   local cjson = require('cjson')
   local PolicyChain = require('apicast.policy_chain')
   local policy_chain = context.policy_chain
   
   local logging_policy_config = cjson.decode([[
   {
     "enable_access_logs": false,
     "custom_logging": "\"{{request}}\" to service {{service.id}} and {{service.name}}"
   }
   ]])
   
   policy_chain:insert( PolicyChain.load_policy('logging', 'builtin', logging_policy_config), 1)
   
   return {
     policy_chain = policy_chain,
     port = { metrics = 9421 },
   }

   Copy to Clipboard

2. 사용자 지정 환경을 정의하는 Lua 파일에서 시크릿을 생성합니다. 예를 들면 다음과 같습니다.

   $ oc create secret generic custom-env-1 --from-file=./env1.lua

   Copy to Clipboard

   시크릿에는 여러 사용자 지정 환경이 포함될 수 있습니다. 사용자 지정 환경을 정의하는 각 파일에 대해 -from-file 옵션을 지정합니다. Operator는 각 사용자 지정 환경을 로드합니다.

3. 방금 생성한 시크릿을 참조하는 APIManager CR(사용자 정의 리소스)을 정의합니다. 다음 예제에서는 사용자 지정 환경을 정의하는 시크릿을 참조하는 상대적 콘텐츠만 보여줍니다.

   apiVersion: apps.3scale.net/v1alpha1
   kind: APIManager
   metadata:
     name: apimanager-apicast-custom-environment
   spec:
     wildcardDomain: <desired-domain>
     apicast:
       productionSpec:
         customEnvironments:
           - secretRef:
               name: custom-env-1
       stagingSpec:
         customEnvironments:
           - secretRef:
               name: custom-env-1

   Copy to Clipboard

   APIManager CR은 사용자 정의 환경을 정의하는 여러 시크릿을 참조할 수 있습니다. Operator는 각 사용자 지정 환경을 로드합니다.

4. 사용자 지정 환경을 추가하는 APIManager CR을 생성합니다. 예를 들면 다음과 같습니다.

   $ oc apply -f apimanager.yaml

   Copy to Clipboard

절차

1. 하나의 사용자 지정 정책을 정의하는 파일에서 시크릿을 생성합니다. 예를 들면 다음과 같습니다.

   $ oc create secret generic my-first-custom-policy-secret \
    --from-file=./apicast-policy.json \
    --from-file=./init.lua \
    --from-file=./my-first-custom-policy.lua

   Copy to Clipboard

   사용자 지정 정책이 두 개 이상 있는 경우 각 사용자 지정 정책에 대한 보안을 생성합니다. 보안에는 하나의 사용자 지정 정책만 포함될 수 있습니다.

2. 3scale Operator를 사용하여 시크릿 변경 사항을 모니터링합니다. apimanager.apps.3scale.net/watched-by=apimanager 레이블을 추가하여 3scale Operator 시크릿 변경 모니터링을 시작합니다.

   $ oc label secret my-first-custom-policy-secret apimanager.apps.3scale.net/watched-by=apimanager

   Copy to Clipboard
   참고

   기본적으로 시크릿 변경은 3scale Operator에서 추적하지 않습니다. 레이블을 배치하면 3scale Operator가 시크릿을 변경할 때마다 APIcast 배포를 자동으로 업데이트합니다. 이는 시크릿이 사용 중인 스테이징 및 프로덕션 환경 모두에서 발생합니다. 3scale Operator는 어떤 방식으로든 시크릿의 소유권을 허용하지 않습니다.

3. 사용자 정의 정책이 포함된 각 보안을 참조하는 APIManager CR을 정의합니다. APIcast 스테이징 및 APIcast 프로덕션에 대해 동일한 시크릿을 지정할 수 있습니다. 다음 예제에서는 사용자 정의 정책이 포함된 보안을 참조하는 것과 관련된 콘텐츠만 보여줍니다.

   apiVersion: apps.3scale.net/v1alpha1
   kind: APIManager
   metadata:
     name: apimanager-apicast-custom-policy
   spec:
     apicast:
       stagingSpec:
         customPolicies:
           - name: my-first-custom-policy
             version: "0.1"
             secretRef:
               name: my-first-custom-policy-secret
           - name: my-second-custom-policy
             version: "0.1"
             secretRef:
               name: my-second-custom-policy-secret
       productionSpec:
         customPolicies:
           - name: my-first-custom-policy
             version: "0.1"
             secretRef:
               name: my-first-custom-policy-secret
           - name: my-second-custom-policy
             version: "0.1"
             secretRef:
               name: my-second-custom-policy-secret

   Copy to Clipboard

   APIManager CR은 다른 사용자 정의 정책을 정의하는 여러 시크릿을 참조할 수 있습니다. Operator는 각 사용자 지정 정책을 로드합니다.

4. 사용자 정의 정책이 포함된 보안을 참조하는 APIManager CR을 생성합니다. 예를 들면 다음과 같습니다.

   $ oc apply -f apimanager.yaml

   Copy to Clipboard

프로세스

1. stringData.config 에 OpenTracing 구성 세부 정보가 포함된 시크릿을 정의합니다. 이는 OpenTracing 구성 세부 정보가 포함된 속성에 대해 유일하게 유효한 값입니다. 다른 사양에서는 APIcast가 OpenTracing 구성 세부 정보를 수신하지 못하도록 합니다. 다음 예제에서는 유효한 보안 정의를 보여줍니다.

   apiVersion: v1
   kind: Secret
   metadata:
     name: myjaeger
   stringData:
     config: |-
         {
         "service_name": "apicast",
         "disabled": false,
         "sampler": {
           "type": "const",
           "param": 1
         },
         "reporter": {
           "queueSize": 100,
           "bufferFlushInterval": 10,
           "logSpans": false,
           "localAgentHostPort": "jaeger-all-in-one-inmemory-agent:6831"
         },
         "headers": {
           "jaegerDebugHeader": "debug-id",
           "jaegerBaggageHeader": "baggage",
           "TraceContextHeaderName": "uber-trace-id",
           "traceBaggageHeaderPrefix": "testctx-"
         },
         "baggage_restrictions": {
             "denyBaggageOnInitializationFailure": false,
             "hostPort": "127.0.0.1:5778",
             "refreshInterval": 60
         }
         }
   type: Opaque

   Copy to Clipboard

2. 시크릿을 생성합니다. 예를 들어 이전 시크릿 정의를 myjaeger.yaml 파일에 저장한 경우 다음 명령을 실행합니다.

   $ oc create -f myjaeger.yaml

   Copy to Clipboard

3. OpenTracing 특성을 지정하는 APIManager CR(사용자 정의 리소스)을 정의합니다. CR 정의에서 openTracing.tracingConfigSecretRef.name 속성을 OpenTracing 구성 세부 정보가 포함된 시크릿 이름으로 설정합니다. 다음 예제에서는 OpenTracing 구성을 기준으로 한 콘텐츠만 보여줍니다.

   apiVersion: apps.3scale.net/v1alpha1
   kind: APIManager
   metadata:
     name: apimanager1
   spec:
     apicast:
       stagingSpec:
         ...
         openTracing:
           enabled: true
           tracingLibrary: jaeger
           tracingConfigSecretRef:
             name: myjaeger
       productionSpec:
         ...
           openTracing:
             enabled: true
             tracingLibrary: jaeger
             tracingConfigSecretRef:
               name: myjaeger

   Copy to Clipboard

4. OpenTracing을 구성하는 APIManager CR을 생성합니다. 예를 들어 APIManager CR을 apimanager1.yaml 파일에 저장한 경우 다음 명령을 실행합니다.

   $ oc apply -f apimanager1.yaml

   Copy to Clipboard

프로세스

1. 유효한 인증서에서 보안을 생성합니다. 예를 들면 다음과 같습니다.

   $ oc create secret tls mycertsecret --cert=server.crt --key=server.key

   Copy to Clipboard

   구성은 APIManager CR(사용자 정의 리소스)에 시크릿 참조를 노출합니다. 보안을 생성한 다음 다음과 같이 APIManager CR에서 시크릿 이름을 참조합니다.

   • production: APIManager CR은 .spec.apicast.productionSpec.httpsCertificateSecretRef 필드에 인증서를 노출합니다.

   • staging: APIManager CR은 .spec.apicast.stagingSpec.httpsCertificateSecretRef 필드에 인증서를 노출합니다.

     선택적으로 다음을 구성할 수 있습니다.

   • httpsPort 는 HTTPS 연결을 수신 대기해야 하는 포트 APIcast를 나타냅니다. HTTP 포트 APIcast와 충돌하면 이 포트를 HTTPS에만 사용합니다.

   • httpsVerifyDepth 는 클라이언트 인증서 체인의 최대 길이를 정의합니다.

     참고

     APIManager CR에서 유효한 인증서 및 참조를 제공합니다. 구성이 httpsPort 에 액세스할 수 있지만 httpsCertificateSecretRef 가 아닌 경우 APIcast는 자체 서명된 인증서를 사용합니다. 이는 권장되지 않습니다.

2. Operators > 설치된 Operators를 클릭합니다.
3. 설치된 Operator 목록에서 3scale Operator를 클릭합니다.
4. API Manager 탭을 클릭합니다.
5. APIManager 생성을 클릭합니다.

6. 편집기에 다음 YAML 정의를 추가합니다.

   1. 프로덕션 환경에 사용할 수 있는 경우 다음 YAML 정의를 구성합니다.

      spec:
        apicast:
          productionSpec:
            httpsPort: 8443
            httpsVerifyDepth: 1
            httpsCertificateSecretRef:
              name: mycertsecret

      Copy to Clipboard

   2. 스테이징 을 활성화하는 경우 다음 YAML 정의를 구성합니다.

      spec:
        apicast:
          stagingSpec:
            httpsPort: 8443
            httpsVerifyDepth: 1
            httpsCertificateSecretRef:
              name: mycertsecret

      Copy to Clipboard
7. 생성을 클릭합니다.

프로세스

1. 아직 로그인하지 않은 경우 OpenShift에 로그인하고 oc 명령을 사용하여 3scale 온-프레미스 인스턴스가 설치된 프로젝트를 선택합니다.

   $ oc login -u <user> <url>
   $ oc project <3scale-project>

   Copy to Clipboard

2. oc patch 명령을 사용하여 시크릿 system-smtp 를 업데이트합니다. {"stringData":{"<field>":"<value>}} 옵션을 사용합니다. 여기서 < field >는 시크릿 필드이고 < value >는 원하는 값입니다. 사용 가능한 필드의 전체 목록은 아래 표에 나열되어 있습니다.

   표 1.4. system-smtp

   필드	설명	시크릿의 기본값	애플리케이션 mailer의 기본값
   address	원격 메일 서버의 주소입니다.	""	nil
   port	사용할 원격 메일 서버의 포트입니다.	""	0
   사용자 이름	메일 서버에 인증이 필요하고 인증 유형에 필요한 경우 사용자 이름입니다.	""	nil
   암호	메일 서버에 인증이 필요하고 인증 유형에 필요한 경우 암호입니다.	""	nil
   인증	메일 서버에 인증이 필요한 경우 를 사용합니다. 암호를 일반 으로 전송하려면 인증 유형을 설정합니다. Base64로 인코딩된 암호 Base64 또는 cram_md5 를 보내 HMAC-MD5 알고리즘을 기반으로 챌린지/응답 메커니즘을 결합합니다.	""	nil
   openssl.verify.mode	TLS를 사용하는 경우 OpenSSL이 인증서를 확인하는 방법을 설정할 수 있습니다. 이 기능은 자체 서명 및/또는 와일드카드 인증서의 유효성을 검사해야 하는 경우에 유용합니다. OpenSSL 확인 상수: none 또는 peer 의 이름을 사용할 수 있습니다.	""	nil
   from_address	no-reply mail 의 address 값	""	"no-reply@{wildcardDomain}"

   참고
   • 메일 서버 구성에 사용되는 HELO 도메인은 {wildcardDomain} 의 값입니다.
   • {wildcardDomain} 은 APIManager CR의 spec.wildcardDomain 에 설정된 값의 자리 표시자입니다.

   예

   $ oc patch secret system-smtp -p '{"stringData":{"address":"<your_address>"}}'
   $ oc patch secret system-smtp -p '{"stringData":{"port":"587"}}'
   $ oc patch secret system-smtp -p '{"stringData":{"username":"<your_username>"}}'
   $ oc patch secret system-smtp -p '{"stringData":{"password":"<your_password>"}}'
   $ oc patch secret system-smtp -p '{"stringData":{"authentication":"plain"}}'
   $ oc patch secret system-smtp -p '{"stringData":{"openssl.verify.mode":"none"}}'

   Copy to Clipboard

3. 보안 변수를 설정한 후 system-app 및 system-sidekiq Pod를 재배포합니다.

   $ oc rollout restart deployment/system-app
   $ oc rollout restart deployment/system-sidekiq

   Copy to Clipboard

4. 롤아웃 상태를 확인하여 완료되었는지 확인합니다.

   $ oc rollout status deployment/system-app
   $ oc rollout status deployment/system-sidekiq

   Copy to Clipboard

검증

1. 다음 명령을 입력하여 배포를 확인합니다.

   $ oc get dc/apicast-staging -o yaml

   Copy to Clipboard

   $ oc get dc/apicast-production -o yaml

   Copy to Clipboard

2. 환경 변수 포함을 확인합니다.

   # apicast-staging
   - name: APICAST_SERVICE_CACHE_SIZE
      value: '10'

   Copy to Clipboard

   # apicast-production
   - name: APICAST_SERVICE_CACHE_SIZE
      value: '20'

   Copy to Clipboard

프로세스

1. 새 데이터베이스를 만듭니다.

2. 다음 설정을 적용합니다.

   ALTER SYSTEM SET max_string_size=extended SCOPE=SPFILE;

   Copy to Clipboard

3. 데이터베이스 사용자 구성

   Oracle Database 통합을 3scale에서 설정하는 방법은 Oracle SYSTEM 사용자 암호를 제공하지 않거나 제공하지 않는 두 가지 옵션이 있습니다.

   3scale은 일반 사용자를 생성하고 필요한 권한을 부여하는 초기 설정에 대해서만 SYSTEM 사용자를 사용합니다. 다음 SQL 명령은 적절한 권한이 있는 일반 사용자를 설정합니다. ({DB_USER} 및 {DB_PASSWORD} 는 실제 값으로 교체해야 하는 자리 표시자입니다.

   CREATE USER {DB_USER} IDENTIFIED BY {DB_PASSWORD};
   GRANT unlimited tablespace TO {DB_USER};
   GRANT create session TO {DB_USER};
   GRANT create table TO {DB_USER};
   GRANT create view TO {DB_USER};
   GRANT create sequence TO {DB_USER};
   GRANT create trigger TO {DB_USER};
   GRANT create procedure TO {DB_USER};

   Copy to Clipboard

   1. SYSTEM 사용자 사용:

      • system-database 시크릿의 ORACLE_ SYSTEM _PASSWORD 필드에 SYSTEM 사용자 암호를 제공합니다.
      • 일반 사용자는 설치 전에 존재할 필요가 없습니다. 3scale 초기화 스크립트에 의해 생성됩니다.
      • system-database 시크릿의 URL 필드에 oracle-enhanced://{DB_USER}:{DB_PASSWORD}@{DB_HOST}:{DB_PORT}/{DB_NAME} 과 같이 연결 문자열에 원하는 사용자 이름과 암호를 입력합니다.
      • 일반 Oracle Database 비 시스템 사용자의 암호는 고유해야 하며 SYSTEM 사용자 암호와 일치하지 않아야 합니다.

      • 지정된 사용자 이름을 가진 사용자가 이미 존재하는 경우 3scale 초기화 스크립트에서 다음 명령을 사용하여 암호를 업데이트하려고 합니다.

        ALTER USER {DB_USER} IDENTIFIED BY {DB_PASSWORD}

        Copy to Clipboard

        데이터베이스 구성으로 인해 동일한 암호 재사용을 제한하는 방식으로 PASSWORD_REUSE_TIME 및 PASSWORD_REUSE_MAX 매개변수가 설정된 경우 이 명령이 성공적으로 완료되지 않을 수 있습니다.

   2. 일반 데이터베이스 사용자의 수동 설정:

      • system-database 시크릿에 ORACLE_SYSTEM_PASSWORD 를 제공할 필요가 없습니다.
      • 3scale 설치 전에 system-database 시크릿의 URL 필드에 있는 연결 문자열에 지정된 일반 데이터베이스 사용자( SYSTEM)가 있어야 합니다.
      • 설치에 사용되는 일반 사용자에게는 위에 나열된 모든 권한이 있어야 합니다.

프로세스

1. GitHub 리포지토리에서 3scale OpenShift 템플릿을 다운로드하고 아카이브를 추출합니다.

   curl -L -o system-oracle-3scale-2.15.0-GA.tar.gz https://github.com/3scale/system-oracle/archive/refs/tags/3scale-2.15.0-GA.tar.gz
   tar -xzf system-oracle-3scale-2.15.0-GA.tar.gz

   Copy to Clipboard

2. Instant Client 다운로드 페이지에서 다음을 다운로드합니다.

   • 클라이언트: 이 값은 basic-lite 또는 basic 중 하나일 수 있습니다.
   • ODBC driver.

   • Oracle Database 19c용 SDK

     • 3scale의 경우 Linux x86-64용 Instant Client Downloads(64비트)를 사용하십시오.
     • ppc64le 및 3scale의 경우 Power Little Endian (64 비트)에서 Linux용 Oracle Instant Client 다운로드를 사용하십시오.

3. 다음 Oracle 소프트웨어 구성 요소 버전에 대한 표를 확인하십시오.

   • Oracle Instant Client Package: Basic 또는 Basic Light
   • Oracle Instant Client Package: SDK

   • Oracle Instant Client Package: ODBC

     표 1.6. Oracle 19c 예제 3scale 패키지

     Oracle 19c 패키지 이름	압축 파일 이름
     Basic	instantclient-basic-linux.x64-19.18.0.0.0dbru.zip
     Basic Light	instantclient-basiclite-linux.x64-19.18.0.0.0dbru.zip
     SDK	instantclient-sdk-linux.x64-19.18.0.0.0dbru.zip
     ODBC	instantclient-odbc-linux.x64-19.18.0.0.0dbru.zip

     표 1.7. ppc64le 및 3scale의 Oracle 19c 예제 패키지

     Oracle 19c 패키지 이름	압축 파일 이름
     Basic	instantclient-basic-linux.leppc64.c64-19.3.0.0.0dbru.zip
     Basic Light	instantclient-basiclite-linux.leppc64.c64-19.3.0.0.0dbru.zip
     SDK	instantclient-sdk-linux.leppc64.c64-19.3.0.0.0dbru.zip
     ODBC	instantclient-odbc-linux.leppc64.c64-19.3.0.0.0dbru.zip

   참고

   로컬로 다운로드 및 저장된 클라이언트 패키지 버전이 3scale과 일치하지 않는 경우 3scale은 다음 단계에서 적절한 버전을 자동으로 다운로드하여 사용합니다.

4. Oracle Database Instant Client 패키지 파일을 system-oracle-3scale-2.15.0-GA/oracle-client-files 디렉터리에 배치합니다.

5. 사용자 지정 시스템 Oracle 기반 이미지를 빌드합니다. 이미지 태그는 다음 예와 같이 고정된 이미지 태그여야 합니다.

   $ cd system-oracle-3scale-2.15.0-GA
   $ docker build . --tag myregistry.example.com/system-oracle:2.15.0-1

   Copy to Clipboard

6. 시스템 Oracle 기반 이미지를 OCP 클러스터에서 액세스할 수 있는 컨테이너 레지스트리로 푸시합니다. 이 컨테이너 레지스트리는 3scale 솔루션을 설치할 위치입니다.

   $ docker push myregistry.example.com/system-oracle:2.15.0-1

   Copy to Clipboard

프로세스

1. 해당 필드에 system-database 시크릿을 생성하여 Oracle Database URL 연결 문자열 및 Oracle Database 시스템 암호를 설정합니다. Oracle Database의 외부 데이터베이스 설치를 참조하십시오.

2. APIManager CR을 생성하여 3scale 솔루션을 설치합니다. Operator를 사용하여 3scale API Management 배포의 지침을 따르십시오.

   • APIManager CR은 이전에 빌드한 시스템의 Oracle 기반 이미지로 설정된 .spec.system.image 필드를 지정해야 합니다.

     apiVersion: apps.3scale.net/v1alpha1
     kind: APIManager
     metadata:
       name: example-apimanager
     spec:
       imagePullSecrets:
       - name: threescale-registry-auth
       - name: custom-registry-auth
       system:
         image: "myregistry.example.com/system-oracle:2.15.0-1"
       externalComponents:
         system:
           database: true

     Copy to Clipboard

절차

1. oc get pvc 명령을 사용하여 오류가 있는 MySQL 데이터가 포함된 PVC를 찾습니다.

   # oc get pvc
   NAME                    STATUS    VOLUME    CAPACITY   ACCESSMODES   AGE
   backend-redis-storage   Bound     vol003    100Gi      RWO,RWX       4d
   mysql-storage           Bound     vol006    100Gi      RWO,RWX       4d
   system-redis-storage    Bound     vol008    100Gi      RWO,RWX       4d
   system-storage          Bound     vol004    100Gi      RWO,RWX       4d

   Copy to Clipboard
2. OCP(OpenShift Container Platform) 콘솔에서 cancel deployment 를 클릭하여 system-mysql pod의 배포를 중지합니다.
3. MySQL 경로 아래의 모든 항목을 삭제하여 볼륨을 정리합니다.
4. 새 system-mysql 배포를 시작합니다.

절차

1. 영구 볼륨에 사용되는 디렉터리에는 root 그룹에 대한 쓰기 권한이 있어야 합니다. MySQL 서비스가 root 그룹에서 다른 사용자로 실행되므로 root 사용자에 대한 읽기-쓰기 권한이 있는 것만으로는 충분하지 않습니다. root 사용자로 다음 명령을 실행합니다.

   $ chmod -R g+w /path/for/pvs

   Copy to Clipboard

2. SElinux가 액세스를 차단하지 못하도록 다음 명령을 실행합니다.

   $ chcon -Rt svirt_sandbox_file_t /path/for/pvs

   Copy to Clipboard

절차

1. [ your_product_name] > Integration > Configuration으로 이동하여 APIcast 구성을 스테이징으로 승격합니다.

2. APIcast Configuration에서 제품에 추가된 각 백엔드의 매핑 규칙을 확인할 수 있습니다. promote v.[n] to Staging APIcast 를 클릭합니다.

   • v.[n] 은 승격할 버전 번호를 나타냅니다.

3. 스테이징으로 승격되면 프로덕션으로 승격할 수 있습니다. Staging APIcast에서 promote v.[n] to Production APIcast를 클릭합니다.

   • v.[n] 은 승격할 버전 번호를 나타냅니다.

4. 명령줄에서 API에 대한 요청을 테스트하려면 테스트에 대해 예제 curl에 제공된 명령을 사용합니다.

   • curl 명령 예제는 제품의 첫 번째 매핑 규칙을 기반으로 합니다.

프로세스

1. 아래 필드를 사용하여 backend-redis 및 system-redis 시크릿을 생성합니다.

   backend-redis

   REDIS_QUEUES_SENTINEL_HOSTS
   REDIS_QUEUES_SENTINEL_ROLE
   REDIS_QUEUES_URL
   REDIS_STORAGE_SENTINEL_HOSTS
   REDIS_STORAGE_SENTINEL_ROLE
   REDIS_STORAGE_URL

   Copy to Clipboard

   system-redis

   NAMESPACE
   SENTINEL_HOSTS
   SENTINEL_ROLE
   URL

   Copy to Clipboard

   • sentinels를 사용하여 Redis에 대해 구성할 때 backend-redis 및 system-redis 의 해당 URL 필드는 redis://[:redis-password@]redis-group[/db] 형식의 Redis 그룹을 나타냅니다. 여기서 [x]는 선택적 요소 x이며, redis-password, redis-group, db 변수를 적절하게 대체합니다.

     예제

     redis://:redispwd@mymaster/5

     Copy to Clipboard

   • SENTINEL_HOSTS 필드는 다음 형식의 sentinel 연결 문자열을 쉼표로 구분한 목록입니다.

     redis://:sentinel-password@sentinel-hostname-or-ip:port

     Copy to Clipboard

     • 목록의 각 요소에 대해 [x]는 선택적 요소 x 및 sentinel-password,sentinel-hostname-or-ip 를 나타내며, port 는 그에 따라 교체할 변수입니다.

       예제

       :sentinelpwd@123.45.67.009:2711,:sentinelpwd@other-sentinel:2722

       Copy to Clipboard

   • SENTINEL_ROLE 필드는 master 또는 slave 입니다.

2. Operator를 사용하여 3scale API Management 배포에 표시된 대로 3scale을 배포합니다.

   1. 이미 존재하는 backend-redis 및 system-redis로 인한 오류를 무시합니다.

1. HA용 3scale API Management의 새로운 설치 배포와 같이 모든 필드를 사용하여 backend-redis 및 system-redis 시크릿을 편집합니다.

2. 백엔드 pod에 대해 다음 backend-redis 환경 변수가 정의되어 있는지 확인합니다.

   name: BACKEND_REDIS_SENTINEL_HOSTS
     valueFrom:
       secretKeyRef:
         key: REDIS_STORAGE_SENTINEL_HOSTS
         name: backend-redis
   name: BACKEND_REDIS_SENTINEL_ROLE
     valueFrom:
       secretKeyRef:
         key: REDIS_STORAGE_SENTINEL_ROLE
         name: backend-redis

   Copy to Clipboard

3. 다음 system-redis 환경 변수가 system-(app|sidekiq) Pod에 대해 정의되어 있는지 확인합니다.

   name: REDIS_SENTINEL_HOSTS
     valueFrom:
       secretKeyRef:
         key: SENTINEL_HOSTS
         name: system-redis
   name: REDIS_SENTINEL_ROLE
     valueFrom:
       secretKeyRef:
         key: SENTINEL_ROLE
         name: system-redis

   Copy to Clipboard
4. 계속 link:h:Link3scaleMigrating3scale: 템플릿을 사용하여 3scale 업그레이드 를 위한 지침을 진행합니다.