出力のchangedとokを読む

各タスクの後、Ansibleはホストごとにステータスを表示します。最もよく目にするのはokとchangedの2つで、それぞれ異なる状況を示します。

okというステータスは、ホストがすでに望ましい状態と一致していたことを示します。タスクは確認を行いましたが、変更は一切加えていません。

changedというステータスは、ホストが望ましい状態と一致していなかったため、モジュールが宣言した状態へ収束するよう変更を加えたことを示します。

デフォルトでは、Ansibleはchangedの出力を黄色、okの出力を緑色で表示します。2回目の実行で緑色一色になるのが、まさに望ましい状態です。

最後に、PLAY RECAPがホストごとのok、changed、unreachable、failedの件数を集計します。これは1行で確認できる健全性チェックです。

冪等性のあるplaybookを2回実行すると、2回目のrecapにはchanged=0と表示されるはずです。再実行で変更が発生した場合は、調査する価値があります。

changedというステータスは成功を示しており、問題ではありません。ホストに処理が必要で、タスクが正しく実行したことを記録しているだけです。

skippingと表示されることもあります。これはwhen条件がfalseだったため、そのホストではタスクが実行されなかったことを示します。

failedはタスクでエラーが発生したことを示します。unreachableは、AnsibleがSSHで接続することすらできなかったことを示します。どちらの場合も、そのホストでのplayは停止します。

changedの件数は、冪等性を測る指標です。繰り返し実行しても変更が報告され続けるなら、そのタスクは真に冪等ではありません。

ansible-playbookに-v（または-vv）を追加すると、各タスクが何を変更したのか、なぜ変更したのかを示す詳細な出力が得られます。

okは「すでに正しい」、changedは「今回修正した」と読み取ります。PLAY RECAPと、changed=0となる再実行によって、playが冪等であることを確認できます。✅