配置Salt-Cloud的GCE Provider时apache-libcloud依赖报错排查

问题重现 #

执行salt-cloud --list-providers时触发错误：

root@bastion-01:~# salt-cloud --list-providers
[WARNING ] The cloud driver, 'gce', configured under the 'my-gce-config' cloud provider alias, could not be loaded. Please check your provider configuration files and ensure all required dependencies are installed for the 'gce' driver.
In rare cases, this could indicate the 'gce.get_configured_provider()' function could not be found.
Removing 'gce' from the available providers list
Error: There was an error listing providers: There are no cloud providers configured.

追踪日志发现核心报错：

[TRACE   ] Error loading clouds.gce: apache-libcloud is not installed

但系统已确认安装该依赖：

root@bastion-01:~# salt --versions-report
Salt Version:
          Salt: 3006.10

Python Version:
        Python: 3.10.16 (main, Mar  6 2025, 02:23:15) [GCC 11.2.0]

Dependency Versions:
          cffi: 1.14.6
      cherrypy: unknown
  cryptography: 42.0.5
      dateutil: 2.8.1
     docker-py: Not Installed
         gitdb: Not Installed
     gitpython: Not Installed
        Jinja2: 3.1.6
       libgit2: Not Installed
  looseversion: 1.0.2
      M2Crypto: Not Installed
          Mako: Not Installed
       msgpack: 1.0.2
  msgpack-pure: Not Installed
  mysql-python: Not Installed
     packaging: 22.0
     pycparser: 2.21
      pycrypto: Not Installed
  pycryptodome: 3.19.1
        pygit2: Not Installed
  python-gnupg: 0.4.8
        PyYAML: 6.0.1
         PyZMQ: 23.2.0
        relenv: 0.18.1
         smmap: Not Installed
       timelib: 0.2.4
       Tornado: 4.5.3
           ZMQ: 4.3.4

System Versions:
          dist: ubuntu 20.04.6 focal
        locale: utf-8
       machine: x86_64
       release: 5.15.0-1078-gcp
        system: Linux
       version: Ubuntu 20.04.6 focal

root@bastion-01:~# pip3.10 list | grep libcloud
apache-libcloud          2.8.0

排查与解决建议 #

• 确认Salt与pip使用的Python环境一致
  Salt可能运行在独立Python环境中，导致无法识别pip3.10安装的包。执行以下命令验证：

  # 查看Salt-Cloud使用的Python解释器路径
  which salt-cloud
  # 检查该环境能否导入apache-libcloud
  $(which salt-cloud) -c "import libcloud; print(libcloud.__version__)"
  

  若提示ModuleNotFoundError，则需要在Salt对应的Python环境中重新安装：

  $(which salt-cloud | sed 's/salt-cloud/pip/') install apache-libcloud==2.8.0
  

• 验证版本兼容性
  Salt 3006.10对apache-libcloud存在版本要求，2.8.0可能不在兼容范围内。尝试安装官方推荐的兼容版本（如3.8.0）：

  pip3.10 install apache-libcloud==3.8.0 --upgrade
  

• 检查GCE Provider配置文件
  确保/etc/salt/cloud.providers.d/下的GCE配置文件（如gce.conf）格式正确，无语法错误：
  示例配置片段：

  my-gce-config:
    provider: gce
    project_id: your-project-id
    service_account_email: your-service-account@example.com
    service_account_private_key: /path/to/private-key.json
    ssh_key_file: /path/to/ssh-key.pub
  

  执行配置验证：

  salt-cloud --validate-config
  

• 重启Salt服务
  安装依赖或修改配置后，重启Salt相关服务：

  systemctl restart salt-master
  systemctl restart salt-minion
  

• 修正文件权限
  确保Salt进程能读取GCE密钥文件，设置正确权限：

  chmod 600 /path/to/private-key.json
  chown root:root /path/to/private-key.json
  

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