迁移 3scale

步骤

1. 根据与 3scale 一起使用的数据库，使用以下值之一设置 ${SYSTEM_DB}：

   • 如果数据库是 MySQL，则为 SYSTEM_DB=system-mysql。
   • 如果数据库是 PostgreSQL，则为 SYSTEM_DB=system-postgresql。

2. 使用现有 DeploymentConfig 创建备份文件：

   $ 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. 验证所有生成的文件是否都为空，并且所有这些文件都具有预期内容。

步骤

1. 要修补 AMP_RELEASE，请运行以下命令：

   $ oc patch cm system-environment --patch '{"data": {"AMP_RELEASE": "2.11"}}'

   Copy to Clipboard Toggle word wrap

2. 确认 system-environment ConfigMap 中的 AMP_RELEASE 键的值为 2.11：

   $ oc get cm system-environment -o json | jq '.data["AMP_RELEASE"]'

   Copy to Clipboard Toggle word wrap

步骤

1. 通过编辑 system-app DeploymentConfig 来更新 system-app pre-hook pod 中的变量：

   $ oc edit dc system-app

   Copy to Clipboard Toggle word wrap

   您将进入交互式编辑器会话。在 .spec.strategy.rollingParams.pre.execNewPod.env 数组部分中找到 BACKEND_ROUTE 环境变量。

   1. 替换以下条目：

      - name: BACKEND_ROUTE
        valueFrom:
          secretKeyRef:
            key: route_endpoint
            name: backend-listener

      Copy to Clipboard Toggle word wrap

   2. 使用这个条目：

      - name: BACKEND_ROUTE
        value: http://backend-listener:3000/internal/

      Copy to Clipboard Toggle word wrap

      保存更改并退出交互式编辑器会话。

2. 更新 system-app 容器中的条目：

   $ oc set env dc/system-app BACKEND_ROUTE="http://backend-listener:3000/internal/"

   Copy to Clipboard Toggle word wrap

   此命令会触发 system-app 的重新部署。等待它重新部署、对应的新容器集就绪，并且前面的容器集终止。

3. 在 system-sidekiq 容器中更新它：

   $ oc set env dc/system-sidekiq BACKEND_ROUTE="http://backend-listener:3000/internal/"

   Copy to Clipboard Toggle word wrap

   此命令会触发 system-sidekiq 的重新部署。等待它重新部署、对应的新容器集就绪，并且前面的容器集终止。

步骤

1. 运行以下命令来记录 prometheus.io/port 和 prometheus.io/scrape 注解的当前值：

   $ oc get dc zync -o json | jq .metadata.annotations

   Copy to Clipboard Toggle word wrap

2. 将注解添加到 zync DeploymentConfig 的 PodTemplate 注解。如果 prometheus.io/port 和 prometheus.io/scrape 注解值与以下命令中所示的不同，则将它们替换为当前在 zync DeploymentConfig DeploymentConfig 中设置的值，如上一命令所示：

   $ oc patch dc zync --patch '{"spec":{"template":{"metadata":{"annotations":{"prometheus.io/port":"9393","prometheus.io/scrape":"true"}}}}}'

   Copy to Clipboard Toggle word wrap

3. 从 zync DeploymentConfig 注解中删除原始注解：

   $ oc annotate dc zync prometheus.io/scrape-
   $ oc annotate dc zync prometheus.io/port-

   Copy to Clipboard Toggle word wrap

   此命令会触发 zync 的重新部署。等待它重新部署、对应的新容器集就绪，并且前面的容器集终止。

步骤

1. 使用以下命令检查 backend-cron 设置的当前资源要求：

   $ oc get dc backend-cron -o json | jq .spec.template.spec.containers[0].resources

   Copy to Clipboard Toggle word wrap

   如果输出为空或 null，代表没有设置资源要求。

