安裝?

本文假設開發人員對python打包有基本的了解,以及如何在系統上安裝和管理python。

要求?

根據所選的驅動程序,您可能需要安裝其他操作系統軟件包??吹搅藛?INSTALL.rst ,它是在初始化新方案時創建的。

  • Python>=3.6,并且 Ansible >= 2.8

CentOS 8?

$ sudo dnf install -y gcc python3-pip python3-devel openssl-devel python3-libselinux

Ubuntu 16.x版?

$ sudo apt update
$ sudo apt install -y python3-pip libssl-dev

Pip?

pip 是唯一受支持的安裝方法。

警告

Ansible沒有被列為molecular包的直接依賴項,因為我們只把它稱為命令行工具。您可能需要使用分發包安裝程序安裝它。如果您還想安裝兼容版本的ansible,請使用提供的 ansibleansible-base 額外費用:

$ python3 -m pip install "molecule[ansible]"  # or molecule[ansible-base]

請記住,在selinux支持系統上,如果安裝到虛擬環境中,可能會遇到 issue 即使selinux未啟用或配置為允許。

您有責任確保Ansible的軟依賴關系在您的控制器或主機上可用。

警告

強烈建議您將Molecule安裝在 virtual environment . 這將提供 setuptools 這是必須的,以便Molecule安裝成功和功能正常。如果無法使用虛擬環境,則可以嘗試使用以下內容升級包:

$ python3 -m pip install --upgrade --user setuptools

警告

pipv19系列具有 isolation bug 對包build env公開的setuptools。這就是為什么強烈建議升級用戶setuptools的原因,即使在使用正確的virtualenv時也是如此,如上圖所示。

要求?

根據所選的驅動程序,您可能需要安裝其他python包。請參閱驅動程序文檔或 INSTALL.rst ,它是在初始化新方案時創建的。

安裝?

安裝 Molecule:

$ python3 -m pip install --user "molecule[lint]"

分子默認使用“委托”驅動程序。其他驅動程序可以與PyPI分開安裝,例如分子對接器驅動程序。如果您希望使用docker作為分子驅動程序,安裝命令將如下所示:

$ python3 -m pip install --user "molecule[docker,lint]"

其他驅動程序,例如 molecule-podman , molecule-vagrant , molecule-azuremolecule-hetzner 也有。

安裝 molecule 包還安裝了它的主腳本 molecule ,通常在 PATH . 用戶應該知道,molecule也可以被稱為python模塊,使用 python -m molecule ... . 這種替代方法有一些好處:

  • 允許顯式控制Molecule使用哪個python解釋器

  • 允許在用戶級安裝Molecule,甚至不需要在 PATH .

注解

我們也有一個連續的預發布過程,這是提供早期采用和反饋的目的??蓮?test.pypi.org/project/molecule 并且可以這樣安裝:

python3 -m pip install \
  --index-url https://test.pypi.org/simple \
  --extra-index-url https://pypi.org/simple \
  molecule==2.21.dev46

哪里 2.21.dev46 是最新的預發布版本。請檢查一下房間 release history 可用版本的列表。

Docker?

分子被構建成碼頭工人的形象 Toolset 項目。

與容器中分子的使用相關的任何問題或錯誤都應該由工具集項目來解決。

源碼?

由于這個工具的開發速度很快,您可能需要從Git安裝并更新Molecule的最新版本。

按照以下說明進行初始安裝和后續更新。

您將安裝的包發行版將自動生成,并包含提交哈希信息,以便在需要發送錯誤報告時更容易引用某些不穩定的版本。

警告

請避免使用 --editable/-e development mode 安裝帶有Pip的Molecule時。這不是很好的支持,只有在進行開發時才需要。出于貢獻的目的,您可以依賴tox命令行界面。請看 our testing guide 更多詳情。

要求?

CentOS 8?

$ sudo dnf install -y libffi-devel git

Ubuntu 16.x版?

$ sudo apt install -y libffi-dev git

安裝?

$ python3 -m pip install -U git+https://github.com/ansible-community/molecule