JFrog帮助中心

我们的新门户即将推出!
文档+知识库





JFrog帮助中心-新的知识体验即将到来!



概述

新的JFrog平台要求Xray连接到单个Artifactory实例。

如果您有一个Xray实例连接到多个Artifactory实例,在升级使用下面的过程移动到这个新的要求。

升级Aritfactory或Xray而不更改此要求将导致无法恢复的数据丢失。

先决条件

您的Xray实例必须升级到2.7到2.11.x之间的版本。


页面内容


选项1:没有配置数据的配对(推荐)

此选项将带您从单个x射线实例中断开所有Artifactory实例的连接,只有一个例外。然后,继续将断开连接的Artifactory实例升级到版本7。x与新安装的Xray版本3。x实例。

此过程将需要重新索引额外的Artifactory实例,并将导致x射线配置数据的一些丢失。您需要:

多对一配对 一对一配对


过程步骤

  1. 导出用户自定义配置(Xray v 2.11及以上版本可选)
    你可以导出x射线用户自定义配置使用一组专用的REST api导入到其他Xray实例。以下设置包括策略、监视、忽略规则、自定义许可证、自定义问题、webhook、邮件服务器、代理配置和索引资源设置。
  2. 断开人工x射线配对,除了一个
    删除连接到Xray的所有Artifactory实例,除了您想保持连接到该Xray实例的那个。如果您有一个Artifactory实例被配置为您的身份验证提供程序,请使用Xray使该实例处于启用状态。
    在Xray UI中,转到管理|一个rtifactory,删除要删除的Artifactory实例。
    请注意:此操作将删除已删除的Artifactory实例的所有数据。
  3. 升级剩余连接的x射线人工配对
    1. 将连接的Artifactory实例升级到版本7.x,使用本指南
    2. 将连接的x射线实例升级到版本3.x,使用本指南
      请注意确保在x光之前升级Artifactory。
  4. 将断开连接的Artifactory实例升级到7.x使用本指南
  5. 安装新的Xray 3。每个Artifactory集群的x实例使用本指南
    在安装新的Xray实例时,请确保提供要与Xray配对的Artifactory实例的基本URL和连接键。
  6. 导入用户自定义配置(可选)Xray 2.11及以上版本
    你可以导入x射线用户自定义配置,如果您在第一步中选择导出它们的话。
  7. 索引每个新Artifactory x射2022世界杯阿根廷预选赛赛程线对所需的所有资源
    从UI中政府模块,转到x射线安全与合规|通用并点击索引资源2022世界杯阿根廷预选赛赛程



选项2:与配置数据配对

该选项将引导您安装额外的x射线版本2。为您拥有的每个Artifactory实例,并恢复所有MongoDB和PostgreSQL数据。然后,您可以继续将每个Artifactory和Xray对升级到版本7。X和版本3.x。

这个过程更复杂,只有在您必须保留所有x射线配置并在新实例中轻松地重新配置它们时才建议使用。

多对一配对 一对一配对


过程步骤

包括以下主要步骤:

  1. 停止x射线服务
  2. 备份x射线数据文件夹
  3. 安装新的x射线并更新配置文件
  4. 恢复MongoDB和PostgreSQL
  5. 启动New Xray实例
  6. 其他x射线实例
  7. 删除不必要的人工x射线配对

步骤1:停止x射线服务

下面的一组步骤将禁用除一个Artifactory实例之外的所有Xray实例,处理Xray队列中的挂起任务,并停止Xray服务。

  1. 如果还没有配置一个Artifactory实例,请将其配置为身份验证提供程序。
    在Xray UI中,转到管理|身份验证,并选择Artifactory实例。
  2. 从Artifactory实例中禁用x射线集成。如果您有一个Artifactory实例被配置为您的身份验证提供程序,请使用Xray使该实例处于启用状态。
    在Artifactory UI中,转到管理|JFrog x光,并禁用x射线集成。

  3. 停止x光。
    请注意:不要停止PostgreSQL和MongoDB。

步骤2:备份x射线数据文件夹

  1. 压缩并复制x射线数据的备份文件。

    cd  tar -zcvf xray.backup.tar.gz


  2. 创建MongoDB转储。

    创建转储文件
    mongodb -d xray -u xray -p password -o mongodb
    压缩转储文件
    Tar -czvf mongodb . Tar .gz mongodb .gz
  3. 创建PostgreSQL转储。

    创建转储文件
    pg_dump -U xray xraydb > /postgresdump
    压缩转储文件
    postgresdump. Tar .gz

