第 7 章 Pipelines as Code 命令参考

您可以使用 tkn pac CLI 工具控制 Pipelines as Code。您还可以使用 TektonConfig 自定义资源将 Pipelines 配置为代码日志，并使用 oc 命令查看 Pipelines as Code 日志。

7.1. Pipelines as Code 命令参考

tkn pac CLI 工具提供以下功能：

提示

您可以使用与功能对应的命令进行测试和试验，因此您不必对包含应用源代码的 Git 仓库进行更改。

$ tkn pac [command or options] [arguments]

$ tkn pac --help

表 7.1. 将管道作为代码安装和配置引导
命令	描述
`tkn pac bootstrap`	安装并配置 Pipelines 作为 Git 仓库托管服务提供商的 Code，如 GitHub 和 GitHub Enterprise。
`tkn pac bootstrap --nightly`	安装每天（nightly）构建的 Pipelines as Code。
`tkn pac bootstrap --route-url <public_url_to_ingress_spec>`	覆盖 OpenShift 路由 URL。默认情况下，`tkn pac bootstrap` 会检测 OpenShift 路由，该路由会自动与 Pipelines as Code 控制器服务关联。如果您没有 OpenShift Container Platform 集群，它会要求您输入指向入口端点的公共 URL。
`tkn pac bootstrap github-app`	在 `openshift-pipelines` 命名空间中创建 GitHub 应用程序和 secret。

表 7.2. 管理 Pipelines 作为代码软件仓库
命令	描述
`tkn pac create repository`	根据管道运行模板创建一个新的 Pipelines as Code 仓库以及一个命名空间。
`tkn pac list`	列出所有 Pipelines as Code 软件仓库，并显示关联运行的最后一个状态。
`tkn pac repo describe`	描述一个 Pipelines as Code 仓库和相关联的运行。

表 7.3. 使用 Pipelines as Code 创建管道运行
命令	描述
`tkn pac generate`	生成简单的管道运行。从包含源代码的目录执行时，它会自动检测当前的 Git 信息。另外，它使用基本的语言检测功能，并根据语言添加额外的任务。例如，如果它在仓库的 root 中检测到一个 `setup.py` 文件，则 pylint 任务会自动添加到生成的管道运行中。

表 7.4. 使用 Pipelines as Code 解析并执行管道运行
命令	描述
`tkn pac resolve`	执行管道运行，就像由 Pipelines as Code 服务中所有的一样。
`tkn pac resolve -f .tekton/pull-request.yaml \| oc apply -f -`	显示在 `.tekton/pull-request.yaml` 中使用模板的实时管道运行状态。结合在本地机器上运行的 Kubernetes 安装，您可以在不生成新提交的情况下观察管道运行。如果从源代码存储库运行命令，它会尝试检测当前的 Git 信息并自动解析当前修订或分支等参数。
`tkn pac resolve -f .tekton/pr.yaml -p revision=main -p repo_name=<repository_name>`	通过覆盖从 Git 存储库派生的默认参数值来执行管道运行。 `-f` 选项也可以接受目录路径，并在该目录中的所有 `.yaml` 或 `.yml` 文件中应用 `tkn pac resolve` 命令。您还可以在同一命令中多次使用 `-f` 标志。您可以使用 `-p` 选项指定参数值，覆盖 Git 仓库收集的默认信息。例如，您可以使用 Git 分支作为修订和不同的仓库名称。