使用最新版本?
JFrog平台用户指南
JFrog Artifactoryx文档
要获得最新版本,请访问JFrog统一平台
需求
设置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/ artificial .default”目录下的JAVA_OPTIONS。
- 对于一个服务安装,修改中的JAVA_OPTIONSARTIFACTORY_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_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目录的存储分区很小的情况,这可能会导致"disk full"错误.
要修复此问题,请更改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用户执行以下命令:
$ARTIFACTORY_HOME/bin/installService.sh [USER [GROUP]]
安装脚本执行命令的顺序如下表所示:
用户创建 |
创建默认用户 您还可以选择运行安装脚本,通过将用户名作为第一个参数传入,以在不同的用户下启动Artifactory服务。如果包含用户名,还可以选择包含一个组。 |
等配置 |
创建文件夹/etc/opt/jfrog/artifactory ,复制配置文件,并在其中创建软链接$ ARTIFACTORY_HOME /等 |
等违约 |
创建文件 要修改JVM参数修改/etc/opt/jfrog/artifactory/default目录下的JAVA_OPTIONS |
Systemd或init。 |
如果您正在运行支持 如果 如果 |
日志文件夹 |
创建文件夹 的 |
备份文件夹 |
创建文件夹$ ARTIFACTORY_HOME /备份 ,因此,如果您希望此文件夹指向不同的位置(例如/var/backup/artifactory 例如)。该脚本使$ ARTIFACTORY_HOME /备份 用户可写ARTIFACTORY_USER . |
数据文件夹 |
创建文件夹美元ARTIFACTORY_HOME /数据 ,因此如果您希望此文件夹指向其他地方,则必须创建一个链接。该脚本使用户可以对其进行编写ARTIFACTORY_USER . |
chkconfig调用 |
脚本调用添加 而且列表 (您可以看到输出),然后激活Artifactory服务 |
运行Artifactory
要启动或停止作为服务的Artifactory,您必须以根用户身份运行。您使用的命令取决于Artifactory服务是否使用systemd
或摆在。
使用systemd
systemd修复
从Artifactory版本6.14.0开始,systemd在RedHat 7.7和8以及Ubuntu 18.04及更高版本中作为服务正常运行。
启动或停止Artifactory使用:
Systemctlartifactory.service . Systemctl artifactory.service . Systemctl
检查Artifactory服务状态
一旦Artifactory被正确安装,你可以检查它是否正在运行:
Systemctl状态
如果Artifactory正在运行,您应该看到它的pid。
如果Artifactory没有运行,您将看到服务使用的环境变量列表。
使用摆在
启动或停止Artifactory使用
服务artifactory
检查Artifactory服务状态
一旦Artifactory被正确安装,你可以检查它是否正在运行:
服务检验
如果Artifactory正在运行,您应该看到它的pid。
如果Artifactory没有运行,您将看到服务使用的环境变量列表。
检查Artifactory日志
您可以使用以下方法检查Artifactory日志以查看服务的状态:
tail -f $ARTIFACTORY_HOME/logs/artifactory.log
RPM或Debian安装
Artifactory也可以从RPM或Debian发行版安装到Red Hat兼容的Linux发行版上。
安装包创建一个专用用户,安装为Artifactory配置的精简版Apache Tomcat容器(在端口8081上),并将该Tomcat注册为服务(但不立即启动它)。
这个包有效地取代了Artifactory Zip发行版中包含的不同设置脚本。
服务,Debian/RPM和Docker安装
默认情况下,在service、Debian/RPM和Docker安装类型中,Tomcat目录将位于/opt目录下。在部署大文件的情况下,TOMCAT_HOME/temp目录(在/tomcat目录下)将存储临时文件,直到部署完成。对于分配给/opt目录的存储分区很小的情况,这可能会导致"disk full"错误.
要修复此问题,请更改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 |
Artifactory env变量 |
/等/ opt / jfrog/ artifactory /违约 |
artifactory |
Tomcat的家 |
/ opt / jfrog / artifactory / tomcat | Artifactory(子dirs的根) |
Artifactory启动脚本 |
/etc/init.d/artifactory |
根 |
Artifactory二进制 |
/ opt / jfrog / artifactory | 根 |
安装Artifactory
从RPM或Debian发行版安装Artifactory您必须以root用户运行并可以使用下面对应的命令:
JVM参数
一定要修改你的JVM参数中的JAVA_OPTIONS/etc/opt/
jfrog/
artifactory/违约
根据您的安装情况而定。
运行Artifactory
启动或停止Artifactory您必须以root用户运行并可以使用以下命令:
服务artifactory start | stop
检查Artifactory服务状态
一旦Artifactory被正确安装,你可以检查它是否正在运行:
服务检验
如果Artifactory正在运行,您应该看到它的pid。
如果Artifactory没有运行,您将看到服务使用的环境变量列表。
你也可以用以下方法检查Artifactory日志:
tail -f $ARTIFACTORY_HOME/logs/artifactory.log
当从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 Image被拉取。详情请参阅使用Docker安装.
服务,Debian/RPM和Docker安装
默认情况下,在service、Debian/RPM和Docker安装类型中,Tomcat目录将位于/opt目录下。在部署大文件的情况下,TOMCAT_HOME/temp目录(在/tomcat目录下)将存储临时文件,直到部署完成。对于分配给/opt目录的存储分区很小的情况,这可能会导致"disk full"错误.
要修复此问题,请更改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