ansible copy 模塊詳解

ansible 模塊 copy

one、概述

• copy 模塊的作用就是拷貝文件，它與之前介紹過的 fetch 模塊類似，不過，fetch 模塊是從遠程主機中拉取文件到 ansible 管理主機，而 copy 模塊是將 ansible 管理主機上的文件拷貝到遠程主機中。

two、常用參數

• src參數 ：用於指定需要copy的文件或目錄。

• dest參數 ：用於指定文件將被拷貝到遠程主機的哪個目錄中，dest為必須參數。

• content參數 ：當不使用src指定拷貝的文件時，可以使用content直接指定文件內容，src與content兩個參數必有其一，否則會報錯。

• force參數 : 當遠程主機的目標路徑中已經存在同名文件，並且與ansible主機中的文件內容不同時，是否強制覆蓋，可選值有yes和no，默認值為yes，表示覆蓋，如果設置為no，則不會執行覆蓋拷貝操作，遠程主機中的文件保持不變。

• backup參數 : 當遠程主機的目標路徑中已經存在同名文件，並且與ansible主機中的文件內容不同時，是否對遠程主機的文件進行備份，可選值有yes和no，當設置為yes時，會先備份遠程主機中的文件，然后再將ansible主機中的文件拷貝到遠程主機。

• owner參數 : 指定文件拷貝到遠程主機后的屬主，但是遠程主機上必須有對應的用戶，否則會報錯。

• group參數 : 指定文件拷貝到遠程主機后的屬組，但是遠程主機上必須有對應的組，否則會報錯。

• mode參數 : 指定文件拷貝到遠程主機后的權限，如果你想將權限設置為”rw-r--r--“，則可以使用mode=0644表示，如果你想要在user對應的權限位上添加執行權限，則可以使用mode=u+x表示。

thsree、示例

1.將 ansible 管理主機中 /testdir/copytest 文件復制到遠程主機的 /testdir 目錄下。

ansible 管理主機中的文件內容為：

[root@ansible-manager ~]# cat /testdir/copytest 
123
456123

