Ansibleのインストールと初期設定について解説

[test@cnt07 ~]$ ansible –version
ansible 2.3.0.0
  config file = /etc/ansible/ansible.cfg
  configured module search path = Default w/o overrides
  python version = 2.7.5 (default, Nov  6 2016, 00:28:07) [GCC 4.8.5 20150623 (Red Hat 4.8.5-11)]

# yum install epel-release

# yum list available | grep ansible

ansible.noarch 2.3.0.0-3.el7 epel
ansible-doc.noarch 2.3.0.0-3.el7 epel
ansible-inventory-grapher.noarch 2.3.2-1.el7 epel
ansible-lint.noarch 3.4.12-1.el7 epel
ansible-openstack-modules.noarch 0-20140902git79d751a.el7 epel
ansible-review.noarch 0.13.0-2.el7 epel
kubernetes-ansible.noarch 0.6.0-0.1.gitd65ebd5.el7 epel
python2-ansible-tower-cli.noarch 3.1.3-1.el7 epel

# yum install ansible

ANSIBLE(1) System administration commands ANSIBLE(1)

NAME
ansible – run a task on a target host(s)

ターゲットホスト上でタスクを実行すること –

SYNOPSIS
ansible <host-pattern> [-m module_name] [-a args] [options]

DESCRIPTION
Ansible is an extra-simple tool/framework/API for doing ‘remote things’. This is the adhoc command that allows for a ‘single task playbook’ run.

Ansibleは、「遠隔のもの」を行うための特別なツール/フレームワーク/ APIです。 これは「シングルタスクプレイブック」を実行できるアドホックコマンドです。

※Ad hoc とは「特にこのために、その場しのぎに、特別に」というような意味です。

ARGUMENTS
host-pattern
A name of a group in the inventory, a shell-like glob selecting hosts in inventory or any combination of the two separated by commas.

インベントリ内のグループ名、インベントリ内のホストまたはコンマで区切られた2つの組み合わせを選択するシェルのようなグロブ。

※glob「グロブ」とは「クリームなどのかたまり」という意味です。

OPTIONS
-a　’ARGUMENTS’, –args=’ARGUMENTS’
　　The ARGUMENTS to pass to the module.

　　モジュールに渡す引数。

-b, –become
　　Use privilege escalation (specific one depends on become_method), this does not imply prompting for passwords.

　　特権エスカレーション（特定のものはbecome_methodに依存します）を使用してください。これはパスワードの入力を促すものではありません。

-K, –ask-become-pass
　　Ask for privilege escalation password.

　　特権エスカレーションパスワードを要求します。

-k, –ask-pass
　　Prompt for the connection password, if it is needed for the transport used. For example, using ssh and not having a key-based authentication with ssh-agent.

　　使用されているトランスポートに必要な場合は、接続パスワードを尋ねます。 たとえば、sshを使用し、ssh-agentでキーベースの認証を持たないなどです。

–ask-su-pass
　　Prompt for su password, used with –su (deprecated, use become).

　　- suで使用されるsuのパスワードを求めるプロンプトです。（廃止予定、becomeを使用すること）

–ask-sudo-pass
　　Prompt for the password to use with –sudo, if any (deprecated, use become).

　　–sudoでパスワードを使用するかどうかを確認するメッセージが表示されます。（廃止予定、becomeを使用すること）

–ask-vault-pass
　　Prompt for vault password.

　　vault passwordのプロンプトを出力します。

　　※vault passwordとは、インフラ構成管理の機密性を保持するために、ymlファイルを暗号化する機能です。

-B NUM, –background=NUM
　　Run commands in the background, killing the task after NUM seconds.

　　バックグラウンドでコマンドを実行し、NUM秒後にタスクを強制終了します。

–become-method=BECOME_METHOD
　　Privilege escalation method to use (default=sudo), valid choices: [ sudo | su | pbrun | pfexec | doas | dzdo | ksu ]

　　使用する特権エスカレーション方法（デフォルト= sudo）、有効な選択肢：[sudo | スー| pbrun | pfexec | ドゥーズ| dzdo | ksu]

–become-user=BECOME_USER
　　Run operations as this user (default=root).

　　このユーザーとして操作を実行します（デフォルト= root）。

-C, –check
　　Do not make any changes on the remote system, but test resources to see what might have changed. Note this can not scan all possible resource types and is only a simulation.

　　リモートシステムを変更せず、リソースを変更して何が変わったのかを確認してください。 これはすべての可能なリソースタイプをスキャンすることはできず、シミュレーションに過ぎないことに注意してください。

