Red Hat 3scale API Management 마이그레이션


Red Hat 3scale API Management 2.15

3scale API Management 및 해당 구성 요소를 마이그레이션 또는 업그레이드

Red Hat Customer Content Services

초록

Red Hat 3scale API Management를 3scale Operator를 통해 최신 버전으로 업그레이드하고 Operator 기반 배포에서 APIcast를 업그레이드하는 정보도 찾습니다.

머리말

이 가이드에서는 Red Hat 3scale API Management를 3scale Operator를 통해 최신 버전으로 업그레이드하는 데 필요한 정보를 제공합니다. 3scale 설치를 2.14에서 2.15로 업그레이드하는 데 필요한 세부 정보와 Operator 기반 배포에서 APIcast를 업그레이드하는 단계가 있습니다.

3scale 온-프레미스 배포를 업그레이드하려면 다음 가이드를 참조하십시오.

Operator 기반 배포에서 APIcast를 업그레이드하려면 다음 가이드를 참조하십시오.

Red Hat 문서에 관한 피드백 제공

문서 개선을 위한 의견에 감사드립니다.

개선 사항을 제안하려면 Jira 문제를 열고 제안된 변경 사항을 설명합니다. 귀하의 요청을 신속하게 처리할 수 있도록 가능한 한 자세한 정보를 제공하십시오.

사전 요구 사항

  • Red Hat 고객 포털 계정이 있어야 합니다. 이 계정을 사용하면 Red Hat Jira Software 인스턴스에 로그인할 수 있습니다. 계정이 없는 경우 계정을 생성하라는 메시지가 표시됩니다.

프로세스

  1. 다음 링크를 클릭합니다. 문제 생성.
  2. 요약 텍스트 상자에 문제에 대한 간략한 설명을 입력합니다.
  3. 설명 텍스트 상자에 다음 정보를 입력합니다.

    • 문제를 발견한 페이지의 URL입니다.
    • 문제에 대한 자세한 설명입니다.
      다른 필드에 있는 정보는 기본값에 따라 그대로 둘 수 있습니다.
  4. 생성 을 클릭하여 Jira 문제를 문서 팀에 제출합니다.

피드백을 제공하기 위해 시간을 내어 주셔서 감사합니다.

1장. 3scale API Management Operator 기반 업그레이드 가이드: 2.14에서 2.15로

Operator 기반 설치에서 Red Hat 3scale API Management를 버전 2.14에서 2.15로 업그레이드하여 OpenShift 4.x에서 3scale을 관리합니다.

3scale의 마이크로 출시를 자동으로 얻으려면 자동 업데이트가 있는지 확인하십시오. Oracle 외부 데이터베이스를 사용하는 경우 자동 업데이트를 설정하지 마십시오. 이를 확인하려면 마이크로 릴리스의 자동화된 애플리케이션 구성을 참조하십시오.

중요

필요한 조건 및 절차를 이해하려면 나열된 단계를 적용하기 전에 전체 업그레이드 가이드를 읽으십시오. 업그레이드 프로세스에서 절차가 완료될 때까지 서비스 프로비저닝을 중단합니다. 이러한 중단으로 인해 유지 관리 기간이 있는지 확인하십시오.

1.1. 업그레이드를 수행하기 위한 사전 요구 사항

중요

3scale Operator를 사용하여 인증서 확인 실패를 해결하려면 주석을 추가하여 영향을 받는 사용자 정의 리소스(CR)에 인증서 확인을 건너뜁니다. 이 주석은 생성 중에 CR에 적용하거나 기존 CR에 추가할 수 있습니다. 적용되면 오류가 조정됩니다.

이 섹션에서는 Operator 기반 설치에서 3scale을 2.14에서 2.15로 업그레이드하는 데 필요한 구성에 대해 설명합니다.

  • 관리자 액세스 권한이 있는 OpenShift Container Platform (OCP) 4.12, 4.13, 4.14, 4.15, 4.16 또는 4.17 클러스터입니다. OCP 환경이 3scale 업데이트를 진행하기 위한 최소 요구 사항인 4.12 이상으로 업그레이드되었는지 확인합니다.
  • 3scale 2.14는 이전에 3scale Operator를 통해 배포되었습니다.
  • 3scale-2.14 채널의 최신 CSV가 사용 중인지 확인합니다. 이를 확인하려면 다음을 수행하십시오.

    • 서브스크립션에 대한 승인 설정이 자동 인 경우 이미 채널의 최신 CSV 버전에 있어야 합니다.
    • 서브스크립션 승인 설정이 수동 인 경우 보류 중인 모든 InstallPlan 을 승인하고 최신 CSV 버전이 있는지 확인합니다.
    • 보류 중인 설치 계획이 있는 경우 기존 보류 중인 계획이 설치된 후에만 표시되는 보류 중인 설치 계획이 더 표시될 수 있습니다.

