JFrog CLI

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 NPM和Jfrog 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_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下载命令与占位符和-一起使用产品——= 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可以通过摩根富林明可执行文件。

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-v2-jf

Echo "[jfrog-cli]" > jfrog-cli.repo;Echo "name=jfrog-cli" >> jfrog-cli.repo;回声“baseurl = https://releases.jfrog。/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 -fL https://install-cli.jfrog.io | sh

curl -fL https://getcli.jfrog.io/v2-jf | sh

安装-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 "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可执行文件。

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-v2

Echo "[jfrog-cli]" > jfrog-cli.repo;Echo "name=jfrog-cli" >> jfrog-cli.repo;回声“baseurl = https://releases.jfrog。/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 -fL https://getcli.jfrog.io/v2 | sh

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可执行文件。

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;

Echo "[jfrog-cli]" > jfrog-cli.repo;Echo "name=jfrog-cli" >> jfrog-cli.repo;回声“baseurl = https://releases.jfrog。/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 -fL https://getcli.jfrog.io | sh

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平台配置

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

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

移除已配置的服务器

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

显示已配置的服务器

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

将服务器设置为默认值

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

导出和导入配置

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

出口

进口

设置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是代理使用的行业标准。

壳自动完成

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

安装自动完成功能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: "<你的主密钥>"

• 确保唯一的权限安全。已经为运行JFrog CLI的用户读取了yaml。

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

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的遗留版本