Ansible-playbook 快速入门到放弃

时间:2023-02-24 19:10:18

Ansible-playbook 快速入门到放弃

    隔岸红尘忙似火,当轩青嶂冷如冰。

1-简介

playbook 相当于可以把模块命令都写入到配置文件里面,这样就可以直接执行配置文件了,类似脚本。

2-playbook 初体验

编写test.yml 文件,在serviceA 主机机器上的/opt/tjt 路径下创建test.txt 文件。

1 ---
2 - hosts: serviceA
3   remote_user: root
4   tasks:
5     - name: "使用touch 命令创建test.txt文件"
6       shell: touch /opt/tjt/test.txt
View Code

Ansible-playbook 快速入门到放弃

文件格式说明

  • 第一行需要有三个杠,hosts 参数指定了对哪些主机进行参作,如果是多台机器可以用逗号作为分隔,也可以使用主机组,在/etc/ansible/hosts里定义;
  • user 参数指定了使用什么用户登录远程主机操作;
  • tasks 指定了一个任务,其下面的name 参数同样是对任务的描述,在执行过程中会打印出来,shell 是ansible 模块名字。

编辑完成之后,使用ansible-playbook 命令执行test.yml 文件。

[root@localhost tjt]# ansible-playbook /opt/tjt/ansible/test.yml

Ansible-playbook 快速入门到放弃

 然后到客户端上看看是否有创建test.txt 文件。

[root@localhost ~]# ls -l /opt/tjt/test.txt

Ansible-playbook 快速入门到放弃

3-playbook 变量

通过创建用户体验playbook 的变量使用方式。

---
- name: "创建test用户"
  hosts: 192.168.8.136
  user: root
  gather_facts: false
  vars:
     - user: "test"
  tasks:
    - name: "---playbook变量----创建test用户---"
      user: name="{{ user }}"

说明:

  • name:对该playbook 实现的功能做一个概述,后面执行过程中,会打印 name 变量的值 ,可以省略;
  • gather_facts:指定了在以下任务部分执行前,是否先执行setup 模块获取主机相关信息,如果需要在后面的tasks里获取setup收集到的信息,就需要把这个参数设置为True;
  • vars:指定了变量,这里声明了一个user 变量,其值为test ,需要注意的是,变量值一定要用引号引住;
  • user:提定了调用user 模块,name是user 模块里的一个参数,而增加的用户名字调用了上面user 变量的值。

执行该文件:

[root@localhost tjt]# ansible-playbook /opt/tjt/ansible/create_user.yml

Ansible-playbook 快速入门到放弃

 到客户端上看看用户是否已创建:

[root@localhost ~]# id test

Ansible-playbook 快速入门到放弃

4-playbook 循环

---
- hosts: 192.168.8.136
  user: root
  tasks:
    - name: "playbook---循环"
      file: path=/opt/tjt/{{ item }} state=touch mode=600
      with_items:
        - 1.txt
        - 2.txt
        - 3.txt

参数说明

  • file 模块可以对文件进行相关的操作,例如创建文件或者更改文件权限等,具体可以查看该模块的文档。
  • with_items 为循环的对象,相当于是一个数组或集合,写在下面的1.txt、2.txt 以及3.txt 是该集合的元素。而item 则表示的是遍历出来的元素,也就是说item 指代的是1.txt、2.txt 以及3.txt。
  • state 的值设置为touch 表示如果该文件不存在就进行创建。
  • path 表示文件的路径。
  • mode 设置权限。

执行该文件:

[root@localhost tjt]# ansible-playbook /opt/tjt/ansible/while.yml

Ansible-playbook 快速入门到放弃

到客户端上看看文件是否已创建:

[root@localhost ~]# ll /opt/tjt/*.txt

Ansible-playbook 快速入门到放弃

5-playbook 条件判断