1.1.1. 3scale API Management 2.15 pre-flight 검사

중요
  • 데이터베이스가 업그레이드되지 않으면 3scale 인스턴스가 2.15로 업그레이드되지 않습니다.
  • 3scale 2.15 Operator를 실행하거나 실행하지 않고 데이터베이스를 업그레이드할 수 있습니다. Operator가 실행 중인 경우 10분마다 데이터베이스 버전을 확인하고 업그레이드 프로세스를 자동으로 트리거합니다. 업그레이드 중에 Operator가 실행되지 않은 경우 다시 확장합니다. 요구 사항을 확인하고 설치를 계속하려면 이 작업을 수행해야 합니다.

Operator를 통해 3scale 2.15를 설치하기 전에 데이터베이스 구성 요소가 필요한 최소 버전을 충족하는지 확인합니다. 이 사전 진행 중 업그레이드 중에 3scale 인스턴스가 손상되지 않도록 하는 것이 중요합니다.

1.1.1.1. 구성 요소 및 최소 버전 요구 사항
참고
  • Oracle Database가 확인되지 않았습니다.
  • Oracle이 있는 시스템 데이터베이스는 확인되지 않습니다.
  • 외부 데이터베이스가 있는 zync는 확인되지 않습니다.

다음 구성 요소가 지정된 버전 이상인지 확인합니다.

system-app 구성 요소:

  • MySQL: 8.0.0
  • PostgreSQL: 10.0.0

백엔드 구성 요소:

  • Redis: 6.2(필요한 두 개의 인스턴스)

버전 확인

  • MySQL 버전을 확인합니다.

    $ mysql --version
    Copy to Clipboard Toggle word wrap
  • PostgreSQL 버전 확인:

    $ psql --version
    Copy to Clipboard Toggle word wrap
  • Redis 버전을 확인합니다.

    $ redis-server --version
    Copy to Clipboard Toggle word wrap
1.1.1.2. 요구 사항을 충족하지 않는 데이터베이스 업그레이드

데이터베이스 버전이 최소 요구 사항을 충족하지 않는 경우 다음 단계를 따르십시오.

  1. 3scale 2.15 Operator를 설치합니다.

    • 2.15 Operator는 데이터베이스 버전과 관계없이 설치됩니다.
  2. 데이터베이스 업그레이드:

    • 필요한 최소 버전을 충족하기 위해 MySQL, PostgreSQL 또는 Redis를 업그레이드합니다.
    • 참고: 각 데이터베이스의 업그레이드 절차에 대한 공식 문서를 따르십시오.
  3. 2.15 업그레이드 다시 시작:

    • 데이터베이스가 업그레이드되면 3scale 2.15 Operator에서 새 버전을 감지합니다.
    • 3scale 2.15의 업그레이드 프로세스는 자동으로 진행됩니다.

이러한 사전 진행 상태를 확인하고 데이터베이스 구성 요소가 최신 상태인지 확인하면 3scale 2.15로 전환할 수 있습니다.

1.2. Operator 기반 설치에서 2.14에서 2.15로 업그레이드

