需要其他JFrog产品的帮助?hth华体会最新官方网站

JFrog平台
JFrog Artifactory
JFrog x光
JFrog任务控制中心
JFrog分布
(JFrog管道)
JFrog访问


页面树
跳到元数据的末尾
进入元数据的开始

欢迎来到JFrog CLI

JFrog CLI是一个紧凑而智能的客户端,它提供了一个简单的界面,可以自动访问JFrog产品,简化您的自动化脚本,使它们更易于阅读和维护。hth华体会最新官方网站JFrog CLI与JFrog Artifactory, Xray, Distribution和Mission Control一起工作(通过他们各自的REST api),使您的脚本在以下几个方面更加高效和可靠:

并行上传和下载

JFrog CLI允许您通过可配置数量的线程并发上传和下载构件,帮助您的自动化构建运行得更快。对于大型工件,您可以定义许多块来拆分文件以进行并行下载。

校验和优化

JFrog CLI通过跳过已经存在于目标位置的工件来优化上传和下载操作。在上传工件之前,JFrog CLI用工件的校验和查询Artifactory。如果它已经存在于Artifactory的存储中,CLI将跳过发送该文件,如果有必要,Artifactory只更新其数据库以反映工件上传。类似地,当从Artifactory下载工件时,如果工件已经存在于相同的下载路径中,它将被跳过。使用校验和优化,长时间的上传和下载操作可以在中间暂停,然后在稍后停止的地方继续。

灵活的上传和下载

JFrog CLI支持使用通配符模式、正则表达式和ANT模式上传文件到Artifactory,让您轻松收集所有您希望上传的文件。您还可以使用通配符模式下载文件。

上传及下载预览

控件可以使用所有上传和下载操作——即将选项,让您预览将与当前命令上传的所有文件。


JFrog CLI v2

概述

JFrog CLI v2于2021年7月推出。它包括对一些遗留的JFrog CLI命令的功能和用法的更改。这些变化是我们通过GitHub从用户那里得到的反馈,使使用和功能更容易、更直观。例如,一些默认值改变了,现在在不同的命令之间更加一致。我们也利用这个机会来改进和重组代码,以及替换旧的和过时的功能。

与v1版本相比,v2中包含的大多数更改都是突破性的更改。因此,我们在JFrog CLI v2下打包并发布了这些更改,允许用户在准备好时才迁移到v2。

JFrog CLI的新增强计划仅作为V2的一部分引入。目前,V1很少受到开发关注。因此,我们鼓励尚未迁移到V2的用户这样做。

JFrog CLI v2的变更列表

  1. 的默认值——平选项现在设置为falseJfrog rt上传命令。
  2. 的已弃用语法n . n .不再支持Command。要使用新语法,首先需要使用Jfrog rt MVNC命令。
  3. 的已弃用语法青蛙不gradle不再支持Command。要使用新语法,首先需要使用我的青蛙命令。
  4. 的已弃用语法Jfrog rt NPM而且Jfrog rt npm-ci不再支持命令。要使用新语法,首先需要使用Jfrog rt NPMC命令。
  5. 的已弃用语法青蛙不走不再支持Command。要使用新语法,首先需要使用Jfrog rt go-config命令。
  6. 的已弃用语法Jfrog rt nuget不再支持Command。要使用新语法,首先需要使用青蛙金币命令。
  7. 删除所有Bintray命令。
  8. Jfrog rt config命令将被删除并替换为Jfrog config add命令。
  9. Jfrog rt使用命令将被删除并替换为Jfrog配置使用
  10. ——道具命令选项和道具属性的文件规范Jfrog rt上传命令将被删除,并替换为——target-props命令选项和targetProps文件规格属性分别。
  11. 删除以下命令

    Jfrog rt release-bundle-create Jfrog rt release-bundle-delete Jfrog rt release-bundle-distribute Jfrog rt release-bundle-sign Jfrog rt release-bundle-update

    而且分别替换为以下命令

    Jfrog ds release-bundle-create Jfrog ds release-bundle-delete Jfrog ds release-bundle-distribute Jfrog ds release-bundle-sign Jfrog ds release-bundle-update
  12. 去出版吧命令现在只支持Artifactory 6.10.0及以上版本。此外,该命令不再接受目标存储库作为参数。方法对目标存储库进行预配置Jfrog rt go-config命令。
  13. 青蛙不走如果在Artifactory中找不到依赖项,命令将不再回落到VCS。
  14. ——deps——publish-deps——no-registry而且——自我的选项去出版吧命令现在删除。
  15. ——apiKey选项现在被删除。的值传递API键——密码选择。
  16. ——exclude-patterns选项现在被删除,并替换为——除外选择。同样适用于excludePatterns属性,该属性将替换为除外责任财产。
  17. JFROG_CLI_JCENTER_REMOTE_SERVER而且JFROG_CLI_JCENTER_REMOTE_REPO环境变量现在被删除并替换为JFROG_CLI_EXTRACTORS_REMOTE环境变量。
  18. JFROG_CLI_HOME环境变量现在被删除并替换为JFROG_CLI_HOME_DIR环境变量。
  19. JFROG_CLI_OFFER_CONFIG环境变量现在被删除并替换为CI环境变量。将CI设置为true将禁用所有提示符。
  20. 目录结构现在被更改Jfrog rt下载命令与占位符和-一起使用产品——= false(——flat=false现在是默认值)。类的值,当使用占位符时——平选项被忽略。
  21. Jfrog rt上传命令现在将符号链接上传到Atyifctory,被符号链接引用的目标文件将以符号链接的名称上传到Artifactory。如果——符号链接选项,符号链接本身(不是引用的文件)被上传,引用的文件作为附加到文件的属性。


