检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
从控制台获取项目ID 在调用接口的时候，部分URL中需要填入项目编号，所以需要获取到项目编号。项目编号获取步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，在下拉列表中单击“我的凭证”。 进入“我的凭证 > API凭证”页面，在项目列表中查看项目ID。 图1 查看项目ID 多项目时
合软件开发生产线中编译构建、代码检查、测试计划、部署等服务的自动化任务使用。根据用户需要的场景，如开发测试环境应用部署、生产环境应用部署等，对这些自动化任务进行自定义编排，一次配置后就可以一键自动化触发调度执行，避免频繁低效的手工操作。 流水线是软件开发生产线中的一个服务，不支持
用于连接第三方Git仓库，连接成功后可以在流水线、构建等服务中获取该仓库的分支等信息。 码云Git 用于连接码云Git账号，连接成功后可以在流水线、构建等服务中获取该账号的仓库、分支等信息。 GitHub 用于连接Github账号，连接成功后可以在流水线、构建等服务中获取该账号的仓库、分支等信息。 IAM账户
控制某一具体流水线任务的操作权限，在流水线任务中进行配置，生效范围为当前流水线任务。 租户级权限 通过统一身份认证服务，为指定用户配置流水线服务中租户级策略、租户级规则、扩展插件及流水线模板的权限。 使用租户账号或其他有权限的账号登录CodeArts。 单击右上角的用户名，选择“子账号管理”，进入统一身份认证服务控制台。
动同步人员权限；如果修改人员权限，则以人员权限为准。 若“角色权限配置”中该用户所属角色没有执行权限，则为该角色添加执行权限（此操作会导致是该角色的用户，对该条流水线都具有执行权限）。 若“角色权限配置”中该用户所属角色有执行权限，则在“人员权限配置”页签，为该用户添加执行权限。
分组管理流水线 操作场景 在项目开发过程中，一般会涉及多个流水线，为方便管理和归类，可通过流水线分组功能，将具有相同特性的流水线进行归类统一管理，提升操作效率。例如，可以将流水线按环境级别划分为生产环境流水线、测试环境流水线等多个类别；或按照研发业务划分为定时构建、开发自测、集成测试、生产部署等多个业务场景。
通过流水线生成软件包并部署到主机 流水线服务本质上是一个可视化的自动化任务调度平台，需要配合软件开发生产线中编译构建、代码检查、测试计划、部署等服务的自动化任务使用，可根据需要自定义编排，自动化调度执行，避免频繁低效的手工操作。 本节通过新建一条简单的流水线，将构建任务、代码检查
流水线执行状态，包括已完成、运行中、失败、已停止、暂停、挂起、忽略。 触发方式 触发流水线运行的方式，包括手动触发、定时任务触发、MR触发、Push触发、Webhook触发、子流水线触发等。 工作流 流水线的调度流程及执行状态（已完成、失败、运行中、已停止等）。 执行时间 流水线开始执行的时间。
命令过程中，通常会涉及和流水线执行过程中的各种数据进行交互。本节从插件的代码开发输入输出，介绍插件业务的代码实现。 自定义插件的数据输入 插件代码开发过程中获取的外部信息主要包括三部分：低代码界面配置输入、流水线运行参数、其他外部信息。 低代码界面配置输入：在插件命令中，使用环境变量获取低代码界面输出，如：echo
Deploy部署（模板） 仅支持在流水线模板中配置，该插件会在通过模板生成流水线时，依照当前配置的部署任务模板，自动创建部署任务并配置到所生成的流水线中。 Kubernetes发布 将容器镜像部署到云容器引擎（CCE）或原生Kubernetes集群中。支持滚动发布和基于集群Service的蓝绿发布。
滚动升级包括两种部署方式：镜像创建和YAML创建。 镜像创建：替换工作负载中容器的镜像。 表2 参数说明 参数项 说明 命名空间 待升级的服务所在的命名空间。 工作负载 命名空间下的工作负载。 容器 工作负载中需要升级的容器。 YAML创建：使用yaml文件升级或上线工作负载。 表3
发布管理环境变量使用示例 用户可以在以下两种场景中使用环境变量。 配置发布管理发布策略时，在所编排任务的YAML路径参数中，可以使用“${变量名}”引用环境变量，如：“滚动升级”任务中的“工作负载YAML路径”参数。 图1 引用环境变量 在发布策略关联的YAML配置文件中使用“{{变量名}}”引用环境变量。
变更管理 创建变更 查询变更详情 修改变更状态 修改变更代码仓信息 查询变更列表 查询流水线上的变更 查询发布中的变更 查询变更操作历史 查询项目下变更创建人信息 查询变更关联的工作项 更新变更关联的工作项 父主题： API
资源类型 环境关联的资源类型。 发布用户 当前用户。 服务扩展点 CCE资源的服务扩展点。 集群区域 在CCE云容器引擎中申请的K8S集群区域。 集群ID 在CCE云容器引擎中申请的K8S集群ID。 变量版本 当前环境的环境变量版本号。 标签 环境类型。 描述 描述信息。 单击右上角“编辑”，可修改环境信息。
单租户下最大微服务数量 500 单项目下最大微服务数量 50 表6 变更使用限制 指标类别 指标项 限制值 变更 单个微服务下最大进行中的变更数量（即处于开发中、待发布、发布中的变更总数） 50 单个变更关联最大关联工作项数量 10 发布流水线最大运行变更数量 10
ID为job_id的任务包含的所有信息。 jobs.<job_id>.status string 任务的运行结果，取值结果为：INIT（初始化）、QUEUED（排队中）、RUNNING（运行中）、CANCELED（已中止）、COMPLETED（成功）、FAILED（失败）、PAUSED（暂停）、IGNORED（忽略）
不可修改。 插件描述 插件描述将展示在插件市场中，介绍插件主要用途和功能，后期可修改。长度不超过1000字符。 基本信息填写完成后，单击“下一步”，进入“版本管理”页面。 单击，弹出“上传插件”对话框，选择已准备好的插件（插件中已包含输入定义、业务执行脚本等内容），然后上传。上传成功后可以看到带“草稿”标识的版本。
流水线名称，输入“Pipeline01”。 所属项目 流水线所在的项目，选择准备工作中已创建的项目“Project01”。 代码源 流水线关联的代码源类型，选择“Repo”。 代码仓 选择准备工作中已创建的代码仓“Repo01”。 默认分支 默认使用的分支，选择准备工作中已创建的分支“release-1.0.0”。
流水线执行失败，提示任务不存在或者已被删除 流水线配置的定时任务未触发 流水线执行权限不够（执行按钮不可操作） 保存流水线时提示人工审核任务中配置了不属于当前项目的审核人 流水线执行失败，提示流水线不存在 变更流水线执行失败，提示authentication required 流水线执行失败，提示没有配置部署策略
流水线服务提供基于规则和策略的准出条件管理能力，是指在流水线阶段中配置的用于自动化看护的质量指标卡点，通过配置规则和策略，来实现阶段准出校验，并最终控制流水线的执行。 规则：基于扩展插件的输出阈值，设置比较关系和阈值条件，供策略使用，并最终应用到流水线准出条件中，作为准出条件的判断依据。 策略：策略是一
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
