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}
在上面的代码中,允许的哈希是所有者、组和模式。所有者和组键只有两个有效值。