2.4. WildcardRouter에서 Zync 경로 관리로 마이그레이션

절차

1. Zync가 외부 게이트웨이의 경로를 관리하지 않으므로 제안된 대안 중 하나의 단계에 따라 Zync에서 관리하지 않는 각 서비스의 배포 옵션을 수정할 수 있습니다.

   • 3scale에서 다음을 수행합니다.

     1. 통합 페이지로 이동하여 통합 설정 편집 을 클릭합니다.
     2. 올바른 배포 옵션을 선택하고 변경 사항을 해당하는 경우 저장합니다.

   • API 사용:

     1. 액세스 토큰(ACCESS_TOKEN)과 테넌트 엔드포인트(TENANT_URL)를 사용하여 서비스ID(ID)로 서비스를 업데이트합니다.

        $ curl -XPUT "${TENANT_URL}/admin/api/services/${ID}.json" -d deployment_option=self_managed -d access_token="${ACCESS_TOKEN}"

        또는 APIcast 호스팅을 사용하는 경우 아래 명령을 사용할 수 있습니다.

        $ curl -XPUT "${TENANT_URL}/admin/api/services/${ID}.json" -d deployment_option=hosted -d access_token="${ACCESS_TOKEN}"

     2. 각 테넌트의 서비스마다 3scale 또는 API를 통해 deployment_option 필드를 수정합니다.

        • 다음은 deployment_option 을 self_managed 로 설정할 수 있는 경우입니다.

          • APIcast는 OpenShift의 사용자 지정 경로에 연결됩니다.
          • APIcast는 OpenShift 외부에서 호스팅됩니다.
          • APICAST_PATH_ROUTING 이 true 로 설정되어 있습니다.
        • 다른 경우에는 deployment_option 을 호스팅 하도록 설정합니다.

2. 잠재적으로 존재하는 경로 중 일부 기본 경로는 2.5에서 3scale로 자동 생성되었습니다. 이를 제거하려면 다음을 실행합니다.

   $ oc delete route system-master
   $ oc delete route system-provider-admin
   $ oc delete route system-developer
   $ oc delete route api-apicast-production
   $ oc delete route api-apicast-staging

   • WILDCARD_POLICY=Subdomain 을 사용하여 3scale 2.5를 배포한 경우 다음을 사용하여 와일드카드 경로를 제거해야 합니다.

     $ oc delete route apicast-wildcard-router

   • 그렇지 않으면 WILDCARD_POLICY=Subdomain 없이 3scale 2.5를 배포한 경우 Zync가 생성할 경로의 중복을 방지하기 위해 3scale 테넌트 및 서비스에 대해 수동으로 생성한 경로를 제거해야 합니다.

1. 3scale 서비스 및 테넌트 OpenShift 경로를 모두 Zync로 강제로 다시 동기화합니다.

   $ SYSTEM_SIDEKIQ_POD=$(oc get pods | grep sidekiq | awk '{print $1}')

2. SYSTEM_SIDEKIQ_POD 환경 변수 결과가 비어 있지 않은지 확인합니다.

   $ echo ${SYSTEM_SIDEKIQ_POD}

