罗兰杨
2022-03-21 07:35

你会得到什么?

用户添加图片

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

的必备条件

最小Docker引擎v18。

对于docker安装，设置挂载点非常重要。这将涵盖Artifactory home，并允许配置持久化。

支持docker引擎v18的操作系统
https://docs.docker.com/engine/install/

以下端口需要在内部(容器内)可用:8081、8082、8040、8045、8048、9092、8070、8086、8046、8047、8049、8091、8061、8062。8081和8082还需要在节点和LB/反向代理之间的外部可达。这两个端口将在集装箱启动时暴露在下面。它们不需要暴露给最终用户。其他端口只需要在容器中可用，并且不被其他进程占用——其中一些端口可以通过系统进行配置。如果无法提供，请使用Yaml。

环境的细节

安装Artifactory前，请参考系统需求有关支持的平台、支持的浏览器和其他要求的信息。我们建议使用易于扩展的机器，以防人工工厂的使用量增加。一般来说，一台具有4核CPU、每个节点8GB RAM的机器在开始时就足够了。
更多节点硬件细节请参见//m.si-fil.com/confluence/display/JFROG/System+Requirements

Pre-setup

1.为Artifactory主目录创建一个目录。在我的例子中，我选择创建一个“jfrog”目录:

/home/loreny/jfrog

$ mkdir -p artifactory/var/etc/ $ mkdir -p artifactory/var/bootstrap/artifactory/tomcat/lib

3.创建system.yaml

$ touch jfrog/artifactory/var/etc/system.yaml

4.该文件涵盖了您将为Artifactory和我们的其他产品调整的大多数配置。hth华体会最新官方网站我们将在下面继续编辑。检索主机的IP，并给它一个惟一的ID。如果不设置这些，其他节点将无法到达Artifactory。这将进入系统。我喜欢这样:

共享: extraJavaOpts: "-Xms512m - xx4g " 节点: 知识产权:10.150.0.222 id: nodeone haEnabled:真 taskAffinity:任何

确保您的YAML间距保持一致!我们建议缩进2或4个空格，但要确保始终保持一致。
5.为整个目录提供适当的权限;默认情况下，这只意味着1030用户(默认的工件id)的所有权。您不需要显式地创建id为1030的用户来运行城镇。您需要具有sudo级别的权限才能成功运行chown。

$ chown -R 1030:1030 jfrog/

数据库

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

PostgreSQL支持:

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

外部Postgres设置:

1.登录数据库，执行如下SQL语句:创建用户artuser，密码为PassJFrog!453; 创建数据库artifactory WITH OWNER=artuser ENCODING='UTF8'; 授予artuser数据库的所有权限;2.下载与您的PostgreSQL版本相对应的JDBC驱动程序PostgreSQL JDBC驱动下载站点并将下载的jar文件复制到artifactory/var/bootstrap/artifactory/tomcat/lib目录下。确保您的驱动程序具有所有用户的读取权限。
3.调整系统中的数据库连接详情。Yaml配置文件。出于演示的目的，我的数据库可以在端口5432上的10.150.0.223访问。
共享:类型:postgresql 司机:org.postgresql.Driver url: jdbc: postgresql: / / 10.150.0.223:5432 / artifactory 用户名:artus 密码:PassJFrog !4534.在Artifactory服务器上启用PostgreSQL连接:
在/data/pg_hba.conf中添加以下行。主机artifactory artifactory md5将以下行添加到(如果它已经存在，请更新它)< postgres_mount > /数据/ postgresql.conf listen_addresses = ' * 'Artifactory支持多种数据库类型，包括mysql, oracle, mariaDB。你可以找到链接其他支持的数据库下面是词汇表。

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

有关更多数据库建议，请参见管理人工数据库的最佳实践

文件存储(S3/Local):

Artifactory将二进制文件与数据库分开存储。默认情况下，这是在与Artifactory安装相同的文件系统上完成的。为了便于扩展，我们建议设置一个s3存储桶，并利用它进行无限扩展。文件存储是通过文件binarstore .xml配置的，它位于下面:

artifactory / var / etc / artifactory / binarystore.xml。

要将其配置为使用S3，您需要使用以下模板并填写详细信息:

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

配置文件存储- JFrog
我们也为其他云提供商提供了其他配置模板:
配置文件存储- JFrog

当地的

如果你想使用本地磁盘存储而不是S3，你可以在binarstore .xml中使用:

<配置version = " 2 " > <链模板= "集群文件系统" / > < / config >

下载位置

这将需要访问https://releases.jfrog.io

$ docker pull releases-docker.jfrog.io/jfrog/artifactory-pro:最新版本

安装步骤

现在我们已经配置了系统。现在，我们可以启动第一个节点。供参考，这是我的(基本)完整系统。Yaml看起来像:

共享: 数据库: 类型:postgresql 司机:org.postgresql.Driver url: jdbc: postgresql: / / 10.150.0.223:5432 / artifactory 用户名:artus 密码:PassJFrog !453 节点: 知识产权:10.150.0.222 id: nodeone haEnabled:真 taskAffinity:任何

1.开始Artifactory:

$ docker run——name artifactory -v /home/loreny/jfrog/artifactory/var/:/var/opt/jfrog/artifactory -d -p 8081:8081 -p 8082:8082 release -docker.jfrog.io/jfrog/artifactory-pro:最新版本

2.通过检查以下消息的日志来检查artifactory是否启动:

$ docker logs -f artifactory 2017-09-20 20:44:34. 610z [jfrou] [INFO] [30a6b3f102dc9b52] [local_topology.]Go:270] [main] - ############################################################### 所有服务在86.544秒内启动成功 ###############################################################3.一旦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"，…

4.对于加入集群的新节点，这些节点必须连接到相同的数据库并具有相同的主密钥。要安装其他节点，您需要使用相同的系统。(修改节点IP和ID)和binarstore .xml。安装过程是相同的，除了需要复制一个master.key。如果您想提前生成自己的密钥，您可以这样做按照这里的指南去做．该密钥将在第一个节点第一次启动时为您生成。复制主版本。密钥从第一个节点(artifactory/var/etc/security/master.key)到其他节点，在相同的文件系统位置。然后，您可以使用相同的docker run命令启动其他节点。注意，每个Artifactory节点都需要一个许可证。

SSL

如果需要HTTPS，您可以在Artifactory前面设置反向代理。反向代理配置可以在Artifactory UI中生成，方法是执行以下命令管理- > Artifactory - > HTTP设置。我们将在这个例子中使用NGINX。这需要复制到你的NGINX配置中。您需要拥有自己的SSL证书和密钥，并将它们放在NGINX配置中指定的正确目录中。下面是一个示例配置供参考。下面的配置假设你和Artifactory在同一台机器上安装NGINX;请根据需要调整主机。

########################################################### 这个配置是由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

升级步骤

1.使用本地Docker命令停止和删除Artifactory容器。
例如:码头停止人工 Docker rm -f artifactory2.将路径设置为当前Artifactory主目录，并确保正确设置了目录权限。export ARTIFACTORY_HOME=<挂载到当前Artifactory数据目录的路径> $ARTIFACTORY_HOME3.启动Artifactory容器docker运行命令——name artifactory- v $ARTIFACTORY_HOME:/var/opt/jfrog/artifactory -d -p 8081:8081 -p 8082:8082 docker. binarray .io/jfrog/artifactory-:最新4.对其他节点重复此操作。

调优人工(可选)

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

如何对Artifactory进行重载调优?

1.系统中的javaOpts(堆大小)。Yaml -我们建议至少设置这个:共享: extraJavaOpts: "-Xms512m - xx4g "2.在system.yaml中自定义数据库连接:artifactory: 数据库: maxOpenConnections: 200

访问:
数据库:
maxOpenConnections: 200

元数据: 数据库: maxOpenConnections: 200

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

3.在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 =

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

artifactory.async.corePoolSize = 32 artifactory.async.poolMaxQueueSize = 100000

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

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

术语表

ARTIFACTORY:安装快速入门指南- Docker