{"id":28477895,"url":"https://github.com/fog/fog-vsphere","last_synced_at":"2025-07-02T17:30:40.619Z","repository":{"id":2080330,"uuid":"45206013","full_name":"fog/fog-vsphere","owner":"fog","description":"Fog for vSphere","archived":false,"fork":false,"pushed_at":"2025-06-24T13:01:11.000Z","size":753,"stargazers_count":36,"open_issues_count":35,"forks_count":62,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-06-28T17:04:41.969Z","etag":null,"topics":["fog","ruby","vsphere"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fog.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"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,"zenodo":null},"funding":{"github":"geemus"}},"created_at":"2015-10-29T19:35:37.000Z","updated_at":"2025-06-24T13:01:16.000Z","dependencies_parsed_at":"2024-06-18T15:37:52.706Z","dependency_job_id":"ab2ee65a-13dd-4b2b-a037-a710654fefdd","html_url":"https://github.com/fog/fog-vsphere","commit_stats":{"total_commits":289,"total_committers":56,"mean_commits":5.160714285714286,"dds":0.8512110726643598,"last_synced_commit":"ca07a0d41f1d1d07e4d791887c0875523fb91da8"},"previous_names":[],"tags_count":71,"template":false,"template_full_name":null,"purl":"pkg:github/fog/fog-vsphere","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fog%2Ffog-vsphere","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fog%2Ffog-vsphere/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fog%2Ffog-vsphere/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fog%2Ffog-vsphere/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fog","download_url":"https://codeload.github.com/fog/fog-vsphere/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fog%2Ffog-vsphere/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262465791,"owners_count":23315641,"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":["fog","ruby","vsphere"],"created_at":"2025-06-07T17:08:52.042Z","updated_at":"2025-07-02T17:30:40.612Z","avatar_url":"https://github.com/fog.png","language":"Ruby","funding_links":["https://github.com/sponsors/geemus"],"categories":[],"sub_categories":[],"readme":"# Fog vSphere\n\n\u003e VMware vSphere® provider for the Fog cloud services library\n\n[![Gem Version][gemfury-image]][gemfury-url] [![Build Status][gha-image]][gha-url] [![Test Coverage][coverage-image]][coverage-url] [![Code Climate][climate-image]][climate-url]\n\nThe VMware vSphere® provider allows you to use the abstractions of the Fog cloud services library to communicate with vSphere.\n\n## Installation\n\nTo use this gem in your application, add this line to your Gemfile:\n\n```ruby\ngem 'fog-vsphere'\n```\n\nAnd then execute:\n\n```bash\nbundle\n```\n\nOr install it yourself as:\n\n```bash\ngem install fog-vsphere\n```\n\n## Upgrading\n\nIn version 3.0.0 we have changed the namespacing of `Compute` service.\n`Fog::Compute::Vsphere` became `Fog::Vsphere::Compute` as recommended by fog-core.\nWe hope we are not causing any issues as `Fog::Compute[:vsphere]` is only public API.\n\n## Usage\n\nTo connect to your vSphere instance with Fog vSphere:\n\n```ruby\nrequire 'fog/vsphere'\n\ncompute = Fog::Compute.new(\n  provider: :vsphere,\n  vsphere_username: 'username',\n  vsphere_password: 'password',\n  vsphere_server: 'server.example.com',\n  vsphere_expected_pubkey_hash: '0123456789abcdef0123456789abcdef',\n  vsphere_ssl: true,\n  vsphere_rev: '6.0'\n)\n```\n\nFrom there you can create, destroy, list, and modify most things related to vSphere. Some examples include:\n\n```ruby\n# continued from previous example\n\n# List datacenters\ncompute.list_datacenters\n#=\u003e [{id: 'datacenter-1', name: 'DC1', path: ['DC1'], status: 'gray'},\n#=\u003e  {id: 'datacenter-2', name: 'DC2', path: ['DC2'], status: 'gray'}]\n\n# Get datacenter by name\ncompute.get_datacenter('DC1')\n#=\u003e {name: 'DC1', status: 'gray', path: ['DC1']}\n\n# List virtual machines\ncompute.list_virtual_machines\n#=\u003e [{'id'   =\u003e 'ab589f9a-af35-428e-9690-9b96587d86f3',\n#=\u003e   'name' =\u003e 'TestVM',\n#=\u003e   'uuid' =\u003e 'fc51eb7a-fa50-4d96-bd16-63972b49f52f',\n#=\u003e ...\n\n# List a VM's SCSI controllers\ncompute.list_vm_scsi_controllers('ab589f9a-af35-428e-9690-9b96587d86f3')\n#=\u003e [\u003cFog::Vsphere::Compute::SCSIController\n#=\u003e   shared_bus='noSharing',\n#=\u003e   type='VirtualLsiLogicController',\n#=\u003e   unit_number=7,\n#=\u003e   key=1000,\n#=\u003e   server_id=nil\n#=\u003e  \u003e]\n```\n\nThere is a lot more you can do as well! We are working on providing better documentation right now. For now, you can look at the [RubyDocs](http://www.rubydoc.info/gems/fog-vsphere/), browse what's available with [Pry](http://pryrepl.org/), and view the documentation for [Fog](http://fog.io). We hope to have much more documentation and plenty of examples soon.\n\n## Contributing\n\nTo contribute to this project, add an issue or pull request. For more info on what that means or how to do it, see [this guide](https://guides.github.com/activities/contributing-to-open-source/#contributing) from GitHub.\nFor more details see [CONTRIBUTING.md file](CONTRIBUTING.md)\n\n[climate-image]: https://codeclimate.com/github/fog/fog-vsphere.svg\n[climate-url]: https://codeclimate.com/github/fog/fog-vsphere\n[coverage-image]: https://codeclimate.com/github/fog/fog-vsphere/badges/coverage.svg\n[coverage-url]: https://codeclimate.com/github/fog/fog-vsphere/coverage\n[gemfury-image]: https://badge.fury.io/rb/fog-vsphere.svg\n[gemfury-url]: http://badge.fury.io/rb/fog-vsphere\n[gha-image]: TODO\n[gha-url]: TODO\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffog%2Ffog-vsphere","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffog%2Ffog-vsphere","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffog%2Ffog-vsphere/lists"}