下载安装

一般

要下载可执行文件,请访问JFrog CLI下载站点

您也可以从JFrog CLI项目在GitHub上,您还可以找到关于如何构建JFrog CLI的说明。

JFrog CLI的可执行文件的旧名称是jfrog.为了使CLI的使用更简单、更方便,我们最近发布了一系列新的安装程序,这些安装程序使用新的摩根富林明可执行文件的名字。为了向后兼容,旧的安装程序仍然可用。但是,我们建议迁移到更新的版本摩根富林明可执行文件的名字。

JFrog CLI v2“jf”安装程序

以下安装程序可用于JFrog CLI v2。这些安装程序使得JFrog CLI可以通过摩根富林明可执行文件。

Debian
wget - qo - https://releases.jfrog.io/artifactory/jfrog-gpg-public/jfrog_public_gpg.key | sudo apt-key add - echo "deb https://releases.jfrog.io/artifactory/jfrog-debs xenial contrib" | sudo tee -a /etc/apt/sources.list;恰当的更新;安装-y jfrog-cli-v2-jf;
RPM
Echo "[jfrog-cli]" > jfrog-cli.repo;Echo "name=jfrog-cli" >> jfrog-cli.repo;回声“baseurl = https://releases.jfrog。Io /artifactory/jfrog-rpm " >> jfrog-cli.repo;>> jfrog-cli.repo;RPM—import https://releases.jfrog.io/artifactory/jfrog-gpg-public/jfrog_public_gpg.key sudo mv jfrog-cli。回购/etc/yum.repos.d /;Yum install -y jfrog-cli-v2-jf;
家酿
编译安装jfrog-cli
使用cUrl安装
curl -fL https://install-cli.jfrog.io | sh
使用cUrl下载
curl -fL https://getcli.jfrog.io/v2-jf | sh
NPM
NPM安装-g jfrog-cli-v2-jf
码头工人
docker运行release -docker.jfrog。io/jfrog/jfrog-cli-v2-jf jf -v Full: docker run releases-docker.jfrog. io/jfrog -cli-v2-jf jf -v FullIo /jfrog/jfrog-cli-full-v2-jf jf -v
Powershell
powershell "Start-Process -Wait -Verb RunAs powershell '-NoProfile iwr https://releases.jfrog.io/artifactory/jfrog-cli/v2-jf/[RELEASE]/ j青蛙-cli-windows-amd64/jf.exe -OutFile $env:SYSTEMROOT\system32\jf.exe'"
巧克力色
Choco安装jfrog-cli-v2-jf


JFrog CLI v2“JFrog”安装程序

以下安装程序可用于JFrog CLI v2。这些安装程序使得JFrog CLI可以通过jfrog可执行文件。

