第 5 章 如何调用 Fuse Online 公共 REST API 端点

流程

1. 使用具有集群管理特权的帐户登录 OpenShift。例如：

   oc login -u admin -p admin

   虽然只有 syndesis-operator grant 命令需要集群管理特权，但这个过程假设集群管理员执行所有步骤。

2. 切换到运行 Fuse Online 的 OpenShift 项目。您只在此项目中公开公共 API。例如：

   oc project fuse-online-north

3. 将角色授予 syndesis-public-oauthproxy 服务帐户。您的 OpenShift 项目使用此服务帐户来运行 OAuth 代理服务。指定具有集群管理特权的用户帐户。例如：

   syndesis-operator 授权 --user developer

   此命令创建集群角色和集群角色绑定到 syndesis-public-oauthproxy 服务帐户。ClusterRoleBinding 指定您要公开 API 的 OpenShift 项目的名称，本例中为 fuse-online-north ：

   • ClusterRole:syndesis-auth-delegator
   • ClusterRoleBinding:syndesis-fuse-online-north-auth-delegator

4. 创建客户端服务帐户，并授予其访问 Fuse Online 公共 API 的权限：

   1. 使用您选择的名称创建一个 OpenShift 服务帐户。例如，以下命令创建 cicd-client 服务帐户：

      oc create serviceaccount cicd-client

      调用公共 API 端点的命令使用此帐户来访问公共 API。另外，您需要此服务帐户获取 secret 令牌，该令牌必须在调用 API 端点时指定。这在 获取用于调用 REST API 端点的 secret 令牌 中进行了描述。

   2. 授予客户端服务帐户访问 Fuse Online 公共 API 的权限。如果 fuse-online-north 是安装 Fuse Online 的 OpenShift 项目的名称，如果 cicd-client 是您为访问 API 服务创建的服务帐户的名称，则您将执行以下命令：

      oc policy add-role-to-user edit system:serviceaccount:fuse-online-north:cicd-client`

5. 编辑 syndesis 自定义资源：

   1. 调用以下命令，这通常在编辑器中打开资源：

      oc edit syndesis

   2. 编辑资源，使其启用公共 API，并将 Fuse Online 环境的公共地址指定为 routeHostname 设置。（如果编辑了用于安装 Fuse Online 的 default-cr.yml 文件，启用公共 API 并为端点指定路由主机名，则不需要编辑资源。）

      集群设置决定了您需要指定的公共地址。详情请参阅 OpenShift 文档中的路由。在以下示例中，路由主机名对 minishift 集群有效。

      spec:
        addons:
          publicApi:
            enabled: true
            routeHostname: public-syndesis.192.168.64.63.nip.io

   3. 保存（或关闭）资源。

      保存 syndesis 自定义资源会触发 syndesis-operator （负责安装 Fuse Online）来部署公共 API OAuth 代理服务。

      如果您不需要编辑 syndesis 自定义资源，则已部署公共 API OAuth 代理服务。这可能是因为启用了 publicApi，并在用于安装 Fuse Online 的 default-cr.yml 文件中指定的路由。