2.9. 从 WildcardRouter 迁移到 Zync 路由管理

步骤

1. 假设 Zync 不管理外部网关的路由，您可以按照其中一个建议的替代选择来修改由 Zync 管理的每个服务的部署选项：

   • 在 3scale 中：

     1. 进入 Integration 页面，点 edit integration settings。
     2. 选择正确的部署选项，并在有时保存您的更改。

   • 使用 API：

     1. 使用带有访问令牌 (ACCESS_TOKEN) 和租户端点 (TENANT_URL) 的服务标识符 (ID) 更新服务。

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

        Copy to Clipboard Toggle word wrap

        另外，如果您使用 APIcast 托管，可以使用下面的命令：

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

        Copy to Clipboard Toggle word wrap

     2. 对于每个租户的每个服务，通过 3scale 或 API 修改 deployment_option 字段：

        • 这些是您可以将 deployment_option 设置为 self_managed 的情况：

          • APIcast 链接到 OpenShift 中的自定义路由。
          • APIcast 在 OpenShift 之外托管。
          • APICAST_PATH_ROUTING 设置为 true。
        • 在其他情况下，将 deployment_option 设置为托管的。

2. 在可能的现有路由中，3scale 在 2.5 中自动创建一些默认路由。首先删除它们：

   $ 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

   Copy to Clipboard Toggle word wrap

   • 如果使用 WILDCARD_POLICY=Subdomain 部署 3scale 2.5，则必须使用以下命令删除通配符路由：

     $ oc delete route apicast-wildcard-router

     Copy to Clipboard Toggle word wrap
   • 否则，如果您在没有 WILDCARD_POLICY=Subdomain 的情况下部署 3scale 2.5，您必须删除为 3scale 租户和服务手动创建的路由，以避免重复 Zync 将创建的路由。

1. 使用 Zync 强制重新同步所有 3scale 服务和租户 OpenShift 路由：

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

   Copy to Clipboard Toggle word wrap

2. 检查 SYSTEM_SIDEKIQ_POD 环境变量结果是否不为空：

   $ echo ${SYSTEM_SIDEKIQ_POD}

   Copy to Clipboard Toggle word wrap

3. 最后，执行重新同步：

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

   Copy to Clipboard Toggle word wrap

   您将看到这种样式的输出，其中包含有关通知到系统的信息：

   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
   …

   Copy to Clipboard Toggle word wrap

   在强制 Zync 重新评估后，为所有现有租户和服务创建新路由。根据服务和租户的数量，路由创建可能需要几分钟时间。

   在进程结束时，您将看到创建：

   • 一个主管理门户路由。

     每个 3scale 租户都会创建两个路由：

   • 租户的管理门户路由。

   • 租户的开发人员门户路由。

     每个 3scale 服务都创建两个路由：

   • 与服务对应的 APIcast 暂存路由。
   • APIcast 生产路由与服务对应。

4. 验证是否为所有现有服务和租户创建了上述所有预期的路由。您可以通过运行以下命令查看所有路由：

   $ oc get routes

   Copy to Clipboard Toggle word wrap

   如上一命令的输出中显示的 host/port 字段必须是路由的 URL。

   • 如果您部署了 3scale 2.5，将 WILDCARD_POLICY 设置为 Subdomain，则所有新路由都必须具有与旧 OpenShift 通配符Domain 相同的基本 WildcardDomain。
   • 否则，如果您在没有 WILDCARD_POLICY=Subdomain 的情况下部署 3scale 2.5，新路由必须具有与您删除的旧路由相同的主机，包括在 2.5 发行版中 3scale 自动创建的那些。
5. 最后，如果您为旧通配符路由使用自定义 SSL 证书，或者旧的手动创建的路由，请将它们安装到 Zync 创建的新路由中。您可以通过 OpenShift Web 面板编辑路由，并将证书/添加到其中。

6. 验证在迁移仍然可使用新路由解析前存在的服务和租户。要做到这一点执行以下操作：

   1. 解析与迁移前已存在的 3scale 服务关联的现有 APIcast 生产 URL 的路由。
   2. 解析与迁移前已存在的 3scale 服务关联的现有 APIcast staging URL 的路由。
   3. 解析在迁移前已存在的租户的路由。

7. 验证新的 Zync 功能是否正常工作时，请确认在创建新租户和服务时是否生成了新的路由。要做到这一点执行以下操作：

   1. 从 'master' 面板创建一个新租户，并验证与它关联的新路由后出现在 OpenShift 中。
   2. 在其中一个现有租户中创建一个新服务，并验证与它关联的新路由出现在 OpenShift 中后。

8. 删除 apicast-wildcard-router 服务：

   $ oc delete service apicast-wildcard-router

   Copy to Clipboard Toggle word wrap

9. 删除已弃用的 WildcardRouter 子系统：

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

   Copy to Clipboard Toggle word wrap

   执行完所有列出的步骤后，3scale 从 2.5 升级到 2.6 现已完成。