2.7. Oracle을 시스템 데이터베이스로 사용하여 Operator와 함께 3scale 설치

절차

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

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

   ALTER SYSTEM SET max_string_size=extended SCOPE=SPFILE;

3. 3scale을 사용하여 Oracle Database를 설치하기 전에 시스템 이외의 일반 사용자를 생성합니다.

   1. 일반 Oracle 데이터베이스 비 시스템 사용자의 암호는 고유해야 하며 시스템 암호와 일치하지 않아야 합니다.

   2. Oracle Database 초기화 스크립트는 다음 SQL 명령을 실행합니다.

      ALTER USER {DB_USER} IDENTIFIED BY {DB_PASSWORD}

      • 3scale 설치를 시작하기 전에 이 SQL 명령이 올바르게 실행되는지 확인합니다.
      • {DB_USER} 및 {DB_PASSWORD} 는 일반 비 시스템 사용자의 사용자 이름과 암호입니다.
      • 암호 password_REUSE_ TIME 및 PASSWORD_REUSE_ MAX 매개 변수가 동일한 암호 재사용을 제한하는 방식으로 설정되는 경우 데이터베이스 구성이 이 명령이 성공적으로 완료되지 않을 수 있습니다.

      • Oracle Database 시스템 사용자는 시스템 권한으로 명령을 실행합니다.

        • 일부는 이 GitHub 리포지토리에 자세히 설명되어 있습니다.
        • 데이터베이스에서 테이블을 초기화할 때 Oracle Database initializer에서 최신 버전을 실행할 수 있습니다. 이러한 링크에 나열되지 않은 다른 명령이 있을 수 있습니다.
      • 스키마 마이그레이션을 실행할 때 업그레이드에는 system 사용자가 필요하므로 이전 링크에 포함되지 않은 다른 명령이 실행될 수 있습니다.

절차

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

   tar -xzf 3scale-amp-openshift-templates-3scale-2.12.0-GA.tar.gz

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 소프트웨어 구성 요소에 대해 Red Hat 3scale API Management 지원 구성을 확인하십시오.

   • Oracle Instant Client 패키지: Basic 또는 Basic Light
   • Oracle Instant Client 패키지: SDK

   • Oracle Instant Client 패키지: ODBC

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

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

     표 2.4. 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 패키지 파일을 3scale-amp-openshift-templates-3scale-2.12-GA/amp/system-oracle/oracle-client-files 디렉터리에 배치합니다.

5. 레지스트리 서비스 계정 생성 에서 생성한 인증 정보를 사용하여 registry.redhat.io 계정에 로그인합니다.

   $ docker login registry.redhat.io

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

   $ docker build . --tag myregistry.example.com/system-oracle:2.12.0-1

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

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

절차

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

2. APIManager 사용자 정의 리소스를 생성하여 3scale 솔루션을 설치합니다. Operator를 사용하여 3scale 배포의 지침을 따릅니다.

   • APIManager 사용자 정의 리소스는 이전에 빌드한 시스템의 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.12.0-1"
       externalComponents:
         system:
           database: true