离线安装 SphereEx-Boot #

制作离线镜像安装包方便用户在隔离外网环境的主机上面可以安装部署 Boot 工具。有两种方式进行离线安装。

离线安装包安装 #

适用场景

当部署环境为 Linux 操作系统的 python 2.7 环境，且无法访问外网时，可使用离线安装，离线安装包中包含了对应版本的依赖包。

相关概念

源主机: 可以和外网联通的主控机，安装好 Python 、 pip。
目标主机：不可以和外网联通的主控机，具有和源主机相同版本的 Python。并且源主机和目标主机需要相同的操作系统和架构。

离线包说明

从网址 https://download.sphere-ex.com/boot/spex-boot-offline-1.0.tar.gz 下载 SphereEx-Boot 离线安装包 spex-boot-offline-1.0.tar.gz , 包内已经包含支持 Linux系统、Python2.7 环境的相关安装包软件。

$ tar -zxvf spex-boot-offline-1.0.tar.gz
$ cd spex-boot-offline-1.0
$ ls -l 
total 152704
drwxr-xr-x  30 root  staff       960  3 17 14:49 package
-rw-r--r--@  1 root  staff   1530646  3 17 14:23 pip-20.3.4.tar.gz
-rw-r--r--   1 root  staff  75819309  3 17 15:09 prometheus-2.33.3.linux-amd64.tar.gz
-rw-r--r--   1 root  staff       159  3 17 15:13 requirements.txt
-rw-r--r--   1 root  staff    783964  3 21 14:49 setuptools-41.0.1.tar.gz
-rw-r--r--   1 root  staff     37995  3 17 11:35 spex-boot-1.0.tar.gz

package 存放的是 SphereEx-Boot 依赖包
pip-20.3.4.tar.gz 是 pip 源码安装包
prometheus-2.33.3.linux-amd64.tar.gz 是 prometheus 安装包
requirements.txt 是 SphereEx-Boot 依赖包清单
setuptools-41.0.1.tar.gz 是 setuptools 源码安装包
spex-boot-1.0.tar.gz 是 SphereEx-Boot 安装包

前提条件

把 spex-boot-offline-1.0.tar.gz 安装包发送到目标主机。
目标主机需要有 Python2.7 环境。
已安装 pip，如果未安装可以使用离线包内的 pip 源码包进行安装。

操作步骤

安装 setuptools。

cd spex-boot-offline-1.0
tar -xf setuptools-41.0.1.tar.gz
cd setuptools-41.0.1
python setup.py install

安装 pip (已有可跳过)。

$ tar -zxvf pip-20.3.4.tar.gz
$ cd pip-20.3.4
$ python setup.py install

目标主机安装依赖包。

$ pip install --no-index --find-links=./package -r requirements.txt

目标主机安装 Boot。

$ pip install spex-boot-1.0.tar.gz

制作依赖包安装 #

适用场景

当离线安装包内的 SphereEx-Boot 依赖版本和实际情况不匹配时，可以采取制作依赖包进行安装。

操作步骤

源主机安装 Boot 工具。
获取 Boot 工具依赖清单文件。可以通过下面两种方式获取 Boot 依赖清单文件 requirements.txt：

在源主机中使用 spex mirror clone --requirement 命令导出 Boot 依赖清单。

$ spex mirror clone --requirement
$ ls 
requirements.txt

在源主机执行 spex mirror clone 命令导出全部镜像安装包，包括依赖清单文件。

$ spex mirror clone
$  ls -l
total 126008
-rw-r--r--  1 root  staff  49822163 Feb 23 16:23 apache-shardingsphere-x.x.x-shardingsphere-proxy-bin.tar.gz
-rw-r--r--  1 root  staff  12516362 Feb 23 16:24 apache-zookeeper-x.x.x-bin.tar.gz
-rw-r--r--  1 root  staff   1007502 Feb 23 16:24 mysql-connector-java-x.x.x.jar
-rw-r--r--  1 root  staff       148 Feb 23 16:23 requirements.txt
-rw-r--r--  1 root  staff     34132 Feb 23 16:24 spex-boot-1.0.tar.gz

获取 Boot 依赖安装包。

在源主机上执行如下命令 pip download -r <依赖清单文件> -d <导出目录>，依赖清单中的全部依赖安装包会下载到指定的导出目录中。

$ pip download -r requirements.txt -d ./package

目标主机安装 Boot 依赖包。

把依赖清单文件和依赖安装包发送到目标主机。

在目标主机执行命令 pip install --no-index --find-links=<依赖安装包目录> -r <依赖清单文件>。

$ pip install --no-index --find-links=./package -r requirements.txt

目标主机安装 Boot。

把 Boot 安装包发送到目标主机，在目标主机执行安装命令。

$ pip install spex-boot-1.0.tar.gz