[转] Ansible 系列之 Playbooks 剧本

阅读量：5111 次

发布时间：2019-06-13

本文共 7199 字，大约阅读时间需要 23 分钟。

[From] https://www.cnblogs.com/hanyifeng/p/6435875.html

一、Playbooks 介绍

1.Playbooks是Ansible的配置，部署和编排语言。它们可以描述您希望远程系统执行的策略，或一般IT流程中的一组步骤。

如果说ansible 模块是你车间里的工具，那么playbooks 是你的说明书／使用手册，并且资源清单上的主机是你的原材料。

在基本层面上，剧本可以用于管理远程主机的配置与部署，在更高的一层来说，它们可以对涉及滚动更新的多层发布任务进行排序，并且可以将操作委派给其他主机，同时与监视服务器和负载平衡器进行交互。

官网介绍的说playbooks 篇章有很多的内容，他们不建议我们一下子学完，重在积累，以及在使用的过程中来学习，建议不错。嘿嘿

在ansible 上使用Playbooks是一种完全不同于adhoc的任务执行模式，并且特别强大。简单地说，playbooks是一个非常简单的配置管理和多机器部署系统的基础，以及非常适合部署复杂应用程序的系统。

Playbooks可以对任务进行编排，就像我们要安装一个程序，写个安装shell脚本一样，在哪一步复制配置文件，最后一步启动服务。虽然/usr/bin/ansible 可以运行一些临时任务，但是针对复杂的配置，并且可以将配置标准化，这个时候就需要Playbooks了。

2.Playbooks Language example

Playbooks 语言是以YAML 格式表示，并且有最小的语法，有意的说明它不是一个编程或者脚本语言，它是一种写配置文件的语言。简洁可读性高。

YAML 语法：

这里我们先大致的看下YAML的语法吧，看看有什么需要遵守和记住的编写规则。

a.对于Ansible来说，几乎每个YAML文件都以列表开头。列表中的每个项目是键/值对的列表，通常称为“列表”或“字典”。因此，我们需要知道如何在YAML中编写列表和字典。

b.还有一个地方，每个文件都是以 --- 开始，以 ... 结尾。这也是yaml 语言格式的一部分，指出文档的开始和结束。

c.列表中所有的词都是 - (减号和空格)开头的相同缩进的行。如下：

---# A list of tasty fruitsfruits:    - Apple    - Orange    - Strawberry    - Mango...

d.字典以简单的形式表示 key: value (冒号后面必须跟一个空格)，不能使用tab 键如下：

# An employee recordmartin:    name: Martin D'vloper    job: Developer    skill: Elite

e.也有复杂的数据结构，例如带有字典的列表。

下面是一个随意的YAML文件，和ansible无关。

---# 员工记录name: xiaomingjob: Developerskill: Eliteemployed: Truefoods:    - Apple    - Orange    - Strawberry    - Mangolanguages:    perl: Elite    python: Elite    pascal: Lameeducation: |    4 GCSEs    3 A-Levels    BSc in the Internet of Things

f.区分大小写，如果在 key:value 里，value里面有冒号，需要用 “” 号将整个value 包围住。

OK，继续学习palybooks。。。

每个palybook（剧本）都有一个或多个palys （每一场）组成。palys的目的是将一组主机映射到一些明确定义的角色，由ansible来调用任务。基本来说，一个任务就是调用ansible 的某个模块。

二、真枪实战

1.看一个基本的palybook

---- hosts: all  tasks:    - name: Installs nginx web server      yum: name=nginx state=installed update_cache=true      notify:        - start nginx  handlers:    - name: start nginx      service: name=nginx state=started

结合着上面YAML遵守的规则来分析下。

第一行中，文件开头为　---；这是YAML 将文件解释为正确的文档的要求。YAML 允许多个“文档”存在于一个文件中，每个“文档”由 --- 符号分割，但Ansible只需要一个文件存在一个文档即可，因此这里需要存在于文件的开始行第一行。

YAML对空格非常敏感，并使用空格来将不同的信息分组在一起，在整个文件中应该只使用空格而不使用制表符，并且必须使用一致的间距，才能正确读取文件。相同缩进级别的项目被视为同级元素。

以 - 开头的项目被视为列表项目。作为散列或字典操作，它具有key：value格式的项。YAML文档基本上定义了一个分层的树结构，其中位于左侧是包含的元素。

在第二行

---- hosts: all

这是我们在上面学到的YAML中的列表项，但由于它在最左侧的级别，它也是一个Ansible“palys”（某个任务）。plays基本上是在某一组主机上执行的任务组，以允许它们实现要分配给它们的功能。每个play必须指定一个主机或一组主机，正如上面一样，指定了all 所有主机。

往下看，看下第一个任务

---- hosts: all  tasks:    - name: Installs nginx web server      yum: name=nginx state=installed update_cache=true      notify:        - start nginx

在上面，有 “tasks:"与 "hasts:" 同级。它包含一个包含键值对的列表（因为它以一个 "-" 开头）.

第一个，“name”，这是一个任务的描述。可以随意定义。

下一个key 是 "yum",这里引用的是Ansible 的一个模块，就像我们直接在命令行使用ansible 命令一样，如下面：

# ansible all -m yum -a "name=nginx state=present update-cache=true"

