puppet 安装
puppet 的核心组件： 资源
资源清单： manifests
资源清单及清单中的资源定义的所依赖的文件，模版等数据按照特定结构组织成为 模块
安装： https://yum.puppetlabs.com/
ruby环境： ruby ruby-libs ruby-shadow
master： puttet-server
slave: puppet, facter
[root@k8s1 ~]# puppet help Usage: puppet <subcommand> [options] <action> [options] Available subcommands: agent The puppet agent daemon apply Apply Puppet manifests locally ca Local Puppet Certificate Authority management. catalog Compile, save, view, and convert catalogs. cert Manage certificates and requests certificate Provide access to the CA for certificate management. certificate_request Manage certificate requests. certificate_revocation_list Manage the list of revoked certificates. config Interact with Puppet's settings. describe Display help about resource types device Manage remote network devices doc Generate Puppet documentation and references facts Retrieve and store facts. file Retrieve and store files in a filebucket filebucket Store and retrieve files in a filebucket help Display Puppet help. inspect Send an inspection report instrumentation_data Manage instrumentation listener accumulated data. DEPRECATED. instrumentation_listener Manage instrumentation listeners. DEPRECATED. instrumentation_probe Manage instrumentation probes. Deprecated key Create, save, and remove certificate keys. kick Remotely control puppet agent man Display Puppet manual pages. master The puppet master daemon module Creates, installs and searches for modules on the Puppet Forge. node View and manage node definitions. parser Interact directly with the parser. plugin Interact with the Puppet plugin system. queue Deprecated queuing daemon for asynchronous storeconfigs report Create, display, and submit reports. resource The resource abstraction layer shell resource_type View classes, defined resource types, and nodes from all manifests. secret_agent Mimics puppet agent. status View puppet server status. See 'puppet help <subcommand> <action>' for help on a specific subcommand action. See 'puppet help <subcommand>' for help on a specific subcommand. Puppet v3.8.7
获取所有的资源类型：
[root@k8s1 ~]# puppet describe --list
[root@k8s1 ~]# puppet describe package
puppet 从3个维度来对资源完成抽象
1.相似的资源被抽象成同一种资源“类型”，如程序包资源，用户资源及服务资源等；
2.将资源属性或状态的描述与其实现方式剥离开来，如仅说明安装一个程序包而不用关心具体是通过yum、pakadd、ports或其他方式实现
3.仅描述资源的目标状态，期望其实现的结果，而不是其具体过程，如“确定nginx运行起来”而不是具体描述为“运行nginx” 命令将其启动起来
这三个 也被成为puppet 的资源抽象层(RAL)
RAL 由type（类型）和 provider（提供者，即不同os上的特定实现）组成
资源的特殊属性
1. Name/Namevar 名称变量
大多数类型都有一个属性，该属性标识目标系统上的资源
被称为namevar，通常简称的名字
namevar值必须唯一每个资源类型
2. Ensure （保证，确保）
用于大多数资源中，用于控制资源的存在性。
ensure => file 存在且为一个普通文件
ensure =>directory 存在且为一个目录
ensure =>present 存在
ensure =>absent 不存在，删除
3. Metaparmeters（参数）
定义资源：
type ｛'title':
attribute1 => value1,
attribute2 => value2,
｝
type 必须小写： title在同一个资源下必须唯一：
常用的资源类型：
user，group，file，package，service，exec，cron， notify
[root@k8s1 manifest]# cat test.pp group {'distro': gid => 2000, ensure => present, } user {'centos': uid => 2000, gid => 2000, shell => '/bin/bash', home => '/home/centos', ensure => present, }
agent上执行
[root@k8s1 manifest]# puppet apply -v test.pp
group: 管理组资源：
name： 组名 ，namevar 组名 gid： GID 组id system： true，false 系统组 ensure： present, absent 建立或者删除 members：组成员， 可以在这个组中加用户
user：用户资源
commet： 注释信息 ensure： present，absent expiry： 过期时间 groups： 附加组 home： 家目录 shell： 默认shell name： namevar system： 是否是系统用户， true，false uid： UID password： 密码 gid 基本组id
file: 管理文件及其内容、从属关系以及权限：
内容可通过content属性直接给出，也可以通过source属性根据远程服务器路径下载生成：
指明文件内容来源：
content： 直接给出文件内容，支持\n \t source: 从指定位置下载文件： ensure： file,directory,links,present,absent 常用属性： force：强制运行，可用值 yes,no,true,false group: 属组 owner：属主 mode： 指明权限， '0755' 还支持u g o方式 path： 目标路径，放置的路径 source： 源文件路径，可以是本地文件路径，也可以使用puppet:///modules/modules_name/file_name
file { "/etc/nfs.conf":
source => [
"puppet:///modules/nfs/conf.$host",
"puppet:///modules/nfs/conf.$operatingsystem",
"puppet:///modules/nfs/conf"
]
}
target: 当ensure为“link”时，target表示path指向的文件是一个符号链接文件，其目标为此target属性所指向的路径，此时content source属性失败
[root@k8s1 manifest]# cat file.pp #建立一个目录 file {'/tmp/mytest': ensure => directory } #新建一个文件，并且内容是content中指定的内容，以及相关属主属组权限 file {'/tmp/puppet-test': content => "puppet-test file \n2 line\n3 line", ensure => 'file', group => 'puppet', owner => 'ftp', mode => '0777', } #copy一份文件 file {'/tmp/fatab-bak': source => '/etc/fstab', ensure => "file", } #做一个连接 file {'/tmp/puppet.target.link': ensure => 'link', target => '/etc/fstab', }
执行
# puppet apply -v file.pp
exec:
运行一外部命令，命令应该具有幂等性
1.命令本身具有幂等性,多此运行命名，不会对系统有损害， yum update
2.资源有onlyif, unless, creates 等属性以实现命令的条件式运行。
3.资源有refreshonly属性，以实现只有订阅的资源发生变化时才执行：依赖的资源改变了，才运行，如：配置文件更新
command： 运行的命令： NameVar
creates： 此属性指定的文件不存在时才执行此命令。
#creates属性 如果/var/tmp/myfile 这个文件不存在，才会执行tar 命令，cwd 先cd到/var/tmp路径下，在 解压缩。
exec { "tar -xf /Volumes/nfs02/important.tar":
cwd => "/var/tmp",
creates => "/var/tmp/myfile",
path => ["/usr/bin", "/usr/sbin"]
}
属性
cwd： 此属性指定的路径下运行命令,就是 cd 到路径下 user： 以指定的用户身份运行命令。 group： 指定组 onlyif： 给定一个测试命令：仅在此命令执行成功（返回状态码为0）时 才运行command指定的命令： unless： 给定一个测试命令：仅在此命令执行失败（返回状态码为1）时 才运行command指定的命令： refresh: 接受到其他资源发来的refresh通知时，默认是重新执行exec定义的command，refresh属性可改变这种行为，即可指定仅在refresh时运行的命令 refreshonly： 仅在收到refresh通知，才运行此资源。 refreshonly： 期望的状态返回值，返回非此值时表示命令执行失败。 tries： 尝试执行的次数， timeout： 超时时长。 path： 指明命令搜索路径，其功能类型PATH环境变量：path => ['/usr/bin','/usr/sbin'],
exec { "logrotate":
path => "[/usr/bin:/usr/sbin:/bin]",
onlyif => "test `du /var/log/messages | cut -f1` -gt 100000"
}
# unless属性，假如grep 不成功的时候,不包含root的时候，才执行命令。 exec { "/bin/echo root >> /usr/lib/cron/cron.allow": path => "[/usr/bin:/usr/sbin:/bin"], unless => "grep root /usr/lib/cron/cron.allow 2>/dev/null" }
exec { newaliases: path => ["/usr/bin", "/usr/sbin"], subscribe => File["/etc/aliases"], refreshonly => true }
[root@k8s1 manifest]# cat exec.pp exec{'modprobe ip_vs': user => root, group => root, refresh => 'modprobe -r ip_vs', timeout => 5, tries => 2, path => ['/usr/bin','/usr/sbin'], } #假如/tmp/hello.txt不存在，运行echo hello exec{'echo hello >> /tmp/hello.txt': user => root, group => root, creates => '/tmp/hello.txt', path => ['/usr/bin','/usr/sbin'], } exec{'echo hello >> /tmp/hello1.txt': user => root, group => root, unless => 'test -e /tmp/hello1.txt', path => ['/usr/bin','/usr/sbin'], }
notify: 通知信息
Sends an arbitrary message to the agent run-time log.
message: 要发送的消息的内容： NameVar
[root@k8s1 manifest]# cat notify.pp notify{'this is run-time agent log':}
cron: 计划任务：
常用属性：
ensure： present absent
command: 运行的jobs
hour： 小时
minute： 分钟
month： 月
monthday： 日
weekday： 周
name： 名称
user： 运行的用户
environment: 运行时的环境变量
cron{'sync time':
command => '/usr/sbin/ntpdate 192.168.20.220 & >/dev/null',
minute => '*/10',
user => root,
ensure => present,
}
package 管理程序包
常用属性：
configfile: 更新程序包后，老的配置文件处理方式， keep或replace
ensure: installed, latest(最新版本), version(2.3.1-2.el7), present,absent
name: 程序报名称
source： 需要指定软件包的路径或URL，如果使用rpm，需要指明包的路径。
provider 使用 包的来源（yum， rpm）
package{'zsh':
ensure => latest,
}
package{'zabbix':
ensure => installed,
source => '/tmp/rpm/zabbix22-2.2.16-1.el7.x86_64.rpm',
provider => rpm,
}
service： 管理服务
常用属性
enable： 是否开机启动，true、false。 ensure： 启动（running），停止（stopped） hasrestart： 是否支持restart参数，用来说明当前的程序自带restart功能 hasstatus： 是否支持status参数 name： 服务名称，namevar path： 脚本查找路径 pattern： 用户搜索此服务相关的进程的模式： 当脚本不支持restart/status时，用于确定服务是否处于运行状态 restart： 用于执行 重启 命令，如果不支持hasrestart，那么使用restart定义，先kill，然后在启动 start： 用于执行启动命令 stop： 用于执行停止命令 status： 用于执行状态检查命令
package{'nginx':
ensure => latest,
allow_virtual => false,
}
service{'nginx':
ensure => running,
enable => true,
hasrestart => true,
hasstatus => true,
restart => 'systemctl reload nginx.service'
}
#############################################################
package{'zabbix22-agent':
ensure => latest,
allow_virtual => false,
}
service{'zabbix-agent':
ensure => running,
enable => true,
hasrestart => true,
hasstatus => true,
restart => 'systemctl restart zabbix-agent.service'
}
特殊属性: metaparameters
1.定义依赖关系，有次序的关系，
puppet提供了before（之前）、 require（要求）、notify（通知）、subscribe（订阅） 四个参数来定义资源间的相关性。
被依赖的资源中使用：before
依赖其它资源的资源： require
这四个元参数都以另外的其他资源或者资源数组作为其值，这称为资源引用
资源引用要通过"Type['title']"的方式进行，如User['magedu'] , 注意：资源引用时，其类型名的首字母要大写。
before 定义
group {'linux': gid => 3000, ensure => present, before => User['suse'], #在创建user suse账户前，先创建linux 组， } user {'suse': uid => 3000, gid => 3000, shell => '/bin/bash', home => '/home/suse', ensure => present, }
###################################################
require 定义, 在user中定义 linux组必须存在，才能创建suse用户。
group {'linux':
gid => 3000,
ensure => present,
}
user {'suse':
uid => 3000,
gid => 3000,
shell => '/bin/bash',
home => '/home/suse',
ensure => present,
require => Group['linux']
}
#########################################################
使用 -> 符号，表示先group，后user
group{'tomcat':
gid => 5001,
ensure => present,
} ->
user{'tomcat':
uid => 5001,
gid => 5001,
ensure => present,
home => '/home/tomcat',
shell => '/bin/bash',
}
2.定义通知关系
subscribe 当 file 文件变化时，重启nginx服务。
subscribe 订阅， notify 通知
###############################
定义不了重启
package{'nginx': ensure => latest, } file{'nginx.conf': source => '/tmp/nginx.conf',
path => '/etc/nginx/nginx.conf' ensure => file, require => Package['nginx'],
# notify => Service['nginx'] } service{'nginx': ensure => running, enable => true, hasrestart => true, hasstatus => true, #subscribe => File['/etc/nginx/nginx.conf']，
require => [Package['nginx'],File['nginx.conf']] }
当文件/tmp/nginx.conf 内容变更了，要让servie 重启， 所以require定义不了重启。需要使用notify和subscribe。
notify 定义在前资源，自己发生改变要通知 后面的资源。
subscribe 定义在后资源， 自己监控着 前资源，如果前资源发生改变，自己做什么操作
package{'nginx': ensure => latest, allow_virtual => false, } file{'nginx.conf': path => '/etc/nginx/nginx.conf', source => '/tmp/nginx.conf', ensure => file, require => Package['nginx'], } service{'nginx': ensure => running, enable => true, hasrestart => true, hasstatus => true, restart => 'systemctl reload nginx.service', require => [Package['nginx'],File['nginx.conf']], subscribe => File['nginx.conf'], }
puppet 变量
puttet 的变量名称必须以$开头，复制操作符为 =
任何正常数据类型（非正则）的值都可以赋予puppet中的变量，如字符串、数值、布尔型、数组、hash以及特殊的undef值。
puppet的每个变量都有2个名字，简短名称和长格式完全限定名称，完全限定名称的格式为“$scope::variable”
scope是一个特定的代码区域，用于同程序中的其他代码隔离开来
在puppet中，scope可以用于限定变量及资源默认属性的作用范围，但不能用于限定资源名称及资源引用的生效范围。
每个变量有两种引用路径：
相对路径：
绝对路径： $::scope::scope::variable
正则表达式
属于puppet的非标准数据类型，不能赋值给变量，仅能用于有限的几个接受正则表达式的地方，即接受使用“=~”及“！~” 匹配操作符的位置，通常包括case 语句中的
selector，以及节点名称匹配的位置
正则表达式不能传递给函数或者用户资源属性的定义
puppet中额正则表达式支持使用(?<ENABLED OPTION启用的选项>:<SUBPATTERN>) 和 （?-<DISABLED OPTION>:<SUBPATTERN>禁用使用-号）两个特殊的符号
OPTION 正则表达式匹配选项 i (忽略字符大小写)，m（把 . 当作换行符） ，x （忽略模式中的空白字符和注释）
- 减号取反义
$packages = $operatingsystem ? { /(?i-mx:(ubuntu|debian))/ => 'apache2', /(?i-mx:(redhat|centos))/ => 'httpd', }
operatingsystem的值 匹配 ubuntu 和 redhat，如果匹配了，那么 packages 的值为apache2 或者 httpd。
puppet中变量的种类
1.自定义变量
2.facter变量： 可直接引用， 使用命令 facter -p
3.内置变量：
客户端内置： $clientcert, $clientversion
服务器断内置： $servername $serverversion $serverip $module_name
puppet 条件语句
if case unless selector
单分支 if CONITION { statement } if conition { statement } else { statement }
多分支 if conition { statemnet } elsif { statemnet } else { statemnet}
if $processorcount>1 { notice("process count 4") } else { notice("process not 4") }
notice是内置变量，输出结果。
conition的用法：
1. 比较表达式
2. 变量引用
3. 有返回值函数调用
判断文件系统是什么
if $filesystems =~ /^(?i-mx:(xfs|ext4|ext3))/ { notice("linux filesystem is $1") }
case contorl_express {
case1: {statemnet.....}
case2: { statemnet....}
default: { statement... }
}
case $filesystems { 'xfs': {notice(" this's linux filesystem is xfs")} 'ext3': {notice(" this's linux filesystem is ext3")} 'ext4': {notice(" this's linux filesystem is ext4")} 'zfs': {notice(" this's linux filesystem is zfs")}
default: {notice("nothing")} }
contorl_express 表达式、变量、函数（有返回值）
select 是返回一个值，不是执行代码块 ，不能用于一个已经嵌套于selector的case中，
CONTROL_VARIABLE ? {
case1 => value1
case2 => value2
default => valueN
}
$packages = $operatingsystem ? { /(?i-mx:(ubuntu|debian))/ => 'apache2', /(?i-mx:(redhat|centos))/ => 'httpd',
dafult => 'httpd' } operatingsystem的值 匹配 ubuntu 和 redhat，如果匹配了，那么 packages 的值为apache2 或者 httpd。
select 使用要点：
1.这个selector 语句会被当作一个单独的值，puppet会将控制变量按列出的次序与每个case进行比较，并在遇到一个匹配的case后，将其值作为整个语句的值进行返回，
2.控制变量与个case比较的方式与case相同，但如果没有任何一个case与控制变量匹配是，puppet在编译时会返回一个错误，因此，实践中，其必须提供default case。
类： class
创建后可在puppet全局进行调用，类可以被继承。类的名字只能小写
class nginx { $package = $operatingsystem ? { /^(?i-mx:(centos|redhat))/ => nginx, /^(?i-mx:(debian|ubuntu))/ => httpd, } package{$package: ensure => latest,
allow_virtual => false, } file{'nginx.conf': ensure => file, source => '/tmp/nginx.conf', path => '/etc/nginx/nginx.conf', require => Package['$package'], } service{'nginx': ensure => running, enable => true, hasrestart => true, hasstatus => true, restart => 'systemctl reload nginx.service', subscribe => File['nginx.conf'], } } include nginx
在manifest文件中定义的类不会直接被执行，他们需要事先声明后才能被执行。
声明类（调用类）的方式：
1. 用 include 声明一个类 2. 用 require 声明一个类 3. 像声明一个 resource（资源） 声明一个类 4. 用ENC的方式声明一个类
1.include 声明
使用方法 include base::linux
include base::linux,nginx 声明2个类
class nginx { package{'nginx': ensure => latest, } file{'nginx.conf': path => '/etc/nginx/nginx.conf', ensure => file, source => '/tmp/nginx.conf', require => Package['nginx'], } service{'nginx': ensure => running, enable => true, hasrestart => true, hasstatus => true, restart => 'systemctl reload nginx.service', require => Package['nginx'], subscribe => File['nginx.conf'], } } include nginx
类的声明方式一：
include class_name , class_name,........
定义能接受参数的类：
class class_name($arg1='value1',$arg2='value2'){
.....code
}
类声明方式二：
class｛'class_name':
arg1 => value,
arg2 => value,
｝
2.resource(像声明一个资源一样，声明一个类),带参数的
class {'apache'
version => '2.2.6',
}
class{'base::linux':}
class nginx($webserver='nginx') { package{$webserver: ensure => latest, } file{'nginx.conf': path => '/etc/nginx/nginx.conf', ensure => file, source => '/tmp/nginx.conf', require => Package['nginx'], } service{'nginx': ensure => running, enable => true, hasrestart => true, hasstatus => true, restart => 'systemctl reload nginx.service', require => Package['nginx'], subscribe => File['nginx.conf'], } } ###########resource 调用类################### #nginx 是 上面定义的 class_name class{'nginx': webserver => 'nginx', }
3.require
4.ENC
类的继承：
定义方式：
基类/父类 子类 继承 基类/父类
class base_class::class_name inherits base_class {
...... puppet code........
}
作用：继承一个已有的类，并实现覆盖资源属性，或向资源属性追加额外值：
=>,+>
类继承时：
1.声明子类时，其基类会被自动首先声明。
2.基类成为了子类的父作用域，基类中的变量和属性默认值会被子类复制一份：
3.子类可以覆盖父类中同一资源的相同属性的值。
# 安装应用程序和启动服务都是相同的，
class nginx { package{'nginx': ensure => latest, } service{'nginx': ensure => running, enable => true, hasrestart => true, hasstatus => true, restart => 'systemctl reload nginx.service', } } class nginx::webserver inherits nginx { file{'nginx.conf': ensure => file, path => '/etc/nginx/nginx.conf', source => '/tmp/nginx_web.conf', notify => Service['nginx'], } } class nginx::proxy inherits nginx { file{'nginx.conf': ensure => file, path => '/etc/nginx/nginx.conf', source => '/tmp/nginx_proxy.conf', notify => Service['nginx'], } } include nginx::proxy #调用子类
在子类中覆盖父类中已经定义的资源属性值：
[root@k8s1 manifest]# cat class5.pp class nginx { package{'nginx': ensure => latest, name => nginx, } service{'nginx': ensure => running, enable => true, hasrestart => true, hasstatus => true, restart => 'systemctl reload nginx.service', } } class nginx::webserver inherits nginx { Package['nginx'] { #子类可以覆盖父类中同一资源的相同属性的值。 name => tengine,
#name +> varnish, ####表示追加安装varnish,
}
file{'nginx.conf':
ensure => file,
path => '/etc/nginx/nginx.conf',
source => '/tmp/nginx_web.conf',
notify => Service['nginx'],
}
}
class nginx::proxy inherits nginx {
file{'nginx.conf':
ensure => file,
path => '/etc/nginx/nginx.conf',
source => '/tmp/nginx_proxy.conf',
notify => Service['nginx'],
}
}
include nginx::webserver
模版：
基于ERB模版语言，在静态文件中使用变量等变成元素生成适用于多种不同的环境的文本文件，用于实现在文本文件中嵌入ruby代码，原来的文本信息不会被改变
但ruby代码会被执行，执行结果将直接替换原来代码：
<%= Ruby Expression %>: 替换为表达式的值：
<% Ruby Expression %>: 仅执行代码，不替换
<%# comment %>: 文本注释：
<%%: 输出为<%
%%>: 输出为%>
<%- Ruby code %>: 忽略空白字符：
<% Ruby code -%>： 忽略空白行：
在模版中可是使用变量，包括puppet的任意可用变量，但变量名以@字符开头。
条件判断：
<% if condition -%>
some text
<% end %>
<% if condition -%>
some text
<% else %>
some text
<% end %>
迭代：
<% @ArrayName.echo do | Variable_name | -%>
some text with <%= Variable_name %>
<% end %>
使用模版实例：
1. 修改nginx配置文件
2. 修改puppet配置文件
class nginx::webserver inherits nginx {
Package['nginx'] {
name => nginx,
}
file{'nginx.conf':
ensure => file,
path => '/etc/nginx/nginx.conf',
#source => '/tmp/nginx_web.conf',
# template函数对/tmp/nginx_web.conf进行计算，生成数据流，把数据流当成内容
content => template('/tmp/nginx_web.conf'),
notify => Service['nginx'],
}
}
3. 验证结果 vi /etc/nginx/nginx.conf
模块：
路径 /etc/puppet/modules
/etc/puppet/modules/manifests/
init.pp: 至少应该包含一个与当前模块名称同名类：
/etc/puppet/modules/files: 静态文件 puppet:///module/module_name/file_name
/etc/puppet/modules/template: 模版文件目录: template('module_name/template_name')
/etc/puppet/modules/lib: 插件目录
/etc/puppet/modules/tests: 当前模块的使用帮助及实例文件
/etc/puppet/modules/spec: 类似与tests目录，存储lib目录下定义的常见的使用帮助及示例文件
模块管理命令
[root@k8s1 modules]# puppet help module
USAGE: puppet module <action> [--environment production ] [--modulepath $basemodulepath ] This subcommand can find, install, and manage modules from the Puppet Forge, a repository of user-contributed Puppet code. It can also generate empty modules, and prepare locally developed modules for release on the Forge. OPTIONS: --render-as FORMAT - The rendering format to use. --verbose - Whether to log verbosely. --debug - Whether to log debug information. --environment production - The environment Puppet is running in. For clients (e.g., `puppet agent`) this determines the environment itself, which is used to find modules and much more. For servers (i.e., `puppet master`) this provides the default environment for nodes we know nothing about. --modulepath $basemodulepath - The search path for modules, as a list of directories separated by the system path separator character. (The POSIX path separator is ':', and the Windows path separator is ';'.) Setting a global value for `modulepath` in puppet.conf is deprecated. Please use directory environments instead. If you need to use something other than the default modulepath of `<ACTIVE ENVIRONMENT'S MODULES DIR>:$basemodulepath`, you can set `modulepath` in environment.conf. For more info, see http://docs.puppetlabs.com/puppet/latest/reference/environments.html ACTIONS: build Build a module release package. changes Show modified files of an installed module. generate Generate boilerplate for a new module. install Install a module from the Puppet Forge or a release archive. list List installed modules search Search the Puppet Forge for a module. uninstall Uninstall a puppet module. upgrade Upgrade a puppet module.
#找到本地安装的puppet 模块。
[root@k8s2 puppet]# puppet module list
/etc/puppet/modules (no modules installed)
/usr/share/puppet/modules (no modules installed)
#从forgeapi.puppetlabs.com 中查找nginx模块.
#从forgeapi.puppetlabs.com 中安装nginx模块
puppet module install nginx
模块的具体应用
[root@k8s1 template]# mkdir -pv /etc/puppet/modules/nginx/{manifests,files,templates,tests,lib,spec} /etc/puppet/modules/nginx/mainfests/init.pp 中必须有一个类，类的名称必须与 /etc/puppet/modules/nginx目录的nginx相同 [root@k8s1 template]# cp /root/manifest/test2.pp /etc/puppet/modules/nginx/manifests/init.pp 静态文件放置在 /etc/puppet/modules/nginx/files/目录下 [root@k8s1 template]# cp /tmp/nginx_proxy.conf /etc/puppet/modules/nginx/files/ nginx_web.conf 是模版文件（<%= @processcount -%>），放置在/etc/puppet/modules/nginx/templates/目录下，并且改名成nginx_web.conf.erb [root@k8s1 template]# cp /tmp/nginx_web.conf /etc/puppet/modules/nginx/templates/nginx_web.conf.erb
修改/etc/puppet/modules/manifests/init.pp文件，修改file 中的source属性：
执行命令，--noop表示不进行应用，执行是否正确：
[root@k8s1 manifests]# puppet apply -v --noop -e "include nginx::proxy"
Notice: Compiled catalog for k8s1 in environment production in 1.32 seconds
Info: Applying configuration version '1494307794'
Notice: /Stage[main]/Nginx::Webserver/File[nginx.conf]/ensure: current_value absent, should be file (noop)
Info: /Stage[main]/Nginx::Webserver/File[nginx.conf]: Scheduling refresh of Service[nginx]
Notice: Class[Nginx::Webserver]: Would have triggered 'refresh' from 1 events
Notice: /Stage[main]/Nginx/Package[nginx]/ensure: current_value absent, should be latest (noop)
Notice: /Stage[main]/Nginx/Service[nginx]/ensure: current_value stopped, should be running (noop)
Info: /Stage[main]/Nginx/Service[nginx]: Unscheduling refresh on Service[nginx]
Notice: Class[Nginx]: Would have triggered 'refresh' from 2 events
Notice: Stage[main]: Would have triggered 'refresh' from 2 events
Notice: Finished catalog run in 0.34 seconds
执行并应用：
[root@k8s2 manifests]# puppet apply -v -e "include nginx::proxy"
puppet master/agent:
agent: 默认30分钟向master 发送node name 和facts，并请求catalog
master： 验证客户端身份， 查找与其相关的site manifest, 编译生成catalog，并发送给客户端。
ssl xmlrpc ， https 8140/tcp 端口
master 安装软件： puppet, puppet-server, facter
agent 安装软件： puppet facter
#安装puppet server端
[root@k8s3 ~]# yum -y install puppet-server
puppet server配置文件 vim /etc/puppet/puppet.conf
puppet server默认的系统配置信息
[root@k8s2 puppet]# puppet help config USAGE: puppet config <action> [--section SECTION_NAME] This subcommand can inspect and modify settings from Puppet's 'puppet.conf' configuration file. For documentation about individual settings, see http://docs.puppetlabs.com/references/latest/configuration.html. OPTIONS: --render-as FORMAT - The rendering format to use. --verbose - Whether to log verbosely. --debug - Whether to log debug information. --section SECTION_NAME - The section of the configuration file to interact with. ACTIONS: print Examine Puppet's current settings. set Set Puppet's settings. See 'puppet man config' or 'man puppet-config' for full help.
#查看默认配置信息
[root@k8s2 puppet]# puppet config print
#启动master服务 守护进程，-D 放置到后台
[root@k8s2 puppet]# puppet master -D
#启动agent服务 守护进程，-D 放置到后台
[root@k8s2 puppet]# puppet agent --server=puppet.domain.cn -D
手动生成完整配置文件：
master：
[root@k8s2 puppet]# puppet master --genconfig > /etc/puppet/puppet_default.conf
agent：
[root@k8s2 puppet]# puppet agent --genconfig > /etc/puppet/puppet_default.conf
说明：
(1) 生成新的配置文件之前，不能删除或移除原有的puppet.conf:
(2) 生成的配置中，有的参数已经被废弃，与现有puppet版本可能兼容，
(3) 有的参数的默认值与现有版本所支持值可能不相兼容：
获取puppet 文档：
puppet doc
分段， 称为reference
列出所有的reference:
puppet doc --list
查看某一 reference:
puppet doc -r REFERENCE_NAME
配置文件的组成部分：
[main]
[master]
[agent]
签署证书:
puppet cert <action> [-h|--help] [-V|--version] [-d|--debug] [-v|--verbose] [--digest <digest>] [<host>]
EXAMPLE
-------
$ puppet cert list 显示请求的证书
$ puppet cert sign culain.madstop.com 签署证书
配置agent/master
1. 配置master;
# puppet master --no-daemonize -v #启动测试模式，如果无问题，kill掉
# systemctl start puppetmaster.service
# systemctl enable puppetmaster.service
2. 配置agent端
# puppet agent --server=master_host_name --no-daemonize --noop --test -v
# puppet agent --server=master_host_name --no-daemonize -v -d #发送证书签署请求给master：
3. 在master端为客户签署证书
# puppet cert list #待签署的请求
# puppet cert sign node_name
# puppet cert sign --all #签署全部
# puppet cert clean node_name #清除指定节点
4. 在master端：
(1) 安装所有用到的module，或者自己写
（2） 定义site manifest;
/etc/puppet/manifests/site.pp
node 'NODE_NAME' {
....puppet code......
}
例如：
node "k8s3" {
include nginx::proxy
}
5. agent端
（1）修改vim /etc/puppet/puppet.conf ,添加server 的地址
server = k8s2
（2） 启动客户端agent 进程
[root@k8s1 nginx]# systemctl start puppetagent.service
6. 节点管理：
site.pp 定义节点的方式：
(1) 以主机名直接给出其相关定义
node 'node_name' {
..... puppet code ......
}
(2) 把功能相近的主机按照统一的命名，按照统一格式调用：
node /^web\d+\.abcg\.com/ {
... puppet code .......
}
7. master 检查manifests中 init.pp 语法是否正确
master： puppet parser validate /etc/puppet/modules/copyfiletest/manifests/init.pp
agent： puppet agent --server=k8s2 --no-daemonize --noop --test -v
主机命名方式：
角色名-运营商-机房名-机器ip.域名
web1-cnc-wx-172.16.230.3.abc.com
对节点配置分段管理
/etc/puppet/mainfests/
site.pp
import "webserver/*.pp"
webserver/
tomcat.pp
nginx.pp
cache/
varnish.pp
squid.pp
api
kong.pp
面临的问题：
1. 主机名解析：(ddns)
2. 如何为系统准备好puppet agent;
puppet的配置文件：
master环境配置：开发环境、测试环境、生产环境
# vim /etc/puppet/puppet/conf
[master]
environment = production,testing,development
[production] manifest=/etc/puppet/environments/production/manifests/site.pp modulepath=/etc/puppet/environments/production/modules/ fileserverconfig=/etc/puppet/fileserver.conf
[testing]
manifest=/etc/puppet/environments/testing/manifests/site.pp
modulepath=/etc/puppet/environments/testing/modules/
fileserverconfig=/etc/puppet/fileserver.conf
[development]
manifest=/etc/puppet/environments/development/manifests/site.pp
modulepath=/etc/puppet/environments/development/modules/
fileserverconfig=/etc/puppet/fileserver.conf
# 修改puppet.conf 配置文件，重启服务
# systemctl restart puppetmaster.service
agent 配置有两种方法：
第一种 [agent] environment = testing 或者 enviroment=development 或者 enviroment=production
第二种 puppet agent --test --noop --environment [testing, development, production]
puppet 默认是production环境
[root@k8s1 example_env]# puppet config print | grep env
environment = production
puppet的文件服务器
fileserver.conf 生效的结果是结合puppet.conf 与auth.conf: 用于实现安全配置，例如agent能够或不能访问master端的那些文件。
[mount_point]
path /etc/puppet/file
allow hostname
allow_ip ip
deny all
auth.conf 配置文件：
认证配置文件，为puppet提供acl功能， 主要应用于puppet的Restful。
namespace.conf 用于控制名称空间的访问法则。
[puppetrun]
all node_hostname
名称空间：
fileserver, puppetmaster, puppetruners,puppetreports, resource
autosign.conf:
让master 在接受到agent 的证书签署后直接自动为其签署：
puppet kick 触发每个agent，agent从master直接请求。
puppet dashboard
安装puppet-dashboard：
# yum install rubygem-rake ruby-mysql
yum localinstall puppet-dashboard
gem install rake
实例：
所有服务器 ntpdate 放置在/etc/crontab 文件中，需要判断文件中是否有ntp时间，如果没有，添加ntpdate，并且重启crond服务
master 端： 1.新建ntptime 类，用于同步时间
mkdir -pv /etc/puppet/modules/ntptime/{files,manifests,spec,lib,templates,tests} 2. 编辑 /etc/puppet/modules/ntptime/manifests/init.pp 文件，写ntptime类
3. 修改总的资源清单 /etc/puppet/manifests/site.pp
4. master 测试语法是否错误
puppet parser validate /etc/puppet/modules/ntptime/manifests/init.pp
5. agent 测试是否能够执行
puppet agent --server=k8s2 --no-daemonize --noop --test -v
6. 重启agent
systemctl enable puppetagent.service
