文章目录
- 前言
- 一、inventory主机清单和变量配置
- 1、常用inventory变量
- 2、inventory主机分组
- 3、常用用法
- 3.1、通过变量实现免密登入
- 3.2、组变量
- 3.3、组嵌套
- 二、 Playbook 的介绍与结构
- 三、playbook常用命令
- 四、变量和引用
- 五、条件判断 when
- 六、迭代:使用with_items 或 loop
- 七、Templates 模块
- 八、tags模块
- 九、roles模块
- 1、roles介绍
- 2、roles内各目录含义解释
- 3、在一个 playbook 中使用 roles 的步骤:
- 4、案例
- 总结
前言
Ansible作为自动化运维的核心工具,其高效管理离不开主机清单的灵活配置与变量定义。本文将系统解析inventory分组、变量应用及Playbook的模块化设计,助力构建可维护的自动化体系。
一、inventory主机清单和变量配置
1、常用inventory变量
2、inventory主机分组
Inventory支持对主机进行分组,每个组内可以定义多个主机,每个主机都可以定义在任何一个或多个主机组内。
如果是名称类似的主机,可以使用列表的方式标识各个主机。·
vim/etc/ansible/hosts[webservers]192.168.10.14:2222#冒号后定义远程连接端口,默认是 ssh 的 22 端口192.168.10.1[2:5][dbservers]db-[a:f].example.org#支持匹配 a~f3、常用用法
3.1、通过变量实现免密登入
[webservers]192.168.10.106ansible_port=22ansible_user=rootansible_password=123456无须输入密码,直接登入成功
3.2、组变量
组内主机共享变量
[webservers:vars]ansible_user=rootansible_password=123456[all:vars]ansible_port=22批量实现免密操作
3.3、组嵌套
vi /etc/ansible/hosts
[webservers]test1ansible_port=22ansible_user=rootansible_password=123456http_port=8080server_name=www.benet.comroot_dir=/etc/httpd/htdocs[dbservers]test2ansible_port=22ansible_user=rootansible_password=123456http_port=8080server_name=www.benet.comroot_dir=/etc/httpd/htdocs[sjj:children]webservers dbservers二、 Playbook 的介绍与结构
Ansible 的 Playbook 是一个包含多个 Play 的 YAML 文件,每个 Play 负责对指定的 主机组 执行一系列的任务。Playbook 通常由以下几部分组成:
- Tasks:每个任务会调用一个模块来在目标主机上执行操作。
- Variables:通过定义和使用变量,使 Playbook 更具灵活性和可重用性。
- Templates:通过 Jinja2 模板动态生成配置文件。
- Handlers:用于响应任务执行后的变更( notify 触发)。
- Roles:把多个任务、变量、模板、文件、处理程序组织成模块化结构,便于复用。
示例:
- name: first playbook gather_facts:falsehosts: webservers remote_user: root tasks: - name: task1 ping: - name: task2 command:date- name: task3installhttpd yum:name=httpdstate=latest ignore_errors:truenotify:"restart httpd"handlers: - name: restart httpd service:name=httpdenabled=truestate=restarted三、playbook常用命令
ansible-playbook test1.yaml# 运行 playbookansible-playbook test1.yaml --syntax-check# 检查语法ansible-playbook test1.yaml --list-task# 查看任务列表ansible-playbook test1.yaml --list-hosts# 查看影响的主机ansible-playbook test1.yaml --start-at-task='install httpd'# 从指定任务开始执行如果要使用 SSH 密码 或 sudo 密码,可以使用以下选项:
ansible-playbook test1.yaml -k# 提示输入 SSH 密码ansible-playbook test1.yaml -K# 提示输入 sudo 密码四、变量和引用
变量在 Playbook 中非常有用,它们可以通过 vars 或命令行进行定义。
- name: second play hosts: dbservers remote_user: root vars: groupname: sjjgroup username: sjj tasks: - name: create group group:name={{groupname}}gid=1010- name: create user user:name={{username}}uid=1234group={{groupname}}# 执行ansible-playbook test2.yaml
在命令行中,变量也可以通过 -e 参数传递:
例如:
ansible-playbook test1.yaml -e “username=httpd”
五、条件判断 when
在Ansible中,提供的唯一一个通用的条件判断是when指令,当when指令的值为true时,则该任务执行,否则不执行该任务。
- name: first playbook# gather_facts: falsehosts: all remote_user: root tasks: - name: task1 ping: - name: task2 command:date- name: task3installhttpd yum:name=httpdstate=latest ignore_errors:truenotify:"restart httpd"when: ansible_default_ipv4.address=="192.168.10.107"handlers: - name: restart httpd service:name=httpdenabled=truestate=restarted
或根据主机名来执行:
when: inventory_hostname == “<主机名>”
六、迭代:使用with_items 或 loop
Ansible 支持使用 with_items 或 loop 进行迭代。两者作用相同, loop 是较新的推荐用法
- name: play1 hosts: webservers gather_facts:falsetasks: - name:touchfile: path:"/opt/{{item}}.log"state:touchloop:[1,2,3]七、Templates 模块
Jinja是基于Python的模板引擎。Template类是Jinja的一个重要组件,可以看作是一个编译过的模板文件,用来产生目标文本,传递Python的变量给模板去替换模板中的标记。
Jinja2 模板引擎在 Ansible 中用来动态生成文件。即通过动态的模板文件,去更改原生文件
步骤一:创建jinja模板文件(.j2)
cp/etc/httpd/conf/httpd.conf /opt/httpd.conf.j2vim/opt/httpd.conf.j2 Listen{{http_port}}#42行,修改ServerName{{server_name}}#95行,修改DocumentRoot"{{root_dir}}"#119行,修改步骤二:定义变量并在主机清单中指定
#修改主机清单文件,使用主机变量定义一个变量名相同,而值不同的变量vim/etc/ansible/hosts[webservers]192.168.10.14http_port=8080server_name=www.benet.comroot_dir=/etc/httpd/htdocs步骤三:执行playbook
- name: first playbook# gather_facts: falsehosts: dbservers remote_user: root tasks: - name: task1 ping: - name: task2 command:date- name: task3installhttpd yum:name=httpdstate=latest ignore_errors:true- name:11template:src=/opt/httpd.conf.j2dest=/etc/httpd/conf/httpd.conf notify:"restart httpd"handlers: - name: restart httpd service:name=httpdenabled=truestate=restarted
端口已修改
八、tags模块
Tags 允许你指定只执行某些特定任务。通过命令行传入 --tags 参数来执行带有特定标签的任务。playbook还提供了一个特殊的tags为always。作用就是当使用always当tags的task时,无论执行哪一个tags时,定义有always的tags都会执行。
- hosts: webservers remote_user: root tasks: - name: Copy hostsfilecopy:src=/etc/hostsdest=/opt/hosts tags: - a - name:touchfilefile:path=/opt/testhoststate=touch tags: - always# 始终执行- name:touchfilefile:path=/opt/hosts_3state=touch tags: - c执行:ansible-playbook webhosts.yaml --tags=“c”
九、roles模块
1、roles介绍
Roles 数据中心有各种不同类型的主机。如web服务器、数据库服务器,基于开发环境的服务器。随着时间的推移,具有处理所有这些情况的任务和人员的Ansible playbook将变得庞大而复杂。
1)角色允许将复杂的剧本组织成独立的、更小的剧本和文件
2)角色提供了一种从外部文件加载任务、处理程序和变量的方法
3)角色也可关联和引用静态的文件和模板
4)角色可以编写成满足普通用途需求,并且能被重复利用
Ansible为了层次化、结构化地组织Playbook,使用了角色(roles),roles可以根据层次型结构自动装载变量文件、task以及handlers等。简单来讲,roles就是通过分别将变量、文件、任务、模块及处理器放置于单独的目录中,并可以便捷地include它们。roles一般用于基于主机构建服务的场景中,但也可以用于构建守护进程等场景中。
2、roles内各目录含义解释
- files: 用来存放由 copy 模块或 script 模块调用的文件。
- templates: 用来存放 jinjia2 模板,template 模块会自动在此目录中寻找 jinjia2 模板文件。
- tasks: 此目录应当包含一个 main.yml 文件,用于定义此角色的任务列表,此文件可以使用
- include 包含其它的位于此目录的 task 文件。
- handlers: 此目录应当包含一个 main.yml 文件,用于定义此角色中触发条件时执行的动作。
- vars: 此目录应当包含一个 main.yml 文件,用于定义此角色用到的变量。
- defaults: 此目录应当包含一个 main.yml 文件,用于为当前角色设定默认变量。
- meta: 此目录应当包含一个 main.yml 文件,用于定义此角色的特殊设定及其依赖关系。
Roles 是将 Playbook 组织成模块化的结构,使其易于管理和重用。每个 Role 都有一套预定义的目录结构:
3、在一个 playbook 中使用 roles 的步骤:
- 创建以 roles 命名的目录:
mkdir /etc/ansible/roles/ -p #yum装完默认就有 - 创建全局变量目录(可选):
mkdir/etc/ansible/group_vars/ -ptouch/etc/ansible/group_vars/all#文件名自己定义,引用的时候注意- 在 roles 目录中分别创建以各角色名称命令的目录,如 httpd、mysql:
mkdir/etc/ansible/roles/httpdmkdir/etc/ansible/roles/mysql- 在每个角色命令的目录中分别创建files、handlers、tasks、templates、meta、defaults和vars目录,用不到的目录可以创建为空目录,也可以不创建
mkdir/etc/ansible/roles/httpd/{files,templates,tasks,handlers,vars,defaults,meta}mkdir/etc/ansible/roles/mysql/{files,templates,tasks,handlers,vars,defaults,meta}- 在每个角色的 handlers、tasks、meta、defaults、vars 目录下创建 main.yml 文件,千万不能自定义文件名:
touch/etc/ansible/roles/httpd/{defaults,vars,tasks,meta,handlers}/main.ymltouch/etc/ansible/roles/mysql/{defaults,vars,tasks,meta,handlers}/main.yml- 修改 site.yml 文件,针对不同主机去调用不同的角色:
vim/etc/ansible/site.yml --- - hosts: webservers remote_user: root roles: - httpd - hosts: dbservers remote_user: root roles: - mysql- 运行 ansible-playbook:
cd/etc/ansible ansible-playbook site.yml4、案例
创建项目目录
mkdir/etc/ansible/roles/httpd/{files,templates,tasks,handlers,vars,defaults,meta}-pmkdir/etc/ansible/roles/mysql/{files,templates,tasks,handlers,vars,defaults,meta}-pmkdir/etc/ansible/roles/php/{files,templates,tasks,handlers,vars,defaults,meta}-ptouch/etc/ansible/roles/httpd/{defaults,vars,tasks,meta,handlers}/main.ymltouch/etc/ansible/roles/mysql/{defaults,vars,tasks,meta,handlers}/main.ymltouch/etc/ansible/roles/php/{defaults,vars,tasks,meta,handlers}/main.yml编写httpd模块
vim/etc/ansible/roles/httpd/tasks/main.yml - name:installapache yum:name={{pkg}}state=latest - name: start apache service:enabled=truename={{svc}}state=started //定义变量:可以定义在全局变量中,也可以定义在roles角色变量中,一般定义在角色变量中vim/etc/ansible/roles/httpd/vars/main.yml pkg: httpd svc: httpd编写mysql模块
vim/etc/ansible/roles/mysql/tasks/main.yml - name:installmysql yum:name={{pkg}}state=latest - name: start mysql service:enabled=truename={{svc}}state=startedvim/etc/ansible/roles/mysql/vars/main.yml pkg: - mariadb - mariadb-server svc: mariadb编写roles
vim/etc/ansible/site.yml --- - hosts: webservers remote_user: root roles: - httpd - mysqlcd/etc/ansible ansible-playbook site.yml总结
本文深入剖析了Ansible主机清单管理、Playbook编写及roles模块化实践。掌握这些核心机制能显著提升运维自动化水平,实现高效、可扩展的基础设施即代码管理。