Ansible 2.10离线安装azure集合tar包报Invalid collection name如何解决

Ansible 2.10.x版本的ansible-galaxy工具默认会将install命令后传入的参数优先解析为标准<命名空间>.<集合名>格式的集合标识，不会自动识别为本地tar包路径，因此直接传入tar包文件名会触发格式校验报错。

方法1：添加--offline参数执行安装 #

执行安装命令时加上--offline参数，同时明确指定tar包的相对或绝对路径，避免被识别为集合名：

ansible-galaxy collection install --offline ./azure-azcollection-1.10.0.tar.gz

方法2：解压后安装 #

如果方法1执行仍报错，可以先解压tar包再指定解压后的目录安装：

1. 解压tar包

tar -xzf azure-azcollection-1.10.0.tar.gz

2. 执行本地目录安装

ansible-galaxy collection install ./azure/azcollection

方法3：显式指定集合名关联本地包 #

通过<集合名>:<本地路径>的格式明确告知工具参数对应本地包：

ansible-galaxy collection install azure.azcollection:./azure-azcollection-1.10.0.tar.gz

安装前请确认离线环境已提前安装azcollection依赖的Python SDK包，避免后续执行模块时报依赖缺失错误。

内容的提问来源于stack exchange，提问作者WhoAmI