6.10. 安装和配置 Tekton

先决条件

• 您已安装并配置了 @backstage/plugin-kubernetes 和 @backstage/plugin-kubernetes-backend 动态插件。有关安装动态插件的详情，请参考 第 6 章 动态插件安装。
• 您已将 Kubernetes 插件配置为使用 ServiceAccount 连接到集群。

• 对于访问集群的 ServiceAccount，必须为自定义资源(PipelineRuns 和 TaskRuns)授予 ClusterRole。

  注意

  如果您配置了 RHDH Kubernetes 插件，则必须授予 ClusterRole。

• 要查看 pod 日志，您已为 pod/log 授予权限。

• 您可以使用以下代码为自定义资源和 pod 日志授予 ClusterRole ：

  kubernetes:
     ...
     customResources:
       - group: 'tekton.dev'
         apiVersion: 'v1'
         plural: 'pipelineruns'
       - group: 'tekton.dev'
         apiVersion: 'v1'
  
  
   ...
    apiVersion: rbac.authorization.k8s.io/v1
    kind: ClusterRole
    metadata:
      name: backstage-read-only
    rules:
      - apiGroups:
          - ""
        resources:
          - pods/log
        verbs:
          - get
          - list
          - watch
      ...
      - apiGroups:
          - tekton.dev
        resources:
          - pipelineruns
          - taskruns
        verbs:
          - get
          - list

  Copy to Clipboard Toggle word wrap

  您可以将准备的清单用于只读 ClusterRole，它为 Kubernetes 插件和 Tekton 插件提供访问权限。

• 在实体的 catalog-info.yaml 文件中添加以下注解，以识别实体是否包含 Kubernetes 资源：

  annotations:
    ...
  
    backstage.io/kubernetes-id: <BACKSTAGE_ENTITY_NAME>

  Copy to Clipboard Toggle word wrap

• 您还可以添加 backstage.io/kubernetes-namespace 注解来使用定义的命名空间标识 Kubernetes 资源。

  annotations:
    ...
  
    backstage.io/kubernetes-namespace: <RESOURCE_NS>

  Copy to Clipboard Toggle word wrap

• 将以下注解添加到实体的 catalog-info.yaml 文件中，以便在 RHDH 中启用 Tekton 相关功能。注解值标识 RHDH 实体的名称：

  annotations:
    ...
  
    janus-idp.io/tekton : <BACKSTAGE_ENTITY_NAME>

  Copy to Clipboard Toggle word wrap

• 添加自定义标签选择器，它 RHDH 用来查找 Kubernetes 资源。标签选择器优先于 ID 注解。

  annotations:
    ...
  
    backstage.io/kubernetes-label-selector: 'app=my-app,component=front-end'

  Copy to Clipboard Toggle word wrap

• 在资源中添加以下标签，以便 Kubernetes 插件从请求的实体获取 Kubernetes 资源：

  labels:
    ...
  
    backstage.io/kubernetes-id: <BACKSTAGE_ENTITY_NAME>

  Copy to Clipboard Toggle word wrap
  注意

  使用标签选择器时，资源上必须存在上述标签。

流程

• Tekton 插件在 RHDH 中预加载，带有基本配置属性。要启用它，将 disabled 属性设置为 false，如下所示：

  global:
    dynamic:
      includes:
        - dynamic-plugins.default.yaml
      plugins:
        - package: ./dynamic-plugins/dist/janus-idp-backstage-plugin-tekton
          disabled: false

  Copy to Clipboard Toggle word wrap

先决条件

• 已安装 Red Hat Developer Hub (RHDH)。
• 已安装 Tekton 插件。对于安装过程，请参阅 安装和配置 Tekton 插件。