More than 5 years have passed since last update.

Ansibleのyum module:各state(present,installed,latest,absent,removed)の違い

Posted at 2015-12-31

Ansibleでyum moduleを使っていたときに少しハマったのでメモします。

yum moduleとは

その名の通り、RedHat系で利用されるパッケージ管理システムを利用してプロビジョニングを行うためのモジュールです。
このmoduleを利用して、パッケージをインストールしたり削除したりします。

公式ドキュメントの state 欄にも

Whether to install (present or installed, latest), or remove (absent or removed) a package.

としか書かれておらず、結局それぞれの違いはなんだろうと思ったのがきっかけです。

このうち、 latest が曲者でした。ansible実行の1回目と2回目以降で、結果が変わるケースがあります。

nameで[pkgname]-[version]を指定したとしても、stateがlatestであれば、指定したバージョンより新しいものが(あれば)インストールされる
しかも、新しいバージョンがインストールされるのはansible実行の2回目以降。1回目は指定したバージョンがインストールされる

例えば、以下のような書き方をしたとします。

tasks/main.yml

  name: install one specific version of Apache
  yum: name=httpd-2.2.29-1.4.amzn1 state=latest

yumリポジトリ上に、 httpdの2.2.29と、2.2.31のパッケージが混在していたとします。

すると、以下のような動きになります。

冪等性が崩れます。何回やっても同じ結果になるかと思いきや、初回と2回目以降で結果が変わるためです。
試したのはansible 1.9ですが、ソースコードを見る限りでは2.0系でも同じようです。

パッケージのバージョンを固定したければ、そもそもlatestを使わずに、presentかinstalledを使う ということでした。

裏でどんなyumコマンドが実行されているかを想像した上で、latest っていう意味から分かるでしょと言われるとそうなのですが、何気なく書く場合は注意しましょうという話でした。