基于rubby开发，C/S架构，支持多平台，可管理配置文件，用户,cron任务，用户软件包，分为社区版和企业版，企业版收费，支持图形界面

1. 准备工作

两台机器：
10.10.13.248（服务端）
10.10.13.247 （客户端）
两台机器关闭selinux，清空iptables规则，并保存，设置hostname

248上
hostname   master.river.com
编辑/etc/sysconfig/network  定义hostname

247上
hostname   client.river.com
编辑/etc/sysconfig/network  定义hostname
重启服务器

编辑hosts文件
248和247全部为
10.10.13.248  master.river.com
10.10.13.247   client.river.com


安装ntpdate，并建立自动同步时间的任务计划：
yum install -y ntp
cront -e   #加入
*/10  * * * * ntpdate time.windows.com >/dev/null 2>&1 

#如果不添加日志输出日志系统默认会发邮件

2.  服务端安装

安装puppet 源
rpm -ivh  "http:#yum.puppetlabs.com/el/6/products/x86_64/puppetlabs-release-6-7.noarch.rpm"

安装服务端程序
yum install -y puppet-server
启动服务
service  puppetmaster start

开机启动
chkconfig  puppetmaster on

3. 客户端安装

安装puppet 源
rpm -ivh "http:#yum.puppetlabs.com/el/6/products/x86_64/puppetlabs-release-6-7.noarch.rpm"

安装客户端程序
yum install -y puppet

修改配置文件
vim  /etc/puppet/puppet.conf
在[agent]底下添加：
listen = true
server = master.river.com
runinterval = 30   #主动更新，每隔30s

然后启动puppet服务
/etc/init.d/puppet start

4. 配置认证（服务端查看，签发客户端的证书）

手动生成ssl证书
puppet agent  --test  --server  master.river.com   #服务端也生成证书将它同时也当成一个客户端，需要在客户端操作

服务端查看有哪些客户端证书，可以发起认证请求

puppet cert list    #列出没有签名的证书

puppet cert list --all   #列出所有证书

会看到client.river.com 的key，正常应该会在行首有一个+，如果没有说明还没有签发

签发客户端（签名后服务端才承认你是合法的可以认证的）   
puppet cert --sign client.river.com

5、删除证书重新签发

服务端上删除客户端证书

puppet cert clean --all 删除所有证书

puppet cert clean client.river.com
停止客户端服务

/etc/init.d/puppet stop

