@4cloudguru/pipeline-task-ado

中文文档
0.11.1发布于 2026/09/09Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 3760

Azure DevOps特定任务原始由Azure管道任务扩展共享.

中文使用文档
文档目录5 节
  1. 为什么这与 pipeline-task-core
  2. 同伴依赖,而非依赖
  3. 范围
  4. 警告任何移动模块的人
  5. 发展

@ 4cloudguru/ 管道任务加多

Azure DevOps 任务与 Azure管道任务共享的原始任务 扩展( e)zu管-晶体, (中文(简体) ), zu管-包装器) (中文(简体) ).

为什么这与 pipeline-task-core

@4cloudguru/pipeline-task-core 是故意的,这是故意的 平台不可识别: 进口 azure-pipelines-task-lib 也没有 undici,这就是让它 被审计和重用而不拖入 ADO 运行时间。 那块地值钱 继续.

但真正的任务需要代码 实值 ADO 特定内容——读取输入,注册 与代理人的秘密,通过代理人的代理来传送HTTP 本地化消息 。 该代码被复制到任务之间和任务之间 两个扩展重置,字节相同,由每个重置执行 scripts/check-shared-modules.js这个包裹是它的家.

分裂是关键:

pipeline-task-corepipeline-task-ado (这个)
取决于 ADO 任务 lib永远是(作为同行)
示例assertEgressHostAllowed, (中文(简体) ), redactUrl, (中文(简体) ), VerificationFailuregetBoolInputDefaultTrue,代理意识 HTTP 客户端
readUrlInput 编号 : readSecretInput 编号 : readEndpointUrl - 读取任务输入或服务连接 URL 而不使用任务- lib 的 getInput()编号 :getEndpointUrl() 调试行,该行在读取时打印原始值后,任何呼叫者才能掩盖它. readUrlInput 记录任何 URL 用户信息在值( 整数、 嵌入数、 无方案数) 中的拼写和每个证书名称的值 key=value a. 在自由形式块中进行分配; readSecretInput 记录整个数值行和日志 name=***· ; readEndpointUrl uRL 处理用于 ENDPOINT_URL_<id>。 。 。 .

把它们作为两个分光符 也是保留扩展测试的方法 接合:一个任务可以嘲笑这个包的 HTTP 表面,而安全保卫它 继续解决 -core 并保持真实。 把它们拼成一 模块将允许单 registerMock 空空守护者 存在测试 核查——绿色,检查无.

同伴依赖,而非依赖

azure-pipelines-task-lib 是一个 端点一项任务已经销售了自己的副本, 和代理配置 那个 举个例子 装了第二架就飞来 每个 .vsix 并且可以对投入和秘密作出不同的回答. undici 实值 一个可选的对等端,仅需要代理意识的 HTTP 表面.

范围

模块一次移动一个家庭, 最小的第一, 所以迁移模式 在任何安全动作之前

  • getBoolInputDefaultTrue — 失败的闭塞布尔输入
  • http-client — 代理意识, HTTPS 绑定的客户端接线 -core
  • registry-version-resolver
  • https-client
  • secure-temp ——暗含临时文件编写器(0600+独家创建). azure-pipelines-terraform副本添加了 Windows ACL 硬化和 a 擦除前取消链接通过 azure-pipelines-packer副本缺失; 在此移动地形复制件 .
  • environment-variables ——履带inv var + 秘密注册助手. azure-pipelines-terraform副本添加 registerSecret编号 : getTrackedSecretValues 用于精确匹配的秘密编辑 附加内容 azure-pipelines-packer副本不见了.
  • id-token-generator ——OIDC代币换联邦证书. azure-pipelines-terraform副本验证 SYSTEM_OIDCREQUESTURI是因为 发送前, 主机名与许可列表相对应 System.AccessToken 有证书的; azure-pipelines-packer副本仅检查 URL 方案为 https: 并缺少许可列表检查.

警告任何移动模块的人

几个消费者大门扫描 in- repo 源码 —— 说 check-proxy-parity.js, (中文(简体) ), check-artifact-trust.js, (中文(简体) ), check-egress-authorization.js,以及 PreMaskingClassL0'源级行. 当一个模块移动到这个包, 那些门都找不到了 继续退出 0。这不是假设: zu管-铁道# 949 发送代理闸门报告零呼叫 地点和绿色建筑.

因此,每次迁移都必须在同一变化中:

  1. 移动带有密码的大门 进入repo自己的套房;
  2. 将消费者的形状门替换为版本地板 ——坚持任务 取决于 @4cloudguru/pipeline-task-ado >= X (证明,不是形状);
  3. 在消费者身上保留一个行为测试 证明电线仍然坚守 结束到结束,所以消费者证明了一些事情而不是信任一个版本.

发展

npm ci
npm test            # vitest
npm run typecheck
npm run build       # tsup, dual CJS/ESM
npm run smoke       # packs the tarball and consumes it as a real task does

承诺遵循常规承诺;释放自动化,请 并用出处发布于npm.

版本与发布记录

@4cloudguru/pipeline-task-ado 共发布 21 个版本,首次发布于 2026/08/15;过去 12 个月发布了 21 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.11.1latest2026/09/091 个月前
0.11.02026/09/081 个月前
0.10.02026/09/081 个月前
0.9.12026/09/072 个月前
0.9.02026/09/072 个月前
0.8.12026/09/042 个月前

关于 @4cloudguru/pipeline-task-ado 的常见问题

@4cloudguru/pipeline-task-ado 是什么?

Azure DevOps特定任务原始由Azure管道任务扩展共享.

如何安装 @4cloudguru/pipeline-task-ado?

在项目目录运行 npm install @4cloudguru/pipeline-task-ado,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:azure-pipelines-task-lib(>=4)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@4cloudguru/pipeline-task-ado 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@4cloudguru/pipeline-task-ado 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@4cloudguru/pipeline-task-ado 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@4cloudguru/pipeline-task-ado 可以商用吗?

@4cloudguru/pipeline-task-ado 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@4cloudguru/pipeline-task-ado 的下载量有多少?

根据 npm 官方下载统计,@4cloudguru/pipeline-task-ado 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,760 次,日均约 125 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@4cloudguru/pipeline-task-ado 还在维护吗?

最新版本 0.11.1 发布于 2026/09/09(1 个月前);至今共发布 21 个版本,其中过去 12 个月发布了 21 个;首次发布于 2026/08/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。