离线安装

Pigsty是一个复杂的软件系统，为了确保系统的稳定，Pigsty会在初始化过程中从互联网下载所有依赖的软件包并建立本地Yum源。

所有依赖的软件总大小约1GB左右，下载速度取决于您的网络情况。尽管Pigsty已经尽量使用镜像源以加速下载，但少量包的下载仍可能受到防火墙的阻挠，可能出现非常慢的情况。您可以通过proxy_env配置项设置下载代理以完成首次下载。

如果您希望跳过漫长的下载过程，或者执行控制的元节点没有互联网访问，则可以考虑下载预先打包好的离线安装包。

离线安装包

为了快速拉起Pigsty，建议使用离线下载软件包并上传的方式完成安装。

离线安装包收纳了本地Yum源的所有软件包。默认情况下，Pigsty会在初始化基础设施时创建本地Yum源，

{{ repo_home }}
  |---- {{ repo_name }}.repo
  ^---- {{ repo_name}}/repo_complete
  ^---- {{ repo_name}}/**************.rpm

默认情况下，{{ repo_home }} 是Nginx静态文件服务器的根目录，默认为/www，repo_name是自定义的本地源名称，默认为pigsty

以默认情况为例，/www/pigsty 目录包含了所有 RPM 软件包，离线安装包实际上就是 /www/pigsty 目录的压缩包 。

离线安装包的原理是，Pigsty在执行基础设施初始化的过程中，会检查本地Yum源相关文件是否已经存在。如果已经存在，则会跳过下载软件包及其依赖的过程。

检测所用的标记文件为{{ repo_home }}/{{ repo_name }}/repo_complete，默认情况下为/www/pigsty/repo_complete，如果该标记文件存在，（通常是由Pigsty在创建本地源之后设置），则表示本地源已经建立完成，可以直接使用。否则，Pigsty会执行常规的下载逻辑。下载完毕后，您可以将该目录压缩复制归档，用于加速其他环境的初始化。

沙箱的离线安装包

Pigsty自带了一个沙箱环境，沙箱环境的离线安装包默认放置于files目录中，可以从Github Release页面下载。

cd <pigsty>/files/
wget https://github.com/Vonng/pigsty/releases/download/v0.6.0/pkg.tgz 

下载后，如果放置于files目录中，则可以直接使用 Makefile 提供的快捷指令上传离线安装包至元节点上。

使用 Pigsty 沙箱时，可以通过 make cache 制作离线安装包并拷贝到本地。

# cache rpm packages from meta controller
cache:
	rm -rf pkg/* && mkdir -p pkg;
	ssh -t meta "sudo tar -zcf /tmp/pkg.tgz -C /www pigsty; sudo chmod a+r /tmp/pkg.tgz"
	scp -r meta:/tmp/pkg.tgz files/pkg.tgz
	ssh -t meta "sudo rm -rf /tmp/pkg.tgz"

同理，使用 make upload，也会将本地的离线安装包（Yum缓存）拷贝至元节点上。

# upload rpm cache to meta controller
upload:
	ssh -t meta "sudo rm -rf /tmp/pkg.tgz"
	scp -r files/pkg.tgz meta:/tmp/pkg.tgz
	ssh -t meta "sudo mkdir -p /www/pigsty/; sudo rm -rf /www/pigsty/*; sudo tar -xf /tmp/pkg.tgz --strip-component=1 -C /www/pigsty/"

在生产环境使用离线安装包

使用离线安装包前，您必须确保生产环境的操作系统与制作该安装包的机器操作系统一致。Pigsty提供的离线安装包默认使用CentOS 7.8。

使用不同操作系统版本的离线安装包可能会出错，也可能不会，我们强烈建议不要这么做。

如果您使用了CentOS 7.8以外的操作系统，建议在安装有该版本操作系统，且带有互联网访问的元节点上完成完整的初始化流程（不使用离线安装包），然后使用make cache类似的命令制作符合您的环境操作系统版本的离线安装包。

tar -zcf /tmp/pkg.tgz -C /www pigsty

然后pkg.tgz即可用于其他带有同版本操作系统的生产环境中。

在生产环境使用离线安装包与沙箱环境类似，用户需要将pkg.tgz复制到元节点上，然后将离线安装包解压至目标地址。

这里以默认的 /www/pigsty 为例，将压缩包中的所有内容（RPM包，repo_complete标记文件，repodata 源的元数据库等）解压至目标目录/www/pigsty中，可以使用以下命令。

mkdir -p /www/pigsty/
sudo rm -rf /www/pigsty/*
sudo tar -xf /tmp/pkg.tgz --strip-component=1 -C /www/pigsty/

离线安装Ansible

Pigsty依赖Ansible进行环境初始化。那么就有一个问题，如果元节点本身没有安装Ansible，也没有互联网访问怎么办？

离线安装包本身带有ansible，可以直接通过本地文件Yum源的方式使用，假设您已经将离线安装包解压至/www/pigsty。

将以下Repo文件写入/etc/yum.repos.d/pigsty-local.repo 中，就可以直接使用该源了。

[pigsty-local]
name=Local Yum Repo pigsty
baseurl=file:///www/pigsty
skip_if_unavailable = 1
enabled = 1
priority = 1
gpgcheck = 0

执行以下命令，在元节点上离线安装Ansible

yum clean all
yum makecache
yum install ansible