Debian
wget - qo - https://releases.jfrog.io/artifactory/jfrog-gpg-public/jfrog_public_gpg.key | sudo apt-key add - echo "deb https://releases.jfrog.io/artifactory/jfrog-debs xenial contrib" | sudo tee -a /etc/apt/sources.list;恰当的更新;安装-y jfrog-cli-v2;
RPM
Echo "[jfrog-cli]" > jfrog-cli.repo;Echo "name=jfrog-cli" >> jfrog-cli.repo;回声“baseurl = https://releases.jfrog。Io /artifactory/jfrog-rpm " >> jfrog-cli.repo;>> jfrog-cli.repo;RPM—import https://releases.jfrog.io/artifactory/jfrog-gpg-public/jfrog_public_gpg.key sudo mv jfrog-cli。回购/etc/yum.repos.d /;-y jfrog-cli-v2;
家酿
编译安装jfrog-cli
使用Curl下载
curl -fL https://getcli.jfrog.io/v2 | sh
NPM
安装-g jfrog-cli-v2
码头工人
docker运行release -docker.jfrog。io/jfrog/jfrog-cli-v2 jfrog -v Full: docker run releases-docker.jfrog. io/jfrog -cli-v2 jfrog -v FullIo /jfrog/jfrog-cli-full-v2 jfrog -v
巧克力色
Choco安装jfrog-cli


JFrog CLI v1(遗留)安装程序

以下安装可用于JFrog CLI v1。这些安装程序使得JFrog CLI可以通过jfrog可执行文件。

Debian
wget - qo - https://releases.jfrog.io/artifactory/jfrog-gpg-public/jfrog_public_gpg.key | sudo apt-key add - echo "deb https://releases.jfrog.io/artifactory/jfrog-debs xenial contrib" | sudo tee -a /etc/apt/sources.list;恰当的更新;安装jfrog-cli;
RPM
Echo "[jfrog-cli]" > jfrog-cli.repo;Echo "name=jfrog-cli" >> jfrog-cli.repo;回声“baseurl = https://releases.jfrog。Io /artifactory/jfrog-rpm " >> jfrog-cli.repo;>> jfrog-cli.repo;RPM—import https://releases.jfrog.io/artifactory/jfrog-gpg-public/jfrog_public_gpg.key sudo mv jfrog-cli。回购/etc/yum.repos.d /;Yum install -y jfrog-cli;
使用cUrl下载
curl -fL https://getcli.jfrog.io | sh
NPM
NPM install -g jfrog-cli-go
码头工人
docker运行release -docker.jfrog。io/jfrog/jfrog-cli jfrog -v Full: docker run released -docker.jfrog. ioIo /jfrog/jfrog-cli-full jfrog -v
GO111MODULE=on go get github.com/jfrog/jfrog-cli;if [-z "$GOPATH"] then binPath="$HOME/go/bin";其他binPath = " $ GOPATH / bin”;fi;mv "$binPath/jfrog-cli" "$binPath/jfrog";echo "$($binPath/jfrog -v)安装在$binPath";


系统需求

JFrog CLI运行在任何完全支持Go编程语言


使用

使用CLI,安装它在您的本地机器上,或者下载其可执行文件,将其放在文件系统中的任何位置,并将其位置添加到您的路径环境变量。


环境变量

摩根富林明选项命令显示所有支持的环境变量。

JFrog CLI使用了以下环境变量:

变量名
描述
JFROG_CLI_LOG_LEVEL

(默认值:信息)

该变量决定了JFrog命令行的日志级别。
可能取值为:信息错误、DEBUG。
如果设置为ERROR, JFrog CLI只记录错误消息。当您希望读取或解析JFrog CLI输出并且不希望记录任何其他信息时,它非常有用。

JFROG_CLI_LOG_TIMESTAMP

(默认值:时间)

控制日志消息的时间戳格式。取值包括:TIME、DATE_AND_TIME和OFF。

JFROG_CLI_HOME_DIR

(默认值:~ / .jfrog)

定义JFrog CLI主目录。

JFROG_CLI_TEMP_DIR

[默认值:操作系统的临时目录]

定义JFrog CLI使用的临时目录。

JFROG_CLI_PLUGINS_SERVER

[默认值:正式的JFrog CLI插件注册表]

配置了用于下载JFrog CLI插件的Artifactory服务器ID。

JFROG_CLI_PLUGINS_REPO

(默认值:“jfrog-cli-plugins”)

可以选择与JFROG_CLI_PLUGINS_SERVER环境变量一起使用。确定要使用的本地存储库的名称。

CI

(默认值:false)

如果为true,则禁用交互式提示和进度条。

JFrog平台配置

添加和编辑已配置的服务器

