红帽全球峰会5.3. Pipelines as Code 解析器注解
您可以使用 Pipelines as Code 解析器注解来引用 Task 和 Pipeline 自定义资源(CR)定义。Pipelines as Code 解析器从注解中指定的位置获取定义。如果在获取远程任务或解析它们时出现错误，Pipelines as Code 将停止处理任务。
如果您在管道运行或 PipelineRun 或 PipelineSpec 对象中引用远程任务，Pipelines as Code 解析器会自动解析引用的资源，并将其包含在生成的 PipelineRun 自定义资源(CR)中。
5.3.1. 远程任务注解
要包含远程任务，请参阅以下注解示例：
引用 Tekton Hub 中的远程任务
在 Tekton Hub 中引用单个远程任务。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow ... pipelinesascode.tekton.dev/task: "git-clone" ...
... pipelinesascode.tekton.dev/task: "git-clone"1 ...- 1
- Pipelines as Code 包括来自 Tekton Hub 的任务的最新版本。
引用 Tekton Hub 中的多个远程任务
Copy to Clipboard Copied! Toggle word wrap Toggle overflow ... pipelinesascode.tekton.dev/task: "[git-clone, golang-test, tkn]" ...
... pipelinesascode.tekton.dev/task: "[git-clone, golang-test, tkn]" ...使用
-<NUMBER>后缀引用 Tekton Hub 中的多个远程任务。Copy to Clipboard Copied! Toggle word wrap Toggle overflow ... pipelinesascode.tekton.dev/task: "git-clone" pipelinesascode.tekton.dev/task-1: "golang-test" pipelinesascode.tekton.dev/task-2: "tkn" ...
... pipelinesascode.tekton.dev/task: "git-clone" pipelinesascode.tekton.dev/task-1: "golang-test" pipelinesascode.tekton.dev/task-2: "tkn"1 ...- 1
- 默认情况下，Pipelines as Code 会将字符串解析为从 Tekton Hub 获取最新的任务。
引用 Tekton Hub 中的远程任务的特定版本。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow ... pipelinesascode.tekton.dev/task: "[git-clone:0.1]" ...
... pipelinesascode.tekton.dev/task: "[git-clone:0.1]"1 ...- 1
- 引用 Tekton Hub 中的
git-clone远程任务的0.1版本。
使用 URL 的远程任务
... pipelinesascode.tekton.dev/task: "<https://remote.url/task.yaml>" ...
...
pipelinesascode.tekton.dev/task: "<https://remote.url/task.yaml>"
...- 1
- 远程任务的公共 URL。注意
如果使用 GitHub，远程任务 URL 使用与
Repository自定义资源定义 (CRD) 相同的主机，Pipelines as Code 会使用 GitHub 令牌并使用 GitHub API 获取 URL。例如，如果您有一个类似于
https://github.com/<organization>/<repository>的存储库 URL，远程 HTTP URL 引用类似于https://github.com/<organization>/<repository>/blob/<mainbranch>/<path>/<file> 的 GitHub blob，Pipelines as Code 会使用 GitHub App 令牌从该私有存储库中获取任务定义文件。当您使用公共 GitHub 存储库时，Pipelines as Code 的行为与 GitHub 原始 URL 类似，如
https://raw.githubusercontent.com/<organization>/<repository>/<mainbranch>/<path>/<file>。- GitHub App 令牌的范围为所有者或存储库所在的机构。使用 GitHub Webhook 方法时，您可以在允许个人令牌的任何机构中获取任何私有或公共存储库。
从存储库内的 YAML 文件中引用任务
... pipelinesascode.tekton.dev/task: "<share/tasks/git-clone.yaml>" ...
...
pipelinesascode.tekton.dev/task: "<share/tasks/git-clone.yaml>"
...- 1
- 到包含任务定义的本地文件的相对路径。
5.3.2. 远程管道注解
您可以使用远程管道注解在多个存储库间共享管道定义。
...
pipelinesascode.tekton.dev/pipeline: "<https://git.provider/raw/pipeline.yaml>"
...
...
pipelinesascode.tekton.dev/pipeline: "<https://git.provider/raw/pipeline.yaml>"
...- 1
- 远程管道定义的 URL。您还可以为同一存储库中的文件提供位置。
您只能使用注解引用一个管道定义。
5.3.2.1. 覆盖远程管道中的任务
默认情况下，如果您在管道运行中使用远程管道注解，Pipelines as Code 会使用作为远程管道一部分的所有任务。
您可以通过在管道运行中添加任务注解来覆盖远程管道中的任务。添加的任务必须与远程管道中的任务的名称相同。
例如，您可以使用以下管道运行定义：
引用远程管道和覆盖任务的管道运行定义示例
apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
annotations:
pipelinesascode.tekton.dev/pipeline: "https://git.provider/raw/pipeline.yaml"
pipelinesascode.tekton.dev/task: "./my-git-clone-task.yaml"
apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
annotations:
pipelinesascode.tekton.dev/pipeline: "https://git.provider/raw/pipeline.yaml"
pipelinesascode.tekton.dev/task: "./my-git-clone-task.yaml"
在本例中，假设位于 https://git.provider/raw/pipeline.yaml 的远程任务包括一个名为 git-clone 的任务，并且 my-git-clone-task.yaml 文件定义的任务也命名为 git-clone。
在这种情况下，管道运行执行远程管道，但将管道中名为 git-clone 的任务替换为您定义的任务。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}