一、Ansible Jinja2模板背景介绍

目前Nginx的配置文件在所有的服务器上都是相同的,但我希望能根据每一台服务器的性能去定制服务的启动进程。
同时定制每一台Nginx服务的响应头，以便于当某台服务出现问题时能快速定位到具体的服务器。
要做这样的定制势必会导致一个问题，Nginx 在每台物理服务器上的配置文件都不一样，这样的配置文件如何管理呢?
再使用copy 模块去做管理显然已经不合适。此时使用Ansible 提供的另一个模板(template) 功能，它可以帮助我们完美的解决问题。

二、Jinja2模板

要学会Ansible 中的模板(template)使用，前提我们必须要学会JinJa2模板。学会了它，就相当于我们学会了Ansible 模板。

1.JinJa2 是什么

Jinja2是基于Python书写的模板引擎。功能比较类似于PHP的smarty模板。

2.Jinja2必知必会

1、jinja2 文件以 .j2 为后缀，也可以不写后缀。
2、jinja2 中存在三种定界符

注释: {# 注释内容 #}
变量引用: { { var }}
逻辑表达: {% %}

3.Jinja2逻辑控制

3.1 条件表达

{
    
    % if %}
...
...
{
    
    % endif %}

Example

{
    
    # 如果定义了 idc 变量， 则输出 #}
{
    
    % if idc is defined %}
{
    
    {
    
    idc}}
{
    
    % else if %}
{
    
    % endif %}

3.2 循环控制

{
    
    % for %}
...
...
{
    
    % endfor %}

Example

{
    
    # 列举出 db-servers 这个 group 中的所有主机 #}
{
    
    % for host in groups['db-servers'] %}
{
    
    {
    
     host }}
{
    
    % endfor %}

{
    
    #与Python 语法不通，模板中的循环内不能break或continue。但你可以在迭代中过滤序列来跳过某些项#}
{
    
    #打印db-servers 组中的所有主机，但是不打印1.1.1.1 这台主机#}
{
    
    % for host in groups['db-servers'] if host != "1.1.1.1" %}
{
    
    {
    
    host}}
{
    
    % endfor %}

三、如何使用模板

一个基于Facts的Jinja2 实例

# cat config.j2
{
    
    # use variable example #}
welcome host {
    
    {
    
     ansible_hostname }}, os is {
    
    {
    
     ansible_os_family }}

{
    
    # use condition example #}
{
    
    % if ansible_processor_vcpus > 1 %}
OS CPU more than one core
{
    
    % endif %}

{
    
    % for m in ansible_mounts if m['mount'] != "/" %}
mount {
    
    {
    
     m['mount'] }}, total size is {
    
    {
    
    m['size_total']}}, free size is {
    
    {
    
    m['size_available']}}
{
    
    % endfor %}

如何在Ansible 中使用模板

# cat usejinja2.yml
---
- name: a template example
  hosts: all
  remote_user: root
  tasks:
    - name: update jinja2 config
      template: src=config.j2 dest=/tmp/config.conf

验证：
[root@server ~]# ansible-playbook -i hosts usejinja2.yml

在这里插入图片描述
实例演示
Jinja2 模板以及如何在Ansible中使用模板，已经介绍完了。那么如何去实现我们的需求呢?

# cat nginx.conf.j2
user              www;
{
    
    # start process equal cpu cores #}
worker_processes {
    
    {
    
     ansible_processor_vcpus }};   //内置变量

error_log  /var/log/nginx/error.log;
pid        /var/run/nginx.pid;

events {
    
    
    worker_connections  1024;
}

http {
    
    
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    sendfile        on;
    tcp_nopush     on;

    keepalive_timeout  0;

    gzip on;
    gzip_min_length  1k;
    gzip_buffers     8 64k;
    gzip_http_version 1.0;
    gzip_comp_level 5;
    gzip_types   text/plain application/x-javascript text/css application/json application/xml application/x-shockwave-flash application/javascript image/svg+xml image/x-icon;
    gzip_vary on;
    {
    
    # add_header {
    
    {
    
     ansible_hostname }}; #}
    add_header x-hostname {
    
    {
    
     ansible_hostname  }};

    include /etc/nginx/conf.d/*.conf;
}

继续优化我们的PlayBook，让它支持模板

---
- name: task control playbook example
  hosts: webservers
  wars:
    createuser:
      - tomcat
      - www
      - mysql
  tasks:
    - name: create user
      user: name={
    
    {
    
     item }} state=present
      with_items: "{
    
    { createuser }}"

    - name: yum nginx webserver
      yum: name=nginx state=present
      
	# use ansible template
    - name: update nginx main config
      template:
      	src: nginx.conf.j2
      	dest: /etc/nginx/nginx.conf
      tags: update
      notify: reload nginx server

    - name: add virtualhost config
      copy: 
        src=www.biudefor.com.conf 
        dest=/etc/nginx/conf.d/
      tags: update
      notify: reload nginx server

    - name: check nginx syntax
      shell: /usr/sbin/nginx -t
      register: nginxsyntax
      tags: update
      
    - name: check nginx running
      stat: path=/var/lock/subsys/nginx
      register: nginxrunning
      tags: update
      
    - name: print nginx syntax
      debug: var=nginxsyntax

    - name: start nginx server
      service: name=nginx state=started
      when: nginxsyntax.rc == 0 and nginxrunning.stat.exists == false
  handlers:
    - name: reload nginx server
      service: name=nginx state=started
      when: nginxsyntax.rc == 0 and nginxrunning.stat.exists == false

[root@server ~]# ansible-playbook -i hosts site.yml

补充： Python2环境需要这个两个依赖包，才能正确完成安装 uwsgi python-devel 和 python2-pip

Ansible Jinja2模板 day6

Jinja2模板