2. 要增加当前的 backend-cron 资源要求，请运行以下命令：

   $ oc patch dc backend-cron --patch '{"spec":{"template":{"spec":{"containers":[{"name":"backend-cron","resources":{"limits":{"memory":"500Mi", "cpu": "500m"}, "requests":{"memory":"100Mi", "cpu": "100m"}}}]}}}}'

   Copy to Clipboard Toggle word wrap

   此命令会触发 backend-cron 的重新部署。等待它重新部署、对应的新容器集就绪，并且前面的容器集终止。

步骤

1. 从 GitHub 存储库下载 3scale OpenShift 模板并提取存档：

   tar -xzf 3scale-amp-openshift-templates-3scale-2.11.1-GA.tar.gz

   Copy to Clipboard Toggle word wrap
2. 将 Oracle Database Instant Client Package 文件放在 3scale-amp-openshift-templates-3scale-2.11.1-GA/amp/system-oracle/oracle-client-files 目录中。

3. 使用 -f 选项运行 oc process 命令并指定 build.yml OpenShift 模板：

   $ oc process -f build.yml | oc apply -f -

   Copy to Clipboard Toggle word wrap

4. 使用 -f 选项运行 oc new-app 命令以指示 amp.yml OpenShift 模板，并使用 -p 选项指定带有 OpenShift 集群域的 WILDCARD_DOMAIN 参数：

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

   Copy to Clipboard Toggle word wrap
   注意

   以下步骤是可选的。如果在安装或系统升级后删除 ORACLE_SYSTEM_PASSWORD，请使用它们。

5. 输入以下 oc patch 命令，将 SYSTEM_PASSWORD 替换为您在准备 Oracle 数据库中设置的 Oracle Database system 密码：

   $ 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"}]}}}}}}'

   Copy to Clipboard Toggle word wrap

6. 输入以下命令，替换 DATABASE_URL 以指向在准备 Oracle 数据库中指定的 Oracle 数据库 ：

   $ oc patch secret/system-database -p '{"stringData": {"URL": "DATABASE_URL"}}'

   Copy to Clipboard Toggle word wrap

7. 输入 oc start-build 命令以构建新系统镜像：

   $ oc start-build 3scale-amp-system-oracle --from-dir=.

   Copy to Clipboard Toggle word wrap

8. 等待构建完成。要查看构建的状态，请运行以下命令：

   $ oc get build <build-name> -o jsonpath="{.status.phase}"

   Copy to Clipboard Toggle word wrap
   1. 等待构建处于 Complete 状态。

9. 使用 Oracle 数据库设置 3scale 系统镜像后，从 system-app DeploymentConfig 中删除 ORACLE_SYSTEM_PASSWORD。在升级到新版本的 3scale 前，不需要再次执行它。

   $ oc set env dc/system-app ORACLE_SYSTEM_PASSWORD-

   Copy to Clipboard Toggle word wrap

步骤

1. 根据与 3scale 一起使用的数据库，使用以下值之一设置 ${SYSTEM_DB}：

   • 如果数据库是 MySQL，则为 SYSTEM_DB=system-mysql。
   • 如果数据库是 PostgreSQL，则为 SYSTEM_DB=system-postgresql。

2. 使用现有 DeploymentConfig 创建备份文件：

   $ 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. 验证所有生成的文件是否都为空，并且所有这些文件都具有预期内容。

步骤

1. 使用以下命令检查 backend-cron 设置的当前资源要求：

   $ oc get dc backend-cron -o json | jq .spec.template.spec.containers[0].resources

   Copy to Clipboard Toggle word wrap

   如果输出为空或 null，代表没有设置资源要求。

2. 要增加当前的 backend-cron 资源要求，请运行以下命令：

   $ oc patch dc backend-cron --patch '{"spec":{"template":{"spec":{"containers":[{"name":"backend-cron","resources":{"limits":{"memory":"500Mi", "cpu": "500m"}, "requests":{"memory":"100Mi", "cpu": "100m"}}}]}}}}'

   Copy to Clipboard Toggle word wrap

   此命令会触发 backend-cron 的重新部署。等待它重新部署、对应的新容器集就绪，并且前面的容器集终止。