0.0
No commit activity in last 3 years
No release in over 3 years
Rimuhosting provider for Vagrant.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.5
>= 0
~> 3.1.0
~> 1.0.1

Runtime

~> 0.7.3
>= 0.1.0
 Project Readme

Rimuhosting Vagrant Provider

vagrant-rimuhosting is a provider plugin for Vagrant that supports the management of Rimuhosting VPS's.

Build Status Code Climate Test Coverage Gem Version MPLv2 License

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

Install the provider plugin using the Vagrant command-line interface:

vagrant plugin install vagrant-rimu

Configure

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

Configuration Requirements

  • You must specify the override.ssh.private_key_path option 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_name option, and it should be a fully qualified domain name (FQDN).

Run

After creating your project's Vagrantfile with the required configuration attributes described above, you may create a new VPS with the following command:

$ 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.

Supported Commands

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 config.vm.synced_folder folders.
  • 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. The 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.

Contributing

  1. Fork it (https://github.com/akissa/vagrant-rimu/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

License

All code is licensed under the MPLv2 License.