马修•王
2023-01-22十一10

你会得到什么?

用户添加图片

快速入门指南，介绍如何使用RPM/Debian安装为生产就绪环境安装和配置Artifactory 7 HA。在本指南中，我们将介绍如何设置Postgres外部数据库、多个人工节点和NGINX反向代理(它也可以作为负载均衡器)。每个Artifactory节点至少需要一个服务器。注意，每个Artifactory节点都需要一个许可证。我们还建议准备好一种云存储桶(例如S3)。要完全掌握本指南中的内容，需要对基于linux的操作系统有很好的理解。

开始之前

系统需求

操作系统

此安装需要以下任何一个Linux系统版本:

Centos 7。倍、8.倍
RPM 7。倍、8.倍
SUSE linux 12 SP 5

计算环境

每个节点的最低要求:4核CPU, 8GB RAM。

我们建议使用易于扩展的机器，以防人工工厂的使用量增加。

负载均衡器

这个示例安装使用NGINX负载均衡器来控制多个Artifactory HA节点。

港口

以下端口需要在内部可用:8081、8082、8040、8045、8048、9092、8070、8086、8046、8047、8049、8091、8061、8062。

端口8081和8082还需要在VM/节点和LB/反向代理之间的外部可达。它们不需要暴露给最终用户。

其他端口只需要在VM中可用，并且不被其他进程占用——其中一些端口可以通过系统进行配置。如果无法提供，请使用Yaml。

JFrog许可证

每个HA节点需要一个Artifactory许可证。

安装数据库

我们强烈建议使用带有Artifactory的外部DB—内建的Derby数据库性能会随着您上传更多工件而下降，并且不支持Artifactory HA。我们建议将数据库安装在单独的服务器上，远离Artifactory实例，但要尽量减少延迟(同一局域网)。

Artifactory支持多种数据库类型，包括mysql, oracle, mariaDB。您可以在下面的术语表中找到指向其他受支持数据库的链接。有关更多数据库建议，请参阅//www.si-fil.com/whitepaper/best-practices-for-managing-your-artifactory-database/

在这个快速入门指南中，我们将介绍Postgres的设置。

PostgreSQL支持:

9.5 (EOL)
9.6(即将上线)
10.倍
11.倍
12.倍
13.倍

外部PostgreSQL设置

1.登录到DB，运行:
用PASSWORD创建用户artifactory
创建数据库artifactory WITH OWNER=artifactory ENCODING='UTF8';
授予数据库artifactory的所有权限;
2.从PostgreSQL JDBC驱动下载站点下载对应PostgreSQL版本的JDBC驱动，并将下载的jar文件拷贝到$JFROG_HOME/artifactory/var/bootstrap/artifactory/tomcat/lib目录下。确保您的驱动程序具有所有用户的读取权限。注意，这个目录将在安装RPM/Debin时创建，或者您可以预先创建它。
3.在系统中添加数据库连接详细信息。$JFROG_HOME/artifactory/var/etc/system.yaml下的配置文件
共享: 数据库: 类型:postgresql 司机:org.postgresql.Driver Url: jdbc:postgresql://<您的数据库Url，例如:localhost:5432>/artifactory 用户名:artifactory 密码:密码
确保您的YAML间距保持一致!我们建议缩进2或4个空格，但要确保始终保持一致。

4.在Artifactory服务器上启用PostgreSQL连接:

a.在/data/pg_hba.conf中添加如下一行。主机artifactory artifactory md5

b.在/data/postgresql.conf中添加以下行(如果已经存在，请更新)

listen_addresses = ' * '

我们建议为数据库提供相当大的存储空间，即使它只存储元数据。它应该至少是预期文件存储大小的2/10。

配置filestore

二进制存储可以在“$JFROG_HOME/var/etc/artifactory/ binarstore .xml”中配置。下面是一个使用Amazon S3 bucket的样例配置。注意，这个文件/目录将在安装RPM/Debin时创建，或者您可以预先创建它。

下面是一个示例S3v3 HA配置

<配置version = " 2 " > <链模板= " cluster-s3-storage-v3 " / > 端点> < s3.amazonaws.com > < /端点 < bucketName > bucketName < / bucketName > <路径> pathPrefix > < /路径 <地区> s3Region > < /地区 <标识> yourIdentity > < /身份 <凭证> yourCredentials < /证书> 真正< usePresigning > < / usePresigning > 600年< signatureExpirySeconds > < / signatureExpirySeconds > > < /供应商 < / config >

