Ansible：エージェントなしで SSH 越しの作業を記述する

Ansible が SSH 越しに扱う対象

README は Ansible を「 radically simple IT automation system」と説明することから始まる。ユースケースのリストには、構成管理、アプリケーション展開、クラウドプロビジョニング、アドホックタスク実行、ネットワーク自動化、マルチノードオーケストレーションが含まれる。また、Ansible が容易にする複雑な変更の例として、ロードバランサーを使ったダウンタイムなしのローリングアップデートを挙げている。設計原則は9つの箇条書きで示されている。それらは、極めてシンプルなセットアッププロセスと最小限の学習曲線、マシンを迅速かつ並列に管理する能力、既存の SSH デーモンを活用してカスタムエージェントや追加のオープンポートを避けるエージェントレスアーキテクチャを求めている。原則はまた、インフラストラクチャは機械と人間の両方に優しい言語で記述されるべきであり、セキュリティとコンテンツの監査容易性が優先事項であり、新しいリモートマシンをソフトウェアのブートストラップなしで管理できると述べている。モジュール開発は Python だけでなくあらゆる動的言語で可能であるべきであり、システムは非 root ユーザーとして使用可能であるべきである。最後の原則は、これまでで最も使いやすい IT 自動化システムになることである。これらはプロジェクト自身の主張であり、README はそれらを裏付ける外部の証拠やベンチマーク結果を提供していない。「radically」という言葉は定義なしに使われ、「easy」の範囲も定量化されていない。原則は願望であり、仕様ではない。README はこれらの原則がどのように測定または施行されるかを説明しておらず、実際にどのように適用されるかの例も示していない。

inventory と playbook の分業

README には完全なインストールマニュアルは含まれていない。リリース版の Ansible は pip またはパッケージマネージャーでインストールでき、さまざまなプラットフォームへのインストール方法の詳細はインストールガイドへのリンクがあると述べている。正確なコマンドやパッケージ名は README には記載されておらず、そのガイドで確認する必要がある。最新機能を求めるユーザー向けに、README は devel ブランチを直接実行できると述べている。それはかなり安定していると説明されているが、リリース版よりも破壊的な変更が発生する可能性が高い。README は devel ブランチを実行するつもりなら Ansible コミュニティに参加することを推奨している。リポジトリのメタデータはデフォルトブランチが devel であることを確認しており、これは README の「活発に開発中のブランチ」という説明と一致する。他のインストール方法は言及されておらず、オペレーティングシステムの詳細、依存関係の要件、インストール手順の検証についても README には記載がない。

module と idempotence を試す

コミュニケーションは Ansible フォーラムを中心に行われる。README は3つのフォーラムカテゴリを挙げている：ヘルプを求めたり知識を共有したりする「Get Help」、愛好家同士が交流する「Social Spaces」、ソーシャルイベントを含むプロジェクト全体の発表を追跡する「News & Announcements」である。また、ヘルプカテゴリの投稿をフィルタリングするために ansible、ansible-core、playbook などのタグを使用することを推奨している。Ansible コミュニティとのコミュニケーションに関する別のページが、さらなる連絡方法としてリンクされている。Bullhorn ニュースレターはリリース発表や重要な変更の情報源として言及されている。README は IRC、メーリングリスト、Slack などの他のコミュニケーションプラットフォームには言及しておらず、したがってこの情報源では確認できない。フォーラムはユーザーがヘルプと交流のために案内される唯一の場所であり、README は応答時間、モデレーションポリシー、サポートレベルについても説明していない。

check mode と変更差分

貢献セクションは、コントリビューターガイドと、バグ報告やコードの提出を含む貢献方法を説明するコミュニティ情報ページへのリンクから始まる。README はコード更新を devel ブランチへのプルリクエストを通じて提出することを明示しており、重複作業を避けるために大きな変更を行う前にプロジェクトと話し合うことを勧めている。コーディングガイドラインは開発者ガイドに文書化されており、特に2つのページが強調されている：モジュールを貢献するためのものと、規約、ヒント、落とし穴に関するものである。リポジトリには ansible-core の開発コンテキストを含む context ディレクトリもある。README はそれらのガイドラインの内容を要約しておらず、ただ指し示すだけである。また、プルリクエストのレビュープロセス、コードスタイルルール、期待されるテスト手順についても説明していない。コントリビューターガイドはリンクされているがその内容は再現されておらず、貢献者になるための実際の手順は README では完全には特定されていない。

権限、秘密情報、接続条件

README はブランチ構成を説明している：devel は活発に開発中のリリースに対応し、stable-2.X ブランチは安定リリースに対応する。プルリクエストを開くには、devel をベースにブランチを作成し、開発環境を設定する必要があると README は述べており、共通環境設定のページへのリンクを提供している。アクティブなブランチに関する情報については、リリースとメンテナンスのページが参照されている。ロードマップについて、README はメジャーまたはマイナーバージョン（例：2.7、2.8）に対して初期ロードマップが公開されると述べている。Ansible ロードマップページは、計画されている内容とロードマップに影響を与える方法を説明するためにリンクされている。README には具体的な機能や日付は記載されておらず、ロードマップの詳細はその外部ページにある。README はまた、ロードマップに何を含めるかを決定するプロセスや、コミュニティのフィードバックがどのように組み込まれるかを説明していない。

devel と stable-2.X の使い分け

README は Michael DeHaan を Ansible の作成者として挙げ、プロジェクトには5000人以上のユーザーからの貢献があると述べている（表現は「貢献者」ではなく「ユーザー」である）。また、「このプロジェクトは主に人間によってコードが書かれている」という文も含まれており、これはコードベースの性質についての意図的な声明のように見える。Ansible は Red Hat, Inc. によってスポンサーされており、プロジェクトのホームページは ansible.com である。リポジトリのメタデータは、主要言語が Python であり、現在のスター数（70,218）、フォーク数（24,316）、オープンイシュー数（816）を示しているが、これらの数字は README の一部ではなく、時間とともに変化する。貢献者の分布、ガバナンスモデル、スポンサーシップ声明以外の Red Hat の役割については情報がない。README は他の資金源や組織構造についても言及していない。

GPL-3.0 と採用判断

README は Ansible が GNU 一般公衆ライセンス v3.0 以降の下でライセンスされていると述べ、全文については COPYING ファイルを指している。リポジトリのメタデータは SPDX ライセンス識別子を GPL-3.0 と記録している。しかし、この記事のために提供されたライセンス抜粋はライセンス文そのものではなく、一般的なパスにライセンスファイルが見つからなかったという声明のみを含む。つまり、実際のライセンス条項は抜粋から検証できず、README の COPYING への言及がライセンス主張の唯一の根拠である。ライセンス文（内容が何であれ）は、セキュリティ保証、サポート、保証について一切の声明をしておらず、README もこれらのトピックに言及していない。COPYING ファイルはリンクされているが README には含まれておらず、完全なライセンス条項はリポジトリの主要なドキュメントファイルに直接存在しない。

Ansible は一台の検証ホストを inventory に登録し、README の導入手順に合わせて `ansible -m ping` を実行します。続いてファイル配置やパッケージ状態を変える短い playbook を `--check --diff` と通常実行で比較し、二回目に変更が残らないこと、失敗時のタスク名、sudo の権限、SSH のログを保存します。devel と stable-2.X の説明を混ぜず、使った版、module、対象 OS、秘密値の渡し方を別々に記録します。

編集部の結論

SSH で到達できる複数ホストへ、playbook と inventory を使ってソフトウェア導入や設定変更を適用したい運用者に向きます。対象ホストへ常駐エージェントを置けない環境の自動化にも候補になりますが、ネットワーク機器、権限昇格、秘密情報、変更承認の設計は別に必要です。先に一台の検証ホストへ `ansible -m ping` と idempotent な playbook を実行し、check mode、diff、SSH ユーザー、sudo、失敗時の変更範囲を確認してください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes