마이그레이션 3scale


Red Hat 3scale API Management 2.9

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

초록

템플릿에서 운영자 기반 설치로 3scale을 마이그레이션합니다. 또한 3scale 및 해당 구성 요소를 최신 버전으로 업그레이드하는 정보를 찾습니다.

접두부

이 가이드에서는 Red Hat 3scale API Management를 템플릿에서 운영자 기반 설치로 마이그레이션하고 3scale 설치를 2.8에서 2.9로 업그레이드하는 데 필요한 세부 정보, 운영자 기반 배포에서 APIcast를 업그레이드하는 단계를 설명합니다.

템플릿 기반 배포에서 운영자 기반 배포로 마이그레이션하려면 3scale 마이그레이션 가이드에 나열된 절차를 참조하십시오.

3scale 온프레미스 배포를 2.8에서 2.9로 업그레이드하려면 설치 유형에 따라 다음 가이드 중 하나를 참조하십시오.

개발자 포털에서 API 프로비저닝을 위한 업그레이드 후 단계입니다.

  • 3scale 2.9로 업그레이드한 후 3scale 2.8의 개발자 포털에서 OAS 3.0(OpenAPI Specification 3.0)을 이미 구성한 경우 OAS 3.0을 계속 사용하려면 다음을 참조하십시오. OAS 3.0으로 개발자 포털 업데이트.

운영자 기반 배포에서 APIcast를 업그레이드하려면 APIcast 업그레이드 가이드에 나열된 단계를 참조하십시오.

1장. 3scale 마이그레이션 가이드: 템플릿에서 운영자 기반 배포로

이 섹션에서는 Red Hat OpenShift 3.11을 사용하여 템플릿 기반 배포에서 Red Hat OpenShift 4.x를 사용하여 운영자 기반 배포로 Red Hat 3scale API Management를 마이그레이션하는 방법에 대해 설명합니다.

주의

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

1.1. 마이그레이션을 수행하기 위한 사전 요구 사항

3scale 설치를 템플릿에서 운영자 기반 배포로 마이그레이션하기 전에 다음 가이드를 참조하여 배포를 지원하는지 확인합니다.

1.2. 3scale 템플릿을 운영자 기반 배포로 마이그레이션

마이그레이션 전 기본 설정은 3scale이 OCP3 도메인을 가리킵니다. 3scale.example.comocp3.example.com

Red Hat OpenShift 3.11을 사용하여 템플릿 기반 배포에서 Red Hat OpenShift 4.1을 사용하여 운영자 기반 배포로 3scale을 마이그레이션하려면 다음 단계를 따르십시오.

나열된 단계를 모두 수행한 후 템플릿에서 운영자 기반 배포로 3scale 마이그레이션이 완료됩니다.

2장. 3scale 템플릿 기반 업그레이드 가이드: 2.8에서 2.9.1로

이 섹션에서는 템플릿 기반 배포에서 Red Hat 3scale API Management를 버전 2.8에서 2.9.1로 업그레이드하는 방법을 설명합니다.

중요 고려 사항

  • 필요한 조건 및 절차를 이해하려면 나열된 단계를 적용하기 전에 전체 업그레이드 가이드를 읽으십시오. 업그레이드 프로세스는 절차가 완료될 때까지 서비스 프로비저닝을 중단합니다. 이러한 중단으로 인해 유지 관리 기간이 있어야 합니다.
  • 3scale 템플릿 기반 설치가 Oracle 데이터베이스와 함께 실행되는 경우 3scale 2.9.1 릴리스 노트에서 Oracle 데이터베이스에 대한 지원을 참조하십시오.

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

이 섹션에서는 템플릿 기반 설치에서 3scale을 2.8에서 2.9.1로 업그레이드하는 데 필요한 구성, 작업 및 도구에 대해 설명합니다.

2.1.1. 설정

  • 3scale은 OpenShift 3.11의 템플릿으로 2.8에서 2.9.1로 업그레이드 경로를 지원합니다.

2.1.2. 예비 작업

  • OpenShift CLI 툴이 3scale이 배포된 동일한 프로젝트에 구성되어 있는지 확인합니다.
  • 3scale에서 사용 중인 데이터베이스 백업을 수행합니다. 백업 절차는 각 데이터베이스 유형 및 설정에 따라 다릅니다.

2.1.3. 툴

