3.4. 使用经过身份验证的 Git API 指定远程管道、任务或步骤操作

对于经过身份验证的 Source Control Management (SCM) API，您必须为经过身份验证的 Git 连接设置配置。

您可以使用 go-scm 库支持的 Git 存储库供应商。并非所有 go-scm 实现都已使用 Git 解析器测试，但以下供应商已知可以正常工作：

您可以配置多个 Git 供应商，也可以为同一 Git 供应商添加多个配置，以便在不同的任务运行和管道运行中使用。

使用您的唯一标识符密钥前缀在 TektonConfig 自定义资源(CR)中添加详情。

在创建管道运行时，您可以使用经过身份验证的 SCM API 从 Git 存储库指定远程管道。在创建管道或任务运行时，您可以从 Git 仓库指定远程任务。在任务中创建步骤时，您可以从 Git 存储库中引用远程 StepAction 定义。

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  name: git-pipeline-reference-demo
spec:
  pipelineRef:
    resolver: git
    params:
    - name: org
      value: tektoncd
    - name: repo
      value: catalog
    - name: revision
      value: main
    - name: pathInRepo
      value: pipeline/simple/0.1/simple.yaml
  params:
  - name: name
    value: "testPipelineRun"
  - name: sample-pipeline-parameter
    value: test

以下示例管道引用 Git 存储库中的远程任务：

apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
  name: pipeline-with-git-task-reference-demo
spec:
  tasks:
  - name: "git-task-reference-demo"
    taskRef:
      resolver: git
      params:
      - name: org
        value: tektoncd
      - name: repo
        value: catalog
      - name: revision
        value: main
      - name: pathInRepo
        value: task/git-clone/0.6/git-clone.yaml
    params:
    - name: sample-task-parameter
      value: test

以下示例任务运行引用 Git 存储库中的远程任务：

apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
  name: git-task-reference-demo
spec:
  taskRef:
    resolver: git
    params:
    - name: org
      value: tektoncd
    - name: repo
      value: catalog
    - name: revision
      value: main
    - name: pathInRepo
      value: task/git-clone/0.6/git-clone.yaml
  params:
  - name: sample-task-parameter
    value: test

以下示例任务包含引用 Git 存储库中的 StepAction 定义的步骤：

apiVersion: tekton.dev/v1
kind: Task
metadata:
  name: git-stepaction-reference-demo
spec:
  steps:
  - name: example-step
    ref:
      resolver: git
      - name: org
        value: openshift-pipelines
      - name: repo
        value: tektoncd-catalog
      - name: revision
        value: p
      - name: pathInRepo
        value: stepactions/stepaction-git-clone/0.4.1/stepaction-git-clone.yaml
    params:
    - name: sample-stepaction-parameter
      value: test

您可以在创建 TaskRun 和 PipelineRun 资源时传递唯一的 configKey 参数来指定多个 Git 供应商。

如果没有传递 configKey 参数，则会使用默认配置。您还可以通过将 configKey 值设置为 default 来指定默认配置。

您可以覆盖特定管道运行或任务中的初始配置设置，以根据不同的用例自定义行为。您可以使用此方法访问没有在 TektonConfig 自定义资源(CR)中配置的经过身份验证的供应商。

以下示例任务运行引用 Git 存储库中的远程任务来覆盖之前的解析器配置：

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: git-task-reference-demo
spec:
  taskRef:
    resolver: git
    params:
    - name: org
      value: tektoncd
    - name: repo
      value: catalog
    - name: revision
      value: main
    - name: pathInRepo
      value: task/git-clone/0.6/git-clone.yaml
    - name: token
      value: my-secret-token
    - name: tokenKey
      value: token
    - name: scmType
      value: github
    - name: serverURL
      value: https://ghe.mycompany.com