パイプラインでの冪等性と Lint

優れたロールには、さらに2つの条件があります。冪等であり、lintを通過することです。Moleculeがこの2つを実行してくれます。

Moleculeはロールを2回目に実行し、その出力を確認します。この専用ステップを冪等性と呼びます。

2回目の実行では変更がないことが求められます。いずれかのタスクがchangedを報告すると、冪等性のステップでテストが失敗します。

生のcommandモジュールを使ったタスクは毎回実行されるため、冪等性を壊しがちです。代わりに適切なモジュールを使用してください。

lintステップは、ホストが作成される前にYAMLとタスクの静的チェックを実行します。

lintはansible-lintを実行し、名前の不足、非推奨の構文、安全でないシェルの使用など、危険なパターンを指摘します。

さらにyamllintも実行し、インデントの誤り、末尾の空白、長すぎる行など、書式の問題を検出します。

lintはmolecule testの早い段階で実行されるため、スタイルエラーがあると、ホストの作成に時間を使う前に実行が停止します。

パイプラインでは、1回のmolecule test呼び出しでlint、converge、verify、冪等性を1つの品質ゲートとして実行できます。

そのコマンドをCIに組み込み、テストが失敗したらマージをブロックするようにします。問題のあるロールがmainブランチに到達することはありません。

実行が成功すれば、ロールがlintを通過し、正しく適用され、検証され、冪等であることが証明されます。これが本番運用可能であることを示すサインです。

Moleculeがロールの冪等性をどのように証明するか思い出してください。

Moleculeは2つのゲートを追加します。lintがスタイルと危険なパターンを早期に検出し、冪等性によって2回目の実行で何も変更されないことを証明します。CIに組み込みましょう。🚦