업그레이드를 수행하려면 다음 도구가 필요합니다.

  • 3scale 2.8은 OpenShift 3.11 프로젝트에서 템플릿과 함께 배포되었습니다.
  • Bash 쉘: 업그레이드 절차에 설명된 명령을 실행하려면 다음을 수행하십시오.
  • base64: 비밀 정보를 인코딩 및 디코딩합니다.
  • jq: JSON 변환 목적으로 사용됩니다.

2.2. 템플릿 기반 설치에서 2.8에서 2.9.1로 업그레이드

이 섹션에 설명된 절차에 따라 템플릿 기반 설치에서 3scale 2.8을 2.9.1로 업그레이드하십시오.

업그레이드를 시작하려면 3scale이 배포된 프로젝트로 이동합니다.

$ oc project <3scale-project>
Copy to Clipboard Toggle word wrap

그런 다음 다음 순서에 따라 단계를 수행합니다.

2.2.1. 3scale 프로젝트의 백업 생성

이전 단계

none.

현재 단계

이 단계에서는 3scale 프로젝트의 백업을 생성하는 데 필요한 작업을 나열합니다.

  1. 3scale과 함께 사용되는 데이터베이스에 따라 다음 값 중 하나를 사용하여 ${SYSTEM_DB}를 설정합니다.

    • 데이터베이스가 MySQL인 경우 SYSTEM_DB=system-mysql.
    • 데이터베이스가 PostgreSQL인 경우 SYSTEM_DB=system-postgresql.
  2. 기존 DeploymentConfigs를 사용하여 백업 파일을 생성합니다.

    THREESCALE_DC_NAMES="apicast-production apicast-staging backend-cron backend-listener backend-redis backend-worker system-app system-memcache ${SYSTEM_DB} system-redis system-sidekiq system-sphinx zync zync-database zync-que"
    
    for component in ${THREESCALE_DC_NAMES}; do oc get --export -o yaml dc ${component} > ${component}_dc.yml ; done
    Copy to Clipboard Toggle word wrap
  3. export all 명령을 통해 내보낸 프로젝트에서 기존의 모든 OpenShift 리소스를 백업합니다.

    oc get -o yaml --export all > threescale-project-elements.yaml
    Copy to Clipboard Toggle word wrap
  4. export all 명령으로 내보내지 않는 추가 요소를 사용하여 백업 파일을 생성합니다.

    for object in rolebindings serviceaccounts secrets imagestreamtags cm rolebindingrestrictions limitranges resourcequotas pvc templates cronjobs statefulsets hpa deployments replicasets poddisruptionbudget endpoints
    do
      oc get -o yaml --export $object > $object.yaml
    done
    Copy to Clipboard Toggle word wrap
  5. 생성된 모든 파일이 비어 있지 않으며 모든 파일이 예상된 콘텐츠가 있는지 확인합니다.

2.2.2. BASE_URL 필드 제거

현재 단계

이 섹션에서는 system-master-apicast 시크릿에서 BASE_URL 필드를 제거하는 방법을 설명합니다. 3scale 2.9에서 구성 요소를 사용하지 않기 때문에 이 필드가 제거됩니다.

  1. 다음 명령을 실행합니다.

    oc patch secret system-master-apicast --type=json -p='[{"op": "remove", "path": "/data/BASE_URL"}]'
    Copy to Clipboard Toggle word wrap
  2. BASE_URL 필드가 성공적으로 제거되었는지 확인합니다.

    oc get secret system-master-apicast -o json | jq .data
    Copy to Clipboard Toggle word wrap

2.2.3. 3scale 버전 번호 업데이트

현재 단계

이 단계에서는 system-environment ConfigMap의 3scale 릴리스 버전 번호를 2.8 에서 2.9 로 업데이트합니다. uuid_RELEASE는 일부 DeploymentConfig 컨테이너 환경에서 참조되는 ConfigMap 항목입니다.

  1. uuid_RELEASE를 패치하려면 다음 명령을 실행합니다.

    oc patch cm system-environment --patch '{"data": {"AMP_RELEASE": "2.9"}}'
    Copy to Clipboard Toggle word wrap
  2. system-environment ConfigMap의 AMP_RELEASE 키에 2.9 값이 있는지 확인합니다.

    oc get cm system-environment -o json | jq '.data["AMP_RELEASE"]'
    Copy to Clipboard Toggle word wrap

2.2.4. 3scale 이미지 업그레이드

현재 단계

이 단계에서는 업그레이드 프로세스에 필요한 3scale 이미지를 업데이트합니다.