Operator 기반 배포에서 버전 2.14에서 2.15로 3scale을 업그레이드하려면 다음을 수행합니다.

  1. 관리자 권한이 있는 계정을 사용하여 OCP 콘솔에 로그인합니다.
  2. 3scale-operator 가 배포된 프로젝트를 선택합니다.
  3. Operators > 설치된 Operators를 클릭합니다.
  4. Red Hat Integration - 3scale > Subscription > Channel 을 선택합니다.
  5. 3scale-2.15 를 선택하고 변경 사항을 저장하여 서브스크립션 채널을 편집합니다.

    그러면 업그레이드 프로세스가 시작됩니다.

  6. 새 버전이 모두 실행되고 오류 없이 준비가 될 때까지 프로젝트에서 Pod의 상태를 쿼리합니다.

    $ oc get pods -n <3scale_namespace>
    Copy to Clipboard Toggle word wrap
    참고
    • Pod에 업그레이드 프로세스 중에 일시적인 오류가 있을 수 있습니다.
    • Pod 업그레이드에 필요한 시간은 5-10분에 따라 다를 수 있습니다.
  7. 새 포드 버전이 실행된 후 3scale 관리 포털에 로그인하고 예상대로 작동하는지 확인하여 업그레이드를 성공적으로 확인합니다.
  8. 다음 명령을 실행하여 APIManager 오브젝트의 상태를 확인하고 YAML 콘텐츠를 가져옵니다. <myapimanager>는 APIManager 의 이름을 나타냅니다.

    $ oc get apimanager <myapimanager> -n <3scale_namespace> -o yaml
    Copy to Clipboard Toggle word wrap
    • 값이 포함된 새 주석은 다음과 같아야 합니다.

      apps.3scale.net/apimanager-threescale-version: "2.15"
      apps.3scale.net/threescale-operator-version: "0.12.x"
      Copy to Clipboard Toggle word wrap

모든 단계를 수행한 후 Operator 기반 배포에서 3scale 업그레이드를 2.14에서 2.15로 업그레이드합니다.

다음 절차에 따라 외부 Oracle 데이터베이스를 사용하여 3scale Operator 기반 설치를 업데이트합니다.

프로세스

  1. Red Hat 3scale API Management 설치 가이드 의 다음 단계에 따라 새로운 system-oracle-3scale-2.14.0-1 이미지를 생성합니다.
  2. link:h:Link3scaleMigrating3scale: operator 기반 설치에서 2.14에서 2.15로 업그레이드하여 3scale Operator를 업그레이드합니다.
  3. 업그레이드가 완료되면 Operator를 사용하여 3scale API Management 설치에 설명된 대로 이 절차의 첫 번째 단계에서 생성된 새 이미지로 APIManager 사용자 정의 리소스를 업데이트합니다.

2장. APIcast Operator 기반 업그레이드 가이드: 2.14에서 2.15로

Operator 기반 설치에서 APIcast를 2.14에서 2.15로 업그레이드하면 APIcast API 게이트웨이를 사용하여 내부 및 외부 API(애플리케이션 프로그래밍 인터페이스) 서비스를 3scale과 통합할 수 있습니다.

중요

필요한 조건 및 절차를 이해하려면 나열된 단계를 적용하기 전에 전체 업그레이드 가이드를 읽으십시오. 업그레이드 프로세스에서 절차가 완료될 때까지 서비스 프로비저닝을 중단합니다. 이러한 중단으로 인해 유지 관리 기간이 있는지 확인하십시오.

2.1. 업그레이드를 수행하기 위한 사전 요구 사항

Operator 기반 설치에서 APIcast를 2.14에서 2.15로 업그레이드하려면 다음과 같은 필수 사전 요구 사항이 이미 있어야 합니다.

  • 관리자 액세스 권한이 있는 OpenShift Container Platform (OCP) 4.12, 4.13, 4.14, 4.15, 4.16 또는 4.17 클러스터입니다. OCP 환경이 APIcast 업데이트를 진행하기 위한 최소 요구 사항인 4.12 이상으로 업그레이드되었는지 확인합니다.
  • APIcast 2.14는 이전에 APIcast Operator를 통해 배포되었습니다.
  • 3scale-2.14 채널의 최신 CSV가 사용 중인지 확인합니다. 이를 확인하려면 다음을 수행하십시오.

    • 서브스크립션에 대한 승인 설정이 자동 인 경우 이미 채널의 최신 CSV 버전에 있어야 합니다.
    • 서브스크립션 승인 설정이 수동 인 경우 보류 중인 모든 InstallPlan 을 승인하고 최신 CSV 버전이 있는지 확인합니다.
    • 보류 중인 설치 계획이 있는 경우 기존 보류 중인 계획이 설치된 후에만 표시되는 보류 중인 설치 계획이 더 표시될 수 있습니다.

2.2. Operator 기반 설치에서 APIcast를 2.14에서 2.15로 업그레이드

APIcast가 3scale 설치에서 API 게이트웨이로 작동하도록 Operator 기반 설치의 2.14에서 2.15로 APIcast를 업그레이드합니다.

