JFrog帮助中心

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

搜索





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



概述

升级发行版的过程取决于您的安装类型。我们强烈建议您在继续升级之前通读此页面。

在升级发行版之前,请参考有关支持的其他信息平台、浏览器等要求,和系统架构

重要的

确保使用与最初安装Distribution时相同的升级方法(RPM、Debian、Docker等)。

为确保在升级过程中遇到任何问题时可以恢复分发版和数据库,我们强烈建议您确保您的系统和数据库备份是最新的

升级到2。第一次做X ?

建议您先复习一下有什么新鲜事最新的JFrog平台。查看重大变更、弃用特性等。

人工和分销配对

升级到JFrog平台需要将源工件映射到单个分发服务。如果您正在创建和分发来自多个源Artifactory实例和一个Distribution实例的发布包,那么您现在需要在包含这些源Artifactory实例的每个JPD中部署一个Distribution服务。如果您的Mission Control实例是另一个JPD的一部分,则需要在新的Distribution实例中注册它。详见此处。


升级步骤

升级过程主要包括以下几个步骤:

  1. 下载分布(Docker Compose, RPM, Debian)。
  2. 停止分发服务
  3. 安装分布根据安装程序的分发类型。
  4. 检查迁移日志并检查system.yaml验证迁移是否成功(仅用于从v2.x升级)。
  5. 启动服务使用启动脚本或操作系统服务管理。
  6. 检查配电日志查询服务的状态。

默认主目录/ $JFROG_HOME

默认的Distribution主目录是根据安装类型定义的。有关更多详细信息,请参阅产品目录结构页面。

注意:本指南使用JFROG_HOME美元表示包含已部署产品的JFrog根目录。

JFrog订阅级别

自托管
企业+
页面内容


从1.6以下版本升级

升级前,请确认当前使用的操作系统版本为支持。看到系统需求有关操作系统支持的详细信息。

从低于1.6的版本升级。X,您首先需要升级到1.6版本。中描述的X升级发行版本x文档,然后继续从1.6版本升级到2.x。


从1.6版本升级到2.x

升级前,请确认当前使用的操作系统版本为支持。看到系统需求有关操作系统支持的详细信息。

JFrog发行版v2。x只兼容JFrog Artifactory v7.x。要升级,你必须首先安装JFrog Artifactory 7.x

在发行版2.x中引入了几个新概念,改进安装和定制流程

支持以下升级方式:

交互式脚本升级(推荐)

安装脚本适用于所有支持的升级方法(RPM、Debian和Docker Compose)。它为您提供了一种交互式的方式来安装Distribution及其依赖项。

  1. 下载分布
  2. 停止服务。

    Docker——停止并移除旧容器
    分发停止docker ps -a——format '{{。grep ^distribution_* | xargs docker rm -f
    Linux
    CD /opt/jfrog/distribution/scripts ./distribution.sh停止
  3. 提取压缩归档文件的内容并转到提取的文件夹。

    jfrog-distribution--.tar.gz CD jfrog-distribution--

    .env文件包含在Docker-Compose归档文件中

    这个.env文件由docker-compose在安装和升级期间更新。

    请注意,有些操作系统默认情况下不显示点文件。如果对文件进行了任何更改,请记住在升级之前进行备份。

  4. 运行安装脚本。
    请注意:脚本将提示您一系列强制输入,包括jfrogURL(自定义基URL)joinKey

    组成
    。/ config.sh
    RPM / DEB
    。/ install.sh
  5. 通过查看以下文件,检查迁移是否成功完成:

    1. 迁移日志美元JFROG_HOME /分销/ var / log / migration.log文件。

    2. system.yaml配置美元JFROG_HOME /分销/ var / etc / system.yaml
      这个新创建的文件将以新的格式包含您当前的自定义配置。

  6. 启动并管理Distribution服务。

    systemd操作系统
    Systemctl start|stop distribution.service
    systemv操作系统
    服务分发start / stop
    码头工人组成
    cd jfrog-distribution--compose#从发行版2.5开始。docker-compose -p distribution-redis -f docker-compose- Redis . x Redis已经被移动到自己的组合文件中,这需要在启动其他服务之前启动。从2.5开始。在启动其他服务之前,需要先启动PostgreSQL。Docker-compose -postgres-9-6-10v。-d docker-compose -p distribution ps docker-compose -p distribution down
  7. 从您的浏览器访问分发:http:// < jfrogUrl > / ui /,去吧。分布选项卡应用程序模块。
  8. 检查分发日志。

    Linux
    $产品目录结构/var/log/console.log . tail