2.2.4.1. 시스템 이미지 패치
  1. 새 이미지 스트림 태그를 생성합니다.

    oc patch imagestream/amp-system --type=json -p '[{"op": "add", "path": "/spec/tags/-", "value": {"annotations": {"openshift.io/display-name": "AMP system 2.9"}, "from": { "kind": "DockerImage", "name": "registry.redhat.io/3scale-amp2/system-rhel7:3scale2.9"}, "name": "2.9", "referencePolicy": {"type": "Source"}}}]'
    Copy to Clipboard Toggle word wrap
  2. 절차를 계속 진행하려면 3scale 배포와 함께 사용되는 데이터베이스를 고려하십시오.

2.2.4.1.1. 시스템 이미지 패치: Oracle Database를 사용한 3scale
  1. Oracle 데이터베이스를 사용하여 3scale의 시스템 이미지 패치를 시작하려면 데이터베이스 버전에 따라 다음 절차 중 하나를 수행하십시오.

  2. system-app ImageChangeTrigger를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/system-app --from-image=amp-system:latest --containers=system-master,system-developer,system-provider --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/system-app --from-image=amp-system:2.9-oracle --containers=system-master,system-developer,system-provider
      Copy to Clipboard Toggle word wrap

      그러면 system-app 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

    3. ImageStream 에서 :latest 태그를 제거합니다.

      oc tag -d amp-system:latest
      Copy to Clipboard Toggle word wrap
  3. 시스템-sidekiq ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/system-sidekiq --from-image=amp-system:latest --containers=system-sidekiq,check-svc --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/system-sidekiq --from-image=amp-system:2.9-oracle --containers=system-sidekiq,check-svc
      Copy to Clipboard Toggle word wrap

      그러면 시스템 측kiq 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

  4. system-sphinx ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/system-sphinx --from-image=amp-system:latest --containers=system-sphinx,system-master-svc --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/system-sphinx --from-image=amp-system:2.9-oracle --containers=system-sphinx,system-master-svc
      Copy to Clipboard Toggle word wrap

      이로 인해 시스템-sphinx 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

  5. 크기를 줄이면 3scale을 다시 확장합니다.
2.2.4.1.2. 시스템 이미지 패치: 다른 데이터베이스와의 3scale
  1. system-app ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/system-app --from-image=amp-system:latest --containers=system-master,system-developer,system-provider --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/system-app --from-image=amp-system:2.9 --containers=system-master,system-developer,system-provider
      Copy to Clipboard Toggle word wrap

      그러면 system-app 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

  2. 시스템-sidekiq ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/system-sidekiq --from-image=amp-system:latest --containers=system-sidekiq,check-svc --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/system-sidekiq --from-image=amp-system:2.9 --containers=system-sidekiq,check-svc
      Copy to Clipboard Toggle word wrap

      그러면 시스템 측kiq 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

  3. system-sphinx ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/system-sphinx --from-image=amp-system:latest --containers=system-sphinx,system-master-svc --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/system-sphinx --from-image=amp-system:2.9 --containers=system-sphinx,system-master-svc
      Copy to Clipboard Toggle word wrap

      이로 인해 시스템-sphinx 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

2.2.4.2. apicast 이미지 패치
  1. amp-apicast 이미지 스트림을 패치합니다.

    oc patch imagestream/amp-apicast --type=json -p '[{"op": "add", "path": "/spec/tags/-", "value": {"annotations": {"openshift.io/display-name": "AMP APIcast 2.9"}, "from": { "kind": "DockerImage", "name": "registry.redhat.io/3scale-amp2/apicast-gateway-rhel8:3scale2.9"}, "name": "2.9", "referencePolicy": {"type": "Source"}}}]'
    Copy to Clipboard Toggle word wrap
  2. apicast-staging ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/apicast-staging --from-image=amp-apicast:latest --containers=apicast-staging --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/apicast-staging --from-image=amp-apicast:2.9 --containers=apicast-staging
      Copy to Clipboard Toggle word wrap

      이렇게 하면 apicast-staging 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

  3. apicast-production ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/apicast-production --from-image=amp-apicast:latest --containers=apicast-production,system-master-svc --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/apicast-production --from-image=amp-apicast:2.9 --containers=apicast-production,system-master-svc
      Copy to Clipboard Toggle word wrap

      이렇게 하면 apicast-production 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

    3. ImageStream 에서 :latest 태그를 제거합니다.

      oc tag -d amp-apicast:latest
      Copy to Clipboard Toggle word wrap
2.2.4.3. 백엔드 이미지 패치
  1. amp-backend 이미지 스트림을 패치합니다.

    oc patch imagestream/amp-backend --type=json -p '[{"op": "add", "path": "/spec/tags/-", "value": {"annotations": {"openshift.io/display-name": "AMP Backend 2.9"}, "from": { "kind": "DockerImage", "name": "registry.redhat.io/3scale-amp2/backend-rhel7:3scale2.9"}, "name": "2.9", "referencePolicy": {"type": "Source"}}}]'
    Copy to Clipboard Toggle word wrap
  2. backend-listener ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/backend-listener --from-image=amp-backend:latest --containers=backend-listener --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/backend-listener --from-image=amp-backend:2.9 --containers=backend-listener
      Copy to Clipboard Toggle word wrap

      이렇게 하면 backend-listener 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

  3. backend-worker ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/backend-worker --from-image=amp-backend:latest --containers=backend-worker,backend-redis-svc --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/backend-worker --from-image=amp-backend:2.9 --containers=backend-worker,backend-redis-svc
      Copy to Clipboard Toggle word wrap

      이렇게 하면 backend-worker 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

    3. ImageStream 에서 :latest 태그를 제거합니다.

      oc tag -d amp-backend:latest
      Copy to Clipboard Toggle word wrap
  4. backend-cron ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/backend-cron --from-image=amp-backend:latest --containers=backend-cron,backend-redis-svc --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/backend-cron --from-image=amp-backend:2.9 --containers=backend-cron,backend-redis-svc
      Copy to Clipboard Toggle word wrap

      그러면 backend-cron 이 다시 배포됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

2.2.4.4. the zync 이미지 패치
  1. amp-zync 이미지 스트림을 패치합니다.

    oc patch imagestream/amp-zync --type=json -p '[{"op": "add", "path": "/spec/tags/-", "value": {"annotations": {"openshift.io/display-name": "AMP Zync 2.9"}, "from": { "kind": "DockerImage", "name": "registry.redhat.io/3scale-amp2/zync-rhel7:3scale2.9"}, "name": "2.9", "referencePolicy": {"type": "Source"}}}]'
    Copy to Clipboard Toggle word wrap
  2. zync ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/zync --from-image=amp-zync:latest --containers=zync,zync-db-svc --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/zync --from-image=amp-zync:2.9 --containers=zync,zync-db-svc
      Copy to Clipboard Toggle word wrap

      그러면 zync 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

  3. 패치 the zync-que ImageChange 트리거:

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/zync-que --from-image=amp-zync:latest --containers=que --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/zync-que --from-image=amp-zync:2.9 --containers=que
      Copy to Clipboard Toggle word wrap

      그러면 zync-que 의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

    3. ImageStream 에서 :latest 태그를 제거합니다.

      oc tag -d amp-zync:latest
      Copy to Clipboard Toggle word wrap
2.2.4.5. system-memcached 이미지 패치
  1. system-memcached ImageStream을 패치합니다.

    oc patch imagestream/system-memcached --type=json -p '[{"op": "add", "path": "/spec/tags/-", "value": {"annotations": {"openshift.io/display-name": "System 2.9 Memcached"}, "from": { "kind": "DockerImage", "name": "registry.redhat.io/3scale-amp2/memcached-rhel7:3scale2.9"}, "name": "2.9", "referencePolicy": {"type": "Source"}}}]'
    Copy to Clipboard Toggle word wrap
  2. system-memcache ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/system-memcache --from-image=system-memcached:latest --containers=memcache --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/system-memcache --from-image=system-memcached:2.9 --containers=memcache
      Copy to Clipboard Toggle word wrap

      이렇게 하면 system-memcache DeploymentConfig의 재배포가 트리거됩니다. 다시 배포되고 해당 새 포드가 준비되고 이전 포드가 종료될 때까지 기다립니다.

    3. ImageStream 에서 :latest 태그를 제거합니다.

      oc tag -d system-memcached:latest
      Copy to Clipboard Toggle word wrap
2.2.4.6. zync-database-postgresql 이미지 패치
  1. the zync-database-postgresql 이미지 스트림을 패치합니다.

    oc patch imagestream/zync-database-postgresql --type=json -p '[{"op": "add", "path": "/spec/tags/-", "value": {"annotations": {"openshift.io/display-name": "Zync 2.9 PostgreSQL"}, "from": { "kind": "DockerImage", "name": "registry.redhat.io/rhscl/postgresql-10-rhel7"}, "name": "2.9", "referencePolicy": {"type": "Source"}}}]'
    Copy to Clipboard Toggle word wrap
    • 이 패치 명령은 2.9 태그를 포함하도록 zync-database-postgresql 이미지 스트림을 업데이트합니다. 다음 단계를 사용하여 2.9 태그가 생성되었는지 확인할 수 있습니다.

      1. 다음 명령을 실행하십시오.

        oc get is zync-database-postgresql
        Copy to Clipboard Toggle word wrap
      2. Tags 열에 2.9 태그가 표시되는지 확인합니다.
  2. zync-database ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/zync-database --from-image=zync-database-postgresql:latest --containers=postgresql --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/zync-database --from-image=zync-database-postgresql:2.9 --containers=postgresql
      Copy to Clipboard Toggle word wrap

      이미지에 새 업데이트가 있는 경우 이 패치에서 zync-database DeploymentConfig의 재배포를 트리거할 수도 있습니다. 이 경우 새 포드가 재배포되고 준비되고 이전 포드가 종료될 때까지 기다립니다.

    3. ImageStream 에서 :latest 태그를 제거합니다.

      oc tag -d zync-database-postgresql:latest
      Copy to Clipboard Toggle word wrap
2.2.4.7. 추가 이미지 변경

3scale 2.8 설치에서 다음 DeploymentConfig 중 하나 이상을 사용할 수 있는 경우 적용되는 링크를 클릭하여 진행 방법에 대한 자세한 정보를 얻습니다.

2.2.4.7.1. backend-redis DeploymentConfig

현재 3scale 설치에 backend-redis DeploymentConfig가 있는 경우 backend-redis:에 대한 redis 이미지를 패치합니다.

  1. backend-redis 이미지 스트림을 패치합니다.

    oc patch imagestream/backend-redis --type=json -p '[{"op": "add", "path": "/spec/tags/-", "value": {"annotations": {"openshift.io/display-name": "Backend 2.9 Redis"}, "from": { "kind": "DockerImage", "name": "registry.redhat.io/rhscl/redis-32-rhel7:3.2"}, "name": "2.9", "referencePolicy": {"type": "Source"}}}]'
    Copy to Clipboard Toggle word wrap

    이 패치는 backend-redis 이미지 스트림을 업데이트하여 2.9 태그를 포함합니다. 아래 명령을 사용하여 Tags 열에 2.9 가 표시되는 경우 태그가 생성되었는지 확인할 수 있습니다.

    oc get is backend-redis
    Copy to Clipboard Toggle word wrap
  2. backend-redis ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/backend-redis --from-image=backend-redis:latest --containers=backend-redis --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/backend-redis --from-image=backend-redis:2.9 --containers=backend-redis
      Copy to Clipboard Toggle word wrap

      이미지에 새 업데이트가 있는 경우 이 패치에서 backend-redis DeploymentConfig의 재배포를 트리거할 수도 있습니다. 이 경우 새 포드가 재배포되고 준비되고 이전 포드가 종료될 때까지 기다립니다.

    3. ImageStream 에서 :latest 태그를 제거합니다.

      oc tag -d backend-redis:latest
      Copy to Clipboard Toggle word wrap
2.2.4.7.2. system-redis DeploymentConfig

system-redis DeploymentConfig가 현재 3scale 설치에 있는 경우 시스템-redis 에 대한 redis 이미지를 패치합니다.

  1. system-redis 이미지 스트림을 패치합니다.

    oc patch imagestream/system-redis --type=json -p '[{"op": "add", "path": "/spec/tags/-", "value": {"annotations": {"openshift.io/display-name": "System 2.9 Redis"}, "from": { "kind": "DockerImage", "name": "registry.redhat.io/rhscl/redis-32-rhel7:3.2"}, "name": "2.9", "referencePolicy": {"type": "Source"}}}]'
    Copy to Clipboard Toggle word wrap

    이 패치는 system-redis 이미지 스트림을 업데이트하여 2.9 태그를 포함합니다. 아래 명령을 사용하여 Tags 열에 2.9 가 표시되는 경우 태그가 생성되었는지 확인할 수 있습니다.

    oc get is system-redis
    Copy to Clipboard Toggle word wrap
  2. system-redis ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/system-redis --from-image=system-redis:latest --containers=system-redis --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/system-redis --from-image=system-redis:2.9 --containers=system-redis
      Copy to Clipboard Toggle word wrap

      이미지에 새 업데이트가 있는 경우 이 패치로 인해 system-redis DeploymentConfig가 재배포될 수도 있습니다. 이 경우 새 포드가 재배포되고 준비되고 이전 포드가 종료될 때까지 기다립니다.

    3. ImageStream 에서 :latest 태그를 제거합니다.

      oc tag -d system-redis:latest
      Copy to Clipboard Toggle word wrap
2.2.4.7.3. system-mysql DeploymentConfig

system-mysql DeploymentConfig가 현재 3scale 설치에 있는 경우 system-mysql 의 MySQL 이미지를 패치합니다.

  1. system-mysql 이미지 스트림을 패치합니다.

    oc patch imagestream/system-mysql --type=json -p '[{"op": "add", "path": "/spec/tags/-", "value": {"annotations": {"openshift.io/display-name": "System 2.9 MySQL"}, "from": { "kind": "DockerImage", "name": "registry.redhat.io/rhscl/mysql-57-rhel7:5.7"}, "name": "2.9", "referencePolicy": {"type": "Source"}}}]'
    Copy to Clipboard Toggle word wrap

    이 패치는 system-mysql 이미지 스트림을 업데이트하여 2.9 태그를 포함합니다. 아래 명령을 사용하여 Tags 열에 2.9 가 표시되는 경우 태그가 생성되었는지 확인할 수 있습니다.

    oc get is system-mysql
    Copy to Clipboard Toggle word wrap
  2. system-mysql ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/system-mysql --from-image=system-mysql:latest --containers=system-mysql --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/system-mysql --from-image=system-mysql:2.9 --containers=system-mysql
      Copy to Clipboard Toggle word wrap

      이미지에 새 업데이트가 있는 경우 이 패치에서 system-mysql DeploymentConfig의 재배포를 트리거할 수도 있습니다. 이 경우 새 포드가 재배포되고 준비되고 이전 포드가 종료될 때까지 기다립니다.

    3. ImageStream 에서 :latest 태그를 제거합니다.

      oc tag -d system-mysql:latest
      Copy to Clipboard Toggle word wrap
2.2.4.7.4. system-postgresql DeploymentConfig

system-postgresql DeploymentConfig가 현재 3scale 설치에 있는 경우 system-postgresql 의 PostgreSQL 이미지를 패치합니다.

  1. system-postgresql 이미지 스트림을 패치합니다.

    oc patch imagestream/system-postgresql --type=json -p '[{"op": "add", "path": "/spec/tags/-", "value": {"annotations": {"openshift.io/display-name": "System 2.9 PostgreSQL"}, "from": { "kind": "DockerImage", "name": "registry.redhat.io/rhscl/postgresql-10-rhel7"}, "name": "2.9", "referencePolicy": {"type": "Source"}}}]'
    Copy to Clipboard Toggle word wrap

    이 패치는 system-postgresql 이미지 스트림을 업데이트하여 2.9 태그를 포함합니다. 아래 명령을 사용하여 Tags 열에 2.9 가 표시되는 경우 태그가 생성되었는지 확인할 수 있습니다.

    oc get is system-postgresql
    Copy to Clipboard Toggle word wrap
  2. system-postgresql ImageChange 트리거를 패치합니다.

    1. 최신 트리거를 제거합니다.

      oc set triggers dc/system-postgresql --from-image=system-postgresql:latest --containers=system-postgresql --remove
      Copy to Clipboard Toggle word wrap
    2. 새 버전별 트리거를 추가합니다.

      oc set triggers dc/system-postgresql --from-image=system-postgresql:2.9 --containers=system-postgresql
      Copy to Clipboard Toggle word wrap

      이미지에 새 업데이트가 있는 경우 이 패치에서 system-postgresql DeploymentConfig의 재배포를 트리거할 수도 있습니다. 이 경우 새 포드가 재배포되고 준비되고 이전 포드가 종료될 때까지 기다립니다.

    3. ImageStream 에서 :latest 태그를 제거합니다.

      oc tag -d system-postgresql:latest
      Copy to Clipboard Toggle word wrap
2.2.4.8. 이미지 URL 확인

이전 단계

DeploymentConfigs의 모든 이미지 URL에 각 URL 주소 끝에 추가된 해시가 포함된 새 이미지 레지스트리 URL이 포함되어 있는지 확인합니다.