安装步骤

1.在Red Hat兼容的Linux发行版上，以根用户的身份将Artifactory作为服务安装。Yum install -y jfrog-artifactory--.rpm

2.启用系统的HA功能。yaml(并添加DB的详细信息，如果还没有完成):共享: extraJavaOpts: "-Xms512m - xx4g " 节点: haEnabled:真 taskAffinity:任何在其他节点上，复制$JFROG_HOME/var/etc/security/master。键从第一个节点到同一位置。第一个节点将在第一次启动时自动生成该文件。同样，请确保与system.yaml中的间距一致。如果您希望提前生成自己的密钥，可以按照这里的指南进行操作。

3.配置$JFROG_HOME/var/etc/artifactory/ binarstore .xml中的文件存储。见//www.si-fil.com/confluence/display/JFROG/Configuring + + Filestore # ConfiguringtheFilestore-AmazonS3SDKClusterBinaryProvider。在本指南中，我们将使用Amazon SDK提供程序。<配置version = " 2 " > <链模板= " cluster-s3-storage-v3 " / > 端点> < s3.amazonaws.com > < /端点 < bucketName > bucketName < / bucketName > <路径> pathPrefix > < /路径 <地区> s3Region > < /地区 <标识> yourIdentity > < /身份 <凭证> yourCredentials < /证书> 真正< usePresigning > < / usePresigning > 600年< signatureExpirySeconds > < / signatureExpirySeconds > > < /供应商 < / config >
4.使用以下命令管理Artifactory:服务人工启动/停止5.检查console.log，查看以下启动成功的打印输出$JFROG_HOME/artifactory/var/log/console.log . tail [jfrou] [INFO] [470978b404ac5eac] [local_topology.]Go:270] [main] - ############################################################### 所有服务在52.558秒内启动成功 ###############################################################

6.一旦Artifactory出现，UI应该可以在端口8082上访问。通过运行以下REST API检查Artifactory是否处于HA模式，并在插件数组中查找“HA”:

$ curl localhost:8082/artifactory/api/system/version -u admin:password { 版本号:7.25.7 “revision”:“72507900” "addons": ["ha"，…如果缺少，则表示Artifactory没有以HA模式启动。或者，在启动期间，Artifactory-service.log也会打印出“Artifactory HA”的ASCII格式。如果不在HA模式下，它将打印“Artifactory Pro”。

7.对于加入集群的新节点，这些节点必须连接到相同的数据库并具有相同的主密钥。对于其他节点，重复步骤1 - 6。注意，每个Artifactory节点都需要一个许可证。

安装后的步骤

SSL

启用SSL可以使用反向代理或负载均衡器(如Nginx, Apache, HAProxy, F5等)来完成，Artifactory在Admin -> Http Settings的UI中为Nginx和Apache内置了一个配置生成器。你可以把配置放在/etc/nginx或/etc/httpd下的conf.d文件夹中

########################################################### 这个配置是由JFrog Artifactory生成的 ###########################################################

##在配置中设置HTTPS时添加SSL条目
TLSv1.1 TLSv1.2 TLSv1.3;
ssl_certificate /etc/ssl/private/server.key;
ssl_certificate_key /etc/ssl/private/server.crt;
ssl_session_cache共享:SSL: 1米;
ssl_prefer_server_ciphers;
##服务器配置
服务器{
监听443 ssl;
听80;
server_name ~ \(? <回购>。+)。artifactory_host artifactory_host;
如果($http_x_forwarded_proto = ") {
设置$http_x_forwarded_proto $scheme;
}
特定于应用程序的日志
## access_log /var/log/nginx/artifactory_host-access.log定时;
## error /var/log/nginx/artifactory_host-error.log;
重写^/$ /ui/ redirect;
重写^/ui$ /ui/ redirect;
重写^ / (v1 | v2) / (. *) / artifactory / api /码头工人/回购美元/ 1 / 2美元;
chunked_transfer_encoding;
client_max_body_size 0;
位置/ {
proxy_read_timeout 2400年代;
proxy_pass_header服务器;
proxy_cookie_path ~ * ^ /。* /;
proxy_buffer_size 128 k;
Proxy_buffers 40 128k;
proxy_busy_buffers_size 128 k;
proxy_pass http://localhost: 8082;
$http_x_forwarded_proto://$host:$server_port;
proxy_set_header X-Forwarded-Port $server_port;
$http_x_forwarded_proto;
proxy_set_header $http_host;
$proxy_add_x_forwarded_for;

位置~ ^/artifactory/ { proxy_pass http://localhost: 8081; } } }反向代理也可以配置为处理节点之间的负载平衡流量。在NGINX的情况下，你可以在顶部添加这段代码:上游人工{ 服务器10.150.0.222:8082; 服务器<附加节点IP>:8082; }

上游人工直接{ 服务器10.150.0.222:8081; 服务器<附加节点IP>:8081; }然后，将proxy_pass行修改为:proxy_pass http://localhost: 8082;→proxy_pass http://artifactory; proxy_pass http://localhost: 8081;→proxy_pass http://artifactory-direct;
否则，您可以使用专用负载平衡器来处理流量平衡。

请注意，为了支持docker请求，您需要反向代理或负载平衡器来处理请求重写。此外，如果您计划使用负载平衡器终止SSL和反向代理，则需要将以下标头硬编码为负载平衡器的详细信息。

NGINX的:proxy_set_header x - jfrog - overrides - base - url https://:; proxy_set_header X-Forwarded-Port proxy_set_header X-Forwarded-Proto https

调优人工(可选)

我们有以下可选的调优部分来针对更重的负载优化Artifactory—当Artifactory实例承担更多负载时，最好记住这些参数。

堆大小

系统中的javaOpts(堆大小)。Yaml -我们建议至少设置这个:共享: extraJavaOpts: "-Xms512m - xx4g "

数据库连接

在system.yaml中自定义数据库连接:artifactory: 数据库: maxOpenConnections: 200

访问:
数据库:
maxOpenConnections: 200

元数据: 数据库: maxOpenConnections: 200根据经验，我们需要(最多)基于以下公式的多个DB连接:
连接总数=(节点数)* (artifactory.database.)* 2) + access.database.maxOpenConnections + metadata.database.maxOpenConnections) + 50

Tomcat线程

在system.yaml中调优Tomcat线程:artifactory: tomcat: 连接器: maxThreads: 400

访问: tomcat: 连接器: maxThreads: 100当修改Access maxThreads时，需要更新$JFROG_HOME/artifactory/var/etc/artifactory/artifactory.system。属性文件:

artifactory.access.client.max.connections =

异步线程池

在同一文件中调优异步线程池。注意，corePoolSize不应超过CPU核数的8倍:artifactory.async.corePoolSize = 32 artifactory.async.poolMaxQueueSize = 100000

升级步骤

RPM升级:

1.从负载平衡器中删除第一个节点。所有请求都将被定向到其他节点。检查$HOME/logs/request.log和ARTIFACTORY_URL/api/tasks(搜索“running”)以确保Artifactory完全不活动。

2.在目标集群中，只保持一个节点运行，并对其余节点执行安全关闭。
维修停机

3.在已停止节点的Red Hat兼容的Linux发行版上，以根用户的身份将Artifactory作为服务安装。
Yum -y install jfrog-artifactory--

4.通过查看以下文件，检查迁移是否成功完成:
迁移日志:$JFROG_HOME/artifactory/var/log/migration.log
系统。$JFROG_HOME/artifactory/var/etc/system.yaml

这个新创建的文件将以新的格式包含您当前的自定义配置。

5.管理Artifactory。
服务人工启动/停止

6.检查console.log，查看以下启动成功的打印输出$JFROG_HOME/artifactory/var/log/console.log . tail [jfrou] [INFO] [470978b404ac5eac] [local_topology.]Go:270] [main] - ############################################################### 所有服务在52.558秒内启动成功 ###############################################################7.除运行节点外的所有节点升级完成后，在最后一个节点执行步骤2 - 6

要开始使用该产品，您可以使用以下指南:

快速入门指南:JFrog自托管
 快速入门指南:开始
 快速入门指南:Maven和Gradle
快速入门指南:npm

术语表

JFrog高级安全

ARTIFACTORY:安装快速启动指南- RPM