手动RPM升级

RPM安装捆绑了Distribution及其所有依赖项。它是作为本机RPM包提供的,Distribution及其依赖项必须单独安装。如果您正在自动化安装,请使用此选项。

  1. 下载分布
  2. 停止当前服务器。

    CD /opt/jfrog/distribution/scripts ./distribution.sh停止
  3. 提取压缩归档文件的内容并转到提取的文件夹。

    CD jfrog-distribution--rpm. gz
  4. 以root用户在Red Hat兼容的Linux发行版上将Distribution作为服务安装。

    Yum -y install ./distribution/distribution.rpm
  5. 通过查看以下文件,检查迁移是否成功完成:

    1. 迁移日志美元JFROG_HOME /分销/ var / log / migration.log文件。

    2. system.yaml配置美元JFROG_HOME /分销/ var / etc / system.yaml
      这个新创建的文件将以新的格式包含您当前的自定义配置。

  6. 设置Artifactory连接详细信息。
    分发需要一个可用的Artifactory服务器和一个合适的许可证。分配连接到Artifactory需要2个参数:
    • jfrogUrl-部署JFrog Artifactory的机器的URL,或者指向它的负载平衡器。建议使用DNS名称,不要使用直连ip。例如:http://jfrog.acme.comhttp://10.20.30.40:8082
      将其设置为共享配置部分美元JFROG_HOME /分销/ var / etc / system.yaml文件。
    • join.key-这是Artifactory注册和认证分发服务器所需的“秘密”密钥。
      你可以去取神器joinKey的JPD UI中(join Key)管理模块|安全|设置|连接键
      设置join.key中的Artifactory服务器所使用的共享配置部分美元JFROG_HOME /分销/ var / etc / system.yaml文件。
  7. 确保第三方服务正在运行。

    PostgreSQL

    如果您已经安装了封装为1. sql的一部分的PostgreSQL数据库。X,可以继续使用。使用以下命令启动和停止PostgreSQL服务。
    请注意:./distribution.sh stop all命令,在发行版1中使用。X版本不能在版本2.x中使用。

    Service postgresql-9.6 start|stop|status

    复述,

    这将从以前的安装中获得。使用以下命令启动和停止服务。

    Red Hat / CentOS
    Service redis start / stop / status
    Debian / Ubuntu
    Service redis-server start|stop|status
  8. 启动和管理分销。

    systemd操作系统
    Systemctl start|stop distribution.service
    systemv操作系统
    服务分发start / stop
  9. 从您的浏览器访问分发:http:// < jfrogUrl > / ui /,去吧。分布选项卡应用程序模块。
  10. 检查分发日志。

    $JFROG_HOME/distribution/var/log/console.log . tail

手动升级Debian