-c CONNECTION, –connection=CONNECTION
　　Connection type to use. Most common options are paramiko (SSH), ssh, winrm and local. local is mostly useful for crontab or kickstarts.

　　使用する接続タイプ。 最も一般的なオプションはparamiko（SSH）、ssh、winrm、localです。 localは、crontabやkickstartsの場合に最も便利です。

-e EXTRA_VARS, –extra-vars=’EXTRA_VARS
　　Extra variables to inject into a playbook, in key=value key=value format or as quoted YAML/JSON (hashes and arrays). To load variables from a file, specify the file preceded by @ (e.g. @vars.yml).

　　プレイブックに挿入する余分な変数、key=value key=value形式、または引用符で囲まれたYAML/JSON（ハッシュと配列）。 ファイルから変数をロードするには、@で始まるファイルを指定します（@ vars.ymlなど）。

-f NUM, –forks=NUM
　　Level of parallelism. NUM is specified as an integer, the default is 5.

　　いくつ並列して実行するか決めます。NUMは整数として指定され、デフォルトは5です。

-h, –help
　　Show help message and exit.

　　ヘルプメッセージを表示して終了します。

-i PATH, –inventory=PATH
　　The PATH to the inventory, which defaults to /etc/ansible/hosts. Alternatively you can use a comma separated list of hosts or single host with trailing comma host,.

　　インベントリへのPATH。デフォルトは /etc/ansible/hosts です。 代わりにカンマで区切ったホストのリストや末尾のカンマhostを持つ単一ホストを使用することもできます。

-l SUBSET, –limit=SUBSET
　　Further limits the selected host/group patterns. You can prefix it with ~ to indicate that the pattern is a regex.

　　さらに、選択したホスト/グループパターンを制限します。 パターンに正規表現があることを示すために、接頭辞として〜を付けることができます。

–list-hosts
　　Outputs a list of matching hosts; does not execute anything else.

　　一致するホストのリストを出力します。 他には何も実行しません。

-m NAME, –module-name=NAME
　　Execute the module called NAME.

　　NAME で指定したモジュールを実行します。

-M DIRECTORY, –module-path=DIRECTORY
　　The DIRECTORY search path to load modules from. The default is /usr/share/ansible. This can also be set with the ANSIBLE_LIBRARY environment variable.

　　モジュールをロードするディレクトリ検索パス。 デフォルトは /usr/share/ansible ディレクトリです。 これは ANSIBLE_LIBRARY 環境変数で設定することもできます。

-o, –one-line
　　Try to output everything on one line.

　　すべてを1行に出力します。

-P NUM, –poll=NUM
　　Poll a background job every NUM seconds. Requires -B.

　　NUM秒ごとにバックグラウンドジョブをポーリングします。 -B のオプションが必要です。

–private-key=PRIVATE_KEY_FILE
　　Use this file to authenticate the connection.

　　このファイルを使用して接続を認証します。

-S, –su
　　Run operations with su (deprecated, use become).

　　suでオペレーションを実行します。（非推奨、becomeを使用すること）

-R SU_USER, –su-user=SU_USER
　　Run operations with su as this user (default=root) (deprecated, use become).

　　このユーザーとしてsuを使用して操作を実行します（デフォルト= root）（非推奨、becomeを使用すること）

-s, –sudo
　　Run the command as the user given by -u and sudo to root (deprecated, use become).

　　-uで指定されたユーザーとしてコマンドを実行し、rootになるために sudo を実行します（廃止予定、becomeを使用すること）

–sftp-extra-args=’-f …’
　　Add the specified arguments to any sftp command-line.

　　指定された引数を任意のsftpコマンドラインに追加します。

–scp-extra-args=’-l …’
　　Add the specified arguments to any scp command-line.

　　scpコマンドラインに指定した引数を追加します。

–ssh-extra-args=’-R …’
　　Add the specified arguments to any ssh command-line.

　　指定された引数を任意のsshコマンドラインに追加します。

-U SUDO_USERNAME, –sudo-user=SUDO_USERNAME
　　Sudo to SUDO_USERNAME default is root. (deprecated, use become).

　　SudoからSUDO_USERNAMEへのデフォルトはrootです。 （廃止、becomeを使用すること）

-t DIRECTORY, –tree=DIRECTORY
　　Save contents in this output DIRECTORY, with the results saved in a file named after each host.

　　この出力ディレクトリに内容を保存します。結果は各ホストの後に付けられたファイルに保存されます。

-T SECONDS, –timeout=SECONDS
　　Connection timeout to use when trying to talk to hosts, in SECONDS.

