Rimuhosting Vagrant Provider
vagrant-rimuhosting is a provider plugin for Vagrant that supports the
management of Rimuhosting VPS's.
Current Features include:
- create and destroy VPS's
- power on and off VPS's
- rebuild a VPS (destroys and ups with same IP address)
- provision a VPS
- move a VPS to a different host server
- setup a SSH public key for authentication
- create a new user account during VPS creation
Install the provider plugin using the Vagrant command-line interface:
vagrant plugin install vagrant-rimu
Once the provider has been installed, you will need to configure your project to use it.
The most basic
Vagrantfile to create a VPS on Rimu is shown below
(with the optional options commented out):
Vagrant.configure('2') do |config| config.vm.provider :rimu do |provider, override| override.ssh.insert_key = true override.ssh.private_key_path = '~/.ssh/id_rsa' provider.api_key = 'YOUR RIMU API KEY' provider.host_name = 'rimu.example.com' # provider.distro_code = 'centos6.64' # provider.data_centre = 'DCDALLAS' # provider.memory_mb = 1024 # provider.disk_space_mb = 40000 # provider.disk_space_2_mb = 40000 # provider.vps_type = 'REGULAR' # provider.root_password = 'zxcvbnm' # provider.control_panel = 'webmin' # provider.vps_to_clone = 999 # provider.extra_ip_reason = 'TLS/SSL for example.com and example.net' # provider.num_ips = 2 # provider.private_ips = true # provider.billing_id = 9999 # provider.host_server_id = 9999 # provider.minimal_init = true end end
- You must specify the
override.ssh.private_key_pathoption to enable authentication.
- You must specify your Rimu API Key. This can be found/generated in the RIMU control panel.
- You must specify the
provider.host_nameoption, and it should be a fully qualified domain name (FQDN).
After creating your project's
Vagrantfile with the required configuration
attributes described above, you may create a new VPS with the following
$ vagrant up --provider=rimu
This command will create a new VPS, setup your SSH key for authentication, create a new user account, and run the provisioners you have configured.
The provider supports the following Vagrant sub-commands:
vagrant destroy- Destroys the Rimu VPS.
vagrant rebuild- Destroys the Rimu VPS and recreates it with the same IP address which was previously assigned.
vagrant halt- Powers off the Rimu VPS.
vagrant reload- Reboots the Rimu VPS.
vagrant provision- Runs the configured provisioners and rsyncs any specified
vagrant status- Outputs the status (active, off, not created) for the Rimu VPS.
vagrant ssh- Logs into the Rimu VPS using the configured user account.
vagrant rimu- Rimu provider specific commands
Rimu Specific Commands
The Rimu specific commands are available as sub commands of
vagrant rimu command provides the following sub commands:
distributions- Lists the distributions supported.
servers- Lists the servers under your account.
billing methods- Lists the billing methods setup for your account.
move-vps- Moves your VPS to a different host.
- Fork it (https://github.com/akissa/vagrant-rimu/fork)
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Add some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request
All code is licensed under the MPLv2 License.