Debian升级捆绑了发行版及其所有依赖项。它是作为本地Debian软件包提供的,其中Distribution及其依赖项必须单独安装。如果您正在自动化安装,请使用此选项。

  1. 下载分布
  2. 停止当前服务器。

    CD /opt/jfrog/distribution/scripts ./distribution.sh停止
  3. 提取压缩归档文件的内容并转到提取的文件夹。

    CD jfrog-distribution--deb. Tar .gz
  4. 以root用户在Debian兼容的Linux发行版上安装Distribution作为服务。

    运行安装
    DPKG - 1 ./distribution/distribution.deb
  5. 通过查看以下文件,检查迁移是否成功完成:

    1. 迁移日志美元JFROG_HOME /分销/ var / log / migration.log文件。

    2. system.yaml配置美元JFROG_HOME /分销/ var / etc / system.yaml
      这个新创建的文件将以新的格式包含您当前的自定义配置。

  6. 设置Artifactory连接详细信息。
    分发需要一个可用的Artifactory服务器和一个合适的许可证。分配连接到Artifactory需要2个参数:
    • jfrogUrl-部署JFrog Artifactory的机器的URL,或者指向它的负载平衡器。建议使用DNS名称,不要使用直连ip。例如:http://jfrog.acme.comhttp://10.20.30.40:8082
      将其设置为共享配置部分美元JFROG_HOME /分销/ var / etc / system.yaml文件。
    • join.key-这是Artifactory注册和认证分发服务器所需的“秘密”密钥。
      你可以去取神器joinKey的JPD UI中(join Key)管理模块|安全|设置|连接键
      设置join.key中的Artifactory服务器所使用的共享配置部分美元JFROG_HOME /分销/ var / etc / system.yaml文件。
  7. 确保第三方服务正在运行。

    PostgreSQL

    如果您已经安装了封装为1. sql的一部分的PostgreSQL数据库。X,可以继续使用。使用以下命令启动和停止PostgreSQL服务。
    请注意:./distribution.sh stop all命令,在发行版1中使用。X版本不能在版本2.x中使用。

    Service postgresql-9.6 start|stop|status

    复述,

    这将从以前的安装中获得。使用以下命令启动和停止服务。

    Red Hat / CentOS
    Service redis start / stop / status
    Debian / Ubuntu
    Service redis-server start|stop|status
  8. 启动和管理分销。

    systemd操作系统
    Systemctl start|stop distribution.service
    systemv操作系统
    服务分发start / stop
  9. 从您的浏览器访问分发:http:// < jfrogUrl > / ui /,去吧。分布选项卡应用程序模块。
  10. 检查分发日志。

    $JFROG_HOME/distribution/var/log/console.log . tail
  11. 启动和管理分销。

    服务分发start / stop
  12. 从您的浏览器访问分发:http:// < jfrogUrl > / ui /,去吧。分布选项卡应用程序模块。

  13. 检查分发日志。

    $JFROG_HOME/distribution/var/log/console.log . tail

Post-Upgrade步骤

升级完成后。

将发布包元数据迁移到分发服务

新的JFrog平台要求将Distribution连接到单个Source Artifactory实例,作为JPD的一部分。

如果您有一个分布实例连接到多个Source Artifactory实例,使用导出和导入发布包元数据REST API命令移动到这个新的升级过程后的要求。有关更多信息,请参见升级分布


从版本2升级。X到2.x

升级前,请确认当前使用的操作系统版本为支持。看到系统需求有关操作系统支持的详细信息。

支持以下升级方式:

交互式脚本升级(推荐)

安装脚本适用于所有支持的升级方法(RPM、Debian和Docker Compose)。它为您提供了一种交互式的方式来安装Distribution及其依赖项。

  1. 下载分布(RPM, Debian或Docker Compose)。
  2. 停止服务。

    Systemd操作系统
    Systemctl停止distribution.service
    Systemv操作系统
    服务分配站
    Docker——停止并移除旧容器
    CD jfrog-distribution--compose docker-compose -p distribution down
  3. 提取压缩归档文件的内容并转到提取的文件夹。安装程序脚本位于解压的文件夹中。
    请注意对于Docker Compose升级,请确保将您的自定义合并到当前版本docker-compose.yaml文件的新解压缩版本
    docker-compose.yaml文件。

    jfrog-distribution--.tar.gz CD jfrog-distribution--

    的内容.env文件在之前的安装中新建.env此存档中的文件不复制版本,因为这将影响升级。

  4. 运行安装脚本。
    请注意:如果需要,脚本将提示您一系列强制输入,包括jfrogURL(自定义基础URL)joinKey

    组成
    。/ config.sh
    RPM / DEB
    。/ install.sh
  5. 启动并管理Distribution服务。

    systemd操作系统
    systemctl启动|停止

    distribution.service


    systemv操作系统
    服务分发start / stop
    码头工人组成
    cd jfrog-distribution--compose#从发行版2.5开始。docker-compose -p distribution-redis -f docker-compose- Redis . x Redis已经被移动到自己的组合文件中,这需要在启动其他服务之前启动。从2.5开始。在启动其他服务之前,需要先启动PostgreSQL。如果PostgreSQL 9.6.11正在运行,请使用- docker-compose-p distribution-postgres -f docker-compose-postgres-9-6-10v。使用- docker-compose-p distribution-postgres -f docker-compose-postgres-10-13v。使用- docker-compose-p distribution-postgres -f docker-compose-postgres。-d docker-compose -p distribution ps docker-compose -p distribution down
  6. 从您的浏览器访问分发:http:// < jfrogUrl > / ui /,去吧。分布选项卡应用程序模块。
  7. 检查分发日志。

    $JFROG_HOME/distribution/var/log/console.log . tail

