国产麒麟系统下Ansible 2.8.20离线安装全攻略（附PyYAML依赖解决）

最新推荐文章于 2026-04-27 17:56:40 发布

原创

最新推荐文章于 2026-04-27 17:56:40 发布 · 349 阅读

标签

#Ansible #离线安装 #麒麟系统 #自动化运维

国产麒麟系统下Ansible 2.8.20离线安装全攻略（附PyYAML依赖解决）

最近在几个国产化替代项目中，经常需要在内网隔离的麒麟服务器上部署自动化运维工具。Ansible作为无代理架构的佼佼者，自然是首选。但实际操作起来，尤其是在Kylin-Server这类国产系统上离线安装特定版本，远不是一条yum install命令那么简单。依赖包的缺失、Python环境的差异、编译过程中的各种“坑”，都是需要提前规划和手动解决的。这篇文章，我就结合自己最近在政务云环境中的实战经验，为你梳理一份从零开始的、详尽且可复现的Ansible 2.8.20离线安装指南。无论你是金融、能源还是其他对国产化有严格要求的行业运维工程师，这份攻略都能帮你绕过我踩过的那些雷。

1. 环境准备与规划：打好离线部署的基础

在开始动手之前，充分的准备工作能避免后续80%的麻烦。离线安装的核心矛盾在于：所有依赖都必须预先下载并妥善管理。对于麒麟系统（以Kylin-Server-10-SP2为例），我们尤其要关注其自带的软件源和Python环境可能与主流社区版本的细微差别。

首先，确认你的基础环境。通过以下命令获取关键信息：

cat /etc/kylin-release
uname -a
python3 --version
pip3 --version || echo "pip3 not installed"

一个典型的环境输出可能如下：

Kylin Linux Advanced Server release V10 (Sword)
Linux kylin-server 4.19.90-23.8.v2101.ky10.x86_64 #1 SMP Wed Mar 3 03:00:00 CST 2021 x86_64 x86_64 x86_64 GNU/Linux
Python 3.7.9

为什么选择Ansible 2.8.20？ 在国产化替代初期，系统版本和依赖库版本往往比较固定。Ansible 2.8是一个长期支持且相对稳定的版本，其依赖的Python库版本与麒麟系统自带的Python 3.7兼容性较好，避免了因版本过高导致的不必要编译问题。当然，你也可以选择其他2.8.x的版本，流程大同小异。

接下来是依赖包收集，这是离线安装最关键的步骤。你需要一个能连接互联网的、环境类似的“跳板机”（可以是虚拟机），用于下载所有必需的安装包。我们需要的主要分为两类：

Ansible源码及其Python依赖：包括Ansible本身和其核心依赖如PyYAML、Jinja2、Paramiko等。
系统级编译依赖：用于从源码编译Python包的工具，如gcc、python3-devel等。这些通常可以通过麒麟系统的离线镜像源获取，但务必提前准备好。

提示：建议在跳板机上使用pip download命令来下载依赖的wheel或源码包，这比手动一个个寻找要高效准确得多。虽然我们最终目标是离线安装，但收集过程本身需要网络。

2. 构建离线资源库：系统依赖与Python包管理

在跳板机上，我们创建一个专门的工作目录，例如/opt/ansible-offline，并在此目录下完成所有资源的下载。

2.1 下载Ansible源码及核心依赖

首先，下载指定版本的Ansible源码包。你可以从官方仓库或国内镜像站获取。

mkdir -p /opt/ansible-offline/packages
cd /opt/ansible-offline/packages
# 使用wget或curl下载，这里以官方地址为例（实际操作中可替换为国内镜像加速）
wget https://releases.ansible.com/ansible/ansible-2.8.20.tar.gz

接着，使用pip来下载Ansible及其所有依赖。创建一个临时的虚拟环境是个好习惯，可以避免污染跳板机的环境。