VMware的Salt扩展模块

这是一个集合，包含Salt维护的扩展模块，用于与VMware vSphere、vCenter、ESXi及其它相关产品一起使用。

安全

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

用户文档

这个README主要是关于贡献项目的。如果您只是想开始，请查看用户文档。注意：有关如何配置VMC操作所需属性的更多信息，请参阅使用Salt管理VMC SDDC部分。

贡献

盐-扩展-模块-vmware项目团队欢迎社区贡献。如果您想贡献代码，但尚未签署我们的贡献者许可协议（CLA），当您发起拉取请求时，我们的机器人会更新问题。有关CLA流程的任何问题，请参阅我们的常见问题解答。

Salt贡献指南包含大量相关信息，但如果您想立即开始，以下是操作步骤

# 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, after sourcing activate `python` will refer to python3.
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. Make a local dir for salt state files
mkdir -p local/srv/salt

# 3. Make a local dir for salt pillar files
mkdir -p local/srv/pillar

# 4. 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
pillar_roots:
  base:
    - $PWD/local/srv/pillar
EOF

# 5. Make a Saltfile
cat << EOF> Saltfile
salt-call:
  local: true
  config_dir: local/etc/salt
EOF

# 6. Create a pillar file for you configuration
cat << EOF> local/srv/my_vsphere_conf.sls
# vCenter
saltext.vmware:
  # Or use IP address, e.g. 203.0.113.42
  host: vsphere.example.com
  password: CorrectHorseBatteryStaple
  user: BobbyTables
EOF

# 7. Create a pillar top file
cat << EOF>  local/srv/pillar.sls
base:
  saltdev:
    - my_vsphere_conf
EOF

# 8. (deprecated but not removed yet) If you're contributing to the project and need to run the tests, create a test config file:
python tools/test_value_scraper.py -c local/vcenter.conf

# 9. (deprecated but not removed yet) 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或电子邮件组中提问/回答问题

以上任何一件事对我们社区来说都非常宝贵，我们真诚地感谢每一份贡献！

有关更多信息，请构建文档并访问https://127.0.0.1:8000/ —— 您将在那里找到其余的文档。