THREESCALE_DC_NAMES="apicast-production apicast-staging backend-cron backend-listener backend-redis backend-worker system-app system-memcache system-mysql system-redis system-sidekiq system-sphinx zync zync-database zync-que"
for component in ${THREESCALE_DC_NAMES}; do echo -n "${component} image: " && oc get dc $component -o json | jq .spec.template.spec.containers[0].image ; done
Copy to Clipboard Toggle word wrap

다음 단계

none. 나열된 단계를 모두 수행한 후 템플릿 기반 배포에서 2.8에서 2.9.1로 3scale 업그레이드를 완료합니다.

2.3. 템플릿 기반 설치의 Oracle Database로 3scale 업그레이드

이 섹션에서는 OpenShift 3.11과의 템플릿 기반 설치에서 Oracle Database로 3scale 시스템 이미지를 사용할 때 Red Hat 3scale API Management를 업그레이드하는 방법을 설명합니다.

사전 요구 사항

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

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

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

이 절차에서는 기존 3scale 2.8 설치에서 3scale 2.9.1용 Oracle Database 12c에서 Oracle Database 19c로 변경하는 방법을 안내합니다.

중요: 데이터베이스에 대한 연결이 손실되어 잠재적으로 3scale이 손상될 수 있습니다. 업그레이드를 진행하기 전에 백업을 만듭니다. 공식 Oracle Database 문서를 참조하십시오. Oracle 데이터베이스 백업 및 복구 사용자 가이드.

사전 요구 사항

  • 3scale 2.8 설치
  • Oracle Database 12c 설치

절차

  1. 다음과 같은 고려 사항을 사용하여 3scale을 0 (0으로 축소)합니다.

    1. Oracle 12c와 연결이 끊어져 데이터베이스에 대한 3scale 연결이 실패합니다.
  2. Oracle 12c를 Oracle 19c로 업그레이드

    1. 업그레이드를 수행하려면 공식 Oracle Database Upgrade Guide 를 따르십시오.
  3. 3scale 2.9.1용 OpenShift 템플릿을복제합니다.

    $ git clone --branch 2.9.1.GA https://github.com/3scale/3scale-amp-openshift-templates.git
    Copy to Clipboard Toggle word wrap
  4. Oracle Database Instant Client 패키지 파일을 3scale-amp-openshift-templates/amp/system-oracle-client-files 디렉터리에 배치합니다.
  5. oc process 명령을 -f 옵션과 함께 실행하고 build.yml OpenShift 템플릿을 지정합니다.

    $ oc process -f build.yml | oc apply -f -
    Copy to Clipboard Toggle word wrap
  6. oc start-build 명령을 입력하여 새 시스템 이미지를 빌드합니다.

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

    $ oc get build <build-name> -o jsonpath="{.status.phase}"
    Copy to Clipboard Toggle word wrap
    1. 빌드가 Complete 상태가 될 때까지 기다립니다.

2.3.2. Oracle 12c로 3scale 업그레이드

이 절차에서는 기존 3scale 2.8 설치에서 3scale 2.9.1용 Oracle Database 12c 업데이트를 안내합니다.

중요: 데이터베이스에 대한 연결이 손실되어 잠재적으로 3scale이 손상될 수 있습니다. 업그레이드를 진행하기 전에 백업을 만듭니다. 공식 Oracle Database 문서를 참조하십시오. Oracle 데이터베이스 백업 및 복구 사용자 가이드.

사전 요구 사항

  • 3scale 2.8 설치
  • Oracle Database 12c 설치

절차

  1. 3scale 2.9.1용 OpenShift 템플릿을복제합니다.

    $ git clone --branch 2.9.1.GA https://github.com/3scale/3scale-amp-openshift-templates.git
    Copy to Clipboard Toggle word wrap
  2. Oracle Database Instant Client 패키지 파일을 3scale-amp-openshift-templates/amp/system-oracle-client-files 디렉터리에 배치합니다.
  3. oc process 명령을 -f 옵션과 함께 실행하고 build.yml OpenShift 템플릿을 지정합니다.

    $ oc process -f build.yml | oc apply -f -
    Copy to Clipboard Toggle word wrap
  4. oc start-build 명령을 입력하여 새 시스템 이미지를 빌드합니다.

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

    $ oc get build <build-name> -o jsonpath="{.status.phase}"
    Copy to Clipboard Toggle word wrap
    1. 빌드가 Complete 상태가 될 때까지 기다립니다.

