puppet简介及配置（入门）

LXY3800

　　Puppet官网：https://puppetlabs.com
　　Puppet简介：
　　

    Puppet是开源的基于Ruby的系统配置管理工具，依赖于C/S的部署架构。puppet使用跨平台语言规范，管理配置文件、用户、软件包、系统服务等内容，在puppet里这些内容都被看做是“资源”，每种资源都有对应的属性，如软件包有安装不安装的属性，文件有权限属性等。Puppet的代码主要由这些资源和其属性组成。其代码化的好处：分享，保存，快速的恢复和部署。　　

    Puppet客户端默认每半小时连接一次服务器端（此时puppet客户端进程工作在后台模式，也可根据需要手动执行），从服务器端下载最新的配置文件,并且严格按照配置文件来配置服务器. 配置完成以后,puppet客户端可以反馈给服务器端一个消息. 简单流程可如下图:　　

　　

    NOTE：/etc/puppet目录存放着puppet的配置文件及代码，因此可将/etc/puppet整个目录放在svn上，管理员编写puppet代码至svn服务器，puppetmaster可每隔一段时间svn update puppet代码至puppetmaster本地，再传送给client执行。（本文演示未涉及svn）　　

　　Puppet安装：
　　

1：安装前准备  　　

  (1):主机名    　　

   服务器端：/etc/hostname　　

• server.puppet.com
  

　　

   客户端：/etc/hostname 　　

• client.puppet.com
  

　　

　　
(2):添加解析:
　　

   服务器端:/etc/hosts 　　

• 192.168.1.93    client.puppet.com
  

　　

   客户端:/etc/hosts 　　

• 192.168.1.92    server.puppet.com
  

　　

　　
(3):同步时间
　　

　　

2：安装puppet（OS：ubuntu server 12.04）    　　

   服务器端：　　

• $ sudo apt-get install puppet puppetmaster
  

　　

   客户端：　　

• $ sudo apt-get install puppet
  

　　

   NOTE：apt-get方便快捷一步到位，当然你也可源码安装依次安装ruby，facter，puppet。详情参照官网：http://docs.puppetlabs.com/guides/installation.html此处不再详述。　　
Puppet工作原理：（此图by：守住每一天）

　　

　　

   （1）客户端puppetd向master发起认证请求。或使用带签名的证书    　　

　　

   （2）master告诉client你是合法的。    　　

　　

   （3）客户端puppetd调用facter，facter探测出主机的一些变量，例如主机名，内存大小，ip地址等。pupppetd 把这些信息通过ssl连接发送到服务器端 　　

　　

   （4）服务器端的puppetmaster 检测客户端的主机名，然后找到manifest里面对应的node配置，并对该部分内容进行解析，facter送过来的信息可以作为变量处理，node牵涉到的代码才解析，其他没牵涉的代码不解析。解析分为几个阶段，语法检查，如果语法错误就报错。如果语法没错，就继续解析，解析的结果生成一个中间的“伪代码”(catelog)，然后把伪代码发给客户端　　

   （5）客户端接收到“伪代码”，并且执行。 　　

　　
（6）客户端在执行时判断有没有file文件，如果有向fileserver 发起请求。
　　

   （7）客户端判断有没有配置report。如果配置把执行结果发送给服务器。　　

   （8）服务器端把客户端的执行结果写入日志。并可以发送给报告系统(DashBoard)　　

　　Puppet验证证书：
　　

   客户端:　　

　　

• $ sudo puppetd --test --server server.puppet.com
  

　　

　　

   服务器端:　　

• $ sudo puppetca --list
  
• $ sudo puppetca -s -a          #给所有请求签名
  

　　

   NOTE：puppet的客户端和服务器通过ssl连接,在服务器端上一个自签名的根证书,在安装软件的时候自动生成.因此在安装软件以前须设置好主机名,生成证书的时候要把主机名写入证书,如果证书生成后再改主机名,会导致无法通信.每个客户端的证书要经过根证书的签名才能和服务器连接.所以要执行以上命令,请求证书=>签发证书        　　

   NOTE：自动签名：创建/etc/puppet/autosign.conf文件，添加*.puppet.com一行。根据实际情况，修改客户机对应的域名.puppet会检查证书请求是否匹配该配置文件的任何一行,客户端端主机如匹配*.puppet.com,puppetmaster都会自动签名。（因只要主机名匹配，master都会信任，此为潜在的安全问题，不建议使用）　　


Puppet目录结构（/etc/puppet）：　　

• |-auth.conf                     #认证配置文件
  
• |-puppet.conf                   #主配置文件
  
• |-fileserver.conf               #文件服务器配置文件
  
• |-autosign.conf                 #自动验证配置文件
  
• |‘-manifests                    #puppet代码文件存储目录
  
•     |‘-nodes                    #节点配置目录
  
•          |-node1.pp             #节点1配置文件
  
•     |-site.pp                   #入口文件，定义变量，默认配置等
  
•     |-modules.pp                #加载模块
  
• |‘-modules                      #模块配置目录，其下一个目录相当于一个模块，如mysql
  
•     |‘-mysql                    #mysql模块，一般有files，manifests，templates三个子目录
  
•          |‘-files               #文件存储目录，如my.cnf
  
•               |-my.cnf
  
•          |‘-manifests           #模块配置代码所在目录，其下必须有init.pp文件
  
•               |-init.pp
  
•          |‘-templates           #针对此模块模板目录
  
• |‘-templates                    #模板目录
  

　　

　　Puppet的几个常见资源：
　　

（1）文件：管理系统文件 　　

• file {
  
•     "/etc/mysql/my.cnf":
  
•     source => "puppet:///mysql-server/my.cnf",
  
•     owner => root,
  
•     group => root,
  
•     mode => 0644;
  
• }
  

　　

　　

   NOTE：上面的代码是让/etc/mysql/my.cnf这个文件权限保持644，并且属于root用户root组，第二行为资源的title，默认和文件的名字相同，source是指定文件复制到客户端并覆盖已有的文件，上面代码定义的source代码也可这样写source=>"puppet://$fileserver/mysql-server/my.cnf",此处的mysql-server指的是定义在fileserver.conf中的一个模块所对应的全路径.这里需要知道fileserver.conf的配置：　　

• $ vim fileserver.conf                         #添加如下行:
  
• [mysql-server]
  
•   path /etc/puppet/modules/mysql-server/files #指定文件所在的目录
  
•   allow *                                     #可配置allow，deny做限制，支持使用主机名，IP，
  
•                                                及通配符，此处为方便，允许所有主机
  

　　

   通过fileserver.conf的定义，代码source =>"puppet:///mysql-server/my.cnf"所指定的路径可以解析为/etc/puppet/modules/mysql-server/files/my.cnf，代码source => "puppet:///mysql-server/my.cnf"中的mysql-server可简单理解为等价于/etc/puppet/modules/mysql-server/files　　

（2）软件包：管理软件包的安装升级和删除。 　　

• package {
  
•       ["nginx","mysql-server"]:
  
•       ensure => installed;
  
•       ["vim"]:
  
•       ensure => absent;
  
• }
  

　　

   NOTE：该资源的主要是ensure，表示该软件包应该在什么状态。installed 表示要安装该软件,也可以写成present; absent表示卸载该软件　　

（3）服务：管理系统服务（启用，禁用，重启等） 　　

• service {
  
•     "mysql":
  
•     enable => true,
  
•     ensure => running;
  
•     "nginx":
  
•     ensure => stopped;
  
• }
  

   NOTE:enable表示服务在开机的时候是否启动,可以设置的值是true和false;　　

        ensure表示是否运行服务, running表示运行服务,stopped 表示停止服务　　

（4）Exec：执行外部命令 　　

• exec {
  
•     "set mysql root password":
  
•     path => "/usr/bin",
  
•     unless => "mysql -uroot -p$root_mysql_password",
  
•     command => "mysqladmin -u root password $root_mysql_password";
  
• }
  

　　

   NOTE:path：命令执行的搜索路径。如果path没有被定义，命令需要使用绝对路径。路径可以以数组或以冒号分隔的形式来定义。　　

        unless:如果unless所设定的命令返回0，此定义的资源将不被执行         　　

        command:将会被执行的命令，必须为被执行命令的绝对路径，或者得提供该命令的搜索路径更多资源介绍请访问puppet官网或者puppet中文维基：http://puppet.wikidot.com/ 　　

　　Puppet资源间的关系：
　　

(1)puppet 资源之间简单依赖关系: 　　

　　
before：在某个资源之前执行
　　

   after：在某个资源之后执行     　　

   require：某个资源必须存在或者正确执行后，才执行相应的资源。  　　

(2)puppet 资源之间触发更新:     　　

   notify：用来通知某个资源进行更新     　　

   subscribe：该资源有更新时，通知另一个资源执行相应的动作 　　

　　Puppet类：
　　

作用：把一组资源收集到一个盒子里面，一起使用，其他地方要用到直接包含此个类就可以，便于维护。例：　　

• class ssh {
  
•         package {
  
•                 [ "openssh-server" ]:
  
•                 ensure => installed;
  
•         }
  
• 
  
•         file {
  
•                 "/etc/ssh/sshd_config":
  
•                 mode => 0644,
  
•                 owner => root,
  
•                 group => root,
  
•                 source => "puppet://$fileserver/ssh/sshd_config",
  
•                 require => Package["openssh-server"];       #在指定的Packgae资源执行成功后再执行此File资源
  
•         }
  
• 
  
•         service {
  
•                 "ssh":
  
•                 ensure => running,
  
•                 require => Package["openssh-server"],
  
•                 subscribe => File["/etc/ssh/sshd_config"];   #sshd_config文件有变动，重启ssh服务，使其生效
  
•         }
  
• }
  

　　

　　Puppet节点：
　　

puppet用来区分不同的客户端，并且给不同的服务器端分配manifest.例：　　

• node 'host1.puppet.com' {
  
•            include ssh                           #此处的ssh指的是定义的ssh类
  
• }
  
• node 'host2.puppet.com' {
  
•            include apache,mysql,ssh
  
• }
  

　　

　　Puppet模块：
　　

  (1):一个模块包含/etc/puppet/modules目录下的一个目录和它的子目录,通常一个模块目录下面含三个目录files,manifests,templates.    　　

  (2):在puppet的主文件site.pp里面可以用import modulename可以插入模块。新版本的puppet可自动插入modules目录下的模板。引入模块，可以结构化代码，便于分享，保存，及管理    　　

  (3):manifests里面必须包含一个init.pp的文件,为此模块的初始文件.    　　

  (4):files目录是该模块的文件发布目录,    　　

  (5):templates包含erb模型文件。　　

　　一个完整示例：
　　

（1）修改主机名，hosts文件，同步时间  　　

（2）服务器端安装好puppet，puppetmaster；客户端安装好puppet  　　

（3）客户端请求签名，服务器端签名  　　

（4）/etc/puppet下代码的配置 　　

• $ cd /etc/puppet
  
• 
  
• #modules目录配置：
  
• $ sudo mkdir -pv modules/mysql-server/{files,manifests,templates} #创建模块目录及其子目录
  
• $ cd /etc/puppet/modules/mysql-server/files/
  
• $ sudo vim my.cnf                                         #此文件配置好，放在files目录下即可
  
• ...
  
• ...
  
• $ cd /etc/puppet/modules/mysql-server/manifests/
  
• $ sudo vim init.pp                                        #模块的主配置文件，添加如下行：
  
• #mysql-server install and set psaaword
  
• #
  
• class mysql-server {
  
•         package {
  
•                 [ "mysql-server","mysql-client" ]:
  
•                 ensure => installed;
  
•         }
  
•         file {
  
•                 "/etc/mysql/my.cnf":
  
•                 source => "puppet://$fileserver/mysql-server/my.cnf",
  
•                 owner => root,
  
•                 group => root,
  
•                 mode => 0644,
  
•                 require => Package[ "mysql-server","mysql-client" ];
  
•         }
  
•         service {
  
•                 "mysql":
  
•                 ensure => running,
  
•                 require => File[ "/etc/mysql/my.cnf" ],
  
•                 subscribe => File[ "/etc/mysql/my.cnf" ];
  
•         }
  
•         exec {
  
•                 "set mysql root password":
  
•                 path => "/usr/bin",
  
•                 unless => "mysql -uroot -p$root_mysql_password",
  
•                 command => "mysqladmin -u root password $root_mysql_password",
  
•                 require => Service['mysql'];
  
•         }
  
• }
  
• 
  
• #manifests目录下配置：
  
• $ cd /etc/puppet/manifests
  
• $ sudo vim site.pp                      #puppet入口文件配置，添加如下行：
  
• $fileserver = "server.puppet.com"      #puppet变量定义，注意$
  
• $root_mysql_password = "123456"
  
• node default {
  
•         file {
  
•                 "/tmp/test1.txt":
  
•                 content => "hello";
  
•         }
  
• }
  
• import "modules.pp"
  
• import "node*.pp"
  
• 
  
• $ sudo vim modules.pp                   #导入模块配置，添加如下行：
  
• import "mysql-server"
  
• 
  
• $ sudo vim node1.pp                     #节点配置文件，添加如下行：
  
• node 'client.puppet.com' {
  
•         include mysql-server
  
• }
  
• 
  
• #文件服务器配置：
  
• $ cd /etc/puppet
  
• $ sudo vim fileserver.conf              #文件服务器配置文件，添加如下：
  
• [mysql-server]
  
•     path /etc/puppet/modules/mysql-server/files
  
•     allow *
  

　　

（5）在客户端执行如下命令：mysql就会在客户端下安装（如想让puppet以守护进程运行，去掉--test参数即可，puppetd命令的详细参数请参照：puppetd --help） 　　

• $ sudo puppetd --test --server server.puppet.com
  

　　

至此puppet已配置完毕，此篇内容，主要针对入门级简单应用，更多的puppet的语法，如puppet函数（puppet称之为define），数组，以及puppet的更高级的内容，如和nginx结合puppet做集群等等，本文并未涉及，有兴趣的同学可参考puppet官方文档。