Ansible
- Ansible（1）Ansibleの概要
- Ansible（2）ファイル関連モジュール
- Ansible（3）システム管理モジュール
- Ansible（4）コマンド実行モジュール
- Ansible（5）パッケージ管理関連モジュール
blockinfile
ファイル内にテキストブロックを追加/削除する。
| 変数 | デフォルト | 内容 | 備考 |
|---|---|---|---|
| path | 必須 | ファイルパス | |
| block | 挿入するテキストブロック | ||
| insertafter | EOF | 何の後にテキストブロックを追加するか | |
| insertbefoer | 何の前にテキストブロックを追加するか | ||
| marker | # {mark} ANSIBLE MANAGED BLOCK | テキストブロック前後に挿入されるマーカー | |
| backup | no | バックアップファイルを作成するかどうか | |
| owner | 所有者 | ||
| group | グループ | ||
| mode | ファイルパーミッション | ||
| state | present | 実行内容 | absent, present |
Example
- name: Add mappings to /etc/hosts
blockinfile:
path: /etc/hosts
block: |
{{ item.ip }} {{ item.name }}
marker: "# {mark} ANSIBLE MANAGED BLOCK {{ item.name }}"
with_items:
- { name: host1, ip: 10.10.1.10 }
- { name: host2, ip: 10.10.1.11 }
- { name: host3, ip: 10.10.1.12 }
copy
リモートサーバへファイルをコピーする。
| 変数 | デフォルト | 内容 | 備考 |
|---|---|---|---|
| src | コピー元のファイルパス | ||
| remote_src | no | コピー元のファイルパスがリモートサーバのパスであるかどうか | |
| backup | no | バックアップファイルを作成するかどうか | |
| owner | 所有者 | ||
| group | グループ | ||
| mode | ファイルパーミッション |
Example
- name: example copying file with owner and permissions
copy:
src: /srv/myfiles/foo.conf
dest: /etc/foo.conf
owner: foo
group: foo
mode: 0644
file
ファイル属性を変更する。
| 変数 | デフォルト | 内容 | 備考 |
|---|---|---|---|
| path | コピー元のファイルパス | ||
| owner | 所有者 | ||
| group | グループ | ||
| mode | ファイルパーミッション | ||
| state | file | ファイルの状態 | absent, directory, file, hard, link, touch |
Example
# change file ownership, group and mode
- file:
path: /etc/foo.conf
owner: foo
group: foo
# when specifying mode using octal numbers, add a leading 0
mode: 0644
get_url
ファイルのダウンロードを行う。
| 変数 | デフォルト | 内容 | 備考 |
|---|---|---|---|
| url | 必須 | ファイルのURL | |
| dest | 必須 | ダウンロードしたファイルを設置するディレクトリの絶対パス | |
| timeout | 10 | タイムアウト | |
| force | no | 既にファイルが存在していたとしても毎回ダウンロードを行うかどうか | |
| insertbefoer | 何の前にテキストブロックを追加するか | ||
| backup | no | バックアップファイルを作成するかどうか | |
| owner | 所有者 | ||
| group | グループ | ||
| mode | ファイルパーミッション |
Example
- name: Download foo.conf
get_url:
url: https://example.com/path/file.conf
dest: /etc/foo.conf
mode: 0440
git
gitプロジェクトをデプロイする。
| 変数 | デフォルト | 内容 | 備考 |
|---|---|---|---|
| dest | 必須 | gitプロジェクトのチェックアウト先 | |
| repo | 必須 | gitリポジトリ |
Example
# Example git checkout from Ansible Playbooks
- git:
repo: 'https://foosball.example.org/path/to/repo.git'
dest: /srv/checkout
version: release-0.22
lineinfile
ファイル内にテキスト行を追加/削除する。
| 変数 | デフォルト | 内容 | 備考 |
|---|---|---|---|
| path | 必須 | ファイルパス | |
| line | 挿入するテキスト | ||
| insertafter | EOF | 何の後にテキストブロックを追加するか | |
| insertbefoer | 何の前にテキストブロックを追加するか | ||
| backup | no | バックアップファイルを作成するかどうか | |
| owner | 所有者 | ||
| group | グループ | ||
| mode | ファイルパーミッション | ||
| state | present | 実行内容 | absent, present |
Example
# Before 2.3, option 'dest', 'destfile' or 'name' was used instead of 'path'
- lineinfile:
path: /etc/selinux/config
regexp: '^SELINUX='
line: 'SELINUX=enforcing'
replace
特定の文字列を置換する。
| 変数 | デフォルト | 内容 | 備考 |
|---|---|---|---|
| path | 必須 | ファイル名 | |
| regexp | 必須 | 対象文字列の正規表現 | |
| replace | 変換後の文字列 | ||
| backup | no | バックアップファイルを作成するかどうか | |
| owner | 所有者 | ||
| group | グループ | ||
| mode | ファイルパーミッション |
Example
- replace:
path: /etc/hosts
regexp: '(\s+)old\.host\.name(\s+.*)?$'
replace: '\1new.host.name\2'
backup: yes
template
テンプレートファイルをリモートサーバに設置する。
| 変数 | デフォルト | 内容 | 備考 |
|---|---|---|---|
| src | 必須 | Playbook上のテンプレートファイルの名前 | |
| dest | 必須 | リモートサーバ上のパス | |
| backup | no | バックアップファイルを作成するかどうか | |
| owner | 所有者 | ||
| group | グループ | ||
| mode | ファイルパーミッション |
Example
- template:
src: /mytemplates/foo.j2
dest: /etc/file.conf
owner: bin
group: wheel
mode: 0644
unarchive
アーカイブを展開する。
| 変数 | デフォルト | 内容 | 備考 |
|---|---|---|---|
| src | 必須 | 展開するアーカイブのパス | |
| remote_src | no | 展開するアーカイブがリモートサーバにあるかどうか | |
| dest | 必須 | リモートサーバ上のパス | |
| owner | 所有者 | ||
| group | グループ | ||
| mode | ファイルパーミッション |
Example
- name: Unarchive a file that is already on the remote machine
unarchive:
src: /tmp/foo.zip
dest: /usr/local/bin
remote_src: yes