Agent Skills
返回列表
Nexus 制品库 REST 工具

Nexus 制品库 REST 工具

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3a0f7c7a/restartx-nexus-repository。

技能介绍

要解决什么问题

团队在 Sonatype Nexus Repository Manager 3 上托管 Maven、npm 或 Raw 制品时,日常运维往往离不开「列仓库」「搜某个包某版本」「往 Raw 托管库丢文件」「按 URL 拉资产」「误传后按构件 id 删组件」。官方 UI 能做的事不少,但在脚本、CI 或对话式助手里要重复操作时,直接调 REST 更清晰;自己拼 curl 又要记路径、参数和 id 流转。

本技能把能力收敛到 单一自包含 Python CLI(scripts/nexus_cli.py),由助手在合适场景下触发,用环境变量或 ~/.devops-skills/nexus.json 里的连接信息连上 Nexus。

核心能力与工作方式

  • 浏览与列举:列出仓库、查看某仓库里有哪些组件(例如弄清 maven-releases 里有什么)。
  • 搜索构件:按包名、版本等条件查找制品,为后续下载或删除拿到准确的构件信息。
  • Raw 上传:向 raw 格式的 hosted 仓库 上传文件;Maven/npm 等格式有各自的上传字段,raw 覆盖最常见的「发布一个文件」场景。
  • 下载:按资产 URL 拉取文件到本地或流水线。
  • 删除:在确认 id 后删除组件;需先通过 search 或 list-components 拿到 component id。

命令约定统一:标准输出为 JSON,失败时非零退出,便于在 shell 或自动化里解析。启动前 CLI 会检查 Nexus /service/rest/v1/status 与 Server 头,仅支持 Nexus Repository Manager 3.0+;Nexus 2 不在支持范围内。

适用边界与注意点

  • 连接与密钥:一次性配置环境变量或 JSON 配置文件即可,需 Python 3.8+ 与 requests(详见技能内使用手册)。
  • 若确需在未通过版本检查的环境上运行,可设置 NEXUS_SKIP_VERSION_CHECK=1 或 DEVOPS_SKILLS_SKIP_VERSION_CHECK=1,但应明确知晓风险。
  • 删除不可恢复:删除前必须用 search/list-components 核对 id,避免误删生产制品。

使用场景

  • 发布前要在 Raw 托管库里核对是否已有同名路径文件,需先 list/browse 再决定是否 upload-raw
  • CI 失败日志里只有 GAV 或包名,要在 maven-releases 里 search 出精确版本再 download
  • 运维收到清理误传二进制请求,需 search 拿 component id 再 delete,避免删错相邻构件
  • 内网镜像只暴露 Nexus URL,排查依赖缺失时要按 URL download 资产到本机比对

适合人员

  • 负责公司私服 Nexus 3、经常被研发问「这个包在不在仓库里」的 DevOps 工程师
  • 写 Jenkins/GitLab CI 流水线、要把构建产物推到 Raw hosted 或从 Nexus 拉依赖的发布工程师
  • 做制品治理与合规审计、需要可脚本化列举仓库与构件的信息安全 / 平台同学
  • 多环境 Nexus 联调时,不愿反复点 UI、希望通过对话触发 list/search/upload 的后端开发