手动RPM/Debian升级

  1. 下载分布(RPM或Debian)

  2. 停止当前服务器。

    systemd操作系统
    Systemctl停止distribution.service
    systemv操作系统
    服务分配停止
  3. 提取压缩归档文件的内容并转到提取的文件夹。

    CD jfrog-distribution--.tar.gz
  4. 以root用户在Red Hat兼容的Linux发行版上将Distribution作为服务安装。

    rpm
    Yum -y install ./distribution/distribution.rpm
    Debian
    DPKG - 1 ./distribution/distribution.deb
  5. 启动和管理分销。

    systemd操作系统
    Systemctl start|stop distribution.service
    systemv操作系统
    服务分发start / stop
  6. 从您的浏览器访问分发:http:// < jfrogUrl > / ui /,去吧。分布选项卡应用程序模块。

  7. 检查分发日志。

    $JFROG_HOME/distribution/var/log/console.log . tail

Linux Archive升级

  1. 停止当前服务器。

    停止销售
    #导出变量以简化命令-将JFROG_HOME设置为当前安装目录Export JFROG_HOME=/opt/jfrog cd $JFROG_HOME/distribution/app/bin ./distribution.sh stop
  2. 提取压缩归档文件的内容并转到提取的文件夹。

    解压
    /opt/jfrog/ CD /opt/jfrog tar -xf jfrog-distribution--linux.tar.gz
  3. 替换现有的美元JFROG_HOME /分销/应用程序用新的应用程序文件夹中。

    升级
    export JF_NEW_VERSION=/opt/jfrog/jfrog-distribution--linux #删除应用rm -rf $JFROG_HOME/distribution/app #复制新应用cp -fr $JF_NEW_VERSION/app $JFROG_HOME/distribution/ #删除提取的新版本rm -rf $JF_NEW_VERSION chown -r distribution:distribution /opt/jfrog/distribution/app

    中指定的密码是否正确requirepassJFROG_HOME美元/分销/ var / etc /复述/ redis.conf(欲了解更多信息,请参考redis.password美元JFROG_HOME /分销/ etc / system.yaml都是一样的。

  4. 管理分配。
    以分发用户身份运行以下命令。

    美元JFROG_HOME /分销/ app / bin / distribution.sh开始|停止
  5. 访问分布从你的浏览器:http:// < jfrogUrl > / ui /,去吧。指示板选项卡应用程序模块。

  6. 检查分发日志。

    $JFROG_HOME/distribution/var/log/console.log . tail



执掌升级

由于打破变化在PostgreSQL然后,您需要将数据库从旧数据库迁移到新数据库。

执行升级需要停机时间。

要升级发行版,首先需要验证以下内容。

  1. 验证您已将Artifactory升级到v.7x。有关更多信息,请参见执掌升级
  2. 如果您使用默认的PostgreSQL (postgresql.enabled = true),你需要通过前9门考试。X或10postgresql.image.tagdatabaseUpgradeReady = true;在升级Helm之前,你还需要删除PostgreSQL子图中现有的statfulset,因为在升级Helm之前。PostgreSQL的x图表版本有重大变化。
    运行执掌升级设置以下值。
bash $ helm upgrade distribution——set databaseUpgradeReady=true——set unifiedUpgradeAllowed=true——set postgresql。postgresqlPassword=<旧密码>——set postgresql.image。标签=<旧图像标签>——设置redis。Password =<旧密码>——set distribution。joinKey=——set distribution。jfrogUrl= --set distribution.masterKey= --set distribution.migration.enabled=true jfrog/distribution ```
  1. 将已部署的版本更新为更新后的版本。

    头盔升级分发jfrog/分发
  2. 如果安装了分发版而没有提供值postgresql.postgresqlPassword(密码是自动生成的),按照这些说明操作。

    1. 得到了执行以下命令获取当前密码。

      POSTGRES_PASSWORD=$(kubectl get secret -n  -postgresql -o jsonpath="{.data. path ")Postgresql-password}" | base64——decode)
    2. 通过传递先前自动生成的秘密来升级版本。

      jfrog/Distribution——set postgresql.postgresqlPassword=${POSTGRES_PASSWORD}
  3. 如果安装了分发版而没有提供值rabbitmq.rabbitmqPassword / rabbitmq-ha.rabbitmqPassword(密码是自动生成的),按照这些说明操作。

    1. G通过运行以下命令设置当前密码。

      RABBITMQ_PASSWORD=$(kubectl get secret -n  -rabbitmq -o jsonpath="{.data. path ")Rabbitmq-password}”| base64——decode)
    2. 通过传递先前自动生成的秘密来升级版本。

      helm upgrade  jfrog/distribution——set rabbitmq.rabbitmqPassword=${RABBITMQ_PASSWORD}/rabbitmq-ha.rabbitmqPassword=${RABBITMQ_PASSWORD}
  4. 如果安装了带有所有默认值的Distribution(例如,没有用户提供的Rabbit/Postgres的值),请遵循以下步骤。
    1. 如上节所述,检索所有当前密码(RabbitMQ/PostgreSQL)。
    2. 通过传递以前自动生成的秘密来升级版本。

      jfrog/distribution——set rabbitmq-ha。rabbitmqPassword=——set postgresql.post

迁移过程

推荐的迁移过程是PostgreSQL的完整数据库导出和导入。

  1. 阻止用户访问分发版(但不关闭)。
  2. 获取服务名称OLD_PG_SERVICE_NAME使用下面的命令。例如:OLD_PG_SERVICE_NAME作为< OLD_RELEASE_NAME > postgresql

    $ kubectl get svc NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE -distribution LoadBalancer 10.111.81.201  80:31272/TCP 50m -postgresql ClusterIP 10.97.121.27  5432/TCP 50m
  3. 保存之前的密码OLD_PG_SERVICE_NAME或者从现有PostgreSQL pod的secret中提取。

    $ OLD_PASSWORD=$(kubectl get secret -n  -postgresql -o jsonpath="{.data. path "postgresql -password}" | base64——decode)
  4. 安装带有0个副本的新发行版。
    一个新的PostgreSQL pod将被部署和启动。Distribution pod将被部署,但没有启动,因为副本计数为0。
    为例。

    $ helm install distribution-new——set replicaccount =0——set distributionjfrogrurl =——set postgresql。postgresqlPassword=——set redis。Password =< Password >——set distribution。joinKey = < JOIN_KEY > jfrog /分布
  5. 连接到新的PostgreSQL pod(您可以通过运行Kubectl得到豆荚).

    $ kubectl exec -it  bash
  6. 登录后,使用以下命令从上一个数据库创建转储文件pg_dump,并连接到前一个PostgreSQL图表。

    $ pg_dump -h  -U distribution  > /tmp/backup.sql


    运行上述命令后,应该提示您输入密码;此密码为先前的图表密码(
    OLD_PASSWORD).此操作可能需要一些时间,具体取决于数据库的大小。

  7. 有了备份文件后,可以使用如下命令恢复它。
  8. $ psql -U distribution  < /tmp/backup.sql

    运行上述命令后,系统将提示您输入密码;这是当前的图表密码。此操作可能需要一些时间,具体取决于数据库的大小。

  9. 运行命令执掌升级打开分销。

    $ helm upgrade——install distribution-new——set distribution。jfrogrurl =——set postgresql。postgresqlPassword=——set redis。Password =< Password >——set distribution。joinKey=——set distribution。migration.enabled=true jfrog/distribution
  10. 运行以下命令删除旧的Distribution部署和Helm版本。

    helm delete 
  11. 从您的浏览器访问分发:http:// < jfrogUrl > / ui /,然后去安全性与合规性选项卡应用程序模块。
  12. 检查已部署的Helm版本的状态。

    舵位分布

    发行版现在应该可以使用了。


第三方应用

PostgreSQL

如果您已经安装了封装为1. sql的一部分的PostgreSQL数据库。X,可以继续使用。使用以下命令启动和停止PostgreSQL服务。
请注意:./distribution.sh stop all命令,在发行版1中使用。X版本不能在版本2.x中使用。

Service postgresql-9.6 start|stop|status

复述,

这将从以前的安装中获得。使用以下命令启动和停止服务。

Red Hat / CentOS
Service redis start / stop / status
Debian / Ubuntu
Service redis-server start|stop|status
  • 没有标签
版权所有©2023 JFrog Ltd.