步骤3:安装新的x射线和更新配置文件

  1. 安装一个新的Xray实例在另一台机器上。
  2. 解压缩并恢复x射线备份数据。
    1. 换新的XRAY_HOME美元文件夹名称xray_tmp(这将在配置更新完成后删除)。
      请注意:此文件夹包括以下文件夹:备份配置数据db_migraitons

      Mv xray_tmp
    2. 从之前的安装中复制x射线数据备份文件,xray.backup.tar.gz进入新领域XRAY_HOME美元文件夹中。
    3. 解压缩x射线数据备份文件。

      Tar -xvf xray.backup.tar.gz
    4. 确认创建了一个新的x射线文件夹,其结构与xray_tmp结构。
    5. 删除xray_tmp文件夹。

      rm xray_tmp


  3. 修改x射线配置文件/var/opt/jfrog/xray/config/xray_config.yamlpostgresmongodbrabbitmq参数。

    ——ver: 1.0 XrayServerPort: 8000 mqBaseUrl: amqp://guest:guest@rabbitmq:5672 mongoUrl: mongodb://xray:password@mongodb:27017/?authSource=xray& authmechanism = sram - sha -1 postgresqlUrl: postgres://xray:xray@postgres:5432/xraydb?sslmode =禁用

步骤4:恢复MongoDB和PostgreSQL

MongoDB

  1. 拷贝MongoDB备份zip文件mongodump.tar.gz敬新机器。
  2. 解压缩MongoDB备份文件。

    Tar -xvf mongodb . Tar .gz


  3. 恢复MongoDB。
    进入解压后的文件夹,cd到每个子目录,直到到达Xray目录,然后执行以下命令。

    mongorestore / mongodb ump/xray -u xray -p password——authenticationDatabase xray——db xray——drop——batchSize=1

PostgreSQL

  1. 复制PostgreSQL备份zip文件postgresdump.tar.gz敬新机器。
  2. 解压PostgreSQL备份文件。

    Tar -xvf postgresdump.tar.gz


  3. 恢复PostgreSQL。

    psql -U xray -f postgresdump xraydb . exe


步骤5:启动New Xray实例

  1. 从新的Xray实例中删除身份验证提供程序配置。
    在MongoDB中运行以下查询。
    请注意:稍后将连接一个新的身份验证提供者。

    db.getCollection('configuration').deleteOne({"config_id": "accessConfig"})
  2. 为新的Xray实例修改MongoDB中的二进制管理器集合配置。对于初始Xray实例,也应该执行一次此步骤。

    1. 在MongoDB中运行以下查询,以获得Artifactory实例的列表。

      db.getCollection (binary_managers); ({})
    2. 对于每个冗余Artifactory实例,在MongoDB中运行以下查询,除了要连接到这个新Xray实例的选定实例。

      请注意:该命令需要一个不存在的URL来操作新的x射线数据。在这个过程的后面,一旦不必要的配对被删除,这些人工连接将被删除。

      db.getCollection(“binary_managers”)。更新({“bin_mgr_id”:{" < Redundent-Artifactory-id-to-delete >“}},{$设置:{“bin_mgr_url”:“< non-existing-url-which-not-in-use >“}})
  3. 启动新的Xray实例。

  4. 更改x射线基础URL。
    在Xray UI中,转到管理|一般,并禁用Xray Base URL。
  5. 在Artifactory中验证Xray URL。
    在选中的Artifactory UI中,转到管理|先进的|配置描述符,并检查xrayConfig
  6. 在Artifactory中启用Xray。
    在选中的Artifactory UI中,转到管理|JFrog x光,并将“Xray”设置为“Enabled”。
  7. 将Xray连接到您选择的身份验证提供程序。
    在Xray UI中,转到管理|身份验证,并选择Artifactory实例。

步骤6:额外的x射线实例

对于其他x射线实例,重复步骤3到5。

一旦完成了将所有新Xray实例与其人工实例配对的过程,转到每个Xray实例(管理|Artifactory),并检查是否只有一个Artifactory实例连接到它。

继续升级您的Artifactoryx光实例到新的JFrog平台。

第七步:去除不必要的人工x射线配对

对每个x射线实例重复下面的步骤。

  1. 验证新Xray实例是否作为身份验证提供者连接到所选Artifactory实例。

    在继续下一步之前,请确保Artifactory和x射线正常工作。您可以尝试从Artifactory重新索引存储库,并检查它是否在Xray中被索引。

  2. 删除连接到Xray的所有Artifactory实例,除了您想保持连接到该Xray实例的那个。
    在Xray UI中,转到管理|一个rtifactory,删除要删除的Artifactory实例。
    请注意:此操作将删除已删除的Artifactory实例的所有数据。
  3. 重新索引所有必需的存储库。
    在Xray UI中,转到管理|Artifactory,单击身份验证提供程序Artifactory实例并选择Index现有在要索引的存储库上。
  • 没有标签
版权所有©2023 JFrog Ltd.