molecule-vagrant's Introduction

Molecule Vagrant Plugin

Molecule Vagrant is designed to allow use of Vagrant for provisioning of test resources.

Documentation

To use this plugin, you'll need to set the driver and platform variables in your molecule.yml. Here's a simple example using the fedora/32-cloud-base box:

driver:
  name: vagrant

platforms:
  - name: instance
    box: fedora/32-cloud-base
    memory: 512
    cpus: 1

Here's a full example with the libvirt provider:

driver:
  name: vagrant
  provider:
    # Can be any supported provider (VBox, Parallels, libvirt, etc)
    name: libvirt

platforms:
  - name: instance
    # List of dictionaries mapped to `config.vm.network`
    interfaces:
      # `network_name` is the required identifier, all other keys map to
      # arguments.
      - network_name: forwarded_port
        guest: 80
        host: 8080
    # List of raw Vagrant `config` options
    instance_raw_config_args:
      - 'vagrant.plugins = ["vagrant-libvirt"]'
    # Dictionary of `config` options. Note that string values need to be
    # explicitly enclosed in quotes.
    config_options:
      ssh.keep_alive: yes
      ssh.remote_user: "'vagrant'"
    box: fedora/32-cloud-base
    box_version: 32.20200422.0
    box_url:
    memory: 512
    cpus: 1
    # Dictionary of options passed to the provider
    provider_options:
      video_type: "'vga'"
    # List of raw provider options
    provider_raw_config_args:
      - "cpuset = '1-4,^3,6'"
    provision: no

Get Involved

Join us in the #ansible-molecule channel on Freenode.
Join the discussion in molecule-users Forum.
Join the community working group by checking the wiki.
Want to know about releases, subscribe to ansible-announce list.
For the full list of Ansible email Lists, IRC channels see the communication page.