추가 리소스

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

3장. 3scale Operator 기반 업그레이드 가이드: 2.8에서 2.9로

이 섹션에서는 Operator 기반 배포에서 Red Hat 3scale API Management를 버전 2.8에서 2.9로 업그레이드하는 방법에 대해 설명합니다.

3scale의 마이크로 릴리스가 자동으로 제공되려면 자동 업데이트가 있는지 확인합니다. 이를 확인하려면 마이크로 릴리스의 3scale Operator 설정을 참조하십시오.

중요

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

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

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

  • 3scale 2.8은 이전에 3scale Operator를 통해 배포되었습니다.
  • 관리자 액세스 권한이 있는 OCP(OpenShift Container Platform) 4.x 클러스터.

3.2. Operator 기반 설치의 2.8에서 2.9로 업그레이드

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

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

    • 그러면 업그레이드 프로세스가 시작됩니다.
    • 업그레이드 프로세스가 APIManager 에 대해 완료될 때까지 기다립니다.
  6. 프로젝트의 Pod 상태를 쿼리합니다.

    oc get pods
    Copy to Clipboard Toggle word wrap
    • 모든 새 버전이 실행되고 오류 없이 준비될 때까지 기다립니다.
    • 업그레이드 프로세스 중에 일시적인 오류가 있을 수 있습니다.

      참고

      시간은 대략 5-10분에 따라 달라질 수 있습니다. 모든 Pod가 실행, 준비 및 오류 없이 실행될 때까지 Pod의 상태를 계속 확인하십시오.

3scale 관리 포털에 로그인하여 업그레이드 프로세스가 예상대로 작동하는지 확인합니다.

  1. APIManager 오브젝트의 상태를 확인하고 다음 명령을 실행하여 YAML 콘텐츠를 가져옵니다.

    oc get apimanager <myapimanager> -o yaml
    Copy to Clipboard Toggle word wrap
    • 값이 있는 새 주석은 다음과 같아야 합니다.

      apps.3scale.net/apimanager-threescale-version: "2.9"
      apps.3scale.net/threescale-operator-version: "0.6.0"
      Copy to Clipboard Toggle word wrap

나열된 모든 단계를 수행한 후 Operator 기반 배포에서 2.8에서 2.9로의 3scale 업그레이드가 완료되었습니다.

4장. APIcast Operator 기반 업그레이드 가이드: 2.8에서 2.9로

이 섹션에서는 Operator 기반 배포에서 버전 2.8에서 2.9로 APIcast를 업그레이드하는 방법에 대해 설명합니다.

중요

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

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

이 섹션에서는 Operator 기반 설치에서 APIcast를 2.8에서 2.9로 업그레이드하는 데 필요한 구성에 대해 설명합니다.

  • APIcast 2.8은 이전에 APIcast Operator를 통해 배포되었습니다.
  • 관리자 액세스 권한이 있는 OCP(OpenShift Container Platform) 4.x 클러스터.

4.2. Operator 기반 설치에서 APIcast를 2.8에서 2.9로 업그레이드

Operator 기반 배포에서 APIcast를 버전 2.8에서 2.9로 업그레이드하려면 다음을 수행합니다.

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

    • 그러면 업그레이드 프로세스가 시작됩니다.
    • 업그레이드 프로세스가 APIcast 에 대해 완료될 때까지 기다립니다.
  6. 프로젝트의 Pod 상태를 쿼리합니다.

    oc get pods
    Copy to Clipboard Toggle word wrap
    • 모든 새 버전이 실행되고 오류 없이 준비될 때까지 기다립니다.
    • 업그레이드 프로세스 중에 일시적인 오류가 있을 수 있습니다.

      참고

      시간은 대략 5-10분에 따라 달라질 수 있습니다. 모든 Pod가 실행, 준비 및 오류 없이 실행될 때까지 Pod의 상태를 계속 확인하십시오.

  7. APIcast 오브젝트의 상태를 확인하고 다음 명령을 실행하여 YAML 콘텐츠를 가져옵니다.

    oc get apicast <myapicast> -o yaml
    Copy to Clipboard Toggle word wrap
    • 값이 있는 새 주석은 다음과 같아야 합니다.

      apicast.apps.3scale.net/operator-version: “0.3.0”
      Copy to Clipboard Toggle word wrap

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

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat