jfrog

JFrog CLI 制品与构建管理

补充说明

jfrog（jf）是 JFrog Artifactory/Xray/Pipelines 的命令行客户端，负责上传下载制品、发布构建信息和扫描依赖。

常用示例

jf config add artifactory --url https://art.example.com --user app --password "$PASSWORD"
jf config show
jf login artifactory
jf rt upload ./dist/ libs-release-local/app/1.0/
jf rt download libs-release-local/app/1.0/ ./dist/
jf rt build-publish app 1.0.0
jf rt build-download app 1.0.0
jf rt search 'libs-release-local/**'
jf scan ./dist/app.tar.gz
jf xr scan --build-name=app --build-number=1.0.0

常见配置

jf config add artifactory \
  --url https://art.example.com \
  --access-token "$JFROG_TOKEN" \
  --interactive=false

易错点与排错

• server ID 在命令里要一致；多环境用不同 ID，避免传错仓库。
• 优先用 access token/API key，不要把密码写进脚本或历史。
• 仓库路径和虚拟仓库/远程仓库的解析规则不同；先确认仓库类型。
• build-publish 需要先收集构建信息（env/git），否则发布内容不完整。
• Xray 扫描需要相应许可证和索引；扫描失败不一定是依赖有问题。
• 并发上传要控制连接数和重试；大文件注意网络和磁盘。
• 制品校验和、覆盖策略和保留期要在仓库侧配置。

相关命令

• nexus — 另一种制品仓库
• docker — 容器镜像
• npm / mvn — 客户端