　　SECONDSでホストと通話しようとするときに使用する接続タイムアウト。

-u USERNAME, –user=USERNAME
　　Use this USERNAME to login to the target host, instead of the current user.

　　このUSERNAMEを使用して、現在のユーザーではなくターゲットホストにログインします。

–vault-password-file=VAULT_PASSWORD_FILE
　　A file containing the vault password to be used during the decryption of vault encrypted files. Be sure to keep this file secured if it is used. If the file is executable, it will be run and its standard output will be used as the password.

　　vaultで暗号化されたファイルを復号化する際に使用されるvaultのパスワードを含むファイルです。 使用されている場合は、必ずこのファイルを保護しておいてください。 ファイルが実行可能な場合は実行され、標準出力はパスワードとして使用されます。

-v, –verbose
　　Verbose mode, more output from successful actions will be shown. Give up to three times for more output.

　　Verboseモードでは、成功したアクションからのより多くの出力が表示されます。 より多くの出力を得るために最大3回与えます。

–version
　　Show program version number and exit.

　　プログラムのバージョン番号を表示して終了します。

INVENTORY
Ansible stores the hosts it can potentially operate on in an inventory. This can be an ini-like file, a script, directory or a list. The ini syntax is one host per line. Groups headers are allowed and are included on their own line, enclosed in square brackets that start the line.

Ansibleは、潜在的に操作できるホストをインベントリに格納します。 これは、iniのようなファイル、スクリプト、ディレクトリ、またはリストにすることができます。 ini構文は1行に1ホストです。 グループヘッダーは許可され、行を開始する角括弧で囲まれた独自の行に含まれます。

Ranges of hosts are also supported. For more information and additional options, see the documentation on http://docs.ansible.com/.

ホストの範囲もサポートされています。 詳細および追加オプションについては、http://docs.ansible.com/ のマニュアルを参照してください。

ENVIRONMENT
The following environment variables may be specified.

以下の環境変数を指定することができます。

ANSIBLE_INVENTORY ― Override the default ansible inventory file

デフォルトの不可能なインベントリファイルを上書きします。

ANSIBLE_LIBRARY ― Override the default ansible module library path

デフォルトのモジュールライブラリパスを上書きします。

ANSIBLE_CONFIG ― Override the default ansible config file

デフォルトの設定可能な設定ファイルを上書きします。

Many more are available for most options in ansible.cfg

多くのオプションは、多くのオプションで利用可能です。

FILES
/etc/ansible/hosts ― Default inventory file

デフォルトのインベントリファイル

/usr/share/ansible/ ― Default module library

デフォルトのモジュールライブラリ

/etc/ansible/ansible.cfg ― Config file, used if present

設定ファイル（存在する場合）

~/.ansible.cfg ― User config file, overrides the default config if present

ユーザー設定ファイル、存在する場合はデフォルト設定を上書きする

AUTHOR
Ansible was originally written by Michael DeHaan. See the AUTHORS file for a complete list of contributors.

AnsibleはもともとMichael DeHaanによって書かれました。 貢献者の完全なリストについては、AUTHORSファイルを参照してください。

COPYRIGHT
Copyright c 2012, Michael DeHaan Ansible is released under the terms of the GPLv3 License.

Copyright c 2012、Michael DeHaan Ansibleは、GPLv3ライセンスの条件でリリースされています。

SEE ALSO
ansible-playbook(1), ansible-pull(1), ansible-doc(1), ansible-vault(1), ansible-galaxy(1)

Extensive documentation is available in the documentation site: http://docs.ansible.com. IRC and mailing list info can be found in file CONTRIBUTING.md, available in: https://github.com/ansible/ansible

Ansible 2.3.0.0 04/12/2017

[test@cnt07 ansible]$ vi hostlist

※Ansibleで管理するホストのIPアドレスを入力します。

[test@cnt07 ansible]$ cat hostlist
192.168.1.10
192.168.1.11
160.xxx.xxx.115

[all:vars]
ansible_ssh_port=22
ansible_ssh_pass=xxxxxxxxxxxx　←　sshでログインする際のパスワードを設定しています。

[test@cnt07 ansible]$

[local]　←　localグループのメンバーを定義しています。
192.168.1.10
192.168.1.11

[aws]　←　aws（AWS EC2 インスタンス）グループのメンバーを定義しています。
54.xx.xx.xx7

[local:vars]　←　localグループの接続情報を定義しています。

ansible_ssh_user=ansible_test
ansible_ssh_pass=xxxxxxxxxxxx

[aws:vars]　←　aws（AWS EC2 インスタンス）グループの接続情報を定義しています。
ansible_ssh_user=ansible_test
ansible_ssh_private_key_file=~/.ssh/id_rsa

[all:vars]　←　共通の（allの）接続情報を定義しています。
ansible_ssh_port=22

[local]
cnt7 ansible_host=192.168.1.10
cent6 ansible_host=192.168.1.11

[remote]
remote1 ansible_host=160.xxx.xxx.xx5

[aws]
aws ansible_host=54.xx.xx.xx7

[test@cnt07 ansible]$ ansible -i hostlist all -m ping
192.168.1.11 | UNREACHABLE! => {
“changed”: false,
“msg”: “Failed to connect to the host via ssh: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).\r\n”,
“unreachable”: true
}
192.168.1.10 | UNREACHABLE! => {
“changed”: false,
“msg”: “Failed to connect to the host via ssh: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).\r\n”,
“unreachable”: true
}
160.xxx.xxx.115 | UNREACHABLE! => {
“changed”: false,
“msg”: “Failed to connect to the host via ssh: Permission denied (publickey,password).\r\n”,
“unreachable”: true
}
[test@cnt07 ansible]$

$ ansible -i hostlist all -m ping
The authenticity of host ‘160.xxx.xxx.115 (160.xxx.xxx.115)’ can’t be established.

ECDSA key fingerprint is dd:71:2c:5a:05:1a:d7:ff:2f:74:87:66:d2:40:e0:32.

Are you sure you want to continue connecting (yes/no)? The authenticity of host ‘192.168.1.11 (192.168.1.11)’ can’t be established.　→　「Are you sure you want to continue connecting (yes/no)?」のメッセージが表示されているが、ansible の処理が進んでいくため yes を入力することができません。

RSA key fingerprint is 96:19:80:3e:99:f3:c6:42:b3:03:a8:8e:f9:d0:7b:98.

Are you sure you want to continue connecting (yes/no)? The authenticity of host ‘192.168.1.10 (192.168.1.10)’ can’t be established.

ECDSA key fingerprint is 37:87:2b:3c:8d:a7:6f:85:60:c6:f4:3a:b9:8a:2e:4b.
Are you sure you want to continue connecting (yes/no)? yes

160.xxx.xxx.115 | UNREACHABLE! => {
“changed”: false,
“msg”: “Failed to connect to the host via ssh: Warning: Permanently added ‘160.xxx.xxx.115’ (ECDSA) to the list of known hosts.\r\nPermission denied (publickey,password).\r\n”,
“unreachable”: true
}

192.168.1.11 | UNREACHABLE! => {
“changed”: false,
“msg”: “Failed to connect to the host via ssh: Host key verification failed.\r\n”,
“unreachable”: true
}

192.168.1.10 | UNREACHABLE! => {
“changed”: false,
“msg”: “Failed to connect to the host via ssh: Could not create directory ‘/root/.ssh’.\r\nHost key verification failed.\r\n”,
“unreachable”: true
}

# vi /etc/ansible/ansible.cfg

# additional paths to search for roles in, colon separated
#roles_path = /etc/ansible/roles

# uncomment this to disable SSH key host checking
#host_key_checking = False

↓コメントを外す

host_key_checking = False

# change the default callback
#stdout_callback = skippy
# enable additional callbacks
#callback_whitelist = timer, mail

# Determine whether includes in tasks and handlers are “static” by
# default. As of 2.0, includes are dynamic by default. Setting these
# values to True will make includes behave more like they did in the
# 1.x versions.
#task_includes_static = True
#handler_includes_static = True

$ ansible -i hostlist all -m ping
160.xxx.xxx.115 | SUCCESS => {
“changed”: false,
“ping”: “pong”
}

192.168.1.10 | SUCCESS => {
“changed”: false,
“ping”: “pong”
}

192.168.1.11 | SUCCESS => {
“changed”: false,
“ping”: “pong”
}

[test@cnt07 ~]$ ping 54.xxx.xxx.147
PING 54.xxx.xxx.147 (54.xxx.xxx.147) 56(84) bytes of data.

[test@cnt07 ~]$ ping 54.xxx.xxx.147
PING 54.xxx.xxx.147 (54.xxx.xxx.147) 56(84) bytes of data.
64 bytes from 54.xxx.xxx.147: icmp_seq=22 ttl=52 time=5.64 ms
64 bytes from 54.xxx.xxx.147: icmp_seq=23 ttl=52 time=5.22 ms
64 bytes from 54.xxx.xxx.147: icmp_seq=24 ttl=52 time=5.24 ms

# yum install python-simplejson