用途:用 Ansible 自动化 Proxmox VE,优先调用 community.proxmox 原生模块,减少 CLI 使用。
主要能力:创建与克隆虚拟机(proxmox_kvm)、管理用户/组/池/ACL(proxmox_user、proxmox_group、proxmox_pool、proxmox_acl)、存储(proxmox_storage);集群创建与加入、CEPH 初始化与 OSD 创建等无原生模块的操作使用 CLI,并配合幂等控制。
使用方式:安装集合 uv run ansible-galaxy collection install community.proxmox,或 uv run ansible-galaxy collection install -r requirements.yml。API 调用建议 delegate_to: localhost,认证推荐 API Token(api_host、api_user、api_token_id、api_token_secret),本地节点操作可用 root 密码并加 no_log。CLI 操作先检查状态再执行,例如 pvecm status 注册结果后按条件运行 pvecm create 或 pvecm add;CEPH 用 pveceph status、pveceph init、pveceph osd list/create。网络配置可用 community.general.interfaces_file。
适用场景:Proxmox 虚拟机批量供给、模板克隆、权限与存储管理、集群与 CEPH 部署。
限制:集群创建/加入、CEPH 初始化与 OSD 无原生模块,需 CLI;CLI 需自行保证幂等;API 调用不应在受管节点上执行。具体版本、收费与平台支持暂未提供。