pivotalservices/pynsxv

PyNSXv镜像说明

镜像概述

本镜像基于Ubuntu系统，预装了更新的Python库及pynsxv工具，提供CLI命令行和Python库两种使用方式，用于VMware NSX for vSphere的程序化配置与管理，帮助用户自动化NSX环境的部署、组件管理等工作。

核心功能

1. CLI工具：支持逻辑交换机、分布式路由器、边缘服务网关等NSX组件的创建、查询、删除操作。
2. Python库：可导入代码实现自定义NSX工作流，如批量配置或集成到自动化流水线。
3. 多环境支持：通过多个ini配置文件管理不同NSX环境，灵活切换。

使用场景

• 自动化NSX环境的初始化部署。
• 批量管理NSX组件（如批量创建逻辑交换机）。
• 集成到CI/CD流程实现NSX配置的自动化更新。

配置说明

1. 创建nsx.ini配置文件

需包含NSX Manager和vCenter的连接信息，格式如下：

ini
[nsxv]
nsx_manager = <NSX管理器IP>
nsx_username = admin
nsx_password = <NSX密码>

[vcenter]
vcenter = <vCenter IP/主机名>
vcenter_user = administrator@vsphere.local
vcenter_passwd = <vCenter密码>

[defaults]
transport_zone = <传输区域名称>
datacenter_name = <数据中心名称>
edge_datastore = <边缘网关数据存储>
edge_cluster = <边缘网关集群>

2. Docker部署示例

执行CLI命令

将本地配置文件挂载到容器，运行pynsxv命令：

bash
docker run --rm -v $(pwd)/nsx.ini:/app/nsx.ini pivotalservices/pynsxv pynsxv lswitch list

使用自定义配置文件

bash
docker run --rm -v $(pwd)/custom_config.ini:/app/custom_config.ini pivotalservices/pynsxv pynsxv -i /app/custom_config.ini esg list

作为Python库使用

将自定义脚本挂载到容器执行：

bash
docker run --rm -v $(pwd)/script.py:/app/script.py -v $(pwd)/nsx.ini:/app/nsx.ini pivotalservices/pynsxv python /app/script.py

示例脚本（script.py）：

python
from pynsxv.library.nsx_logical_switch import logical_switch_list
from nsxramlclient.client import NsxClient

# 初始化NSX客户端（需确认容器内raml文件路径）
nsxraml_file = '/path/to/nsxvapi.raml'
client = NsxClient(nsxraml_file, 'nsx_manager_ip', 'admin', 'password')

# 查询逻辑交换机列表
ls_list = logical_switch_list(client)
print("逻辑交换机列表：", ls_list)

依赖说明

镜像预装以下开源依赖：

• pyvmomi（VMware vSphere API客户端）
• nsxramlclient（NSX API客户端）
• tabulate（表格输出工具）