■ はじめに

Ansible の調べ物をしていて、モジュールの説明ページなどを見るときは、そのドキュメントの対応バージョンを気にするようにしています。使っている Ansible バージョンでそのモジュールが使えるかどうか、など。この記事では、対応バージョンの確認方法と、バージョンの切り替え方法を説明します。

[2019/07/08 追記] 以下のようにドロップダウンリストでバージョンが選択できるようになりました。

f:id:akira6592:20190708170455p:plain:w300

■ 対応バージョンの確認方法

f:id:akira6592:20180809102127p:plain

ドキュメントの左上に 2.6 などと、対応バージョンが書いてあります。

devel と書いある場合は、今でいうと開発中の 2.7 のことです。（10月リリース予定）

もし、諸事情で開発中のバージョンを使いたいときは、

pip install git+https://github.com/ansible/ansible.git@devel

でインストールできます。

ドキュメントトップのメニューの Previous Version からバージョンを切り替えることができます。

例えば、

というURLの場合、 latest のところを書き換えると、バージョンを切り替える事ができます。

モジュール説明ページのURLを書き換えた結果、 Not Found になるのであれば、そのバージョンにはそのモジュールが無いということになります。（ページ内に書いてある New in version 2.7. といった記載で判断するのが手っ取り早いです）

例えば、

の devel (2.7) を latest (2.6) に書き換えて、

を表示したときに、Not Found になるのは、 2.6 にそのモジュールがないためです。

Ansible 2.4 から 2.5 になったタイミングで、ドキュメントの階層が変わりました。そのため、これらのバージョンをまたいで切り替えるときは注意が必要です。