4.4.2. 在嵌入式 APIcast 中添加自定义策略
要将自定义 APIcast 策略添加到内部部署中,您必须构建包含自定义策略的 OpenShift 镜像,并将其添加到您的部署中。3scale 提供了一个示例存储库,您可以使用作为框架来创建和添加自定义策略到内部部署。
此示例存储库包含自定义策略的正确目录结构,以及用于创建镜像流和 BuildConfig 的模板,用于构建包含您创建的任何自定义策略的新 APIcast OpenShift 镜像。
构建 apicast-custom-policies
时,构建过程会将新镜像推送到 amp-apicast:latest
标签。当此镜像流标签上的镜像更改时(:latest
),apicast-staging 和 apicast-production 标签都默认配置为自动启动新部署。为了避免对生产服务(或暂存)造成任何中断(如果您愿意),请禁用自动部署(在镜像更改时"自动启动新部署 "),或者为生产环境配置不同的镜像流标签(例如 amp-apicast:production
)。
在内部部署中添加自定义策略:
使用以下注意事项,使用您在创建 registry 服务帐户中创建的凭证创建
docker-registry
secret:-
将
your-registry-service-account-username
替换为以 12345678|username 创建的用户名。 -
将
your-registry-service-account-password
替换为用户名下面的密码字符串,位于 Token Information 选项卡下。 为每个镜像流所在并使用 registry.redhat.io 的新
命名空间
创建一个docker-registry
secret。运行这个命令来创建
docker-registry
secret:oc create secret docker-registry threescale-registry-auth \ --docker-server=registry.redhat.io \ --docker-username="your-registry-service-account-username" \ --docker-password="your-registry-service-account-password"
-
将
- 使用策略示例对 https://github.com/3scale/apicast-example-policy [public 软件仓库进行分叉,或使用其内容创建私有存储库。您需要在 Git 存储库中提供自定义策略的代码,供 OpenShift 构建该镜像。请注意,为了使用私有 Git 存储库,您必须在 OpenShift 中设置机密。
- 在本地克隆存储库,为您的策略添加实施,并将更改推送到您的 Git 存储库。
更新
openshift.yml
模板。特别是,更改以下参数:-
策略 BuildConfig 中的
spec.source.git.uri: https://github.com/3scale/apicast-example-policy.git
- 将它更改为 Git 存储库位置。 -
自定义策略 BuildConfig 中的
spec.source.images[0].paths.sourcePath: /opt/app-root/policies/example
- 把example
改为您在存储库中的policies
目录下添加的自定义策略名称。 -
(可选)更新 OpenShift 对象名称和镜像标签。但是,您必须确保更改是共同的(例如:
apicast-example-policy
BuildConfig 构建),并推送apicast-policy:example
镜像,然后被apicast-custom-policies
BuildConfig 作为源使用。因此,标签应该相同。
-
策略 BuildConfig 中的
运行以下命令来创建 OpenShift 对象:
oc new-app -f openshift.yml --param AMP_RELEASE=2.8
如果构建没有自动启动,请运行以下两个命令:如果您更改了它,请将
apicast-example-policy
替换为您自己的 BuildConfig 名称(如apicast-<name>-policy
)。等待第一个命令完成,然后执行第二个命令。oc start-build apicast-example-policy oc start-build apicast-custom-policies
如果内置 APIcast 镜像跟踪 amp-apicast:latest
镜像流中的更改,则 APIcast 的新部署将启动。apicast-staging
重启后,导航到 Integration > Policies,然后点击 Add Policy 按钮来查看列出的自定义策略。选择并配置后,单击 Update Policy Chain,使自定义策略在暂存 APIcast 中正常工作。