云服务器内容精选

  • 查看微服务 进入微服务,在微服务列表页单击微服务名称,可查看微服务详细信息。 概览 概览页展示微服务的创建人、创建时间以及代码源等信息,可根据需要编辑微服务语言、关联的代码仓库和描述信息。 更换代码仓库时,如果微服务下存在没有关闭的变更或运行中的流水线,页面会弹出“数据处理”侧滑框,需先关闭所有变更并停止所有运行中的流水线。 变更 管理微服务下的变更信息,详情请参见变更管理。 流水线 管理微服务下的流水线资源,微服务下的流水线和普通流水线有如下区别: 微服务中,创建流水线时代码仓库不可更改,默认与微服务绑定的代码仓库一致。 修改微服务的代码仓库,微服务下所有流水线配置的代码库会自动更改。 微服务中,可创建一条“变更流水线”,用于联动微服务下的变更,发布变更资源,更多变更流水线的说明,参见变更与流水线。 父主题: 微服务管理
  • 概览 流水线权限从上到下可以分成三个层级,分别控制不同模块不同粒度的用户行为。 层级 模块 描述 租户级权限控制 扩展插件、策略(租户级)、租户级规则、流水线模板 控制租户账号下各模块资源,在统一身份认证服务中进行配置,生效范围为整个租户下的全部项目。 项目级权限控制 流水线、策略(项目级)、微服务、变更、微服务发布和开发者联调 控制某一具体项目下的模块资源,在项目设置中进行配置,生效范围为整个项目下的全部资源。 资源级权限控制 流水线 控制某一具体流水线的操作权限,在流水线编辑状态进行配置,支持按项目成员或项目角色粒度进行设置。 父主题: 配置流水线权限
  • 函数 表达式中可使用如下内置函数。 contains 格式 contains(search, item) 含义 如果“search”包含“item”,则函数返回“true”。如果“search”是一个数组,那么如果“item”是数组中的一个元素,则此函数返回“true”;如果“search”是一个字符串,那么如果“item”是“search”的子字符串,则函数返回“true”。 示例 contains('abc', 'bc') ,函数将返回“true”。 startsWith 格式 startsWith(searchString, searchValue) 含义 如果“searchString ”以“searchValue”开始,则函数返回“true ”。 示例 startsWith('abc', 'ab'),函数将返回“true”。 endsWith 格式 endsWith(searchString, searchValue) 含义 如果“searchString”以“searchValue”结束,则函数返回“true”。 示例 endsWith('abc', 'bc'),函数将返回“true”。 对象筛选器 使用“*”语法应用筛选器并选择集合中的匹配项。 示例: 如下是流水线某次运行的jobs上下文。 则“jobs.*.status”返回“[ 'COMPLETED', 'FAILED' ]”。 可结合contains函数一起使用,如:contains(jobs.*.status, 'FAILED'),函数将返回“true”。 { "check_job": { "status": "COMPLETED", "metrics": { "critical": "0", "major": "0" } }, "demo_job": { "status": "FAILED" } }
  • 操作步骤 登录流水线。 搜索目标流水线,单击“操作”列,选择“编辑”。 进入“任务编排”页面,切换至“参数设置”页面。 参数列表说明如下: 基本信息 说明 立即新建 单击参数列表处的“立即新建”,可以新增参数。 名称 参数名称。可自定义修改参数名称。 说明: 自定义参数名称不可与系统预定义参数名称相同。 类型 参数可选类型,包括:字符串类型、枚举类型、自增长类型。 默认值 根据需要填写/选择参数值。 私密参数 参数为私密参数时,系统会将输入参数做加密存储,使用时进行解密,同时在运行日志里不可见。 运行时设置 打开“运行时设置”开关,在执行流水线时支持修改该参数的值。 参数描述 参数的说明。 删除 单击参数所在行,可以删除该参数。 根据需要新建并配置参数。 单击参数列表下的“立即创建”,新增一个新的参数,请根据需要自定义参数名称、类型(默认为“字符串类型”)、参数值,设置私密参数或运行时设置等。 字符串类型 参数值为字符串,可在“默认值”列自定义参数值、设置为私密参数或运行时设置等。 枚举类型 选中枚举类型后弹出“枚举参数”对话框,可以设置“可选取值”。 设置完成后,单击“默认值”下拉框,在下拉列表选择其中一个值,单击参数值旁的,可修改可选取值。 自增长类型 参数值为字符串,默认值为“1.0.0”。该参数如果被流水线某个任务引用,每全新执行一次流水线后,下次执行时该参数值末位数字会自动加1。 自增长类型参数值如果不是以数字结尾,执行后就不会自动增长。
  • 背景信息 流水线参数可以传递给各个任务使用(通过“${参数名}”方式引用),实现任务间数据流动的统一,用户只需要配置好流水线参数,即可完成构建、部署、接口测试等任务的数据拉通。流水线参数包括以下两种。 自定义参数:根据需要自定义添加,参数类型包括:字符串类型、枚举类型、自增长类型。 系统预定义参数:系统默认提供的参数,无需定义,不能删除,不能修改。 针对代码托管流水线源,如果用户填写了仓库别名,则会在系统预定义参数生成仓库相关的系统参数。 针对码云流水线源,如果用户填写了仓库别名,则会在系统预定义参数生成仓库相关的系统参数。 父主题: 配置流水线参数
  • 查看变更 进入变更列表页,在变更列表页单击变更标题,进入变更详情页面。 页面展示变更概览信息、关联工作项、操作历史,还可以对变更执行提交发布、退出发布、撤销变更操作。 以下详细介绍提交发布、退出发布、撤销变更具体操作: 提交发布 针对阶段状态为“开发中”的变更,在变更详情页单击“提交发布”,弹出“提交变更”对话框。 如果微服务下不存在变更流水线,请根据提示创建变更流水线,创建流程请参见变更与流水线。 如果微服务下存在变更流水线,直接单击“确定”,即可将变更提交到变更流水线。 提交发布后,变更状态由“开发中”改变为“待发布”。 退出发布 针对阶段状态为“待发布”或“发布中”的变更,在变更详情页单击“退出发布”,弹出“退出发布”对话框。 单击“确定”,即可将变更退出变更流水线的发布列表,变更状态重置为“开发中”。 阶段状态为“发布中”的变更,如果变更流水线正在运行,则需要等待变更流水线运行完成或停止变更流水线后才可以退出发布。 撤销变更 针对阶段状态为“开发中”的变更,在变更详情页单击“撤销变更”,弹出“撤销变更”对话框。 单击“确定”,即可将变更状态改为“已撤销”。 父主题: 变更管理
  • 操作步骤 登录流水线。 在流水线列表页搜索目标流水线,单击操作列。 弹出“运行配置”侧滑框,进行如下配置: 流水线源:根据需要选择流水线源的分支或标签执行配置。 运行参数配置:如果流水线配置了运行时参数,请根据需要设置参数值并保存,可参考参数使用。 执行阶段配置:流水线支持选择任务执行,可以选择一个或多个,默认执行全部任务。 阶段如果在配置时选择了“总是运行”,则该阶段的任务默认选中且不能取消。 运行描述:填写本次运行的调试信息。 配置完成后,单击“运行”,进入流水线执行详情页面,可实时查看流水线执行进展及任务执行状态。 单击右上角“停止”,可以中止任务执行。 流水线支持并发执行,继续单击“执行”,可以再次执行流水线,单条流水线最大支持同时执行的次数由购买套餐决定(基础版:5次;专业版:10次;铂金版:15次)。 执行完成后,即可查看流水线执行结果。
  • 使用限制 单账号跟踪的事件可以通过云审计控制台查询。多账号的事件只能在账号自己的事件列表页面去查看,或者到组织追踪器配置的OBS桶中查看,也可以到组织追踪器配置的CTS/system日志流下面去查看。 用户通过云审计控制台只能查询最近7天的操作记录。如果需要查询超过7天的操作记录,您必须配置转储到对象存储服务(OBS),才可在OBS桶里面查看历史文件。否则,您将无法追溯7天以前的操作记录。 云上操作后,1分钟内可以通过云审计控制台查询管理类事件操作记录,5分钟后才可通过云审计控制台查询数据类事件操作记录。
  • env context env context包含流水线运行的自定义参数相关的信息。 名称 类型 说明 name string 自定义参数名称。 value string 自定义参数值。 内容示例 如下示例为流水线一次运行包含的env context信息,包含了两个自定义参数。 { "var_1": "val1", "var_2": "val2" } 使用示例 如需要在某个任务的输入中获取本次流水线运行的自定义参数“var_1”的值,可使用如下语法来获取。 ${{ env.var_1 }}
  • 使用场景 大部分上下文可在流水线任意任务和步骤中使用。 在任务的执行条件中引用上下文,来指定某个任务的执行条件。 示例:如下使用表示任务在指定代码源的运行分支为“master”时才运行。 ${{ sources.my_repo.target_branch == 'master' }} 在任务的输入框中引用上下文获取信息。 示例1:如下使用表示获取流水线运行的所有信息。 ${{ pipeline }} 示例2:如下使用表示获取流水线运行的触发方式。 ${{ pipeline.trigger_type }}
  • pipeline context pipeline context包含流水线运行相关的信息。 名称 类型 说明 pipeline object 流水线运行相关的所有信息,此对象包含的属性包括:project_id、pipeline_id、run_number、timestamp、trigger_type和run_id。 pipeline.project_id string 当前流水线所属项目ID,同现有系统预定义参数PROJECT_ID。 pipeline.pipeline_id string 当前流水线ID,同现有系统预定义参数PIPELINE_ID。 pipeline.run_number string 流水线执行编号,同现有系统预定义参数PIPELINE_NUMBER。 pipeline.timestamp string 流水线执行时间戳,同现有系统预定义参数TIMESTAMP。如:20211222124301。 pipeline.trigger_type string 流水线触发类型,同现有系统预定义参数PIPELINE_TRIGGER_TYPE。 pipeline.run_id string 流水线执行ID,同现有系统预定义参数PIPELINE_RUN_ID。 内容示例 如下示例为一次手动运行的流水线包含的pipeline context信息。 { "project_id": "6428c2e2b4b64affa14ec80896695c49", "pipeline_id": "f9981060660249a3856f46c2c402f244", "run_number": "168", "timestamp": "20231016000004", "trigger_type": "Manual", "run_id": "c2f507f93510459190b543e47f6c9bec" } 使用示例 如需在某个任务的输入中获取本次流水线运行的触发方式,可使用如下语法来获取。 ${{ pipeline.trigger_type }}
  • 模板类型 流水线模板包括两种类型:系统模板和自定义模板。 模板列表操作说明如下: 操作项 说明 生成流水线。单击后进入“新建流水线”页面,可快速生成对应模板的流水线。 收藏模板。单击可收藏模板,收藏后图标变为,再单击可以取消收藏。 单击后选择“编辑”,进入“任务编排”页面,可根据需要编辑模板。 单击后选择“复制”,进入“任务编排”页面,可根据需要复制模板。 单击后选择“删除”,可根据提示删除模板。 系统模板只能用来复制或生成流水线,不能编辑和删除。
  • 新建/配置模板 进入流水线模板列表。 单击模板列表“新建流水线模板”,进入“任务编排”页面。 根据需要配置模板基本信息、模板阶段/任务、模板参数等。 基本信息:可以编辑模板的名称(必填)、语言(可选择Java、Python、Node.js、Go、.Net、C++、PHP等语言,默认选择“无”)、描述(非必填)。 流水线源:无需配置。 准入设置:模板编排暂不支持配置阶段准入。 任务编排:流水线模板目前可以添加流水线阶段及部分插件,将构建、代码检查、部署、接口测试等任务配置在模板中后,通过模板创建流水线的时候会同步创建相应类型的任务。 参数设置:切换至“参数设置”页签,可根据需要为模板添加参数,流水线模板参数包括自定义参数和系统预定义参数两种,其中,自定义参数类型包括:字符串类型、枚举类型、自增长类型,配置方法请参见配置流水线参数。 配置完所有信息,单击“保存”即可。
  • 操作步骤 登录流水线。 在流水线列表页搜索目标流水线,单击流水线名称,进入流水线“运行历史”页面。 单击时间筛选器,可以根据需要选择时间段展示历史执行记录,支持查看最近31天历史执行记录,默认展示最近7天的历史执行记录,支持最近7天、14天、31天快捷切换。 首次执行时历史执行记录页面为空,执行一次后才有记录。 单击历史记录执行编号,进入“流水线详情”页面。 单击右上角,可以根据需要编辑流水线、复制流水线、删除流水线、查看流水线操作历史(新建和编辑操作)。 流水线执行详情页相关操作如下: 操作项 说明 重试 如果任务执行失败,单击页面右上角“重试”,可以选择从失败处继续执行。 编辑 单击“编辑”,可以根据编辑流水线。 运行 单击页面右上角“执行”,可以以最新的配置重新执行流水线,并生成一条新的执行纪录。 下载 单击上方产出信息,可以下载通过流水线自动构建出来的构建包。 说明: 只有构建类型的任务才有构建包。 存在多个构建包时,单击“全部下载”,可以下载全部构建包。 只展示最新构建的10个包,如需下载其他构建包,请切换到发布库页面自行下载。 查看日志 单击任务卡片,可以查看对应日志。 说明: “延时执行”和“挂起流水线”任务没有日志。 更多操作 单击页面右上角,可以根据需要复制流水线、查看流水线操作历史(新建和编辑操作记录以及触发失败记录)、预览流水线、禁用流水线、删除流水线。 说明: 默认只有项目经理或创建者(项目创建者和流水线创建者)才可以删除流水线,可通过配置权限给不同角色添加不同操作权限。
  • 配置方法 使用租户账号或其他有权限的账号登录CodeArts,单击右上角头像,选择“子账号管理”,进入统一身份认证服务控制台。 在左侧菜单栏单击“用户组”,进入用户组设置页面,新建一个用户组或选择已有用户组,单击“授权”,开始对用户组授权。 云服务选择“流水线服务”,即可查看“流水线服务”相关策略列表,包括以下几个: 策略名称 描述 CloudPipeline Tenant Rules FullAccess CodeArts租户规则设置全部权限,控制用户是否具有流水线服务租户级规则的全部权限。 CloudPipeline Tenant Rule Templates FullAccess CodeArts租户策略设置全部权限,控制用户是否具有流水线服务租户级策略的全部权限。 CloudPipeline Tenant Extensions FullAccess CodeArts租户扩展插件全部权限,控制用户是否具有流水线服务扩展插件的全部权限。 CloudPipeline Tenant Pipeline Templates FullAccess CodeArts租户流水线模板全部权限,控制用户是否具有流水线服务流水线模板的全部权限。 勾选所需策略,单击“下一步”,设置最小授权范围,完成对用户组的授权。 最后,通过用户授权或用户组管理的方式,将指定用户加入用户组,即可完成对用户的授权。 除了使用系统策略,租户还可以通过创建自定义策略的方式进行授权。