当前位置：首页 > news >正文

openEuler 24.03 全流程实战：用 Ansible 5 分钟部署分布式 MinIO 高可用集群

news 2025/7/5 5:14:05

0 | 为什么要写这篇教程？

1 | 准备工作

1.1 控制节点手工下载 MinIO

1.2 SSH 互信（可跳过，本教程已有互信）

1.3 安装 Ansible & SELinux 依赖

2 | 项目目录

3 | Inventory hosts.ini

4 | 变量文件 group_vars/all.yml（整体加密）

5 | 角色文件

5.1 roles/minio/tasks/main.yml

5.2 install.yml —— 上传二进制 + 创建用户

5.3 configure.yml —— 创建目录 + 生成 endpoint 列表 + unit 文件

5.4 start.yml

5.5 handlers/main.yml

5.6 templates/minio.service.j2

6 | 主 Playbook deploy_minio.yml

7 | 执行部署

8 | 验证集群状态

9 | 常见踩坑与解决

10 | 总结

版本与环境

OS：openEuler 24.03 (LTS)

Ansible：≥ 2.11（dnf install -y ansible）

MinIO：RELEASE.2025-06-13T11-33-47Z

主控节点：10.130.135.145（也运行 Ansible）

存储节点：10.130.135.{164,149,200,199}

数据目录：/app/minio_data/disk1…4

端口：9000（API）/9001（Console）

0 | 为什么要写这篇教程？

在 openEuler-24.03 上用 Ansible 部署 MinIO 分布式，踩过不少坑：

报错/现象	根因
`VARIABLE IS NOT DEFINED!`	Vault 文件未被加载 / 变量自引用
`loop.parent` attribute error	Jinja2 嵌套循环解析不稳定
`requested handler 'restart minio' was not found`	忘了在 handlers 里声明
SELinux 绑定缺失	openEuler 默认开启 SELinux，需安装 `python3-libselinux`
curl 下载慢	改为一次上传二进制 → copy 分发

下面给出一次能跑通的最终方案，并总结每个坑的解决思路。

1 | 准备工作

1.1 控制节点手工下载 MinIO

mkdir -p /opt/minio-bin
cd /opt/minio-bin
curl -LO https://dl.min.io/server/minio/release/linux-amd64/archive/minio.RELEASE.2025-06-13T11-33-47Z
mv minio.RELEASE.* minio
chmod +x minio

这样只有控制机访问公网，其余节点通过 Ansible 的 copy 分发即可。

1.2 SSH 互信（可跳过，本教程已有互信）

ssh-keygen -t rsa -f ~/.ssh/id_rsa -N ''
for h in 164 149 200 199; do ssh-copy-id root@10.130.135.$h; done

1.3 安装 Ansible & SELinux 依赖

dnf install -y ansible python3-libselinux

2 | 项目目录

minio-ansible/
├── hosts.ini
├── deploy_minio.yml
├── group_vars/
│   └── all.yml          # 已加密
└── roles/└── minio/├── tasks/│   ├── main.yml│   ├── install.yml│   ├── configure.yml│   └── start.yml├── handlers/│   └── main.yml└── templates/└── minio.service.j2

3 | Inventory `hosts.ini`

[minio]
10.130.135.164
10.130.135.149
10.130.135.200
10.130.135.199

4 | 变量文件 `group_vars/all.yml`（整体加密）

为啥放 all.yml 而不是 vault.yml？

group_vars/all.yml 是 Ansible 的 自动加载路径，不会漏读。

整个文件加密，省去在 playbook 里 vars_files 的声明和加载顺序问题。

5 | 角色文件

5.1 `roles/minio/tasks/main.yml`

- import_tasks: install.yml
- import_tasks: configure.yml
- import_tasks: start.yml

5.2 `install.yml` —— 上传二进制 + 创建用户

- name: Create group & userbecome: truegroup: { name: "{{ minio_group }}" }
- user:name: "{{ minio_user }}"group: "{{ minio_group }}"shell: /sbin/nologincreate_home: nobecome: true- name: Copy MinIO binary from control nodecopy:src: "{{ minio_local_bin }}"dest: "{{ minio_bin_path }}"owner: rootgroup: rootmode: '0755'become: true

5.3 `configure.yml` —— 创建目录 + 生成 endpoint 列表 + unit 文件

- name: Create data dirsfile:path: "{{ item }}"state: directoryowner: "{{ minio_user }}"group: "{{ minio_group }}"mode: '0755'loop: "{{ minio_data_dirs }}"become: true# 单行 set_fact，避开 loop.parent 的坑
- name: Build endpoint listset_fact:minio_endpoints: "{{ minio_cluster_nodes| product(minio_data_dirs)| map('join','')| map('regex_replace','^(.*)$','http://\\1')| list }}"- name: Deploy systemd unittemplate:src: minio.service.j2dest: /etc/systemd/system/minio.servicenotify: restart miniobecome: true

5.4 `start.yml`

- systemd:daemon_reload: truebecome: true- systemd:name: miniostate: startedenabled: truebecome: true

5.5 `handlers/main.yml`

- name: restart miniobecome: truesystemd:name: miniostate: restarteddaemon_reload: true

5.6 `templates/minio.service.j2`

[Unit]
Description=MinIO Distributed Object Storage
After=network.target[Service]
User={{ minio_user }}
Group={{ minio_group }}
Environment="MINIO_ROOT_USER={{ minio_root_user }}"
Environment="MINIO_ROOT_PASSWORD={{ minio_root_password }}"ExecStart={{ minio_bin_path }} server {{ minio_endpoints | join(' ') }} \--address ":{{ minio_port }}" --console-address ":{{ minio_console_port }}"Restart=always
LimitNOFILE=65536[Install]
WantedBy=multi-user.target

6 | 主 Playbook `deploy_minio.yml`

---
- hosts: miniobecome: trueroles:- minio

7 | 执行部署

# 首次或每次升级
ansible-playbook -i hosts.ini deploy_minio.yml --ask-vault-pass

如果一切正常，你会看到所有节点 ok= 绿色，failed=0。

8 | 验证集群状态

# 查看 systemd
ansible -i hosts.ini minio -b -a "systemctl status minio --no-pager"# 查看端口
ansible -i hosts.ini minio -a "ss -ltnp | grep :9000" -b
ansible -i hosts.ini minio -a "ss -ltnp | grep :9001" -b# 浏览器访问 http://10.130.135.164:9001 用 root 账号登录

9 | 常见踩坑与解决

报错	解决
`VARIABLE IS NOT DEFINED`	确保敏感变量放在 `group_vars/all.yml` 并加密；或在 playbook 中显式 `vars_files`。
`loop.parent` attribute error	不要在模板用 `loop.parent`；改为先 `set_fact` 生成列表。
`requested handler 'restart minio' was not found`	在 `roles/minio/handlers/main.yml` 声明同名 handler。
SELinux 报缺 `libselinux-python`	openEuler 24.03 默认装 `python3-libselinux`，若无则 `dnf install -y python3-libselinux`。
下载慢	手工下载到控制机，`copy` 分发。