客户端上删除ssl下的文件   
rm -rf /var/lib/puppet/ssl/*    #如果不清空则重新生成时会出错

重启客户端服务(自动重新生成证书)

/etc/init.d/puppet  start 

重新列出客户端

puppet cert list --all    

重新签发客户端   

puppet cert --sign client.river.com

6. 配置自动签发证书

服务端上删除客户端证书

puppet cert clean --all     

客户端上删除ssl下的文件   
rm -rf /var/lib/puppet/ssl/*                    

服务端更改配置文件
vim /etc/puppet/puppet.conf

在[main]下面加一行
autosign = true

服务端创建自动签发的配置文件
vim /etc/puppet/autosign.conf
加入如下内容：
*.river.com 

重启puppetmaster服务
/etc/init.d/puppetmaster restart

客户端重启puppet服务
/etc/init.d/puppet restart

这样就能在服务端上自动签发证书了。当然不重启服务，手动连一下服务端也可以
客户端执行：
puppet agent --test --server  master.river.com


7. 测试
服务端上
vim /etc/puppet/manifests/site.pp
加入如下内容：


node default {
file {
"/tmp/123.txt": content => "test,test";
}
}

#第一次新建测试文件需要重启服务端服务
客户端上
puppet agent --test --server  master.river.com这样会在客户端上生成一个 /tmp/123.txt的文件，并且内容为 testtest

可以测试将认证删除后再同步看是否可以同步

8. 模块管理

首先要理解几个概念，模块、类、资源。 模块是puppet的最大单元，模块里面有类，类下面有资源。 puppet管理的文件、用户、服务、任务计划等全部由这些单元组成。

下面我们来定义一个模块：
在服务端上做如下操作：
mkdir /etc/puppet/modules/testm  #创建一个模块
cd !$
mkdir {files,manifests,templates}   #一个模块下需要有这三个目录，files存一些文件（可以为空），manifests存配置文件，templates存模板（可以留空）


在files目录下创建要同步的文件

vim /files/river.txt 

hello

this is my txt file


touch manifests/init.pp  #这个是必须的
vim  manifests/init.pp       #内容如下
class testm{                  #定义一个类叫testm
file {"/tmp/2.txt":         #表示需要在客户端同步生成的文件,file表示资源
owner => "root",
group => "root",
mode => 0400,
source => "puppet:#$puppetserver/modules/testm#river.txt"   #表示服务端的需要被同步的文件，此时river.txt是指files文件夹里面的river.txt
}
}


说明：类名字也叫做testm, 类下面定义了一个资源file，文件名字叫做/tmp/2.txt ，owner，group，mode定义文件的属主、数组以及权限，source定义这个文件从哪里获取。 $puppetserver一会也要定义一下，这里指的是puppet server服务器上/etc/puppet/modules/testm/files/river.txt

下面要继续定义一个很关键的配置文件：
vim  /etc/puppet/manifests/site.pp    #总入口配置文件
$puppetserver = 'master.river.com'
node 'client.river.com'{                    #此处的节点需要用puppet cert list --all 查看，不一定是客户端的全名，以服务端查看到的为准
    include testm                               #此处Include属于一个类
}

说明：$puppetserver 定义服务端的主机名，node后面为客户端的主机名，这里面定义该客户端要加载的模块
配置完成后，在客户端执行命令：
puppet agent --test  --server=master.river.com   #如果客户端上启动了puppet服务，不用执行这命令，它也会自动同步的

9、同步文件或目录资源

在主模块配置文件init.pp中增加如下类
class apache{
file {"/usr/local/apache2":   #客户端需要同步生成的目录
owner => "root",
group => "root",
source => "puppet:#$puppetserver/modules/testm/apache2",
recurse => true,               #跟cp -r一样，如果是针对拷贝目录的需要开启
purge => true                  #当服务端的需要同步的文件或目录更改、添加、删除后，客户端也同步更改、添加、删除
      }
}

在服务端的files文件夹中创建apache文件夹，再创建aphache的子文件夹（bin,conf,log），在子文件夹bin下创建apachectl文件，在conf中创建apache.conf文件

在puppet主配置文件/etc/puppet/manifests/site.pp增加类

在include testm底下增加  include apache

然后看客户端的/usr/loca/目录底下是否同步了apache2文件夹及子文件夹

可以看到客户端已成功同步apache2文件夹及子文件夹

在服务端对子文件夹进行更改或删除操作客户端也可以成功同步


其中recurse=>true 这个参数很关键，它表示递归的意思，没有这个不能同步目录。purge参数可以保证当服务端删除某个文件，客户端可以跟着删除。

10、puppet远程执行命令

在apache类底下创建资源

vim /etc/puppet/modules/testm/manifests/init.pp

在

file {"/usr/local/apache2":

owner => "root",

group => "root",

source => "puppet:#$puppetserver/modules/testm/apache2",

recurse => true,

purge => true

底下增加：

exec {"123":       #远程执行命令的名字

unless => "test -f /tmp/mylinux.txt",     #unless表示条件，表示mylinux.txt不是文件或这个文件不存在时,相反的条件写成onlyif

path => ["/bin", "/sbin", "/usr/bin", "/usr/sbin"],  #path表示环境变量

command => "/bin/touch /tmp/mylinux.txt"

}

测试：可以看到在客户端已经成功在/tmp目录下生成mylinu.txt文件

11、远程执行定时任务

同样在apache类下创建资源

vim /etc/puppet/modules/testm/manifests/init.pp

cron {"river":
command => "/sbin/ntpdate time.windows.com",
user => "root",
minute => "*/10",
# ensure => "absent"  #当增加了这行配置，则会把该cron删除掉
}

说明：分时日月周分别对应puppet里面的minute，hour，monthday，month，weekday

测试：客户端已经成功添加一条时间同步任务