配置添加而且配置编辑命令用于添加和编辑JFrog Platform服务器配置,存储在JFrog CLI的配置存储中。这些配置的服务器可以被其他命令使用。每个命令都可以通过传入URL和登录凭证的替代值来覆盖配置的服务器详细信息。配置的值保存在JFrog CLI主目录下的文件中。

命令名
Config add / Config edit
缩写
C添加/ C编辑
命令选项


——访问令牌

(可选)

访问令牌。

——artifactory-url

(可选)

Artifactory URL。

——basic-auth-only

(默认值:false)

用于Artifactory认证。设置为true将禁用使用自动创建的访问令牌替换用户名和密码/API密钥,该令牌每小时刷新一次。用户名和密码/API密钥仍将用于使用外部工具或JFrog分发服务的命令。只能与用户名和密码/API密钥选项一起传递。

——client-cert-key-path

(可选)

PEM格式的客户端证书私钥文件。

——client-cert-path

(可选)

PEM格式的客户端证书文件。

——dist-url

(可选)

分布的URL。

——enc-password

(默认值:真实)

如果为true,配置的密码将使用Artifactory的密码进行加密加密API在被储存之前。如果为false,则配置的密码不加密。

——insecure-tls

默认值:false)

设置为true将跳过TLS证书验证,同时在配置过程中加密Artifactory密码。

——互动

[默认值:true,除非$CI为true]

如果您不希望config命令是交互式的,则设置为false。

——mission-control-url

(可选)

任务控制URL。

——密码

(可选)

JFrog平台密码。

——pipelines-url

(可选)

管道的URL。

——ssh-key-path

(可选)

用于使用Artifactory进行身份验证。SSH密钥文件路径。

url——

(可选)

JFrog平台URL。

——用户

(可选)

JFrog平台用户名。

——xray-url [可选]x射线URL。
——覆盖

(用于配置添加只有)

(默认值:false)

如果已经存在具有相同ID的实例,则覆盖实例配置。

命令参数

服务器ID 服务器配置的唯一ID。

移除已配置的服务器

配置删除命令用于删除JFrog平台的服务器配置,该配置保存在JFrog CLI的配置存储中。

命令名
配置删除
缩写
c rm
命令选项


——安静

(默认值:$ CI)

设置为true则跳过删除确认消息。

命令参数

服务器ID 要删除的服务器ID。如果不发送参数,则删除所有配置的服务器。


显示已配置的服务器

配置显示命令显示存储的配置信息。您可以通过将服务器的ID作为参数发送给命令来显示特定的服务器配置。

命令名
配置显示
缩写
c年代
命令参数

服务器ID 要显示的服务器的ID。如果不发送参数,则显示所有配置的服务器。


设置服务器为默认值

配置使用命令将已配置的服务器设置为默认值。下面的命令将使用该服务器。

命令名
配置使用
命令参数

服务器ID 要设置为默认值的服务器ID。

导出导入配置

配置导出命令生成一个令牌,该令牌存储服务器配置。方法可以使用此令牌配置进口命令,导入token中存储的配置,并保存在JFrog CLI的配置存储中。

出口

命令名
配置导出
缩写
c的前女友
命令参数

服务器ID 要导出的服务器ID

进口

命令名
配置进口
缩写
c im
命令参数

服务器的令牌 要导入的令牌

设置CI管道

ci-setup命令允许设置一个基本的CI管道与JFrog平台,同时自动配置JFrog平台为管道服务。这是一个交互式命令,它会提示您一系列问题,例如您的源代码控制详细信息、您的构建工具、构建命令和您的CI提供程序。然后,该命令使用这些信息执行以下操作:

  • 在JFrog Artifactory中创建存储库,供管道用于解析依赖项。
  • 配置JFrog x射线扫描构建。
  • 生成一个基本的CI管道,用于构建和扫描代码。

您可以使用生成的CI管道作为工作起点,然后根据需要对其进行扩展。

该命令目前支持以下包管理器:

  • Maven
  • Gradle
  • npm。

及以下CI供应商:

  • JFrog管道
  • 詹金斯
  • GitHub的行动。

用法:

摩根富林明ci-setup


代理支持

JFrog CLI支持使用HTTP/S代理。您所需要做的就是用代理URL设置HTTP_PROXY或HTTPS_PROXY环境变量。

HTTP_PROXY、HTTPS_PROXY和NO_PROXY是代理使用的行业标准。


变量名

描述

HTTP_PROXY

确定HTTP代理的URL。

HTTPS_PROXY

确定到HTTPS代理的URL。

