vmware/vcsim

vcsim 镜像文档

镜像概述和主要用途

vcsim是由vmware/govmomi驱动的vSphere API模拟框架，提供轻量级的vSphere环境模拟功能。该镜像旨在为vSphere相关应用的开发、测试和调试提供便捷的模拟环境，无需依赖真实的vSphere基础设施，降低开发和测试成本。

核心功能和特性

• vSphere API模拟：完整模拟vSphere API接口，支持vSphere相关操作的模拟执行
• 基于govmomi：依托vmware/govmomi项目，确保与官方vSphere API的兼容性
• 灵活配置：支持自定义监听地址、端口等参数，适应不同开发测试场景
• 轻量级部署：容器化封装，可快速启动和集成到CI/CD流程

使用场景和适用范围

• vSphere客户端应用的开发与功能验证
• vSphere API交互逻辑的调试与问题定位
• 自动化测试环境构建，尤其适用于CI/CD流程中vSphere相关功能的测试
• 学习和熟悉vSphere API的模拟实践环境

详细使用方法和配置说明

构建信息

镜像基于以下Dockerfile构建：https://github.com/vmware/govmomi/blob/master/Dockerfile.vcsim

基本操作示例

查看版本信息

通过以下命令可获取vcsim的版本详情：

bash
docker run -p 8989:8989 docker.xuanyuan.run/vmware/vcsim:latest version

预期输出示例：

Build Version: 0.28.0
Build Commit: ac1eba30
Build Date: 2022-04-27T19:49:50Z

默认方式运行

若未指定执行命令，镜像将默认启动vcsim模拟器，监听127.0.0.1:8989地址和端口：

bash
docker run -p 8989:8989 docker.xuanyuan.run/vmware/vcsim:latest

自定义监听端口

可通过覆盖容器默认命令（CMD）修改监听端口，例如修改为9090端口：

bash
docker run -p 9090:9090 docker.xuanyuan.run/vmware/vcsim -l :9090

启动后，可通过设置环境变量连接到模拟服务器（容器IP需根据实际情况调整）：

bash
export GOVC_URL=https://user:pass@172.17.0.2:9090/sdk GOVC_SIM_PID=1

配置说明

• 默认行为：未指定命令时，自动运行vcsim并监听127.0.0.1:8989
• 命令覆盖：可通过在docker run命令后添加子命令或选项，自定义vcsim运行参数（如端口、地址等）
• 端口映射：需确保容器端口与宿主机端口映射一致（如-p 9090:9090对应自定义的9090端口）