Artifactory 6.倍

使用最新版本?
JFrog平台用户指南

全部展开 全部折叠

JFrog Artifactoryx文档
要获取最新版本，请访问JFrog统一平台

跳到元数据的末尾
转到元数据的开始

概述

请确保在开始之前检查了整个安装过程。

安装在Linux、Solaris或Mac OS上

在继续执行本页上的说明之前，请确保您已经按照中所描述的检查了整个安装过程安装Artifactory．

本页面介绍如何在Linux、Solaris或Mac OS上安装Artifactory。

所有这些平台的过程都是相同的，因此为了清楚起见，本页的其余部分将仅参考Linux。

您可以通过以下方式在Linux系统上安装Artifactory:

以root身份运行，将Artifactory作为服务或RPM发行版安装

要将Artifactory作为服务或RPM发行版安装，您必须具有root权限。

要以root身份运行，执行以下命令:

苏-

或者在所有命令前加上Sudo(例如，Sudo服务人工启动)

如果您无法获得root权限，请联系您的系统管理员。

配置数据库和文件存储

完成Artifactory安装后，请确保根据您的偏好配置了它的数据库和文件存储。详情请参阅配置数据库和配置文件存储．

页面内容

需求

设置JAVA_HOME

的章节中提到系统需求，确保你的JAVA_HOME环境变量正确设置为JDK安装。

设置Java内存参数

虽然不是严格的要求，但建议修改用于运行Artifactory的JVM内存参数。

如果您可以为Artifactory预留至少512MB的空间，那么JVM参数的推荐值如下:

推荐的最小JVM参数

存储库或并发用户数量越大，相应地需要设置的-Xms和-Xmx值就越大。建议的最小值是:

-server -Xms512m -Xmx2g -Xss256k -XX:+UseG1GC

有关硬件配置(特别是-Xmx参数)的更多建议，请参考推荐硬件．

在哪里设置JVM参数取决于你如何运行Artifactory:

  • 对于一个手动安装，修改$ARTIFACTORY_HOME/bin/artifactory.default中的JAVA_OPTIONS。
  • 对于一个服务安装，修改JAVA_OPTIONS中的ARTIFACTORY_HOME / etc /美元默认的
  • 对于一个RPM或Debian安装，修改JAVA_OPTIONS中的/etc/opt/jfrog/artifactory /默认的
  • 对于一个Docker容器安装，将EXTRA_JAVA_OPTIONS环境变量传递给码头工人运行命令

重新启动要求

要使对JVM参数的任何更改生效，需要重新启动Artifactory安装/服务/容器。


手动安装

安装Artifactory

要手动安装Artifactory，只需将Artifactory下载文件解压缩到文件系统上的某个位置。这将是你的ARTIFACTORY_HOME美元的位置。

无需进一步操作。

别忘了修改你的JVM参数中设置JAVA_OPTIONSARTIFACTORY_HOME / bin / artifactory.default美元．

运行Artifactory

你可以通过直接执行以下命令手动运行Artifactory来查看它的行为:

ARTIFACTORY_HOME / bin / artifactory.sh美元

控制台锁定在Artifactory进程上，您可以使用Ctrl + C．

要使用当前shell的环境变量，直接将Artifactory作为守护进程运行，请执行以下脚本:

美元ARTIFACTORY_HOME / bin / artifactoryctl开始

要验证Artifactory是否正在运行，您可以在浏览器中访问它:

http://SERVER_DOMAIN:8081/artifactory

例如，如果你在本地机器上进行测试，你可以使用:http://localhost:8081/artifactory

启动时间

根据您的系统性能，Artifactory可能需要几秒钟才能启动。如果您试图在Artifactory启动时通过浏览器访问它，它会在几秒钟内提供一个通知，表明它处于启动过程中。

使用相同的脚本，您可以检查Artifactory是否正在运行并显示其进程id，或者使用以下命令停止它:

检查Artifactory是否正在运行或停止 
$ARTIFACTORY_HOME/bin/artifactoryctl check | stop


服务安装

Artifactory打包为一个zip文件，附带一个捆绑的Tomcat，以及一个完整的安装脚本，可用于将其安装为在自定义用户下运行的服务。

权限

当Artifactory作为服务运行时，安装脚本将创建一个名为Artifactory它必须在安装目录上具有运行和执行权限。

