pyvmomi社区样例代码安装与使用指南
目录结构及介绍
当你克隆或下载了pyvmomi-community-samples
项目后, 其基本目录结构如下:
pyvmomi-community-samples/
├── samples # 样例脚本存放的位置
│ ├── vsan-samples # VSAN相关功能的脚本
│ └── ... # 其他样例脚本子目录
├── .gitignore # Git忽略规则
├── pylintrc # PyLint 配置文件
├── LICENSE # 许可证信息
├── README.md # 项目读我文件
├── requirements.txt # 必需的Python包列表
├── setup.py # 设置脚本用于安装依赖等
├── test-requirements.txt # 测试所需的额外依赖项
└── tox.ini # Tox测试工具配置文件
目录详解
samples
: 此目录下包含了所有由社区贡献的各种功能示例脚本。.gitignore
: Git配置文件中列出不需要被版本控制跟踪的文件和目录模式。pylintrc
: PyLint静态代码分析工具使用的配置文件。LICENSE
: 说明项目所采用的许可协议(Apache License 2.0)。README.md
: 包含项目简介和其他重要信息的Markdown格式读我文件。requirements.txt
: 列出了运行此项目所必需的Python库及其版本要求。setup.py
: Python包构建系统脚本,用于安装项目本身的依赖。test-requirements.txt
: 测试框架所需的一些特定环境依赖项。tox.ini
: Tox集成测试工具的初始化配置文件。
启动文件介绍
在pyvmomi-community-samples
项目中, 并没有单独定义一个主"启动文件", 因为这个仓库是作为一个样例集设计的, 每个脚本都可以独立执行以演示不同的功能或操作。然而,你可以从samples
目录下的任何脚本来开始探索:
例如,如果你对虚拟机管理感兴趣, 可以尝试运行getallvms.py
样例脚本。要运行这些脚本, 确保你的环境中已经通过pip install -r requirements.txt
命令安装好了所有的依赖库。
配置文件介绍
该项目并没有在一个中央位置维护单一的配置文件; 而是在每个具体的脚本内处理配置和参数设置。通常在每个脚本开头, 你会看到如以下所示的部分:
import sys
from pyVim.connect import SmartConnect, Disconnect
from pyVmomi import vim
def main():
if len(sys.argv) < 5:
print("Usage: %s [server] [username] [password] [port]" % sys.argv[0])
sys.exit()
server = sys.argv[1]
username = sys.argv[2]
password = sys.argv[3]
port = int(sys.argv[4])
try:
si = SmartConnect(host=server, user=username, pwd=password, port=port)
if not si:
raise SystemExit("Unable to connect to the specified host")
except Exception as e:
print("Exception caught, program exiting:", e)
sys.exit(-1)
# Your code logic continues...
该部分展示了如何从命令行参数接收服务器连接详细信息,而这些通常是每个脚本特有的配置点。此外,在开发过程中或者扩展样例时, 开发者可能会在脚本内部定义更多逻辑相关的配置变量。
注: 在运行脚本之前确保你具有正确的环境权限并且理解脚本将要执行的操作, 特别是当涉及到实际生产环境中的数据操作时。