需要其他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 gradle命令不再受支持。要使用新语法,需要首先使用jfrog rt gradlec命令。
  4. 已弃用的语法jfrog rt npm而且jfrog rt npm-ci不再支持命令。要使用新语法,需要首先使用jfrog rt npmc命令。
  5. 已弃用的语法jfrog rt去命令不再受支持。要使用新语法,需要首先使用jfrog rt go-config命令。
  6. 已弃用的语法jfrog rt nuget命令不再受支持。要使用新语法,需要首先使用jfrog rt nugetc命令。
  7. 删除所有Bintray命令。
  8. jfrog rt配置命令将被删除并替换为jfrog配置添加命令。
  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. jfrog rt go-publish命令现在只支持Artifactory版本6.10.0及以上。此外,该命令不再接受目标存储库作为参数。方法预先配置目标存储库jfrog rt go-config命令。
  13. jfrog rt去当在Artifactory中找不到依赖时,命令不再回落到VCS。
  14. ——deps——publish-deps——no-registry而且——自我选项的jfrog rt go-publish命令被删除。
  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上传命令现在将符号链接上传到artiyifctory,符号链接引用的目标文件将以符号链接的名称上传到Artifactory。如果——符号链接选项被使用时,符号链接本身(而不是被引用的文件)被上传,被引用的文件作为附加到文件的属性。


下载和安装

一般

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

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

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;恰当的更新;Apt install -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-rpms”> > jfrog-cli.repo;Echo "enabled=1" >>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 -fL https://install-cli.jfrog.io | sh
下载与旋度
curl -fL https://getcli.jfrog.io/v2-jf | sh
NPM
NPM install -g jfrog-cli-v2-jf
码头工人
Slim: docker运行release -docker.jfrog。io/jfrog/jfrog-cli-v2-jf jf -v Full: docker run downloads -docker.jfrog. io/jfrog/jfrog-cli-v2-jf jf -vio / 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/ jsf .exe -OutFile $env:SYSTEMROOT\system32\ jsf .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 contrib" | sudo tee -a /etc/apt/sources.list;恰当的更新;Apt install -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-rpms”> > jfrog-cli.repo;Echo "enabled=1" >>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;
家酿
酿造安装jfrog-cli
下载与旋度
curl -fL https://getcli.jfrog.io/v2 | sh
NPM
NPM install -g jfrog-cli-v2
码头工人
Slim: docker运行release -docker.jfrog。io/jfrog/jfrog-cli-v2 jfrog -v Full:运行docker release -docker.jfrog. io命令。io / jfrog jfrog-cli-full-v2 jfrog - v
巧克力色
乔科省安装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;恰当的更新;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-rpms”> > jfrog-cli.repo;Echo "enabled=1" >>RPM -import https://releases.jfrog.io/artifactory/jfrog-gpg-public/jfrog_public_gpg.key sudo mv jfrog-cli。回购/etc/yum.repos.d /;yum安装- y jfrog-cli;
下载与旋度
curl -fL https://getcli.jfrog.io | sh
NPM
NPM install -g jfrog-cli-go
码头工人
Slim: docker运行release -docker.jfrog。io/jfrog/jfrog-cli jfrog -v Full: docker run downloads -docker.jfrog. io/jfrog/jfrog-cli 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) is installed at $binPath";


系统需求

JFrog CLI运行在任何现代操作系统上,完全支持去编程语言


使用

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


环境变量

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

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

变量名
描述
JFROG_CLI_LOG_LEVEL

(默认值:信息)

该变量决定了JFrog CLI的日志级别。
可能的值是:信息错误和调试。
如果设置为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 Plugins注册表]

配置了从那里下载JFrog CLI插件的Artifactory服务器ID。

JFROG_CLI_PLUGINS_REPO

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

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

CI

(默认值:false)

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

JFrog平台配置

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

配置添加而且配置编辑命令用于添加和编辑JFrog平台服务器的配置,这些配置存储在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 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。文件内容应该是:

masterKey: <你的主键>"
  • 确保唯一的权限安全。yaml has为运行JFrog CLI的用户读取。

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

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


JFrog CLI插件

一般

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

安装插件

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

$ jf plugin install -plugin-name

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

私有插件注册表

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

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

  • 在Artifactory服务器上,创建一个名为jfrog-cli-plugins
  • 确保您的Artifactory服务器包含在JFrog CLI的配置中,通过运行摩根富林明c显示命令。
  • 方法配置您的Artifactory实例jfrog c添加命令。
  • 将配置的服务器的ID设置为JFROG_CLI_PLUGINS_SERVER环境变量的值。
  • 如果您希望插件库的名称与jfrog-cli-plugins不同,请将该名称设置为JFROG_CLI_PLUGINS_REPO环境变量的值。

摩根富林明插件安装Command现在将安装存储在您的私有注册表中的插件。

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

Jf插件发布插件-name插件-version


发布说明

发布说明JFrog CLI v2

发布说明JFrog CLI的遗留版本


  • 没有标签