需要其他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,其中包括对一些遗留的JFrog CLI命令的功能和用法的更改。这些变化是我们长期以来通过GitHub从用户那里收到的反馈的结果,使使用和功能更容易,更直观。例如,一些默认值发生了变化,现在在不同的命令之间更加一致。我们还利用这个机会改进和重组代码,以及替换旧的和废弃的功能。

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

我们打算保持v1可用。然而,未来的增强功能计划作为v2的一部分引入。因此,我们鼓励用户从遗留版本迁移到v2。

JFrog CLI v2中的更改列表

  1. 的默认值——平选项现在被设置为falseJfrog rt上传命令。
  2. 的已弃用语法Jfrog rt MVN命令不再支持。要使用新语法,首先需要使用Jfrog rt MVNC命令。
  3. 的已弃用语法我的小蝌蚪命令不再支持。要使用新语法,首先需要使用Jfrog rt gradlec命令。
  4. 的已弃用语法Jfrog rt NPMJfrog rt npm-ci命令不再受支持。要使用新语法,首先需要使用Jfrog rt NPMC命令。
  5. 的已弃用语法我走吧。命令不再支持。要使用新语法,首先需要使用Jfrog rt go-config命令。
  6. 的已弃用语法我要吃点东西命令不再支持。要使用新语法,首先需要使用我很高兴命令。
  7. 删除所有Bintray命令。
  8. Jfrog rt配置命令被删除并替换为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- distribution 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_SERVERJFROG_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下载命令与占位符和-一起使用产品——= false(——flat=false现在是默认值)。当使用占位符时,——平选项被忽略。
  21. Jfrog rt上传命令现在将符号链接上传到Artifactory,由符号链接引用的目标文件被上传到具有符号链接名称的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 contribution " | sudo tee -a /etc/apt/sources.list;恰当的更新;安装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;Echo "enabled=1" >> 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
家酿
Brew安装jfrog-cli
使用cUrl安装
curl -fL https://install-cli.jfrog.io | sh
使用cUrl下载
curl -fL https://getcli.jfrog.io/v2-jf | sh
NPM
安装-g jfrog-cli-v2-jf
码头工人
Slim: docker run releases-docker.jfrog。io/jfrog/jfrog-cli-v2-jf jf -v Full: docker run releases-docker.jfrog。/jfrog/jfrog-cli-full-v2-jf
Powershell
powershell "Start-Process -Wait -Verb运行powershell '-NoProfile iwr https://releases.jfrog.io/artifactory/jfrog-cli/v2-jf/[RELEASE]/jfrog-cli-windows-amd64/jf.exe -OutFile $env:SYSTEMROOT\system32\jf.exe'"
巧克力色
安装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 contribution " | sudo tee -a /etc/apt/sources.list;恰当的更新;安装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;Echo "enabled=1" >> 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安装jfrog-cli-v2
家酿
Brew安装jfrog-cli
使用Curl下载
curl -fL https://getcli.jfrog.io/v2 | sh
NPM
NPM install -g jfrog-cli-v2
码头工人
Slim: docker run releases-docker.jfrog。io/jfrog/jfrog-cli-v2 jfrog -v Full: docker run releases-docker.jfrog。/ /jfrog/jfrog-cli-full-v2
巧克力色
安装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 contribution " | sudo tee -a /etc/apt/sources.list;恰当的更新;Apt install -y 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;Echo "enabled=1" >> 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
码头工人
Slim: docker run releases-docker.jfrog。io/jfrog/jfrog-cli jfrog -v Full: docker run releases-docker.jfrog。/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) is installed at $binPath";


系统需求

JFrog CLI可以在任何完全支持的现代操作系统上运行Go编程语言


使用

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


环境变量

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

JFrog CLI使用以下环境变量:

变量名
描述
JFROG_CLI_LOG_LEVEL

(默认值:信息)

这个变量决定了JFrog CLI的日志级别。
可能的值有:信息错误,以及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使用的临时目录。

CI

(默认值:false)

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

JFrog平台配置

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

配置添加配置编辑命令用于添加和编辑JFrog平台服务器配置,这些配置存储在JFrog CLI的配置存储中。其他命令可以使用这些配置好的服务器。通过传入URL和登录凭据的替代值,可以覆盖每个命令所配置的服务器的详细信息。配置的值保存在JFrog CLI主目录下的file中。

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


——访问令牌

(可选)

访问令牌。

——artifactory-url

(可选)

Artifactory URL。

——basic-auth-only

(默认值:false)

用于人工认证。设置为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

(可选)

任务控制中心网址。

——密码

(可选)

JFrog平台密码。

——pipelines-url

(可选)

管道的URL。

——ssh-key-path

(可选)

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

url——

(可选)

JFrog平台URL。

——用户

(可选)

JFrog平台用户名。

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

(用于配置添加只有)

(默认值:false)

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

命令参数

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

移除已配置的服务器

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

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


——安静

(默认值:$ CI)

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

命令参数

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


显示已配置的服务器

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

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

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


将服务器设置为默认值

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

命令名
配置使用
命令参数

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

导出和导入配置

配置导出命令生成令牌,令牌存储服务器配置。此令牌可由配置进口命令,导入存储在令牌中的配置,并将其保存在JFrog CLI的配置存储中。

出口

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

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

进口

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

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

设置CI管道

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

  • 在JFrog Artifactory中创建存储库,供管道使用来解析依赖项。
  • 配置JFrog Xray来扫描构建。
  • 生成一个基本的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的自动完成脚本。

安装JFrog CLI与Homebrew?

如果使用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: "<你的主密钥>"
  • 确保唯一的权限安全。已经为运行JFrog CLI的用户读取了yaml。

下次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安装plugin-name

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

私有插件注册表

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

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

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

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

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

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


发布说明

发布说明JFrog CLI v2

发布说明以获取JFrog CLI的遗留版本


  • 没有标签