"yum" 这个模块允许我们指定一个软件包和它应该在的状态，上面例子中是应“已安装”的状态。update-cache = true 部分告诉我们的远程机器在安装软件之前更新其软件包缓存（相当于yum makecache）。

“notify”项包含具有一个项目的列表，它会呼叫 “start nginx”。这不是一个Ansible内部命令，它是对handlers的引用，当从任务中调用该处理程序时，它可以执行某些功能。我们将在下面定义“start nginx” 的处理程序

---- hosts: all  tasks:    - name: Installs nginx web server      yum: name=nginx state=installed update_cache=true      notify:        - start nginx  handlers:    - name: start nginx      service: name=nginx state=started

“handlers” 部分与“hosts”、“tasks” 处于同一级别。handlers就像任务，但它们只有在客户端系统发生了更改的任务被告知时才运行。

例如，我们在这里有一个handlers，在安装软件包后启动Nginx服务。除非 “Installs nginx web server” 任务导致系统更改，否则不会调用处理程序，这意味着包必须安装，并且之前没有被安装。

我们将上述内容保存一个nginx_install.yml 文件中。

　　本文中文属于作者原创，转载请注明出处。：

2. 运行Ansible-playbook

一旦你制作了一个playbook.yml，可以使用这种格式轻松地调用：

ansible-playbook playbook.yml

例如，如果我们想在所有的主机上安装和启动Nginx，我们可以使用上面的nginx_install.yml，运行以下命令：

[root@ansibler task]# ansible-playbook nginx_install.yml

执行完成后会输出以下信息：

[root@ansibler task]# ansible-playbook nginx_install.ymlPLAY [all] *********************************************************************TASK [setup] *******************************************************************ok: [192.168.30.177]ok: [192.168.30.176]TASK [Installs nginx web server] ***********************************************changed: [192.168.30.176]changed: [192.168.30.177]RUNNING HANDLER [start nginx] **************************************************changed: [192.168.30.177]changed: [192.168.30.176]PLAY RECAP *********************************************************************192.168.30.176             : ok=3    changed=2    unreachable=0    failed=0192.168.30.177             : ok=3    changed=2    unreachable=0    failed=0

从上面可以看出，ansible 的任务是按顺序来执行的，并且每个任务执行都会显示该任务的名称及状态，便于我们了解当前任务的执行状态。在结尾处，是每个任务的状态统计。

上面我们指定了运行playbook的主机为所有hosts 列表中的主机，如果需要指定某些主机可以使用 -l 选项，如下：

ansible-playbook -l 192.168.30.176 nginx.yml

3.增加一些功能到playbook 中

接着上面的nginx_install 文件，继续。上面的剧本是服务器安装了软件，并正常运行。我们可以向 palybook中添加任务来扩展功能。

添加nginx默认首页

我们可以通过添加几行内容来，告诉它将文件从我们的Ansible服务器传输到选定的主机上，完整内容如下：

---- hosts: all  tasks:    - name: Installs nginx web server      yum: name=nginx state=installed update_cache=true      notify:        - start nginx    - name: Upload default index.html for host      copy: src=static_files/index.html dest=/usr/share/nginx/html/ mode=0644  handlers:    - name: start nginx      service: name=nginx state=started

然后我们可以在我们ansible 主机的当前目录中创建一个名为static_files的目录，并将一个index.html文件放在其中。

mkdir static_files

index.html文件内容如下：

This is a sample page

Here is a heading!

Here is a regular paragraph. Wow!

现在，当我们重新运行playbook时，Ansible会检查每个任务。它会看到Nginx已经安装在选定主机上，所以它会进行下一步。并看到新的任务部分，然后将我们的服务器中的index.html文件替换选定主机上默认的index.html文件。

4.注册结果

当我们手动安装和配置服务时，几乎总是需要知道当前的操作是否成功。我们可以通过使用“register”，把这个功能放到我们的palybooks中。对于每个任务，我们可以选择将其结果（失败或成功）注册在我们稍后可以检查的变量中。

当使用这个功能时，我们还必须告诉Ansible忽略该任务的错误，因为如果发生任何错误或异常，它会中止该剧本的执行。因此，如果我们想检查任务是否失败或者不决定后续的步骤，我们可以使用 register 功能。

例如，index.php如果文件存在，我们可以让我们的playbooks上传index.php文件。如果该任务失败，我们可以尝试上传index.html文件。我们将检查任务中的失败情况，因为我们只想在PHP文件失败时上传HTML文件：

---- hosts: all  tasks:    - name: Installs nginx web server      yum: name=nginx state=installed update_cache=true      notify:        - start nginx    - name: Upload default index.html for host      copy: src=static_files/index.php dest=/usr/share/nginx/html/ mode=0644      register: php      ignore_errors: True    - name: Remove index.html for host      command: rm /usr/share/nginx/html/index.html      when: php|success    - name: Upload default index.html for host      copy: src=static_files/index.html dest=/usr/share/nginx/html/ mode=0644      when: php|failed  handlers:    - name: start nginx      service: name=nginx state=started

备注:

目前nginx web环境中还不能处理PHP文件

上述的playbooks版本，尝试将index.php文件上传到选定的主机上。并将该任务的成功或者失败注册到名为“php”的变量中。

a.如果此操作成功，则接下来运行删除index.html文件的任务。（该删除操作的前提是index.html 存在于playbooks中选定的主机上）

b.如果此操作失败，则会上传index.html文件。