README

vagrant-cloudinit

A vagrant provisioner plugin for using cloud-init to bootstrap a compatible machine.

It works by creating the appropriate cloud-init ISO image and attaching it to the machine prior to boot.

Dependencies

vagrant-cloudinit depends on the mkisofs utility: - Ubuntu: sudo apt install mkisofs - Mac Homebrew: brew install dvdrtools - Mac Ports: sudo port install cdrtools

Installation

vagrant plugin install vagrant-cloudinit

Usage

  <span class="n">config</span><span class="o">.</span><span class="n">vm</span><span class="o">.</span><span class="n">provision</span> <span class="ss">:cloud_init</span><span class="p">,</span>
       <span class="ss">wait</span><span class="p">:</span> <span class="kp">true</span><span class="p">,</span>
       <span class="ss">user_data</span><span class="p">:</span> <span class="s2">"./user-data.yml"</span><span class="p">,</span>
       <span class="ss">meta_data</span><span class="p">:</span> <span class="s2">"./meta-data.yml"</span>

Options

  • wait (default: false): If true, the provisioner will block until cloud-init has finished bootstrapping.
  • user_data (required): The path to the user-data file
  • meta_data (optional): The path to the meta-data file.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/jameskeane/vagrant-cloudinit.

License

The gem is available as open source under the terms of the MIT License.