From 9864b2a98faab686a012fc500406a83d9c218983 Mon Sep 17 00:00:00 2001 From: Faustin Lammler Date: Wed, 26 Apr 2023 16:25:24 +0200 Subject: [PATCH] Improve documentation for upgrade scenario If one upgrade from previous molecule versions, and since drivers are now provided by the molecule-plugins, molecule-podman|docker|vagrant packages needs to be removed. See: - https://github.com/ansible-community/molecule/issues/3883 - https://github.com/ansible-community/molecule/issues/3895 --- docs/installation.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/installation.md b/docs/installation.md index 739917870..9c12fae2b 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -95,6 +95,13 @@ installation command would look like this: $ python3 -m pip install --user "molecule-plugins[podman]" ``` +!!! warning + + If you upgrade molecule from previous versions, make sure to remove + previously installed drivers like for instance `molecule-podman` or + `molecule-vagrant` since those are now available in the `molecule-plugins` + package. + Installing molecule package also installed its main script `molecule`, usually in `PATH`. Users should know that molecule can also be called as a python module, using `python -m molecule ...`. This alternative method