Puppet - 配置

在系统上安装 Puppet 后,下一步是配置它以执行某些初始操作。

打开机器上的防火墙端口

要使 Puppet 服务器集中管理客户端的服务器,需要在所有机器上打开指定端口,即,如果我们尝试配置的任何机器上未使用 8140,则可以使用该端口。我们需要在所有机器上启用 TCP 和 UDP 通信。

配置文件

Puppet 的主要配置文件是 etc/puppet/puppet.conf。所有配置文件都是在基于包的 Puppet 配置中创建的。配置 Puppet 所需的大部分配置都保存在这些文件中,一旦 Puppet 运行,它就会自动获取这些配置。但是,对于某些特定任务(例如配置 Web 服务器或外部证书颁发机构 (CA)),Puppet 具有单独的文件和设置配置。

服务器配置文件位于 conf.d 目录中,该目录也称为 Puppet 主控。这些文件默认位于 /etc/puppetlabs/puppetserver/conf.d 路径下。这些配置文件采用 HOCON 格式,保留了 JSON 的基本结构,但更易读。当 Puppet 启动时,它会从 conf.d 目录中获取所有 .cong 文件并使用它们进行任何配置更改。这些文件中的任何更改仅在服务器重新启动时才会生效。

列表文件和设置文件

  • global.conf
  • webserver.conf
  • web-routes.conf
  • puppetserver.conf
  • auth.conf
  • master.conf(已弃用)
  • ca.conf(已弃用)

Puppet 中有不同的配置文件,这些配置文件特定于 Puppet 中的每个组件。

Puppet.conf

Puppet.conf 文件是 Puppet 的主要配置文件。Puppet 使用相同的配置文件来配置所有必需的 Puppet 命令和服务。所有与 Puppet 相关的设置,例如 Puppet master、Puppet agent、Puppet apply 和证书的定义都在此文件中定义。Puppet 可以根据需要引用它们。

配置文件类似于标准 ini 文件,其中的设置可以进入主部分的特定应用程序部分。

主配置部分

[main] 
certname = Test1.vipin.com 
server = TestingSrv 
environment = production 
runinterval = 1h 

Puppet Master 配置文件

[main] 
certname = puppetmaster.vipin.com 
server = MasterSrv 
environment = production 
runinterval = 1h 
strict_variables = true  
[master] 

dns_alt_names = MasterSrv,brcleprod01.vipin.com,puppet,puppet.test.com 
reports = puppetdb 
storeconfigs_backend = puppetdb 
storeconfigs = true 
environment_timeout = unlimited 

详细概述

在 Puppet 配置中,将要使用的文件具有多个配置部分,其中每个部分具有不同类型的多个设置。

配置部分

Puppet 配置文件主要由以下配置部分组成。

  • Main − 这被称为全局部分,由 Puppet 中的所有命令和服务使用。在主部分中定义默认值,这些默认值可以被 puppet.conf 文件中的任何部分覆盖。

  • Master − 此部分由 Puppet master 服务和 Puppet cert 命令引用。

  • Agent − 此部分由 Puppet agent 服务引用。

  • User −它主要用于 Puppet apply 命令以及许多不太常见的命令。

[main] 
certname = PuppetTestmaster1.example.com 

配置文件的关键组件

以下是配置文件的关键组件。

注释行

在 Puppet 中,任何注释行都以 (#) 符号开头。这可能意味着有任意数量的空间。我们也可以在同一行内添加部分注释。

# 这是一条注释。
Testing = true #这也是同一行中的注释

设置行

设置行必须包含 −

  • 任意数量的前导空格(可选)
  • 设置的名称
  • 等号 =,可以被任意数量的空格包围
  • 设置的值

设置变量

在大多数情况下,设置的值将是一个单词,但在某些特殊情况下,有几个特殊值。

路径

在配置文件设置中,获取目录列表。在定义这些目录时,应记住它们应该用系统路径分隔符分隔,在 *nix 平台中为 (:),在 Windows 上为分号 (;)。

# *nix 版本:
environmentpath = $codedir/special_environments:$codedir/environments
# Windows 版本:
environmentpath = $codedir/environments;C:\ProgramData\PuppetLabs\code\environment

在定义中,将扫描首先列出的文件目录,然后如果找不到,则移动到列表中的其他目录。

文件和目录

所有采用单个文件或目录的设置都可以接受可选的权限哈希值。当服务器启动时,Puppet 将强制执行列表中的文件或目录。

ssldir = $vardir/ssl {owner = service, mode = 0771}

在上面的代码中,允许的哈希是所有者、组和模式。所有者和组键只有两个有效值。