Molecule Multipass

0.5.0 verified Mon Apr 27 auth: no python

A Molecule driver for managing test instances with Multipass (Ubuntu VM orchestrator). Current version 0.5.0, low release cadence.

pip install molecule-multipass

Common errors

error molecule create --driver multipass fails with 'DriverNotFound' ↓

cause Molecule driver not registered because molecule-multipass is not installed.

fix

Run: pip install molecule-multipass

error ModuleNotFoundError: No module named 'multipass' ↓

cause Multipass Python bindings not installed; the driver relies on system multipass CLI.

fix

Ensure multipass binary is installed (e.g., snap install multipass) and available in PATH.

error Instance creation fails: 'timeout waiting for instance' ↓

cause Slow network or insufficient resources on host for Multipass VM.

fix

Increase timeout in molecule.yml: driver: name: multipass timeout: 120

Warnings

gotcha Multipass must be installed on the host machine and available in PATH; the driver does not install it. ↓

fix Install Multipass from https://multipass.run/ before using this driver.

breaking Driver name changed from 'multipass' to 'multipass' (same) but some older versions used an alias; ensure molecule.yml uses 'name: multipass'. ↓

fix Use 'name: multipass' in molecule.yml.

deprecated Python 3.6 support deprecated; only Python 3.7+ tested. ↓

fix Upgrade Python to 3.7+ and molecule to 3.0+.

Imports

MoleculeMultipassDriver

wrong

from molecule_multipass import MoleculeMultipassDriver

correct

from molecule_multipass.driver import MoleculeMultipassDriver

Driver class is in the driver submodule

Quickstart

Create a molecule.yml in your molecule/default directory and run: molecule create

# molecule.yml
---
driver:
  name: multipass
provisioner:
  name: ansible
platforms:
  - name: instance
    image: ubuntu:22.04
scenario:
  name: default