一般以setup 模块收集到的主机信息,来作为判断条件。所以在编写代码之前,我们需要先获取相应的信息,例如我要以ip 地址来作为判断条件,那么我就得先从setup 里获取主机ip的相关信息。
执行以下命令可以查看到setup 收集到的所有的facter 信息,输出的信息是JSON格式的:
[root@localhost tjt]# ansible serviceA -m setup

Ansible-playbook 快速入门到放弃

 通过一个简单的创建文件的例子体验playbook 条件判断语句的使用方式,编写 when.yml 文件内容如下:

---
- hosts: serviceA
  user: root
  gather_facts: True
  tasks:
    - name: "playbook---条件判断"
      shell: touch /opt/tjt/when.txt
      when: ansible_virbr0.ipv4.address == "192.168.122.1"

参数说明

  • ansible_virbr0 是一个数组存储着网卡相关信息,ipv4 属于该数组的子元素,但是ipv4也是一个数组,而address 则是ipv4 数组的子元素,我们需要使用address 来作为判断条件,所以要访问address 就需要使用这样的格式:ansible_virbr0.ipv4.address,address 表示的是键,而"192.168.122.1"则是值,when 为判断语句相当于if,所以其判断条件为:该键的值为"192.168.122.1"时就执行shell 模块里定义的语句。
  • gather_facts: True ,在远程主机运行setup 模块,并将收集的信息记录起来(等于命令ansible  all -m setup #查看系统信息),可以通过系统信息来判断是否执行。 
  • gather_facts: no ,在不需要获取机器信息时,根据信息做判断时,将其关闭,避免影响执行速度。

执行该文件:

[root@localhost tjt]# ansible-playbook /opt/tjt/ansible/when.yml

Ansible-playbook 快速入门到放弃

 到客户端上看看文件是否已创建:

[root@localhost ~]# ll /opt/tjt/when.txt
-rw-r--r--. 1 root root 0 2月  21 21:51 /opt/tjt/when.txt
[root@localhost ~]#

6-playbook 的handlers

  • 有一种情况就是执行了tasks里面的内容之后,服务器发生了变化,这时我们可能需要执行一些相关的操作。
  • 例如我们修改了某个服务的配置文件后,则需要重启一下服务,而handlers 就是完成这样的事情的,它相当于编程中的回调函数,当tasks 里的内容执行成功后,就会执行handlers 里定义的内容。
  • 类似于shell 脚本中的 && 符号,例如 cat 1.txt && rm -f 1.txt ,当 cat 1.txt 命令执行成功之后就会执行 rm -f 1.txt 命令,否则不执行。
---
- name: "playbook中的handlers"
  hosts: serviceA
  user: root
  tasks:
    - name: copy file
      copy: src=/opt/tjt/handlers dest=/opt/tjt/handlers.txt
      notify: test handlers
  handlers:
    - name: test handlers
      shell: echo "This is a test string" >> /opt/tjt/ansible/handlers.txt

参数说明

  • 只有copy 模块执行成功后,才会去调用下面的handlers 里定义的内容,去执行handlers 里面的shell 相关命令,这种比较适合配置文件发生更改后,重启服务的操作。
  • notify 用于指定handlers 的name 参数的值,因为handlers 可以定义多个,所以需要使用notify 来进行指定调用哪一个。

执行该文件:

[root@localhost tjt]# ansible-playbook /opt/tjt/ansible/handlers.yml

Ansible-playbook 快速入门到放弃

 到客户端上查看文件末尾一行是否为ansible 执行的echo 写进的那一行内容。

[root@localhost ~]# tail -n1 /opt/tjt/ansible/handlers.txt

Ansible-playbook 快速入门到放弃

7-Ansible 的roles

role是task文件、变量文件、handlers文件的集合体,这个集合体的显著特点是:可移植性和可重复执行性。

在实际项目中,通常我们以部署某个服务为单元作为一个role ,然后将这些服务单元(role)放在一个roles 目录下,主playbook 文件通过调用roles目录下的role,来实现各种灵活多变的部署需求。

roles创建

创建一个role 的方法有两种:

  1. 命令mkdir 和touch 行手动创建,即需要哪个目录和文件就用「mkdir」和「touch」命令创建出来。

  2. 使用ansible-galaxy 自动初始化一个role,创建完后再删除不需要的目录。

使用「ansible-galaxy init」命令创建一个名字为role_D 的role。

[root@localhost roles]#  ansible-galaxy init role_D
- Role role_D was created successfully

Ansible-playbook 快速入门到放弃

role 目录结构

  • tasks : 用于存放role_D 的主要任务,也可以添加其他task 文件,供main.yml 调用,从而实现更加复杂的部署功能。
  • handlers : 用于存放触发执行( hanlders )的任务。
  • defaults : 用于存放默认变量,优先级最低。
  • vars : 用于存放变量文件,role_D 中任务和模版里用到的变量可以在这里定义。
  • files :用于存放需要拷贝到目的主机的文件,例如,作为「copy」模块src 参数的默认根目录。
  • template : 用于存放模版文件,格式为.j2,文件内容要符合Jinja2 语法规则,通常使用「template」模块部署服务的配置文件。
  • meta : 用于存放role 依赖列表,这个知识点后面会详细阐述。
  • tests : 用于存放测试role 本身功能的playbook 和主机定义文件,在开发测试阶段比较常用。

 role 中各个目录下的main.yml 文件很重要,这是ansible 默认加载的YAML 文件。

roles 的引用&执行

可以使用「roles:」语句引用role ,根据需要在主playbook 中引用不同的role,ansible 会把role 所包含的任务、变量、handlers、依赖等加载到playbook中,按照顺序执行。

编写主playbook 文件test_role.yml:

---
- name: "主playbook文件通过调用roles目录下的role"
  hosts: serviceA
  user: root
  gather_facts: false
  roles:
    - roleB
    - roleA

roleA 和roleB 目录结构如下:

Ansible-playbook 快速入门到放弃

/opt/tjt/ansible/roles/roleA/tasks/main.yml

---
- name: "调用-roles目录下的roleA"
  debug:
    msg: "msg: roleA被执行"

/opt/tjt/ansible/roles/roleB/tasks/main.yml

---
- name: "调用-roles目录下的roleB"
  debug:
    msg: "age:: roleB被执行"  

执行主playbook 文件test_role.yml:

[root@localhost roles]# ansible-playbook /opt/tjt/ansible/test_role.ym

Ansible-playbook 快速入门到放弃

如上,可以看到roleB 和roleA 分别有序执行。

检索路径

ansible 如何查找要执行的role,在不使用绝对路径的情况下(可以这么配role - role: /opt/tjt/ansible/roles/roleB),ansible 检索role 的默认路径有:

  • 执行ansible-playbook 命令时所在的当前目录
  • playbook 文件所在的目录及playbook 文件所在目录的roles 目录
  • 当前系统用户下的~/.ansible/roles 目录
  • /usr/share/ansible/roles 目录
  • ansible.cfg 中「roles_path」指定的目录,默认值为/etc/ansible/roles 目录

8-playbook 的chdir

chdir:进入指定目录,如下chdir,执行ls 命令前,先进入指定目录/opt/tjt。

[root@localhost roles]# ansible serviceA -m command -a 'chdir=/opt/tjt ls'

Ansible-playbook 快速入门到放弃

9-playbook 的with_items

ansible 中的循环模块有很多,with_items 最为简单常用。 

---
- name: "with_items循环遍历"
  shell: "echo {{ item }}"
  register: "with_items_output"
  with_items: [a,b,c,d]

Ansible-playbook 快速入门到放弃

 如上,with_items 可以用于迭代一个列表或字典,通过 {{ item }} 获取每次迭代的值。

 

 

 

 

隔岸红尘忙似火
当轩青嶂冷如冰