容器化单机迁移容器化单机

1.1 版本

1.2 应用场景

有时用户需要复用一个工程，或者迁移工程所在服务器。

本文方案，帮助用户将原有容器化部署的单机工程，迁移到另一个容器化部署的单机工程。

注：全文以FineBI作为演示。FineReport迁移步骤基本一致，仅需要两个点：

1）拷贝文件时，FineReport和FineBI需要拷贝的文件不完全相同，注意文档中的表格即可。

2）使用运维平台启停容器时，FineReport关闭的是fr组件，FineBI关闭的是bi6组件。

2.1 部署运维平台

容器化FineBI工程，需要通过运维平台部署。因此用户需要先部署一个FineOps运维平台。

详情请参见：部署运维平台

2.2 部署新容器化工程

进行迁移前，用户需要先通过运维平台部署一个容器化单机工程。

详情请参见：部署新项目-FineBI、部署新项目-FineReport

注1：请记录下MySQL组件的相关信息，由于密码随机生成，请务必修改MySQL组件的密码，方便后续使用。

注2：请记录下FineBI工程的挂载路径，用户可自定义路径。这是工程文件的存放路径，后面步骤中需要用到。

2.3 确认新工程服务器剩余磁盘空间

1）检查原工程的大小。

2）根据原工程大小，适度扩大新工程所在服务器节点剩余磁盘空间，建议大于原工程的两倍，最少剩余磁盘大小500G。

2.4 关闭新工程

用户登录运维平台，点击「运维管理>项目管理」，点击新工程项目后的「组件管理」按钮。

找到bi6组件，点击「停止」按钮，即可关闭新工程。如下图所示：

2.5 备份config

请在新工程的挂载路径/fanruanxxx/bi目录下，找到config文件夹，并另行备份。

该文件夹中存放的yaml文件中，有着工程部署所用语句，后续运营维护时可能会需要使用/查找，请务必异地备份。

3.1 备份原工程

在进行工程迁移前，为避免迁移失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作。

请使用运维平台的 备份管理 功能对原工程进行手动备份。

3.2 升级原工程

工程迁移的前提是，两个工程必须处于同一版本。

管理员登录运维平台，点击「运维管理>项目管理」点击新老工程后的「组件管理」，查看bi6组件的当前版本是否相同（精确到日期）。

若两个工程版本不相同，可参考该文档更新工程版本：外网升级指定版本/内网升级项目

3.3 关闭原工程

用户登录运维平台，点击「运维管理>项目管理」，点击原工程项目后的「组件管理」按钮。

找到bi6组件，点击「停止」按钮，即可关闭新工程。如下图所示：

4.1 拷贝外接数据库

将原容器化项目中的MySQL组件的外挂目录数据，拷贝到新工程项目中的MySQL组件的外挂目录里。

注：MySQL组件的外挂目录地址，一般在项目挂载路径/fanruanxxx/mysql下。

4.2 拷贝工程文件

将原容器化项目中的bi6组件的外挂目录数据，拷贝到新工程项目中的bi6组件的外挂目录里。

1）请提前检查原工程，是否修改了外挂目录位置、是否配置共享文件服务器，确保拷贝到正确的文件。

2）新工程外挂文件所在位置，为2.2节记录的挂载路径。

3）将以下文件，从原工程外挂目录，拷贝到新工程外挂目录中：

注1：请勿直接拷贝整个外挂目录文件夹到新工程，部分文件不可以被覆盖。

注2：请勿使用3.1节备份的文件，而是使用工程最终的文件进行拷贝操作。

• FineBI需要拷贝的文件

• FineReport需要拷贝的文件

用户登录运维平台，点击「运维管理>项目管理」，点击新老工程项目后的「组件管理」按钮。

找到bi6组件，点击「启动」按钮，即可启动新老工程。如下图所示：

容器化工程一般使用「容器私有云认证」方式进行注册。

请参考文档第四章进行授权迁移操作：容器私有云认证