XRAY:安装快速入门指南- Docker撰写
2023-01-22十一10
你会得到什么?
本指南将概述如何安装Xray 3。xproduction-ready environment using the Docker-Compose installation. Note that you will need at least a ProX license to utilize the Xray service. A good understanding of Linux based operating systems, docker-compose, and docker will be required to fully grasp the material throughout this guide.
安装要求:
支持docker-engine v18的操作系统
https://docs.docker.com/engine/install/
以下端口需要在内部(容器内)可用:8000、7000、7002、7003、8082、8046、8047、8049、5671、5672、15672、5432、8036、8037。
8082还需要在节点和LB/反向代理之间的外部可达。
这些端口将在下面容器启动期间暴露。它们不需要暴露给最终用户。其他端口只需要在容器中可用，并且不被其他进程使用。
环境的细节:
安装Xray前，请参考系统需求有关支持的平台、支持的浏览器和其他要求的信息。在JFrog平台使用量增加的情况下，我们建议使用易于扩展的机器。一般来说，一台拥有6核CPU、24GB RAM和500gb DB (SSD、3000 IOPS)的机器就足够了。
更多节点硬件细节请参见//m.si-fil.com/confluence/display/JFROG/System+Requirements
安装步骤:
交互式脚本安装(推荐)
从官方网站下载的Docker Compose存档文件(例如:tar -xvf jfrog-xray-
注意:如果您想继续安装基于Docker Compose的Xray独立服务器，则适用这些步骤。
步骤1:
从官方站点下载压缩后的归档文件后，使用以下命令将其解压缩。$ tar -xvf jfrog-xray-
步骤2:
进入解压后的文件夹。$ CD jfrog-xray-
步骤3:
执行安装程序脚本。美元。/ config.sh
此脚本执行将提示您输入一系列强制输入，例如JFrog URL和连接键．附件是下面的执行示例。[root@system-docker-compose-xray jfrog-xray-3.46.0-compose]# ./config.sh
开始JFrog x射线设置
验证系统需求
如果不执行升级，可以忽略以下问题，直接按“y”
您是否在执行此升级之前断开了人工x射线配对(请参阅http://service.jfrog.org/wiki/Xray+and+Artifactory+One+to+One+Pairing了解更多详细信息)?[y / n]: y
安装目录(默认:/root/.jfrog/xray):运行系统诊断检查，日志可以在[/home/yuvarajanj/jfrog-xray-3.46.0-compose/systemDiagnostics.log]中找到。
打开文件的Ulimit级别小于建议的最小值100000
[警告]一个或多个系统诊断检查失败，查看[/home/yuvarajanj/jfrog-xray-3.46.0-compose/systemDiagnostics.log]了解更多详细信息
触发迁移脚本。这将在需要时迁移，并且可能需要一些时间。
迁移日志将在[/home/yuvarajanj/jfrog-xray-3.46.0-compose/bin/ Migration .log]中提供。文件将被归档到[/root/]。Jfrog /xray/var/log]安装后JFrog URL允许Xray连接到JFrog平台实例。(你可以从Admin > Security > Settings复制JFrog的URL)
JFrog URL: http://ARTIFACTORY_HOST:8082 [OR] http://ARTIFACTORY_HOST_DNS
初始化文件解析器时出错:配置文件不存在:var/etc/system.yaml
尝试连接JFrogURL成功
连接密钥是用于在JFrog平台中的服务之间建立信任的秘密密钥。(你可以从Admin > Security > Settings复制Join Key)
连接键:
对于IPv6地址，将值用方括号括起来，如下所示:[
请指定本机的IP地址(默认:IP):
是否要向现有产品集群添加额外的节点?[y / N]: N
安装程序可以安装PostgreSQL数据库，也可以连接到现有的兼容PostgreSQL数据库
(https://service.jfrog.org/installer/System + # SystemRequirements-RequirementsMatrix需求)
如果您是从现有安装升级，如果您已经外部化PostgreSQL，请选择N，如果没有，请选择Y。
是否要安装PostgreSQL?[Y / n]: Y
要设置PostgreSQL，请输入密码
数据库密码:
确认数据库密码:
创建第三方目录(如有必要)
正在尝试播种PostgreSQL。这可能需要一些时间。
成功播种PostgreSQL
Docker安装完成
安装目录:[/root/]。Jfrog /xray]包含数据和配置。
使用docker-compose命令启动应用程序。一旦应用程序启动，可以通过[http://JFROG_URL:8082]访问它。
例子:
cd /home/system/jfrog-xray-3.46.0-compose
Rabbitmq是一个依赖服务，需要在安装后立即启动。这需要在x射线服务开始之前运行。
启动rabbitmq: docker-compose -p xray-rabbitmq -f docker-compose-rabbitmq。Yaml up -d
启动postgresql: docker-compose-p xray-postgres -f docker-compose-postgres。Yaml up -d
停止postgresql: docker-compose-p xray-postgres -f docker-compose-postgres。yaml下来
启动:docker-compose -p xray up -d
停止:docker-compose -p xray down
注意:撰写文件使用来自.env文件的几个环境变量。记住从[/home/system/jfrog-xray-3.46.0-compose]文件夹中运行
完成
常见问题-安装阶段:
1.为什么在安装过程中，对于“除了执行此升级之前的一个之外，您是否已断开人工x射线配对”的问题，我们需要选择Y ?
-这是因为Xray只支持一对一配对与JFrog平台的发布。有关一对一配对的更多详细信息，请参阅博客在这里．
2.是否要向现有产品集群添加额外的节点?这是什么意思?
-此选项适用于当我们正在执行额外的x射线节点的安装，以成为现有实例的一部分，以建立一个高可用性集群。如果您正在执行独立安装，请继续使用选项N。
如何更改RabbitMQ数据库凭据:
Xray是预先安装在RabbitMQ中的。默认情况下，“erlang cookie”的值设置为来宾用户的rabbitmq密码。如果您以后想要更新RabbitMQ数据库的密码，您可以按照以下步骤进行操作。
步骤1:
导航到以下文件。$ < MOUNT_DIR > / app /第三方/ rabbitmq / rabbitmq.conf
步骤2:
使用以下参数更新新密码。Default_pass = <新密码>
步骤3:
完成该步骤后，也要在x射线配置文件中设置密码。
$ JFROG_HOME / x光/ var / etc / system.yaml
请在下面找到一个示例片段。共享:
rabbitMq:
密码:客人
用户名:客人
这只是一个样例配置。如果您想查看所有其他可用参数，请参考x射线的系统YAML - Wiki。
升级x光:
从官方网站上下载的Docker撰写归档包中捆绑的安装脚本也支持升级。假设您正在执行升级，您可以遵循以下步骤。
步骤1:
停止服务并移除容器。$ x射线停止
$ docker ps -a——format '{{。grep ^xray_* | xargs docker rm -f
步骤2:
提取新下载的Xray 3的内容。并导航到解压后的目录。$ CD jfrog-xray-
注意:.env文件包含在Docker-Compose归档文件中
.env文件由docker-compose使用，并在安装和升级期间更新。请注意，有些操作系统默认情况下不显示点文件。如果对文件进行了任何更改，请记住在升级之前进行备份。
重要提示:对于非Docker组合安装，我们需要确保MongoDB在升级期间运行，以便迁移到PostgreSQL。如果是docker-compose升级，现有的新compose文件将自动启动MongoDB服务。
步骤3:
执行安装程序脚本。美元。/ config.sh
该脚本将提示输入一系列与安装阶段相同的输入(请参阅上面的安装步骤)。
升级完成后，使用以下命令启动实例。$ CD jfrog-xray-
#从Xray 3.8x开始，RabbitMQ已经被移动到自己的合成文件中，这需要在启动其他服务之前启动$ docker-compose -p xray-rabbitmq -f docker-compose-rabbitmq。Yaml up -d
#从Xray 3.8开始。x, PostgreSQL needs to be started before starting the other services.$ docker-compose-p xray-postgres -f docker-compose-postgres-9-5-2v。Yaml up -d
$ docker-compose -p xray up -d
$ docker-compose -p xray ps
$ docker-compose -p xray down
使用手动Docker组合方法安装Xray:
如果您想使用手动Docker组合安装方法安装Xray，则需要遵循以下步骤。
步骤1:
首先，我们需要提取从官方网站下载的压缩文件的内容。$ tar -xvf jfrog-xray-
步骤2:
由于是手动安装，所以需要在$JFROG_HOME/ Xray路径下创建如下Xray文件夹结构。|——[]app
——[]第三方
——[999 999]rabbitmq
——[10351035]var
|——[1035 1035]数据
|——[1035 1035]等
步骤3:
既然目录结构已经准备好了，我们还需要模板(YAML文件)来初始化所需的服务和数据库。从提取的文件夹中复制可用的YAML模板，并将其作为docker-compose放在适当的位置。yaml docker-compose-rabbitmq。Yaml和docker- composition -postgres。yaml文件。
步骤4:
下一步是使用设置参数更新.env文件。
例如:
Xray的安装目录。如果没有输入，脚本将提示您进行此输入。默认($ HOME / .jfrog / x光)ROOT_DATA_DIR =
#主机ID。集群中的其他节点将使用此ID来标识该节点
HOST_ID =
#主节点ID。对于主节点，请保留该值为“None”。(shared.rabbitMq.active.node.name)。
JF_SHARED_RABBITMQ_ACTIVE_NODE_NAME =没有
#主节点IP。(shared.rabbitMq.active.node.ip)
JF_SHARED_RABBITMQ_ACTIVE_NODE_IP = 127.0.0.1
为第三方应用的内部端口绑定IP
JF_THIRD_PARTY_BIND_IP = 127.0.0.1
步骤5:
更新产品配置。
参考样品系统。yaml文件在这里并更新PostgreSQL连接细节，RabbitMQ信息和Java选项(如果适用)。
步骤6:
将“rabbitmq.conf”和“setRabbitCluster.sh”文件拷贝到“app/third-party/rabbitmq”目录下。确保两者都属于999:999 (rabbitmq uid/gid)
如果你想设置RabbitMQ HA集群，主节点的信息应该更新到从节点，如下所示，通过RabbitMQ .conf文件。cluster_formation。Peer_discovery_backend = rabbit_peer_discovery_classic_config
cluster_formation.classic_config.nodes。1 = rabbit@
完成上述所有步骤后，请使用以下命令初始化服务。
##启动其他服务前需要先启动RabbitMQ
＄docker- composition -rabbitmq -fYaml up -d
来自Xray 3.8。x, PostgreSQL needs to be started before starting the other services.
＄Docker-compose -p xray-postgresYaml up -d
$ docker-compose -p xray up -d
检查服务是否正常
＄Docker-compose -p x射线ps
卸载x光:
步骤1:
导航到安装目录。
例如:$ CD jfrog-xray-
步骤2:
使用以下命令停止x射线容器。$ docker-compose -p xray down
步骤3:
使用以下命令停止PostgreSQL容器。$ docker-compose -p xray-postgres down
为了删除Docker容器跟踪，我们需要使用以下命令。$ docker rm xray_router xray_server xray_indexer xray_analysis xray_persist xray_rabbitmq
$ docker rm xray_postgres
注意:上面的命令只能帮助移除容器。如果需要，需要手动删除主机上的Docker挂载目录。
默认位置:~/.jfrog/xray/var
如果您出于某种原因想要从PostgreSQL数据库持久化第三方数据，请确保不要删除
术语表:
-系统要求://m.si-fil.com/confluence/display/JFROG/System+Requirements#SystemRequirements-Overview
- Docker组件安装:
//m.si-fil.com/confluence/display/JFROG/Installing+Xray#InstallingXray-SingleNodeInstallation
- Docker组合安装与高可用性://m.si-fil.com/confluence/display/JFROG/Installing+Xray#InstallingXray-DockerComposeInstallation