프로세스

  1. 관리자 권한이 있는 계정을 사용하여 OCP 콘솔에 로그인합니다.
  2. APIcast Operator 가 배포된 프로젝트를 선택합니다.
  3. Operators > 설치된 Operators를 클릭합니다.
  4. 서브스크립션 > 채널에서 Red Hat Integration - 3scale APIcast 게이트웨이를 선택합니다.
  5. 3scale-2.15 채널을 선택하고 변경 사항을 저장하여 서브스크립션 채널을 편집합니다.

    그러면 업그레이드 프로세스가 시작됩니다.

  6. 새 버전이 모두 실행되고 오류 없이 준비 상태가 표시될 때까지 프로젝트에서 Pod 상태를 쿼리합니다.

    $ oc get pods -n <apicast_namespace>
    Copy to Clipboard Toggle word wrap
    참고
    • Pod에 업그레이드 프로세스 중에 일시적인 오류가 있을 수 있습니다.
    • Pod 업그레이드에 필요한 시간은 5-10분에 따라 다를 수 있습니다.
  7. 다음 명령을 실행하여 APIcast 오브젝트의 상태를 확인하고 YAML 콘텐츠를 가져옵니다.

    $ oc get apicast <myapicast> -n <apicast_namespace> -o yaml
    Copy to Clipboard Toggle word wrap
    • 값이 포함된 새 주석은 다음과 같아야 합니다.

      apicast.apps.3scale.net/operator-version: "0.12.x"
      Copy to Clipboard Toggle word wrap

모든 단계를 수행한 후 Operator 기반 배포에서 APIcast 업그레이드가 2.14에서 2.15로 업그레이드됩니다.

중요
  • system.appSpec.replicas1 로 스케일링하기 전에 데이터베이스를 지원되는 버전 (현재 PostgreSQL 13)으로 업그레이드해야 합니다. Red Hat 3scale API Management 지원 구성참조
  • 이 문서는 포함된 PostgreSQL 10 데이터베이스에서 외부 PostgreSQL 10 데이터베이스로의 마이그레이션에 관한 것입니다. 외부 PostgreSQL 10 데이터베이스에서 외부 PostgreSQL 13 데이터베이스로 업그레이드하려면 공식 PostgreSQL 문서를 따라야 합니다.
  • 면책 조항: 외부 웹사이트(s)에 포함된 링크는 편의를 위해서만 제공됩니다. Red Hat은 링크를 검토하지 않았으며 컨텐츠 또는 이용 가능 여부에 대해 책임을 지지 않습니다. 외부 웹 사이트에 대한 링크가 포함되어 있다고 해서 Red Hat이 해당 웹 사이트 또는 해당 엔티티, 제품, 서비스를 보증한다는 의미는 아닙니다. 사용자는 본인이 그러한 외부 사이트나 콘텐츠를 사용(또는 신뢰)하여 초래되는 어떠한 손실이나 비용에 대해 Red Hat이 어떠한 책임도 지지 않는 데 동의합니다.

포함된 PostgreSQL 데이터베이스에서 및 외부 PostgreSQL 데이터베이스로 이동하는 프로세스는 동일한 DB 버전에서 수행해야 합니다. 이 마이그레이션 가이드에서는 PostgreSQL 10이어야 합니다. 프로덕션 환경에 외부 데이터베이스를 사용해야 합니다.

PostgreSQL을 system-database 로 사용하는 경우 3scale과 함께 외부 데이터베이스 설치에 지원되는 버전을 사용합니다.

중요
  • 이러한 단계는 일반적인 지침입니다. 정확한 단계는 운영 체제, PostgreSQL 버전 및 데이터베이스의 특정 요구 사항에 따라 다를 수 있습니다.
  • 업그레이드하기 전에 PostgreSQL 문서 및 릴리스 노트를 주의 깊게 읽으십시오.
  • 프로덕션 배포에 적용하기 전에 프로덕션 환경 이외의 환경에서 이 절차를 테스트합니다.
  • 이 프로세스는 절차가 완료될 때까지 서비스 프로비저닝을 중단합니다. 이러한 중단으로 인해 유지 관리 기간이 있는지 확인하십시오.