NO_PROXY

使用此变量可以绕过代理到IP地址、子网或域。这可能包含没有协议和端口的逗号分隔的主机名或ip列表。一个典型的用法是将这个变量设置为Artifactory的IP地址。


壳自动完成

如果你在bash、zsh或fish shell中使用JFrog CLI,你可以安装JFrog CLI的自动完成脚本。

用Homebrew安装JFrog CLI ?

如果您使用Homebrew安装JFrog CLI,则bash、zsh或fish自动完成脚本将由Homebrew自动安装。请确保你的. bash_profile. zshrc按照“?Homebrew Shell完成文档

使用Oh My Zsh?

使用您最喜欢的文本编辑器,打开$ HOME /。zshrc and添加“jfrog”到插件列表。

例如:

插件=(git MVN NPM SDK jfrog)

安装自动完成bash,执行以下命令,按照提示完成安装:

Jf完成bash—install

安装自动完成zsh,执行以下命令,按照提示完成安装:

Jf完成ZSH—安装

安装自动完成,执行以下命令:

Jf完成鱼——安装

敏感数据加密

从1.37.0版本开始,JFrog CLI支持加密存储在JFrog CLI配置中的敏感数据。要启用加密,请执行以下步骤。

  • 创建一个随机的32个字符的主密钥。确保键的大小恰好是32个字符。例如f84hc22dQfhe9f8ydFwfsdn48 !wejh8A
  • 创建一个名为security.yaml~ / .jfrog /安全

    如果您通过设置JFROG_CLI_HOME_DIR环境变量修改了默认的JFrog CLI主目录,则安全/ security.yaml文件应该在配置的主目录下创建。

  • 将生成的主密钥添加到security.yaml。文件内容应为:

版本:1 masterKey: "<您的主键>"
  • 确保唯一的权限安全。yaml已经为运行JFrog CLI的用户读取。

下次JFrog CLI尝试访问配置时,该配置将被加密。

当JFrog CLI从1.37.0之前的版本升级到1.37.0或更高版本时,JFrog CLI会自动更改~/.jfrog目录,以支持1.37.0版本中引入的新功能。的内容在进行这些更改之前~ / .jfrog目录备份在~/.jfrog /备份目录中。因此,在启用敏感数据加密后,建议删除备份目录,以确保没有敏感数据未加密。


JFrog CLI插件

一般

JFrog CLI插件允许增强JFrog CLI的功能,以满足特定用户和组织的需求。插件的源代码在GitHub上作为开源Go项目进行维护。所有公共插件都已注册JFrog CLI的插件注册表.作为开发者,我们鼓励您创建插件,并与社区的其他成员公开分享。当一个插件被包含在注册表中时,它就变成了公开可用的,并且可以使用JFrog CLI进行安装。读了JFrog CLI插件开发指南如果你想创建和发布你自己的插件。

安装插件

包含的插件JFrog CLI的插件注册表可以使用以下命令进行安装。

$ jf plugin安装插件名

默认情况下,该命令将从官方公共注册表安装插件。您也可以从私有的JFrog CLI plugin注册表中安装插件,如私有插件注册表部分。

私有插件注册表

除了公开的官方JFrog CLI Plugins Registry之外,JFrog CLI还支持从私有的JFrog CLI Plugins Registry发布和安装插件。私有注册中心可以托管在任何Artifactory服务器上。它使用本地通用的Artifactory存储库来存储插件。

要创建自己的私有插件注册表,请遵循以下步骤。

  • 在Artifactory服务器上,创建一个名为jfrog-cli-plugins
  • 确保您的Artifactory服务器包含在JFrog CLI的配置中,通过运行Jf c show命令。
  • 方法配置Artifactory实例(如果需要)c add命令。
  • 将已配置服务器的ID设置为JFROG_CLI_PLUGINS_SERVER环境变量的值。
  • 如果您希望插件存储库的名称与jfrog-cli-plugins不同,请将此名称设置为JFROG_CLI_PLUGINS_REPO环境变量的值。

Jf插件安装命令现在将安装插件存储在您的私人注册表。

要将插件发布到私有注册表,在插件的sources目录的根目录中运行以下命令。该命令将为所有受支持的操作系统构建插件的源代码。所有二进制文件都将上传到配置的注册表中。

Jf plugin publish the-plugin-name -plugin-version


发布说明

发布说明JFrog CLI v2

发布说明JFrog CLI的旧版本


  • 没有标签