• 執行 copy：

  [root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/"
  ansible-demo3 | FAILED! => {
  "changed": false,
  "checksum": "47ce3ac56f911ac44537d6a3802b72ceed71e152",
  "msg": "Aborting, target uses selinux but python bindings (libselinux-python) aren't installed!"
  }123456

$根據報錯信息，ansible-demo3 主機需要安裝 libselinux-python。 $

[root@ansible-demo3 ~]# yum install libselinux-python -y1

安裝完畢后，再次執行：

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest     dest=/testdir/"
  ansible-demo3 | SUCCESS => {
"changed": true, 
"checksum": "47ce3ac56f911ac44537d6a3802b72ceed71e152", 
"dest": "/testdir/copytest", 
"gid": 0, 
"group": "root", 
"md5sum": "c010aff9dc6276fdb7efefd1a2757658", 
"mode": "0644", 
"owner": "root", 
"secontext": "system_u:object_r:default_t:s0", 
"size": 8, 
"src": "/root/.ansible/tmp/ansible-tmp-1526023671.74-99930404286274/source", 
"state": "file", 
"uid": 0
}12345678910111213141516

• 成功執行后，看看 ansible-demo3 的 /testdir/copytest 文件：

  [root@ansible-demo3 ~]# cat /testdir/copytest
  123
  456123

2.在遠程主機的 /testdir 目錄下生成文件 testfile1，testfile1 文件中有兩行文本，第一行文本為 aaa，第二行為 bbb，當使用 content 指定文件內容時，dest 參數對應的值必須是一個文件，而不能是一個路徑。

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a 'content="aaa\nbbb\n" dest=/testdir/testfile1'
ansible-demo3 | SUCCESS => {
"changed": true,
"checksum": "90c206af0bfefa95541d3e724efe1dbc1ed3877f",
"dest": "/testdir/testfile1",
"gid": 0,
"group": "root",
"md5sum": "8b652b8c79f357694a04bd793f533c96",
"mode": "0644",
"owner": "root",
"secontext": "unconfined_u:object_r:default_t:s0",
"size": 8,
"src": "/root/.ansible/tmp/ansible-tmp-1526113265.26-187047800648668/source",
"state": "file",
"uid": 0
}12345678910111213141516

• 因為 ansible-demo3 主機上面之前已經存在 /testdir/testfile1 文件，所以執行成功后返回 “changed” 為 true。

可以看到，文件內容已經改寫：
執行前

[root@ansible-demo3 ~]# cat /testdir/testfile11

執行后

[root@ansible-demo3 ~]# cat /testdir/testfile1
aaa
bbb123

3.將 ansible 主機中 /testdir/copytest 文件復制到遠程主機的 /testdir 目錄中時，如果遠程主機中已經存在 /testdir/copytest 文件，並且文件內容與 ansible 主機中的 copytest 文件的內容不一致，則不執行拷貝操作，遠程主機中的 /testdir/copytest 文件內容不會被改變。

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/ force=no"
ansible-demo3 | SUCCESS => {
"changed": false,
"dest": "/testdir/",
"src": "/testdir/copytest"
}123456

4.將 ansible 主機中 /testdir/copytest 文件復制到遠程主機的 /testdir 目錄中時，如果遠程主機中已經存在 /testdir/copytest 文件，並且文件內容與 ansible 主機中的 /testdir/copytest 文件的內容不一致，會執行拷貝操作，但是在執行拷貝操作之前，會將遠程主機中的原文件重命名，以作備份，然后再進行拷貝操作。

先修改 /testdir/copytest 文件

[root@ansible-manager ~]# cat /testdir/copytest
123
456
[root@ansible-manager ~]# vi /testdir/copytest
[root@ansible-manager ~]# cat /testdir/copytest
123
456
78912345678

執行 copy

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/ backup=yes"
ansible-demo3 | SUCCESS => {
"backup_file": "/testdir/copytest.20579.2018-05-12@16:31:27~",
"changed": true,
"checksum": "a8d207d098d939cb0dc9df1f3a2b986d6d4499b2",
"dest": "/testdir/copytest",
"gid": 0,
"group": "root",
"md5sum": "a2ef74a76b2bfcfe14817a27c511759c",
"mode": "0644",
"owner": "root",
"secontext": "system_u:object_r:default_t:s0",
"size": 12,
"src": "/root/.ansible/tmp/ansible-tmp-1526113886.45-35720740584873/source",
"state": "file",
"uid": 0
}1234567891011121314151617

查看 ansible-demo3 主機 /testdir 下面的文件
copytest.20579.2018-05-12@16:31:27~ 為備份的文件

[root@ansible-demo3 ~]# ls /testdir/
copytest copytest.20579.2018-05-12@16:31:27~ test testfile1 testfile2
[root@ansible-demo3 ~]# cat /testdir/copytest
123
456
789
[root@ansible-demo3 ~]# cat /testdir/copytest.20579.2018-05-12@16:31:27~
123
456123456789

5.拷貝文件時，指定文件的屬主，需要注意，遠程主機上必須存在對應的用戶。

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/ owner=ding"
ansible-demo3 | SUCCESS => {
"changed": true,
"checksum": "a8d207d098d939cb0dc9df1f3a2b986d6d4499b2",
"dest": "/testdir/copytest",
"gid": 0,
"group": "root",
"mode": "0644",
"owner": "ding",
"path": "/testdir/copytest",
"secontext": "system_u:object_r:default_t:s0",
"size": 12,
"state": "file",
"uid": 1000
}123456789101112131415

可以看到，執行前后的變化

6.拷貝文件時，指定文件的屬組，需要注意，遠程主機上必須存在對應的組。

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/ group=ding"
ansible-demo3 | SUCCESS => {
"changed": true,
"checksum": "a8d207d098d939cb0dc9df1f3a2b986d6d4499b2",
"dest": "/testdir/copytest",
"gid": 1000,
"group": "ding",
"mode": "0644",
"owner": "ding",
"path": "/testdir/copytest",
"secontext": "system_u:object_r:default_t:s0",
"size": 12,
"state": "file",
"uid": 1000
}123456789101112131415

可以看到執行前后的變化

7.拷貝文件時，指定文件的權限。

[root@ansible-manager ~]# ansible ansible-demo3 -m copy -a "src=/testdir/copytest dest=/testdir/ mode=0640"
ansible-demo3 | SUCCESS => {
"changed": true,
"checksum": "a8d207d098d939cb0dc9df1f3a2b986d6d4499b2",
"dest": "/testdir/copytest",
"gid": 1000,
"group": "ding",
"mode": "0640",
"owner": "ding",
"path": "/testdir/copytest",
"secontext": "system_u:object_r:default_t:s0",
"size": 12,
"state": "file",
"uid": 1000
}123456789101112131415

可以看到執行前后的變化