프로세스

  1. APIManager CR(고객 리소스)을 사용하여 system-app DeploymentConfig(DC)를 축소합니다.

    apiVersion: apps.3scale.net/v1alpha1
    kind: APIManager
    metadata:
      name: <apimanager_sample>
    spec:
      system:
        appSpec:
          replicas: 0
      wildcardDomain: <example.com>
    Copy to Clipboard Toggle word wrap
  2. Pod가 축소되었는지 확인합니다.

    $ oc get deploymentconfig system-app -o jsonpath='{.status.availableReplicas}{"\n"}'
    0
    Copy to Clipboard Toggle word wrap
    1. PostgreSQL 마이그레이션을 진행하기 전에 모든 3scale Pod의 상태가 Terminated 상태가 될 때까지 기다립니다.
  3. 모든 데이터, 구성 및 사용자 계정을 포함하여 기존 PostgreSQL 데이터베이스를 백업합니다.

    $ DB_USER=$(oc get secret system-database -o jsonpath="{.data.DB_USER}" | base64 --decode)
    $ DATABASE_NAME=$(oc get secret system-database -o jsonpath="{.data.URL}" | base64 --decode | cut -d '/' -f4)
    Copy to Clipboard Toggle word wrap
    중요

    stdout 으로 파이프하지 마십시오. 바이너리 파일이 손상됩니다.

  4. 사용자 지정 형식의 덤프:

    $ oc rsh $(oc get pods -l 'deploymentConfig=system-postgresql' -o json | jq -r '.items[0].metadata.name') bash -c "pg_dump -U $DB_USER -F c $DATABASE_NAME -f /tmp/<backupfilename>.backup"
    Copy to Clipboard Toggle word wrap
  5. 백업을 다운로드합니다.

    $ oc cp $(oc get pods -l 'deploymentConfig=system-postgresql' -o json | jq -r '.items[0].metadata.name'):/tmp/<backupfilename>.backup <backupfilename>.backup
    Copy to Clipboard Toggle word wrap
  6. 대상 외부 시스템의 3scale에 배포한 것과 동일한 PostgreSQL 10 버전을 설치합니다. 설치 지침에 따라 PostgreSQL 웹 사이트에서 설치 패키지를 다운로드합니다.
  7. 모든 데이터, 구성 및 사용자 계정을 포함하여 기존 PostgreSQL 데이터베이스로 만든 백업을 대상 외부 시스템에 복사하고 복원합니다.
  8. PostgreSQL에서 새 데이터베이스를 생성합니다.

    $ createdb -U <username> <databasename>
    Copy to Clipboard Toggle word wrap
  9. 백업 파일의 데이터를 새 PostgreSQL 데이터베이스로 가져옵니다.

    • 사용자 지정 형식으로 복원:

      $ pg_restore [--host <databasehostname>] -U <username> -d <databasename> --verbose -F c <backupfilename>.backup
      Copy to Clipboard Toggle word wrap
  10. 데이터베이스에 연결하고 쿼리를 실행하여 데이터를 새 PostgreSQL 데이터베이스로 성공적으로 가져왔는지 확인합니다.

    postgresql://<username>:<password>@<databasehostname>/<databasename>
    Copy to Clipboard Toggle word wrap
  11. system-database 시크릿을 업데이트합니다.

    $ oc apply -f - <<EOF
    ---
    apiVersion: v1
    kind: Secret
    metadata:
      name: system-database
    stringData:
      DB_PASSWORD: <password>
      DB_USER: <username>
      URL: "postgresql://<username>:<password>@<databasehostname>:<databaseport>/<databasename>"
    type: Opaque
    EOF
    Copy to Clipboard Toggle word wrap
  12. APImanager CR을 업데이트하여 외부 데이터베이스를 활성화하고 시스템을 확장합니다.

    $ oc patch apimanager <apimanager_sample> --type=merge --patch '{"spec": {"system": {"database": null, "appSpec": {"replicas": 1}}, "externalComponents": {"system": {"database": true}}}}'
    Copy to Clipboard Toggle word wrap
  13. 로컬 postgresql 배포를 제거합니다.

    $ oc delete service system-postgresql
    $ oc delete deploymentconfig system-postgresql
    $ oc delete pvc postgresql-data
    Copy to Clipboard Toggle word wrap
  14. Pod가 확장되었는지 확인합니다.

    $ oc wait --for=condition=available apimanager/<apimanager_sample> --timeout=-1s
    Copy to Clipboard Toggle word wrap

법적 공지

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat