zoukankan      html  css  js  c++  java
  • puppet的使用:ERB模板介绍

    ERB介绍

    全称是Embedded RuBy,意思是嵌入式的Ruby,是一种文本模板技术,用过JSP的话,会发现两者语法很像。
    我们项目中一般用ERB来产生各模块的配置文件。ERB模板也可以用来产生Web页面(之前搞过一段时间ROR开发,模板用的haml),也可以用来产生其他文件。

    <% %>与<%= %>

    <%Ruby脚本%>,一般是Ruby的逻辑脚本,但是不会写入到目标文件中。
    <%= Ruby脚本%> ,脚本的执行结果会写入到目标文件中。
    举例如下(代码来源):
    这段代码是从Hash中读取信息创建sql语句保存到文件中。

    require "erb"  
    domains = {...}  
    sqlTemplate = ERB.new %q{  
    <%for organization in domains.keys%>  
        insert into org_domain(Domain, organization) values('<%=domains[organization]%>','<%=organization%>');  
    <%end%>  
    }  
    sqlFile = File.new("./sql.sql", "w")  
    sqlFile.puts sqlTemplate.result 
    

    使输出紧凑

    <%= -%>

    You can trim line breaks after expression-printing tags by adding a hyphen to the closing tag delimiter.

    • -%> — If the tag ends a line, trim the following line break.

    意思是如果<%= -%>表达式中,-%>是一行的结尾,会忽略后面的换行。

    <%- -%>

    You can trim whitespace surrounding a non-printing tag by adding hyphens (-) to the tag delimiters.

    • <%- — If the tag is indented, trim the indentation.
    • -%> — If the tag ends a line, trim the following line break.

    意思是<%-前面是空白符时,会删除这些空白符;-%> 含义同上。

    puppet中一般怎么使用erb

    举例如下:

    目录结构

    ~/tmp# tree -L 2 puppet
    puppet
    ├── manifests
    │     ├── nodes
    │     └── site.pp
    └── modules
        ├── xxx
        └── nginx
    

    这里是大的目录结构。


    manifests的内容如下:

    ~/tmp/puppet# tree -L 2 manifests
    manifests
    ├── nodes
    │   ├── controller-192-41-1-185.pp
    │   ├── controller-192-41-1-186.pp
    │   ├── controller-192-41-1-187.pp
    │   ├── controller-192-41-1-191.pp
    │   └── controller-192-41-1-202.pp
    └── site.pp
    

    这里每个.pp文件是对应每个agent节点的定义,具体内容见下一节。


    每个模块下的内容类似,现在只以nginx举例。

    ~/tmp/puppet/modules# tree -L 3 nginx/
    nginx/
    ├── files
    │   ├── xxxClientCert.jks
    │   ├──xxxServerCert.jks
    │   ├── README.md
    │   ├── server.crt
    │   └── server.key
    ├── manifests
    │   ├── config.pp
    │   ├── init.pp
    │   ├── params.pp
    │   └── service.pp
    └── templates
        └── conf.d
            ├── nginx.conf.erb
            ├── ssl_restart_oms.sh.erb
            ├── web-hedex.xml.erb
            └── web.xml.erb
    

    具体模块的manifests目录下是各个类的定义,templates定义了各个模板,模板会在manifests下的类中被引用。

    类的定义


    ~/tmp/puppet/manifests# cat site.pp 
    import 'nodes/*.pp'
    $puppetserver='controller-192-41-1-191'
    

    下面是一个node的定义:

    ~/tmp/puppet/manifests/nodes# cat controller-192-41-1-191.pp 
    node 'controller-192-41-1-191' {
      $xxx = "true"
     #这里是各种变量的定义
      Class['aaa']->Class['bbb']->Class['ccc']->Class['nginx']->Class['ddd']
      include aaa,bbb,ccc,nginx,ddd
    }
    

    模板中使用的变量就是来自这里的定义。


    总结如下
    nginx/manifests下的各个pp文件是各个类的定义,类的定义中使用了nginx/templates中定义的模板,这些类被controller-192-41-1-191.pp 文件引用,controller-192-41-1-191.pp 文件中定义了模板中使用的变量。

    访问puppet 变量

    模板可以访问puppet的变量,这是模板的主要数据来源。
    一个ERB模板有自己的本地作用域,它的父作用域是引用该模板的类。这意味着,模板可以使用短名称访问父类中的变量,但是不能向父类中添加新的变量。
    在ERB模板中,有两种方式访问变量。

    • @variable
    • scope['variable'] (旧的形式为:scope.lookupvar('variable'))

    @variable

    原文:

    All variables in the current scope (including global variables) are passed to templates as Ruby instance variables, which begin with “at” signs (@). If you can access a variable by its short name in the surrounding manifest, you can access it in the template by replacing its $ sign with an @. So $os becomes @os, $trusted becomes @trusted, etc.

    当前作用域的所有变量(包括全局变量)都会以Ruby实例变量的形式传给模板。如果你在模板中可以使用短名称访问一个变量,你就可以使用"@"代替"$"。所以,$os就变成了@os,$trusted就变成了@trusted。
    这是访问变量最直接清晰的方式,但是这种方式不能访问其他作用域的变量,需要访问其他作用域的变量时,你需要使用下面的方式。

    scope['variable'] or scope.lookupvar('variable')

    Puppet可以使用对象scope来以散列表的方式访问变量。例如,访问$ntp::tinker你可以使用scope['ntp::tinker']这种形式。
    还有另一种方式使用scope对象,就是通过它的lookupvar方法来访问变量,该方法需要传入要访问的变量名,例如,scope.lookupvar('ntp::tinker')。这和上面的方式效果是一样的,但是使用起来没有scope['ntp::tinker']更简洁直观。

    puppet类型和Ruby类型的对应关系

    这部分表格,就不翻译了,直接贴图。

    未定义变量

    如果一个puppet变量没有定义的话,它的值是undef,意思是,在模板中它的值是nil。
    含义是Puppet变量值为undef,对应Ruby变量值为nil。

    在模板中使用puppet函数

    • 所有的函数都以scope对象的方法调用;
    • 函数名的开头都必须加上前缀"function_";
    • 函数的参数必须以数组的形式传递,即使只有一个参数。
      例如,在一个模板中引用另一个模板:

    <%= scope.function_template(["my_module/template2.erb"]) %>

    参考
    Language: Embedded Ruby (ERB) template syntax

  • 相关阅读:
    给读者、学生、初学者的话(不管你买哪一本计算机书,都适用)
    [回忆]我是怎么落进「写程序」这个大火坑的?
    CF1093E [Intersection of Permutations]
    CF712E [Memort and Casinos]
    CF1093G [Multidimensional Queries]
    FFT与一些冷门问题
    平面图转对偶图&19_03_21校内训练 [Everfeel]
    19_03_26校内训练[魔法卡片]
    洛谷 P4515 [COCI20092010#6] XOR
    NTT模板(无讲解)
  • 原文地址:https://www.cnblogs.com/cuimiemie/p/6442695.html
Copyright © 2011-2022 走看看