3. 마지막으로 재동기화 작업을 수행합니다.

   $ oc exec -it ${SYSTEM_SIDEKIQ_POD} -- bash -c 'bundle exec rake zync:resync:domains'

   시스템에 대한 알림에 대한 정보와 함께 이 스타일의 출력이 표시됩니다.

   $ No valid API key has been set, notifications will not be sent
   ActiveMerchant MODE set to 'production'
   [Core] Using http://backend-listener:3000/internal/ as URL
   OpenIdAuthentication.store is nil. Using in-memory store.
   [EventBroker] notifying subscribers of Domains::ProviderDomainsChangedEvent 59a554f6-7b3f-4246-9c36-24da988ca800
   [EventBroker] notifying subscribers of ZyncEvent caa8e941-b734-4192-acb0-0b12cbaab9ca
   Enqueued ZyncWorker#d92db46bdba7a299f3e88f14 with args: ["caa8e941-b734-4192-acb0-0b12cbaab9ca", {:type=>"Provider", :id=>1, :parent_event_id=>"59a554f6-7b3f-4246-9c36-24da988ca800", :parent_event_type=>"Domains::ProviderDomainsChangedEvent", :tenant_id=>1}]
   [EventBroker] notifying subscribers of Domains::ProviderDomainsChangedEvent 9010a199-2af1-4023-9b8d-297bd618096f
   …

   Zync를 강제 적용하면 기존 테넌트 및 서비스에 대해 새 경로가 생성됩니다. 경로 생성은 서비스 및 테넌트 수에 따라 몇 분 정도 걸릴 수 있습니다.

   프로세스가 끝나면 생성된 것을 확인할 수 있습니다.

   • 마스터 관리 포털 경로 1개

     3scale 테넌트마다 두 개의 경로가 생성됩니다.

   • 테넌트의 관리 포털 경로.

   • 테넌트의 개발자 포털 경로.

     3scale 서비스마다 두 개의 경로가 생성됩니다.

   • 서비스에 해당하는 APIcast 스테이징 경로
   • 서비스에 해당하는 APIcast 프로덕션 경로입니다.

4. 위에서 설명한 모든 예상 경로가 기존 서비스 및 테넌트에 대해 생성되었는지 확인합니다. 다음을 실행하여 모든 경로를 볼 수 있습니다.

   $ oc get routes

   이전 명령의 출력으로 표시된 host/port 필드는 경로의 URL이어야 합니다.

   • WILDCARD_POLICY를 Subdomain 으로 설정하여 3scale 2.5를 배포한 경우 모든 새 경로에 이전 OpenShift 와일드카드 경로와 동일한 기본 WildcardDomain이 있어야 합니다.
   • 그렇지 않으면 WILDCARD_POLICY=Subdomain 없이 3scale 2.5를 배포한 경우 2.5 릴리스에서 3scale에 의해 자동으로 생성된 경로를 포함하여 새 경로가 제거된 이전 경로와 동일한 호스트를 보유해야 합니다.
5. 마지막으로 이전 와일드카드 경로 또는 수동으로 생성한 경로에 사용자 정의 SSL 인증서를 사용하는 경우 Zync에서 생성한 새 경로에 설치합니다. OpenShift 웹 패널을 통해 경로를 편집하고 인증서/s를 여기에 추가하여 이를 수행할 수 있습니다.

6. 이 마이그레이션 이전에 존재하는 서비스 및 테넌트는 새 경로를 사용하여 여전히 확인할 수 있는지 확인합니다. 이 작업을 수행하려면 다음 테스트를 수행합니다.

   1. 이 마이그레이션 전에 이미 존재하는 3scale 서비스와 관련된 기존 APIcast 프로덕션 URL의 경로를 해결합니다.
   2. 이 마이그레이션 전에 이미 존재하는 3scale 서비스와 연결된 기존 APIcast 스테이징 URL의 경로를 해결합니다.
   3. 이 마이그레이션 전에 이미 존재하는 기존 테넌트의 경로를 해결합니다.

7. 새 Zync 기능이 작동하는지 확인할 때 새 테넌트 및 서비스를 생성할 때 새 경로가 생성되었는지 확인합니다. 이 작업을 수행하려면 다음 테스트를 수행합니다.

   1. '마스터' 패널에서 새 테넌트를 생성하고 몇 초 후에 OpenShift에 연결된 새 경로가 표시되는지 확인합니다.
   2. 기존 테넌트 중 하나에서 새 서비스를 생성하고 몇 초 후에 OpenShift에 연결된 새 경로가 표시되는지 확인합니다.

8. apicast-wildcard-router 서비스를 제거합니다.

   $ oc delete service apicast-wildcard-router

9. 더 이상 사용되지 않는 WildcardRouter 하위 시스템을 제거합니다.

   $ oc delete ImageStream amp-wildcard-router
   $ oc delete DeploymentConfig apicast-wildcard-router

   나열된 모든 단계를 수행한 후 템플릿 기반 배포에서 2.6에서 2.7로 3scale 업그레이드가 완료되었습니다.