ARTIFACTORY:安装快速入门指南- Linux存档
2022-03-21 07:29
你会得到什么?
这是一个快速入门指南，介绍如何使用Linux Archive安装为生产就绪环境准备Artifactory 7 HA。在本指南中，我们将介绍如何设置Postgres外部数据库、多个人工节点和NGINX反向代理(它也可以作为负载均衡器)。每个Artifactory节点至少需要一个服务器。注意，每个Artifactory节点都需要一个许可证。我们还建议准备好一种云存储桶(例如S3)。要完全掌握本指南中的内容，需要对基于linux的操作系统有很好的理解。
的必备条件
受支持的linux发行版之一。
Debian 8。x, 9。x10.倍
Centos 7。倍、8.倍
RHEL 7。倍、8.倍
Ubuntu 16.04, 18.04, 20.04
以下端口需要在内部可用:8081、8082、8040、8045、8048、9092、8070、8086、8046、8047、8049、8091、8061、8062。8081和8082还需要在节点和LB/反向代理之间的外部可达。它们不需要暴露给最终用户。其他端口只需要在VM中可用，并且不被其他进程占用——其中一些端口可以通过系统进行配置。如果无法提供，请使用Yaml。
环境的细节
在安装Artifactory之前，请参考系统需求了解支持的平台、支持的浏览器和其他要求。我们建议使用易于扩展的机器，以防人工工厂的使用量增加。一般来说，一台具有4核CPU、每个节点8GB RAM的机器在开始时就足够了。
更多节点硬件细节请参见//m.si-fil.com/confluence/display/JFROG/System+Requirements
数据库
人工linux安装与derby数据库捆绑在一起。强烈建议使用外部数据库。随着工件数量的增加，绑定的derby数据库的性能可能会降低。在这个快速入门指南中，我们将介绍Postgres的设置。
PostgreSQL支持:
- 9.5 (EOL)
- 9.6(即将上线)
- 10.倍
- 11.倍
- 12.倍
- 13.倍
外部Postgres设置:
1.登录到DB，运行:用PASSWORD创建用户artifactory2.下载与您的PostgreSQL版本相对应的JDBC驱动程序PostgreSQL JDBC驱动下载站点并将下载的jar文件复制到以下目录:
创建数据库artifactory WITH OWNER=artifactory ENCODING='UTF8';
授予数据库artifactory的所有权限;$ JFROG_HOME / artifactory / var /引导/ artifactory / tomcat / lib确保您的驱动程序具有所有用户的读取权限。注意，这个目录将在解压缩linux归档文件时创建，或者您可以预先创建它。
3.中调整数据库连接详细信息系统。Yaml配置文件(下图):共享:确保您的YAML间距保持一致!我们建议缩进2或4个空格，但要确保始终保持一致。
数据库:
类型:postgresql
司机:org.postgresql.Driver
Url: jdbc:postgresql://<您的数据库Url，例如:localhost:5432>/artifactory
用户名:artifactory
密码:密码
4.在Artifactory服务器上启用PostgreSQL连接:
将以下行添加到:< postgres_mount > /数据/ pg_hba.conf。将以下行添加到(如果它已经存在，请更新它)
主机artifactory artifactory < postgres_mount > /数据/ postgresql.conf我们建议为数据库提供相当大的存储空间，即使它只存储元数据。它应该至少是预期文件存储大小的2/10。
listen_addresses = ' * '
Artifactory支持多种数据库类型，包括mysql, oracle, mariaDB。你可以找到链接其他支持的数据库下面是词汇表。
有关更多数据库建议，请参阅//m.si-fil.com/whitepaper/best-practices-for-managing-your-artifactory-database/
Filestore (S3)
文件中可配置二进制存储美元JFROG_HOME / var / etc / artifactory / binarystore.xml下面是一个使用Amazon S3 bucket的样例配置。注意，这个文件/目录将在解压缩linux归档文件时创建，或者您可以预先创建它。
S3v3 HA配置样例
<配置version = " 2 " >我们也为其他云提供商提供了其他配置模板:
<链模板= " cluster-s3-storage-v3 " / >
端点> < s3.amazonaws.com > < /端点
< bucketName > bucketName < / bucketName >
<路径> pathPrefix > < /路径
<地区> s3Region > < /地区
<标识> yourIdentity > < /身份
<凭证> yourCredentials < /证书>
真正< usePresigning > < / usePresigning >
600年< signatureExpirySeconds > < / signatureExpirySeconds >
> < /供应商
< / config >
//m.si-fil.com/confluence/display/JFROG/Configuring+the+Filestore#ConfiguringtheFilestore-ConfiguringShardingforHACluster
如果您想使用本地磁盘存储而不是S3，您可以使用:<配置version = " 2 " >
<链模板= "集群文件系统" / >
< / config >
下载位置
wget https://releases.jfrog.io/artifactory/artifactory-pro/org/artifactory/pro/jfrog-artifactory-pro/(释放)/ jfrog-artifactory-pro - -linux.tar.gz(释放)
安装步骤
1.解压缩tar文件。
jfrog-artifactory-pro-\[RELEASE\]-linux.tar.gz
2.创建一个系统。yaml下:
。/ artifactory-pro * / var / etc / system.yaml
3.在system.yaml中添加以下内容，启用HA:
共享:4.添加上面的DB/ binarstore .xml详细信息
extraJavaOpts: "-Xms512m - xx4g "
节点:
haEnabled:真
taskAffinity:任何
5.在其他节点上，复制$JFROG_HOME/var/etc/security/master。键从第一个节点到同一位置。第一个节点将在第一次启动时自动生成该文件。
6.启动应用程序。./artifactory-pro*/app/bin/artifactory.sh7.检查console.log，查看以下启动成功的打印输出[jfrou] [INFO] [470978b404ac5eac] [local_topology.]Go:270] [main] -
###############################################################
所有服务在52.558秒内启动成功
###############################################################
8.一旦Artifactory出现，UI应该可以在端口8082上访问。通过运行以下REST API检查Artifactory是否处于HA模式，并在插件数组中查找“HA”:$ curl localhost:8082/artifactory/api/system/version -u admin:password如果缺少，则表示Artifactory没有以HA模式启动。或者，在启动期间，Artifactory-service.log也会打印出“Artifactory HA”的ASCII格式。如果不在HA模式下，它将打印“Artifactory Pro”。
{
版本号:7.25.7
“revision”:“72507900”
"addons": ["ha"，…
9.对于加入集群的新节点，这些节点必须连接到相同的数据库并具有相同的主密钥。要安装其他节点，重复这些步骤，还需要复制$JFROG_HOME/var/etc/security/master。键从第一个节点到附加节点上的相同位置。第一个节点将在第一次启动时自动生成该文件。如果您想提前生成自己的密钥，您可以这样做按照这里的指南去做。
SSL
如果需要HTTPS，可以在Artifactory前面设置nginx反向代理。反向代理配置可以在Artifactory UI中生成，方法是执行以下命令管理- > Artifactory - > HTTP设置．这将需要复制到你的nginx配置。您需要拥有自己的SSL证书和密钥，并将它们放在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/ {反向代理也可以配置为处理节点之间的负载平衡流量。在NGINX的情况下，你可以在顶部添加这段代码:
proxy_pass http://localhost: 8081;
}
}
}上游人工{否则，您可以使用专用负载平衡器来处理流量平衡。
服务器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;请注意，为了支持docker请求，您需要反向代理或负载平衡器来处理请求重写。另外，如果你打算让负载均衡器终止SSL和反向代理，你需要将以下头硬编码到负载均衡器的详细信息:
proxy_pass http://localhost: 8081;→proxy_pass http://artifactory-direct;
NGINX的:proxy_set_header x - jfrog - overrides - base - url https://
proxy_set_header X-Forwarded-Port
proxy_set_header X-Forwarded-Proto https
升级步骤
1.停止Artifactorycd $ JFROG_HOME / app / bin2.提取压缩归档文件的内容并转到提取的文件夹。
/ artifactoryctl停止。Tar -xvf jfrog-artifactory-3.用新文件夹替换旧的应用程序文件夹。#导出变量以简化命令
export JFROG_HOME=<您的JFrog主目录，例如/opt/ JFrog >
export JF_NEW_VERSION=<例如/opt/jfrog/artifactory-7.x>
#删除旧应用
rm -rf $JFROG_HOME/app
#复制新应用
cp -r $JF_NEW_VERSION/app $JFROG_HOME
删除提取的新版本4.启动Artifactory。
rm -rf $JF_NEW_VERSION . rm$ JFROG_HOME / artifactory / app / bin / artifactoryctl开始| |停止检查5.对其他节点重复此操作。
调优人工(可选)
我们有以下可选调优部分来优化Artifactory更重的负载-当您的Artifactory实例承担更多负载时，记住这些参数是一个好主意。
1.系统中的javaOpts(堆大小)。Yaml -我们建议至少设置这个:共享:2.在system.yaml中自定义数据库连接:
extraJavaOpts: "-Xms512m - xx4g "artifactory:
数据库:
maxOpenConnections: 200
访问:
数据库:
maxOpenConnections: 200
元数据:根据经验，我们需要(最多)基于以下公式的多个DB连接:
数据库:
maxOpenConnections: 200
连接总数=(节点数)* (artifactory.database.)* 2) + access.database.maxOpenConnections + metadata.database.maxOpenConnections) + 50
3.在system.yaml中调优Tomcat线程:artifactory:
tomcat:
连接器:
maxThreads: 400
访问:当修改Access maxThreads时，需要更新$JFROG_HOME/artifactory/var/etc/artifactory/artifactory.system。属性文件:
tomcat:
连接器:
maxThreads: 100artifactory.access.client.max.connections = 4.在同一文件中调优异步线程池。注意，corePoolSize不应超过CPU核数的8倍:artifactory.async.corePoolSize = 32
artifactory.async.poolMaxQueueSize = 100000
要开始使用该产品，您可以使用以下指南:
快速入门指南:JFrog自托管
快速入门指南:开始
快速入门指南:Maven和Gradle
快速入门指南:npm
术语表
- - - - - -系统需求://m.si-fil.com/confluence/display/JFROG/System+Requirements
- - - - - -外部数据库://m.si-fil.com/confluence/display/JFROG/Configuring+the+Database
- - - - - -Postgresql数据库://m.si-fil.com/confluence/display/JFROG/PostgreSQL
- - - - - -Filestore://m.si-fil.com/confluence/display/JFROG/Configuring+the+Filestore
- - - - - -HTTPS设置://m.si-fil.com/confluence/display/JFROG/HTTP+Settings
- - - - - -NGINX安装:https://www.nginx.com/2022世界杯阿根廷预选赛赛程resources/wiki/start/topics/tutorials/install/
- JFrog下载://m.si-fil.com/download-jfrog-platform/
- - - - - -Linux Archive安装://m.si-fil.com/confluence/display/JFROG/Installing+Artifactory#InstallingArtifactory-LinuxArchiveInstallation
- - - - - -Linux Archive升级://m.si-fil.com/confluence/display/JFROG/Upgrading+Artifactory#UpgradingArtifactory-LinuxArchiveUpgrade.1
