基础使用

“云原生构建基于 Docker 生态，通过声明式语法、与环境代码同源管理、资源池化等特点助力软件构建。其有声明式构建环境、缓存、插件等特性，支持按需获取计算资源，还具备 CPU 自由、读秒克隆、缓存并发等高性能表现。

“快速开始”指南以仓库为主体，通过编写配置文件描述在特定分支下发生特定事件时执行的任务，帮助用户创建并触发流水线。介绍了从创建仓库、编写配置文件到查看构建详情的步骤，并以常见需求为例详细说明了配置文件的语法和结构，强调了通过分支、事件、流水线和任务等关键要素实现流水线构建。

“构建触发规则”详细说明了云原生构建如何根据不同事件（如push、pull_request、tag_push等）在特定分支上触发流水线，并解析.cnb.yml配置文件，同时支持glob模式匹配和多种代码版本的构建选择。

云原生构建配置文件（.cnb.yml）用于定义仓库事件触发构建任务的条件和步骤，采用YAML格式，存放在仓库根目录下，支持通过PR进行变更。配置文件包括触发分支和事件、执行环境和任务脚本，支持锚点复用和跨文件配置导入，提供语法检查和自动补全功能。

该文本详细介绍了流水线语法，包括基本概念如 Pipeline、Stage 和 Job，以及它们的配置方法。文本解释了如何定义不同类型的任务，如脚本任务、内置任务和插件任务，并提供了环境变量、锁机制和条件执行的配置选项。通过示例代码，文本展示了在不同触发事件下如何配置和运行流水线。

构建环境由 Docker 容器提供，支持两种配置方式：指定已有镜像或使用 Dockerfile 动态构建。未指定时，默认使用 cnbcool/default-build-env:latest。镜像中的 VOLUME 可通过参数共享给插件任务，以 NodeJS 构建为例，可使用官方 NodeJS 镜像进行依赖安装和测试。

云原生构建通过将任务下发到指定 Docker 镜像的构建集群执行，用户可在流水线配置中通过pipeline.runner.tags指定不同集群，并通过pipeline.runner.cpus配置最大 CPU 核数，如cnb:arch:amd64支持 1 - 64 核，默认 8 核等不同配置选项 。

在云原生构建过程中，可以通过多种方式声明、导入和管理环境变量，支持在 Pipeline 和 Job 级别的设置，以及对敏感信息进行加密处理。变量名必须符合 POSIX 标准，且变量值的长度不能超过 100KiB。在使用时，变量可以在脚本任务、配置文件和多个内置及插件任务中进行替换和引用。

该文本主要介绍了云原生构建内置的默认环境变量，这些变量只读不可写。包括基础变量（如 CI、CNB 相关等众多）、提交类变量（与构建时的提交相关）、仓库类变量（和仓库信息有关）、构建类变量（构建相关的详情）、合并类变量（涉及合并类事件相关）、远程开发类变量（远程开发相关）、Issue 类变量（Issue 事件相关）、评论类变量（评论事件相关），并对变量的具体情况进行了详细说明。

在云原生构建中，流水线最长使用时间为20小时，超时后容器将自动销毁；任务若在10分钟内无输出或执行时间超过1小时（有声明时以声明的timeout为准，但最大不超过12小时）会触发超时。

云原生构建的权限与代码仓库的权限对齐。具体而言，具有代码仓库写权限的用户能触发云原生构建，而有读权限的用户可查看构建日志 。

该文本主要介绍了常见问题及解决办法，包括流水线未触发的排查流程、本地与 CI 环境差异导致的问题及解决方法、登录到流水线容器调试的参考、流水线执行脚本和登陆调试结果不同的处理，以及超时无输出和未改代码但流水线失败的原因及应对等。