2.3. 템플릿 기반 설치에서 Oracle 데이터베이스로 3scale 업그레이드

이 섹션에서는 OpenShift 3.11과 함께 템플릿 기반 설치에서 Oracle 데이터베이스와 함께 3scale 시스템 이미지를 사용할 때 Red Hat 3scale API Management를 업데이트하는 방법에 대해 설명합니다.

사전 요구 사항

Oracle 데이터베이스를 사용한 3scale 설치. Oracle 데이터베이스를 사용하여 3scale 시스템 이미지 설정을 참조하십시오.

템플릿 기반 설치에서 Oracle 데이터베이스를 사용하여 3scale 시스템 이미지를 업그레이드하려면 다음 절차를 수행하십시오.

2.3.1. Oracle 19c로 3scale 업그레이드

이 절차에서는 기존 3scale 2.10 설치에서 3scale 2.11의 Oracle Database 19c 업데이트를 안내합니다.

중요: 데이터베이스에 대한 연결이 손실되면 3scale이 손상될 수 있습니다. 업그레이드를 계속하기 전에 백업을 만듭니다. 자세한 내용은 Oracle 데이터베이스 설명서를 참조하십시오. Oracle 데이터베이스 백업 및 사용자 가이드.

사전 요구 사항

절차

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

    tar -xzf 3scale-amp-openshift-templates-3scale-2.11.1-GA.tar.gz
  2. Oracle Database Instant Client Package 파일을 3scale-amp-openshift-templates-3scale-2.11.1-GA/amp/system-oracle/oracle-client-files 디렉터리에 배치합니다.
  3. oc process 명령을 -f 옵션과 함께 실행하고 build.yml OpenShift 템플릿을 지정합니다.

    $ oc process -f build.yml | oc apply -f -
  4. oc new-app 명령을 -f 옵션과 함께 실행하여 amp.yml OpenShift 템플릿을 지정하고 -p 옵션을 사용하여 OpenShift 클러스터의 도메인으로 PUTLD CARD_DOMAIN 매개 변수를 지정합니다.

    $ oc new-app -f amp.yml -p WILDCARD_DOMAIN=mydomain.com
    참고

    다음 단계는 선택 사항입니다. 설치 또는 시스템 업그레이드 후 ORACLE_SYSTEM_PASSWORD 를 제거하는 경우 사용합니다.

  5. 다음 oc patch 명령을 입력하고 SYSTEM_PASSWORD 를 Oracle 데이터베이스 준비에서 설정한 Oracle 데이터베이스 시스템 암호로 바꿉니다:

    $ oc patch dc/system-app -p '[{"op": "add", "path": "/spec/strategy/rollingParams/pre/execNewPod/env/-", "value": {"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}}]' --type=json
    
    $ oc patch dc/system-app -p '{"spec": {"strategy": {"rollingParams": {"post":{"execNewPod": {"env": [{"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}]}}}}}}'
  6. 다음 명령을 입력하여 DATABASE_URL 을 대체하여 Oracle 데이터베이스 준비에 지정된 Oracle 데이터베이스를 가리킵니다:

    $ oc patch secret/system-database -p '{"stringData": {"URL": "DATABASE_URL"}}'
  7. oc start-build 명령을 입력하여 새 시스템 이미지를 빌드합니다.

    $ oc start-build 3scale-amp-system-oracle --from-dir=.
  8. 빌드가 완료될 때까지 기다립니다. 빌드 상태를 보려면 다음 명령을 실행합니다.

    $ oc get build <build-name> -o jsonpath="{.status.phase}"
    1. 빌드가 Complete 상태가 될 때까지 기다립니다.
  9. Oracle 데이터베이스를 사용하여 3scale 시스템 이미지를 설정한 후 system-app DeploymentConfig에서 ORACLE_SYSTEM_PASSWORD 를 제거합니다. 3scale의 새 버전으로 업그레이드할 때까지 다시 수행할 필요가 없습니다.

    $ oc set env dc/system-app ORACLE_SYSTEM_PASSWORD-

추가 리소스

3scale 및 Oracle Database 지원에 대한 자세한 내용은 Red Hat 3scale API Management Supported Configurations 를 참조하십시오.