4.7. 在 OpenShift Pipelines 中使用 Tekton Hub

流程

1. 创建 Tekton Hub 仓库的分叉。
2. 克隆已分叉的存储库。

3. 更新 config.yaml 文件，使其至少包含一个具有以下范围的用户：

   • 具有 agent:create 范围，如果目录中有任何更改，可以设置一个 cron 作业，该作业会在间隔后刷新 Tekton Hub 数据库。
   • 具有 catalog:refresh 范围的用户，它可以刷新目录以及 Tekton Hub 数据库中的所有资源。

   • 具有 config:refresh 范围的用户，可获取其他范围。

     ...
     scopes:
     - name: agent:create
       users: <username_registered_with_the_Git_repository_hosting_service_provider>
     - name: catalog:refresh
       users: <username_registered_with_the_Git_repository_hosting_service_provider>
     - name: config:refresh
       users: <username_registered_with_the_Git_repository_hosting_service_provider>
     ...

     支持的服务供应商有 GitHub、GitLab 和 BitBucket。

4. 使用托管供应商的 Git 存储库创建 OAuth 应用程序，并记下客户端 ID 和客户端 Secret。

   • 对于 GitHub OAuth 应用程序，将 Homepage URL 和 Authorization 回调 URL 设置为 <auth-route>。
   • 对于 GitLab OAuth 应用程序，请将 REDIRECT_URI 设为 <auth-route>/auth/gitlab/callback。
   • 对于 BitBucket OAuth 应用程序，将 Callback URL 设置为 <auth-route>。

5. 编辑 Tekton Hub API secret 的 <tekton_hub_repository>/config/02-api/20-api-secret.yaml 文件中的以下字段：

   • GH_CLIENT_ID ：通过 Git 存储库托管服务提供商创建的 OAuth 应用程序的客户端 ID。
   • GH_CLIENT_SECRET ：通过 Git 存储库托管服务提供商创建的 OAuth 应用中的客户端 Secret。
   • GHE_URL ：GitHub Enterprise URL，如果您要使用 GitHub Enterprise 进行身份验证。不要提供目录的 URL 作为此字段的值。
   • GL_CLIENT_ID ：来自 GitLab OAuth 应用程序的客户端 ID。
   • GL_CLIENT_SECRET ：来自 GitLab OAuth 应用的客户端 Secret。
   • GLE_URL: GitLab Enterprise URL（如果使用 GitLab Enterprise 进行身份验证）。不要提供目录的 URL 作为此字段的值。
   • BB_CLIENT_ID ：来自 BitBucket OAuth 应用程序的客户端 ID。
   • BB_CLIENT_SECRET ：BitBucket OAuth 应用中的客户端 Secret。
   • JWT_SIGNING_KEY ：用于签署为用户创建的 JSON Web 令牌(JWT)的随机字符串。
   • ACCESS_JWT_EXPIRES_IN ：添加访问令牌过期的时间限制。例如，1m，其中 m 表示分钟。支持的时间单位为秒(s)、分钟(m)、小时(h)、天(d)和周(w)。
   • REFRESH_JWT_EXPIRES_IN ：添加刷新令牌过期的时间限制。例如，1m，其中 m 表示分钟。支持的时间单位为秒(s)、分钟(m)、小时(h)、天(d)和周(w)。确保为令牌刷新设置的到期时间大于为令牌访问设置的到期时间。

   • AUTH_BASE_URL ： OAuth 应用程序的 Route URL。

     注意
     • 将与客户端 ID 和客户端 Secret 相关的字段用于任何托管服务供应商的 Git 存储库。
     • 通过 Git 存储库托管服务提供商注册的帐户凭据，让具有 catalog: refresh 的范围可以验证和加载所有目录资源到数据库。
6. 提交更改并将其推送到您的已分叉的存储库。

7. 确保 TektonHub CR 类似以下示例：

   apiVersion: operator.tekton.dev/v1alpha1
   kind: TektonHub
   metadata:
     name: hub
   spec:
     targetNamespace: openshift-pipelines 1
     api:
       hubConfigUrl: https://raw.githubusercontent.com/tektoncd/hub/main/config.yaml 2

   1

   需要安装 Tekton Hub 的命名空间；默认为 openshift-pipelines。

   2

   使用您 fork 仓库的 config.yaml 文件的 URL 替换。

8. 安装 Tekton Hub。

   $ oc apply -f TektonHub.yaml 1

   1

   TektonConfig CR 的文件名或路径。

9. 检查安装的状态。

   $ oc get tektonhub.operator.tekton.dev
   NAME   VERSION   READY   REASON   APIURL                    UIURL
   hub    v1.7.2    True             https://api.route.url/    https://ui.route.url/