Ansible Documentation
file – Sets attributes of files機能
- ファイル / シンボリックリンク / ディレクトリの属性を設定する
- ファイル / シンボリックリンク / ディレクトリを削除する
パラメータ
| パラメータ | 選択肢/ Default | 説明 |
|---|---|---|
| access_time | - | ファイルのアクセス時間を YYYYMMDDHHMM.SS 形式または now で指定する。アクセス時間を変更しない場合は preserve を指定する。state: file / directory / link / hard のデフォルトは preserve 、state: touch のデフォルトは now になる |
| group | - | ファイルやディレクトリの所有グループ名 |
| mode | - | ファイルやディレクトリのファイルモードを指定する。指定は 0644 や 01777 のように先頭に 0 を付けて明示的に 8 進数で行うか、シングルクォーテーションで括って '644' や '1777' のように行う。 u+rwx や u=rw,g=r,o=r のようなシンボリックモードの指定も可能である |
| modification_time | - | ファイルの変更時間を YYYYMMDDHHMM.SS 形式または now で指定する。アクセス時間を変更しない場合は ppreserve を指定する。state: file / directory / link / hard のデフォルトは preserve 、state: touch のデフォルトは now になる |
| owner | - | ファイルやディレクトリの所有者（オーナー）名 |
| path ※必須※ | - | 管理対象のファイルまたはディレクトリの名称 |
| src | - | state: link または state: hard を指定したときのリンク先のパス名 |
| state | Choices: ・absent ・directory ・file ・hard ・link ・touch | ・absent path: ファイル名の場合はファイルを削除する。ディレクトリ名の場合はディレクトリを再帰的に削除する。シンボリックリンク名の場合はリンクを解除する。 ・directory path: に指定されたパス名のディレクトリを作成する。パス名の途中のディレクトリ（サブディレクトリ）が存在しない場合はサブディレクトリも作成する ・file path: に指定されたパス名がファイルであることを示す。path: に指定したファイルが存在しないときは何もしない（ファイルの作成は touch を指定する） ・hard ハードリンクを作成、変更する ・link シンボリックリンクを作成、変更する ・touch path: に指定したファイルが存在しないとき、パス名の空ファイルを作成する |
例
- name: /etc/foo.conf ファイルのオーナー、グループ、ファイルモードを変更する
file:
path: /etc/foo.conf
owner: foo
group: foo
mode: 0644
- name: /etc/foo.conf のシンボリックリンク f.conf を作成する
file:
src: /etc/foo.conf
dest: /home/workman/f.conf
owner: workman
group: staff
state: link
- name: 空ファイル test.txt を作成する
file:
path: test.txt
state: touch
mode: "u+rw,g-wx,o-rwx"
- name: 同じファイルを再度 touch するが、タイムスタンプは変更しない
file:
path: test.txt
state: touch
mode: "u+rw,g-wx,o-rwx"
modification_time: "preserve"
access_time: "preserve"
- name: ファイルのファイルモードとアクセス時間、変更時間を変更する
file:
path: test.txt
state: file
mode: 0755
modification_time: now
access_time: now
- name: /tmp/some_directory ディレクトリが存在しないとき作成する
file:
path: /tmp/some_directory
state: directory
mode: 0755