{"id":14965218,"url":"https://github.com/saltstack/salt-ext-modules-vmware","last_synced_at":"2025-04-05T13:05:30.678Z","repository":{"id":37912671,"uuid":"358398748","full_name":"saltstack/salt-ext-modules-vmware","owner":"saltstack","description":"Salt Extension Modules for VMware","archived":false,"fork":false,"pushed_at":"2024-10-10T17:37:29.000Z","size":2268,"stargazers_count":20,"open_issues_count":90,"forks_count":36,"subscribers_count":19,"default_branch":"main","last_synced_at":"2025-03-29T12:05:18.969Z","etag":null,"topics":["vmware"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/saltstack.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-15T21:36:14.000Z","updated_at":"2025-03-17T20:24:33.000Z","dependencies_parsed_at":"2023-12-22T21:26:28.714Z","dependency_job_id":"2d912751-8ed3-41b9-852a-962d36b64b52","html_url":"https://github.com/saltstack/salt-ext-modules-vmware","commit_stats":{"total_commits":282,"total_committers":24,"mean_commits":11.75,"dds":0.7836879432624113,"last_synced_commit":"cbf3db89343d0bdfccc78e5e05e9367161e323c3"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack%2Fsalt-ext-modules-vmware","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack%2Fsalt-ext-modules-vmware/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack%2Fsalt-ext-modules-vmware/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack%2Fsalt-ext-modules-vmware/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saltstack","download_url":"https://codeload.github.com/saltstack/salt-ext-modules-vmware/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247339155,"owners_count":20923014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["vmware"],"created_at":"2024-09-24T13:34:23.327Z","updated_at":"2025-04-05T13:05:30.657Z","avatar_url":"https://github.com/saltstack.png","language":"Python","readme":"# Salt Extension Modules for VMware\n\nThis is a collection of Salt-maintained extension modules for use with VMware\nvSphere, vCenter, ESXi, and friends.\n\n## Security\n\nIf you think you've found a security vulnerability, see [Salt's security guide][security].\n\n## User Documentation\n\nThis README is more for contributing to the project. If you just want to get\nstarted, check out the [User Documentation][docs]. Note: See the [Managing VMC SDDC with Salt][vmc-docs] section\nfor more information about how to configure `properties required for VMC operations`\n\n\n## Contributing\n\nThe salt-ext-modules-vmware project team welcomes contributions from the community. If you wish to contribute code and you have not signed our contributor license agreement (CLA), our bot will update the issue when you open a Pull Request. For any questions about the CLA process, please refer to our [FAQ](https://cla.vmware.com/faq).\n\nThe [Salt Contributing guide][salt-contributing] has a lot of relevant information, but if you'd like to jump right in here's how to get started:\n\n    # Clone the repo\n    git clone --origin salt git@github.com:saltstack/salt-ext-modules-vmware.git\n\n    # Change to the repo dir\n    cd salt-ext-modules-vmware\n\n    # Create a new venv, after sourcing activate `python` will refer to python3.\n    python3 -m venv env --prompt vmw-ext\n    source env/bin/activate\n\n    # On mac, you may need to upgrade pip\n    python -m pip install --upgrade pip\n\n    # On WSL or some flavors of linux you may need to install the `enchant`\n    # library in order to build the docs\n    sudo apt-get install -y enchant\n\n    # Install extension + test/dev/doc dependencies into your environment\n    python -m pip install -e .\\[tests,dev,docs\\]\n\n    # Run tests!\n    python -m nox -e tests-3\n\n    # skip requirements install for next time\n    export SKIP_REQUIREMENTS_INSTALL=1\n\n    # Build the docs, serve, and view in your web browser:\n    python -m nox -e docs \u0026\u0026 (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)\n\n    # If you want to run tests against an actual vCenter:\n\n    # 1. Make a local salt dir\n    mkdir -p local/etc/salt\n\n    # 2. Make a local dir for salt state files\n    mkdir -p local/srv/salt\n\n    # 3. Make a local dir for salt pillar files\n    mkdir -p local/srv/pillar\n\n    # 4. Create a minion config\n    cat \u003c\u003c EOF\u003e local/etc/salt/minion\n    user: $(whoami)\n    root_dir: $PWD/local/\n    file_root: $PWD/local\n    master: localhost\n    id: saltdev\n    master_port: 55506\n    pillar_roots:\n      base:\n        - $PWD/local/srv/pillar\n    EOF\n\n    # 5. Make a Saltfile\n    cat \u003c\u003c EOF\u003e Saltfile\n    salt-call:\n      local: true\n      config_dir: local/etc/salt\n    EOF\n\n    # 6. Create a pillar file for you configuration\n    cat \u003c\u003c EOF\u003e local/srv/my_vsphere_conf.sls\n    # vCenter\n    saltext.vmware:\n      # Or use IP address, e.g. 203.0.113.42\n      host: vsphere.example.com\n      password: CorrectHorseBatteryStaple\n      user: BobbyTables\n    EOF\n\n    # 7. Create a pillar top file\n    cat \u003c\u003c EOF\u003e  local/srv/pillar.sls\n    base:\n      saltdev:\n        - my_vsphere_conf\n    EOF\n\n    # 8. (deprecated but not removed yet) If you're contributing to the project and need to run the tests, create a test config file:\n    python tools/test_value_scraper.py -c local/vcenter.conf\n\n    # 9. (deprecated but not removed yet) Create a test config file for VMC:\n    python tools/test_value_scraper_vmc.py --help\n    This command will return the required information.\n\n\nFor code contributions, as part of VMware we require [a signed CLA][cla-faq].\nIf you've already signed the VMware CLA, you're probably good to go.\n\nOf course, writing code isn't the only way to contribute! We value\ncontributions in any of these areas:\n\n- Documentation - especially examples of how to use this module to solve\n  specific problems.\n- Triaging [issues][issues] and participating in [discussions][discussions]\n- Reviewing [Pull Requests][PRs] (we really like [Conventional\n  Comments][comments]!)\n\nYou could also contribute in other ways:\n\n- Writing blog posts\n- Posting on social media about how you used Salt+VMware to solve your\n  problems, including videos\n- Giving talks at conferences\n- Publishing videos\n- Asking/answering questions in IRC, Slack, or email groups\n\nAny of these things are super valuable to our community, and we sincerely\nappreciate every contribution!\n\n\nFor more information, build the docs and head over to http://localhost:8000/ —\nthat's where you'll find the rest of the documentation.\n\n\n[security]: https://github.com/saltstack/salt/blob/master/SECURITY.md\n[salt-contributing]: https://docs.saltproject.io/en/master/topics/development/contributing.html\n[issues]: https://github.com/saltstack/salt-ext-modules-vmware/issues\n[PRs]: https://github.com/saltstack/salt-ext-modules-vmware/pulls\n[discussions]: https://github.com/saltstack/salt-ext-modules-vmware/discussions\n[comments]: https://conventionalcomments.org/\n[cla-faq]: https://cla.vmware.com/faq\n[docs]: https://docs.saltproject.io/salt/extensions/salt-ext-modules-vmware/en/latest/index.html\n[vmc-docs]: https://docs.saltproject.io/salt/extensions/salt-ext-modules-vmware/en/latest/vmc.html\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaltstack%2Fsalt-ext-modules-vmware","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaltstack%2Fsalt-ext-modules-vmware","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaltstack%2Fsalt-ext-modules-vmware/lists"}