https://github.com/ananace/fog-hyperv
Hyper-V provider for fog
https://github.com/ananace/fog-hyperv
fog hyper-v hyperv ruby
Last synced: 6 months ago
JSON representation
Hyper-V provider for fog
- Host: GitHub
- URL: https://github.com/ananace/fog-hyperv
- Owner: ananace
- License: mit
- Created: 2017-08-01T14:24:56.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2020-04-20T07:35:18.000Z (over 5 years ago)
- Last Synced: 2025-04-23T02:53:54.525Z (6 months ago)
- Topics: fog, hyper-v, hyperv, ruby
- Language: Ruby
- Homepage:
- Size: 188 KB
- Stars: 8
- Watchers: 4
- Forks: 1
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Fog Hyper-V
[](https://travis-ci.org/ananace/fog-hyperv) [](https://badge.fury.io/rb/fog-hyperv)
Manage your Hyper-V instance with the help of the Fog cloud service abstractions.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'fog-hyperv'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install fog-hyperv
## Usage
To remotely manage your Hyper-V instance;
```ruby
require 'fog/hyperv'
compute = Fog::Compute.new(
provider: :hyperv,
hyperv_host: 'hyperv.example.com',
hyperv_username: 'domain\\user',
hyperv_password: 'password'
)
compute.servers.all
#=> [ id='',
#=> name='example',
#=> computer_name='HYPERV',
#=> dynamic_memory_enabled=false,
#=> ...
```
## Troubleshooting
If you're getting `WinRM::AuthorizationErrors` from the negotiate transport
even when using a valid user, make sure that the WinRM service is configured
for Negotiate auth.
If you're using a local (non-domain) user, you may also need to set the DWORD
registry value `LocalAccountTokenFilterPolicy` at `HKLM\software\Microsoft\Windows\CurrentVersion\Policies\system`
to `1`.
## Development
After checking out the repo, run `bundle install` to install dependencies. Then, run `rake test` to run the tests. You can also run `bundle exec irb` for an interactive prompt that will allow you to experiment.
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/ananace/fog-hyperv