Ansible是统信UOS上部署自动化运维的首选工具，支持APT、pip及离线三种安装方式，并需配置SSH免密登录与主机清单。
如果您在统信UOS操作系统上需要部署自动化运维能力，则Ansible是最轻量、免客户端且基于SSH的首选工具。以下是针对统信UOS（含d版及企业版）安装与配置Ansible的多种可行方法，覆盖联网与离线场景。
一、使用APT命令直接安装
该方法适用于已配置官方软件源且可访问互联网的统信UOS系统，操作简洁、依赖自动解决，是默认推荐方式。
1、更新软件包索引列表：
sudo apt update
2、执行Ansible安装：
sudo apt install ansible -y
3、验证是否安装成功：
ansible --version
若输出包含 ansible [core x.x.x] 及Python版本信息，则表示核心组件已就绪。
二、通过pip方式安装
当系统中已存在满足要求的Python环境（Python 3.5+），且需安装特定版本或最新版Ansible时，pip方式提供更高灵活性。
1、确认Python版本：
python3 --version
2、确保pip3已安装并升级：
sudo apt install python3-pip -y && pip3 install --upgrade pip
3、安装Ansible：
pip3 install ansible
4、验证安装路径与版本：
pip3 show ansible
注意：若提示权限错误，请使用 --user 参数安装至当前用户目录，或切换为root用户执行。
三、离线环境下安装Ansible
适用于无外网连接但具备Python基础环境的生产服务器，需提前准备依赖包并按顺序安装。
1、检查Python版本与pip状态：
python3 -V && pip3 list | grep pip
2、若pip未安装，下载离线pip包（如pip-20.3.tar.gz）并解压：
tar -zxvf pip-20.3.tar.gz
3、进入解压目录并安装setuptools（pip依赖）：
cd setuptools-38.0.0 && python3 setup.py install
4、返回pip目录并安装pip本身：
cd ../pip-20.3 && python3 setup.py install
5、使用pip3安装Ansible离线wheel包（需提前下载ansible-x.x.x-py3-none-any.whl）：
pip3 install ansible-x.x.x-py3-none-any.whl
关键提示：所有离线包必须与目标系统架构（ARM64/AMD64）及Python主版本严格匹配，否则将出现 ImportError: cannot import name 'main' 等错误。
四、配置SSH免密登录
Ansible通过SSH协议管理节点，必须完成控制端到被控端的身份认证配置，否则所有模块调用均会失败。
1、在Ansible控制主机生成密钥对（不设置密码）：
ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa -N ""
2、将公钥复制至本机（实现localhost自管理）：
ssh-copy-id -i ~/.ssh/id_rsa.pub root@localhost
3、将公钥复制至每台被控主机（以192.168.10.10为例）：
ssh-copy-id -i ~/.ssh/id_rsa.pub root@192.168.10.10
4、测试SSH连通性：
ssh -o ConnectTimeout=5 -o BatchMode=yes root@192.168.10.10 exit
若返回空响应且无密码提示，则表明免密登录配置成功；否则需检查 /root/.ssh/authorized_keys 权限是否为600且属主为root。
五、配置主机清单与主配置文件
主机清单（Inventory）定义管理目标，主配置文件（ansible.cfg）控制全局行为，二者共同构成Ansible运行基础。
1、编辑默认主机清单文件：
sudo nano /etc/ansible/hosts
2、添加示例分组（替换IP为实际被控机地址）：
[prod]
192.168.10.10
192.168.10.11
3、创建或修改Ansible主配置文件：
sudo mkdir -p /etc/ansible && sudo nano /etc/ansible/ansible.cfg
4、写入必要配置项：
[defaults]
host_key_checking = False
remote_user = root
log_path = /var/log/ansible.log
5、手动创建日志目录并授权：
sudo mkdir -p /var/log/ansible && sudo chown root:root /var/log/ansible
重要提醒：首次启用 host_key_checking = False 可跳过SSH指纹确认，但仅限可信内网环境；生产环境建议保留默认值并预注册指纹。
