适用于 VMware 的 Salt Extension 模块

这是一组 Salt 维护的扩展模块，可与 VMware vSphere、vCenter、ESXi 和朋友一起使用。

安全

如果您认为自己发现了安全漏洞，请参阅Salt 的安全指南。

用户文档

这个 README 更适合为项目做贡献。如果您只是想开始，请查看用户文档。注意：有关如何配置的更多信息，请参阅使用 Salt 管理 VMC SDDC部分properties required for VMC operations

贡献

salt-ext-modules-vmware 项目团队欢迎来自社区的贡献。如果您希望贡献代码并且尚未签署我们的贡献者许可协议 (CLA)，我们的机器人将在您打开拉取请求时更新问题。有关 CLA 流程的任何问题，请参阅我们的常见问题解答。

Salt Contributing 指南有很多相关信息，但如果您想直接进入，请按以下步骤开始：

# Clone the repo
git clone --origin salt git@github.com:saltstack/salt-ext-modules-vmware.git

# Change to the repo dir
cd salt-ext-modules-vmware

# Create a new venv
python3 -m venv env --prompt vmw-ext
source env/bin/activate

# On mac, you may need to upgrade pip
python -m pip install --upgrade pip

# On WSL or some flavors of linux you may need to install the `enchant`
# library in order to build the docs
sudo apt-get install -y enchant

# Install extension + test/dev/doc dependencies into your environment
python -m pip install -e .\[tests,dev,docs\]

# Run tests!
python -m nox -e tests-3

# skip requirements install for next time
export SKIP_REQUIREMENTS_INSTALL=1

# Build the docs, serve, and view in your web browser:
python -m nox -e docs && (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)

# If you want to run tests against an actual vCenter:

# 1. Make a local salt dir
mkdir -p local/etc/salt

# 2. Create a minion config
cat << EOF> local/etc/salt/minion
user: $(whoami)
root_dir: $PWD/local/
file_root: $PWD/local
master: localhost
id: saltdev
master_port: 55506
EOF

# 3. Create a test config file:
python tools/test_value_scraper.py -c local/vcenter.conf

# 4. Create a test config file for VMC:
python tools/test_value_scraper_vmc.py --help
This command will return the required information.

对于代码贡献，作为 VMware 的一部分，我们需要签名的 CLA。如果您已经签署了 VMware CLA，那么您就可以开始了。

当然，编写代码并不是贡献的唯一方式！我们重视以下任何领域的贡献：

• 文档 - 特别是如何使用此模块解决特定问题的示例。
• 分类问题并参与讨论
• 审查拉取请求（我们真的很喜欢常规评论！）

您还可以通过其他方式做出贡献：

• 写博客文章
• 在社交媒体上发布关于您如何使用 Salt+VMware 解决问题的信息，包括视频
• 在会议上发表演讲
• 发布视频
• 在 IRC、Slack 或电子邮件组中提问/回答问题

这些东西中的任何一个对我们的社区都非常有价值，我们真诚地感谢每一个贡献！

有关更多信息，请构建文档并访问http://localhost:8000/ — 在那里您可以找到其余文档。