2、Puppet入门指南

Puppet入门指南

1. Puppet运行模式与部署模型

Puppet代理的运行方式多样，既可以作为守护进程运行，也能通过cron等机制触发，或者手动触发连接。通常做法是将Puppet作为守护进程运行，让它定期与主服务器核对配置是否最新，或获取新配置。默认情况下，Puppet代理每30分钟会向主服务器检查一次新的或更改后的配置，你可以根据需求调整这个时间间隔。

除了常见的客户端 - 服务器模式，Puppet还支持独立运行模式，这种模式无需Puppet主服务器，配置直接安装在本地主机，通过运行puppet二进制文件来执行和应用配置。

2. 配置语言与资源抽象层

Puppet使用声明式语言（Puppet语言）来定义配置项，这些配置项被称为资源。声明式语言与许多其他配置工具的命令式或过程式语言不同，它关注的是配置的最终状态，而非实现过程。

例如，要在Red Hat Enterprise Linux、Ubuntu和Solaris主机上安装vim应用程序，手动操作需要编写复杂的脚本，包括连接主机、检查vim是否安装、使用不同平台的命令进行安装以及报告结果等步骤。而使用Puppet，只需定义一个vim包的配置资源：

package { 'vim': ensure => present, }

这个资源由类型（如package）、标题（如vim）和属性（如ensure => present）组成。ensure属性指定了包的状态，present表示安装，absent表示卸载。

3. 资源抽象层

当创建好资源后，Puppet会在代理连接时处理资源管理的细节。每种资源类型都有多个提供者，提供者包含了使用特定包管理工具管理资源的具体方法。例如，package类型有20多种提供者，涵盖yum、aptitude等工具。

Puppet通过Facter工具获取代理的信息，包括操作系统等，然后选择合适的提供者来检查和安装包。如果包已安装，Puppet不会进行任何操作，这就是幂等性。操作完成后，Puppet会将结果报告给主服务器。

Facter是一个系统清单工具，它会返回节点的各种信息，如主机名、IP地址、操作系统等。这些信息会作为变量在Puppet配置中使用，帮助定制每个主机的配置。你可以通过命令行运行facter来查看客户端的可用信息：

$ facter operatingsystem => Ubuntu ipaddress => 10.0.0.10

4. 事务层

Puppet的事务层是其核心引擎，一个Puppet事务包含以下步骤：
- 解释和编译配置。
- 将编译后的配置传达给代理。
- 在代理上应用配置。
- 将应用结果报告给主服务器。

Puppet首先会分析配置，创建一个显示所有资源及其相互关系的图，以此确定应用资源的顺序。然后将资源编译成目录发送给主机，应用结果会以报告形式返回给主服务器。

事务层支持多次重复创建和应用配置，具有幂等性，确保配置的一致性。不过，Puppet并非完全事务性的，事务不会被记录，无法像某些数据库那样回滚，但可以在“noop”模式下测试更改的执行情况。

5. 选择合适的Puppet版本

通常建议使用最新版本的Puppet，目前最新的是3.2.x版本，它具有性能提升和内置Hiera集成等优点。3.1.x版本也很稳定，修复了许多之前版本的漏洞，并包含了新的功能。

不同版本的Puppet在不同操作系统上有不同的打包方式，2.7.x版本广泛打包，3.1.x版本则在较新的操作系统中提供。如果找不到适合的版本，可以自行打包、移植或从源代码安装，但不推荐从源代码安装。

在混合使用不同版本的Puppet时，主服务器的版本必须比代理的版本新，且旧版本的代理与新版本的主服务器可能会出现兼容性问题。

6. Puppet安装

Puppet可以安装在多种平台上，包括Red Hat Enterprise Linux、Debian、Ubuntu、OpenIndiana、Solaris等。以下是不同平台的安装方法：

6.1 Red Hat Enterprise Linux和Fedora

• 安装EPEL仓库：
  • Enterprise Linux 5：# rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm
  • Enterprise Linux 6：# rpm -Uvh http://dl.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm
• 安装Puppet Labs仓库：
  • Enterprise Linux 5：# rpm -ivh http://yum.puppetlabs.com/el/5/products/i386/puppetlabs-release-5-7.noarch.rpm
  • Enterprise Linux 6：# rpm -ivh http://yum.puppetlabs.com/el/6/products/i386/puppetlabs-release-6-7.noarch.rpm
• 安装包：
  • 主服务器：# yum install puppet puppet-server facter
  • 代理：# yum install puppet facter

6.2 通过RubyGems安装

在安装了Ruby和rubygems包后，可以使用以下命令安装Puppet和Facter：

# gem install puppet facter

6.3 Debian和Ubuntu

• 主服务器：# apt-get install puppet puppetmaster
• 代理：# apt-get install puppet

如果需要最新版本的Puppet，可以添加Puppetlabs仓库：
- Debian Wheezy：
# wget http://apt.puppetlabs.com/puppetlabs-release-wheezy.deb # dpkg -i puppetlabs-release-wheezy.deb # apt-get update
- Ubuntu Precise：
# wget http://apt.puppetlabs.com/puppetlabs-release-precise.deb # dpkg -i puppetlabs-release-precise.deb # apt-get update

6.4 OpenIndiana

先安装Ruby：

# pkg install ruby-18

然后使用gem安装Puppet和Facter：

# gem install puppet facter

安装后的二进制文件位于/var/ruby/1.8/gem_home/bin/。

6.5 Solaris 10和11

由于Solaris没有原生的Puppet包，可以从OpenCSW包、RubyGems或源代码安装。这里使用OpenCSW的puppet3包：
1. 安装OpenCSW：# pkgadd -d http://get.opencsw.org/now
2. 安装Puppet和依赖项：# pkgutil --install puppet3
安装后Puppet可在/opt/csw/bin中使用。

6.6 从源代码安装

不推荐从源代码安装，因为这会增加升级、卸载和管理的难度。安装步骤如下：
1. 下载Facter压缩包：
$ cd /tmp $ wget http://downloads.puppetlabs.com/facter/facter-1.6.18.tar.gz
2. 解压并安装Facter：
$ tar -zxf facter-1.6.18.tar.gz $ cd facter-1.6.18 # ./install.rb
3. 下载并安装Puppet：
$ cd /tmp $ wget http://downloads.puppetlabs.com/puppet/puppet-3.1.1.tar.gz $ tar -zxf puppet-3.1.1.tar.gz $ cd puppet-3.1.1 # ./install.rb

以下是Puppet事务层工作流程的mermaid流程图：

graph LR A[解释和编译配置] --> B[创建资源关系图] B --> C[将资源编译成目录] C --> D[将目录发送给代理] D --> E[在代理上应用配置] E --> F[将结果报告给主服务器]

通过以上介绍，你可以了解Puppet的基本运行模式、配置语言、资源管理、事务处理以及不同平台的安装方法，希望能帮助你顺利使用Puppet进行系统配置管理。

Puppet入门指南

7. Puppet运行与配置管理示例

为了更好地理解Puppet的实际应用，下面以管理多个主机上的Nginx服务为例，展示如何使用Puppet进行配置管理。

7.1 定义Nginx资源

首先，在Puppet主服务器上定义Nginx服务的资源配置。在Puppet中，可以创建一个模块来组织相关的资源。假设我们创建一个名为nginx的模块，在模块的manifests目录下创建一个init.pp文件，内容如下：

class nginx { package { 'nginx': ensure => present, } service { 'nginx': ensure => running, enable => true, require => Package['nginx'], } }

上述代码定义了一个nginx类，其中包含了两个资源：一个是package类型，用于确保Nginx包已安装；另一个是service类型，用于确保Nginx服务正在运行并在系统启动时自动启动。require参数指定了服务资源依赖于包资源，即先安装包再启动服务。

7.2 应用配置到代理

在Puppet主服务器上，需要将nginx类应用到相应的代理节点上。可以通过节点定义来实现，在site.pp文件中添加如下内容：

node 'example-node' { include nginx }

这里的example-node是代理节点的主机名，include nginx表示将nginx类应用到该节点。

7.3 代理节点同步配置

当代理节点连接到主服务器时，会自动获取并应用配置。代理节点可以通过以下命令手动触发配置同步：

# puppet agent --test

执行该命令后，代理节点会向主服务器请求最新的配置，主服务器会根据节点信息编译配置并发送给代理节点，代理节点再应用配置。

8. Puppet资源管理进阶

除了基本的资源定义和管理，Puppet还提供了一些高级功能，如资源依赖、条件判断和循环等。

8.1 资源依赖

在前面的Nginx示例中，已经使用了require参数来指定资源依赖关系。Puppet还支持其他依赖关系，如before、notify和subscribe。例如，当修改Nginx配置文件后，需要重新加载Nginx服务，可以使用notify参数：

