Connection プラグイン¶

ssh プラグイン
Connection プラグインの追加
Connection プラグインの使用
プラグイン一覧

Connection プラグインは、Ansibleがターゲットホストに接続して、そのホストでタスクを実行できるようにします。Ansible には多くの connection プラグインが含まれていますが、1 台のホストで一度に使用できるプラグインは 1 つのみです。

デフォルトでは、Ansible には複数のプラグインが含まれます。最もよく使用されるのは、paramiko SSH、ネイティブ (ssh と呼ばれる) およびローカル接続タイプです。上記はすべて、Playbook や /usr/bin/ansible で使用して、リモートマシンと対話する方法を決定できます。

このような接続タイプの基本情報は、getting started のセクションで説明しています。

`ssh` プラグイン ¶

ssh は、システム管理でデフォルトで使用されるプロトコルであり、Ansible で最も使用されるプロトコルでもあるため、コマンドラインツールに ssh オプションが含まれています。詳細は ansible-playbook を参照してください。

Connection プラグインの追加 ¶

カスタムのプラグインを connection_plugins ディレクトリーに配置して、 Ansible を拡張して他のトランスポート (SNMP またはメッセージバス) をサポートできます。

Connection プラグインの使用 ¶

接続プラグインは、Play で設定、コマンドライン (-c、--connection) をキーワードとして設定できます。または、インベントリーで最もよく使われる変数をグローバルに設定できます。たとえば、Windows マシンでは winrm プラグインをインベントリー変数として設定できます。

多くの Connection プラグインは最小限の構成で動作します。デフォルトでは、inventory hostname を使用し、ターゲットホストを検索するようにデフォルト設定されています。

プラグインは、自己文書化されており、プラグインごとに、設定オプションについて文書化する必要があります。以下は、多くの connection プラグインに共通する接続変数です。

ansible_host: 接続するホストの名前 (インベントリーのホスト名と異なる場合)。
ansible_port: ssh および paramiko_ssh の ssh ポート番号は、デフォルトでは 22 に設定されます。
ansible_user: ログインに使用するデフォルトのユーザー名。多くのプラグインは、「Ansible を実行する現在のユーザー」にデフォルトで設定されます。

プラグインごとに、一般的なバージョンをオーバーライドする特定の変数バージョンがある場合もあります。たとえば、ssh プラグインの場合は ansible_ssh_host です。

プラグイン一覧 ¶

ansible-doc -t connection -l を使用すると、利用可能なプラグインの一覧を表示できます。詳細にわたるドキュメントや例を参照するには、ansible-doc -t connection <plugin name> を使用します。

Connection プラグイン¶

ssh プラグイン¶

Connection プラグインの追加¶

Connection プラグインの使用¶

プラグイン一覧¶

`ssh` プラグイン ¶

Connection プラグインの追加 ¶

Connection プラグインの使用 ¶

プラグイン一覧 ¶