因此，建议将Artifactory下载文件解压缩到一个目录中，该目录向所有用户提供运行和执行权限，例如/ opt

Mac OS不支持

目前只支持在Linux和Solaris上安装该服务。Mac OS不支持。

服务，Debian/RPM和Docker安装

默认情况下，在service、Debian/RPM和Docker安装类型中，Tomcat目录将位于/opt目录下。在部署大文件的情况下，TOMCAT_HOME/temp目录(位于/tomcat目录下)将存储临时文件，直到部署完成。在分配给/opt目录的存储分区很小的情况下，这可能会导致"磁盘已满"错误．

要解决此问题，请更改CATALINA_TEMPDIR环境变量到/var/opt/jfrog/ Artifactory /tomcat/temp(确保在启动Artifactory之前创建/var/opt/jfrog/ Artifactory /tomcat/temp)。

别忘了修改你的JVM参数根据需要设置JAVA_OPTIONS在ARTIFACTORY_HOME / etc /美元违约。

您需要重新启动服务以使更改生效。

安装Artifactory

要将Artifactory作为服务安装，请浏览到您的美元ARTIFACTORY_HOME / bin目录下，以root用户执行如下命令:

以root用户运行安装脚本 
$ARTIFACTORY_HOME/bin/installService.sh [USER [GROUP]]


安装脚本执行的命令顺序如下表所示:

用户创建

创建一个默认用户名artifactory（ARTIFACTORY_USER美元）.控件可以更改默认用户ARTIFACTORY_USER美元价值/etc/opt/jfrog/artifactory /违约．

您还可以选择运行安装脚本，通过将用户名作为第一个参数传入，在不同的用户下启动Artifactory服务。如果包含用户名，还可以选择包含组。
等配置
 创建文件夹/etc/opt/jfrog/artifactory，复制配置文件并在其中创建软链接$ ARTIFACTORY_HOME /等
等违约

创建文件/etc/opt/jfrog/artifactory /违约包含Artifactory运行所需的主要环境变量:Java_home, artifactory_user, artifactory_home, java_options，…
的/etc/opt/jfrog/artifactory /违约包含在顶部artifactoryctl并且可以包含任何设置。

修改你的JVM参数修改/etc/opt/jfrog/artifactory/default中的JAVA_OPTIONS
Systemd或init。

如果您运行的Linux发行版支持systemd，安装脚本将使用它来安装Artifactory -否则摆在将被使用。

如果systemd是否支持，安装脚本复制服务脚本文件artifactory来/etc/systemd/system/artifactory.service

如果systemd不支持并且摆在使用时，安装脚本复制服务脚本文件artifactory来/etc/init.d/artifactory
日志文件夹

创建文件夹$ ARTIFACTORY_HOME /日志，使其对用户可写ARTIFACTORY_USER并创建一个软链接美元ARTIFACTORY_HOME /日志/卡特琳娜．

的美元ARTIFACTORY_HOME / tomcat /日志文件夹链接到美元ARTIFACTORY_HOME /日志/卡特琳娜．
备份文件夹
 创建文件夹$ ARTIFACTORY_HOME /备份，因此，如果您希望此文件夹指向不同的位置(例如/var/backup/artifactory例如)。脚本使$ ARTIFACTORY_HOME /备份用户可写的ARTIFACTORY_USER．
数据文件夹
 创建文件夹美元ARTIFACTORY_HOME /数据，因此，如果您希望此文件夹指向其他地方，则必须创建链接。该脚本使用户可以编写它ARTIFACTORY_USER．
chkconfig调用
 脚本调用添加和列表(您可以看到输出)，然后激活Artifactory服务

运行Artifactory

要启动或停止Artifactory作为服务，您必须以root身份运行。您使用的命令取决于Artifactory服务是否已使用systemd或摆在。

使用systemd

systemd修复

从Artifactory 6.14.0版本开始，systemd在RedHat 7.7和8以及Ubuntu 18.04和更高版本中作为服务正常运行。

启动或停止Artifactory使用:

人工安装systemd 
Systemctl  artifactory.service

检查Artifactory服务的状态

一旦Artifactory被正确安装，你可以检查它是否正在运行:

Systemctl status artifactory.service

如果Artifactory正在运行，您应该看到它的pid。

如果Artifactory未运行，您将看到服务使用的环境变量列表。

使用摆在

启动或停止Artifactory使用

人工安装了init.d 
服务工件

检查Artifactory服务的状态

一旦Artifactory被正确安装，你可以检查它是否正在运行:

维修人工检查

如果Artifactory正在运行，您应该看到它的pid。

如果Artifactory未运行，您将看到服务使用的环境变量列表。

检查人工日志

您可以使用以下命令检查Artifactory日志以查看服务的状态:

$ARTIFACTORY_HOME/logs/artifactory.log . tail


RPM或Debian安装

Artifactory也可以从Red Hat兼容的Linux发行版上的RPM或Debian发行版安装。

安装包创建一个专用用户，安装为Artifactory配置的Apache Tomcat容器的精简版(在端口8081上)，并将该Tomcat注册为服务(但不立即启动它)。

这个包有效地替换了Artifactory Zip发行版中包含的不同设置脚本。

服务，Debian/RPM和Docker安装

默认情况下，在service、Debian/RPM和Docker安装类型中，Tomcat目录将位于/opt目录下。在部署大文件的情况下，TOMCAT_HOME/temp目录(位于/tomcat目录下)将存储临时文件，直到部署完成。在分配给/opt目录的存储分区很小的情况下，这可能会导致"磁盘已满"错误．

要解决此问题，请更改CATALINA_TMPDIR环境变量到/var/opt/jfrog/ Artifactory /tomcat/temp(确保在启动Artifactory之前创建/var/opt/jfrog/ Artifactory /tomcat/temp)。

托管文件和文件夹

当从RPM发行版安装时，Artifactory保留FHS(文件系统层次标准)格式:

文件/文件夹
位置
所有权

Artifactory回家

/var/opt/jfrog/artifactory

 artifactory

Artifactory等

/etc/opt/jfrog/artifactory

 artifactory

Artifactory日志

/var/opt/jfrog/artifactory /日志

 artifactory

人工环境变量

/等/ opt / jfrog/ artifactory /违约

 artifactory

Tomcat的家

 / opt / jfrog / artifactory / tomcat 工件(子目录的根目录)

人工启动脚本

/etc/init.d/artifactory

 根

Artifactory二进制

 / opt / jfrog / artifactory 根

安装Artifactory

从RPM或Debian发行版安装Artifactory您必须以root身份运行并可以使用下面相应的命令:

wgethttps://bintray.com/jfrog/artifactory-pro-rpms/rpm- o bintray-jfrog-artifactory-pro-rpms.repo
Sudo mv bintray-jfrog-artifactory-pro-rpm。回购/etc/yum.repos.d /
安装jfrog-artifactory-pro

wgethttps://bintray.com/jfrog/artifactory-rpms/rpm- o bintray-jfrog-artifactory-rpms.repo
Sudo mv bintray-jfrog-artifactory-rpm。回购/etc/yum.repos.d /
安装jfrog-artifactory-oss

wgethttps://bintray.com/jfrog/artifactory-rpms/rpm- o bintray-jfrog-artifactory-rpms.repo
Sudo mv bintray-jfrog-artifactory-rpm。回购/etc/yum.repos.d /
Sudo yum installjfrog-artifactory-cpp-ce

回声”黛比https://jfrog.bintray.com/artifactory-pro-debs{distribution} {components}" | sudo tee -a /etc/apt/sources.list

注意:如果您不确定，组件应该是“main”。要确定您的发行版，请运行lsb_release -c

例子:回声”黛比https://jfrog.bintray.com/artifactory-pro-debs/etc/apt/sources.list

旋度https://bintray.com/user/downloadSubjectPublicKey?username=jfrogsudo apt-key add -

Sudo apt-get update
安装jfrog-artifactory-pro

回声”黛比https://jfrog.bintray.com/artifactory-debs{distribution} {components}" | sudo tee -a /etc/apt/sources.list

注意:如果您不确定，组件应该是“main”。要确定您的发行版，请运行lsb_release- c

示例:echo "debhttps://jfrog.bintray.com/artifactory-debs/etc/apt/sources.list

旋度https://bintray.com/user/downloadSubjectPublicKey?username=jfrogsudo apt-key add -

Sudo apt-get update
Sudo apt-get install jfrog-artifactory-oss

回声”黛比https://jfrog.bintray.com/artifactory-debs{distribution} {components}" | sudo tee -a /etc/apt/sources.list

注意:如果您不确定，组件应该是“main”。要确定您的发行版，请运行lsb_release -c

示例:echo "debhttps://jfrog.bintray.com/artifactory-debs/etc/apt/sources.list

旋度https://bintray.com/user/downloadSubjectPublicKey?username=jfrogsudo apt-key add -

Sudo apt-get update
执行命令apt-get install jfrog-artifactory-cpp-ce

JVM参数

一定要修改你的JVM参数通过修改JAVA_OPTIONS/etc/opt/jfrog/artifactory/违约根据您的安装情况而定。

运行Artifactory

启动或停止人工程序您必须以root身份运行并且可以使用以下命令:

服务人工启动/停止

检查Artifactory服务的状态

一旦Artifactory被正确安装，你可以检查它是否正在运行:

维修人工检查

如果Artifactory正在运行，您应该看到它的pid。

如果Artifactory未运行，您将看到服务使用的环境变量列表。


您还可以使用以下命令检查Artifactory日志:

$ARTIFACTORY_HOME/logs/artifactory.log . tail


从RPM发行版安装时，Artifactory通常启动为根并将苏在内部ARTIFACTORY_USER美元用户。

安全

出于安全考虑，不建议离开ARTIFACTORY_USER美元变量未定义，Artifactory作为当前用户运行，特别是如果当前用户是根．

备份和恢复

当卸载Artifactory的RPM发行版时，它将保存ARTIFACTORY_HOME美元文件夹，并创建一个备份文件夹/var/opt/jfrog/同时保留到远程文件存储库的符号链接。
在安装Artifactory的新实例之后，您可以通过运行脚本从该备份中恢复配置和文件存储ARTIFACTORY_BINARY / bin / recover.backup.sh美元．

使用外部数据库

这个过程不备份外部数据库，而是备份它在Artifactory中的定义。因此，在使用外部数据库时，应该在卸载RPM之前执行手动转储，然后在开始新安装时导入。

在新机器上安装/升级

只有在同一台机器上重新安装RPM时，上面描述的备份和恢复才能工作。如果您要在一台新机器上安装或升级RPM，那么您需要使用Import，如节中所述升级Artifactory．

使用Docker运行

从3.6版开始，Artifactory可以作为Docker镜像被拉入。详情请参阅使用Docker安装．

服务，Debian/RPM和Docker安装

默认情况下，在service、Debian/RPM和Docker安装类型中，Tomcat目录将位于/opt目录下。在部署大文件的情况下，TOMCAT_HOME/temp目录(位于/tomcat目录下)将存储临时文件，直到部署完成。在分配给/opt目录的存储分区很小的情况下，这可能会导致"磁盘已满"错误．

要解决此问题，请更改CATALINA_TEMPDIR环境变量到/var/opt/jfrog/ Artifactory /tomcat/temp(确保在启动Artifactory之前创建/var/opt/jfrog/ Artifactory /tomcat/temp)。


的ARTIFACTORY_HOME文件夹

了解Artifactory主文件夹的位置非常重要，因为该文件夹存储配置和重要的存储库数据。

当Artifactory第一次运行时，它会设置一个默认配置，并在目录下创建所有必要的文件和文件夹ARTIFACTORY_HOME文件夹中。

的默认位置ARTIFACTORY_HOME是{用户．首页}/．artifactory．

要运行Artifactory，将主文件夹设置为文件系统上的不同位置(特别是在生产服务器上安装Artifactory时)，可以采用以下方式:

  • 启动Tomcat虚拟机-Dartifactory．home=<您的首选Artifactory主文件夹位置>
    -或-
  • 设置一个ARTIFACTORY_HOME环境变量，在运行安装之前指向您的首选位置。

如果主文件夹不存在，Artifactory会在启动时创建它。

Artifactory主文件夹的权限

确保运行Tomcat的用户具有写权限在Artifactory主文件夹。

访问Artifactory

Artifactory可以使用以下URL访问:

http://SERVER_DOMAIN:8081/artifactory

例如，如果你在本地机器上进行测试，你可以使用:http://localhost:8081/artifactory

  • 没有标签

JFrog.com|文档|特色有问题吗?想要报告问题?联系JFrog技术支持