file { '/etc/nginx/nginx.conf': ensure => file, content => template('nginx/nginx.conf.erb'), notify => Service['nginx'], }

这里的template函数用于加载一个ERB模板文件生成配置文件内容，notify参数表示当文件内容发生变化时，会通知nginx服务重新加载。

8.2 条件判断

Puppet支持根据不同的条件来应用不同的配置。例如，根据操作系统类型选择不同的包管理工具：

if $facts['os']['family'] == 'RedHat' { package { 'nginx': ensure => present, provider => 'yum', } } elsif $facts['os']['family'] == 'Debian' { package { 'nginx': ensure => present, provider => 'apt', } }

这里使用了$facts变量来获取Facter工具返回的节点信息，根据操作系统家族类型选择不同的包管理提供者。

8.3 循环

在需要管理多个资源时，可以使用循环来简化配置。例如，创建多个用户：

$users = ['user1', 'user2', 'user3'] $users.each |$user| { user { $user: ensure => present, } }

上述代码使用each函数遍历$users数组，为每个元素创建一个user资源。

9. Puppet与外部数据存储（Hiera）

Hiera是Puppet的外部数据存储工具，它可以帮助我们将数据和代码分离，提高配置的可维护性。下面简单介绍如何使用Hiera。

9.1 配置Hiera

在Puppet主服务器上，创建hiera.yaml文件，配置Hiera的数据源和层次结构。示例配置如下：

--- version: 5 defaults: datadir: data data_hash: yaml_data hierarchy: - name: "Per-node data" path: "nodes/%{trusted.certname}.yaml" - name: "Common data" path: "common.yaml"

上述配置定义了两个数据源：一个是根据节点证书名称存储的节点特定数据，另一个是通用数据。

9.2 使用Hiera数据

在Puppet代码中，可以使用lookup函数来获取Hiera中的数据。例如：

$nginx_port = lookup('nginx::port', Integer, 'first', 80) service { 'nginx': ensure => running, enable => true, require => Package['nginx'], subscribe => File['/etc/nginx/nginx.conf'], hasrestart => true, hasstatus => true, start => "/usr/sbin/nginx -c /etc/nginx/nginx.conf -p /var/www -s start -t -g 'daemon on; master_process on;'", stop => "/usr/sbin/nginx -c /etc/nginx/nginx.conf -p /var/www -s stop -t -g 'daemon on; master_process on;'", restart => "/usr/sbin/nginx -c /etc/nginx/nginx.conf -p /var/www -s restart -t -g 'daemon on; master_process on;'", status => "/usr/sbin/nginx -c /etc/nginx/nginx.conf -p /var/www -s status -t -g 'daemon on; master_process on;'", parameters => { 'nginx_port' => $nginx_port, }, }

这里使用lookup函数从Hiera中获取nginx::port的值，如果找不到则使用默认值80。

10. Puppet的监控与维护

在使用Puppet进行系统配置管理时，需要对其进行监控和维护，以确保系统的稳定性和可靠性。

10.1 日志监控

Puppet的运行日志可以帮助我们了解配置管理的执行情况。日志文件通常位于/var/log/puppetlabs/puppet目录下。通过查看日志，可以及时发现配置错误、资源冲突等问题。

10.2 性能优化

为了提高Puppet的性能，可以采取以下措施：
- 合理配置代理节点的检查间隔时间，避免频繁请求主服务器。
- 对资源进行分组和分类，减少不必要的资源检查。
- 定期清理过期的配置和数据。

10.3 版本管理

使用版本控制系统（如Git）对Puppet代码进行管理，可以方便地进行代码的备份、回滚和协作开发。

以下是Puppet资源管理高级功能的关系表格：
| 功能 | 描述 | 示例 |
| — | — | — |
| 资源依赖 | 定义资源之间的先后顺序和触发关系 |require、before、notify、subscribe|
| 条件判断 | 根据不同条件应用不同配置 |if、elsif、else|
| 循环 | 简化多个资源的创建 |each|

以下是Puppet使用Hiera的流程mermaid流程图：

graph LR A[Puppet代码] --> B[使用lookup函数获取数据] B --> C[Hiera配置文件（hiera.yaml）] C --> D[数据源（yaml文件）] D --> B B --> A

通过以上内容，你对Puppet的高级应用、与外部数据存储的结合以及监控维护等方面有了更深入的了解。希望这些知识能帮助你更好地使用Puppet进行系统配置管理。