mcpField
A
artifactory-module-architecture

artifactory-module-architecture

github.com/tencentbluekingクラウド・DevOps2.5k48 回インストール2 日前に更新
リポジトリ

artifactory-module-architecture について

Artifactory Module Architectureは、ビルド成果物、ファイルメタデータ、ストレージバックエンドに関する問題を調べるためのスキルです。メタデータ、タスク、実ストレージを区別し、BkRepoとディスク実装、後処理経路の確認を案内します。

主な機能

  1. 01成果物のストレージモデルとパスを解説
  2. 02BkRepoとディスクのバックエンド調査を案内
  3. 03ファイルメタデータ、タスク、ストレージを区別
  4. 04ビルド成果物のアーカイブとダウンロードに対応
  5. 05非同期処理が成果物の可視性に与える影響を確認

活用シーン

  1. 01アップロード成功後にファイルが見つからない問題を調査
  2. 02稼働中のストレージバックエンドを特定
  3. 03レポートやカスタムディレクトリのパス問題を確認
  4. 04ビルド完了後の成果物処理経路を追跡

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tencentblueking/bk-ci --skill artifactory-module-architecture

インストール後、Claude Code で/artifactory-module-architectureを入力して読み込まれたか確認します。

同梱ファイルreference/1-artifact-storage.mdreference/2-bkrepo-task-extension.md

詳細

プロジェクトの README より

Artifactory 模块架构

适用场景

  • 上传、下载、归档构建产物
  • 管理文件元数据、文件任务和下载令牌
  • 切换或排查 BkRepo / 磁盘存储后端
  • 处理报告文件、自定义目录和流水线产物路径
  • 排查构建完成后的制品后处理

不适用场景

  • 只是商店组件发布问题，不涉及制品存储
  • 只是普通文件路径拼接，不涉及制品语义和存储后端
  • 只是流水线执行问题，不涉及产物归档或下载

快速指导

  1. 先判断问题属于哪条主线：
    • 存储模型与路径：看 reference/1-artifact-storage.md
    • BkRepo、任务与扩展：看 reference/2-bkrepo-task-extension.md
  2. Artifactory 负责“文件和制品如何被存储与访问”，不是执行引擎本身。
  3. 如果问题表现为上传成功但文件找不到，先区分是：
    • 元数据没落库
    • 后端没存成功
    • 路径规则错了
    • 下载令牌或权限错了
  4. 存储后端切换或双实现问题，优先确认实际走的是 BkRepo 还是本地磁盘实现。

高信号规则

  • PROJECT_CODE / PROJECT_ID 通常仍按项目英文标识理解
  • 文件元数据、文件任务和真实后端存储不是同一层
  • BkRepo 与 Disk 是两套后端实现，排查时要先确认命中的实现类
  • 构建完成后的异步处理也会影响制品最终可见性

关键陷阱

  • 只看文件存储后端，不看元数据和任务状态
  • 路径规则变了却没同步影响下载、报告或自定义目录逻辑
  • 只验证上传接口成功，不验证后续查询、下载和清理链路
  • 把商店归档和普通流水线制品归档混成同一问题

延伸阅读

  • 存储基础：reference/1-artifact-storage.md
  • BkRepo 与任务：reference/2-bkrepo-task-extension.md
  • 涉及项目语义时：再看 project-module-architecture
  • 涉及商店归档时：再看 store-module-architecture

コメント

Markdown 対応