epflsti/cluster.coreos.puppet

cluster.coreos.puppet

用于运行CoreOS集群的Puppet Docker镜像及配置（清单），符合EPFL-STI风格。

Docker仓库地址：https://registry.hub.docker.com/u/epflsti/puppet/

快速开始

1. 配置并运行Puppet master：参考 https://github.com/epfl-sti/cluster.foreman
2. 在cluster.foreman Docker容器内检出cluster.coreos.puppet：

   bash
   docker exec -it puppetmaster.mysubdomain.mydomain.com /bin/bash
   cd /etc/puppet/environments/production/modules
   git clone https://github.com/epfl-sti/cluster.coreos.puppet.git epflsti_coreos
   

3. 从Foreman界面 provision 若干节点，它们将自动集成到Puppet集群中。

开发

使用Docker构建Puppet agent镜像：

bash
docker build -t epflsti/puppet .

上传镜像：

bash
docker push epflsti/puppet

为什么在CoreOS上使用Puppet？

在EPFL-STI，我们通过 https://github.com/epfl-sti/cluster.foreman%E3%80%82%E7%9B%AE%E5%89%8D%E6%88%91%E4%BB%AC%E5%AF%B9CoreOS%E5%BE%88%E6%84%9F%E5%85%B4%E8%B6%A3%EF%BC%8C%E5%AE%83%E6%9C%89%E8%87%AA%E5%B7%B1%E7%9A%84%60cloud-config.yaml%60%E7%B3%BB%E7%BB%9F%EF%BC%8C%E4%BD%86CoreOS%E5%AE%98%E6%96%B9%E6%98%8E%E7%A1%AE%E8%A1%A8%E7%A4%BA%E8%AF%A5%E7%B3%BB%E7%BB%9F%E2%80%9C%E5%B9%B6%E9%9D%9EChef/Puppet%E7%9A%84%E6%9B%BF%E4%BB%A3%E5%93%81%E2%80%9D%E3%80%82

在CoreOS集群中，Puppet + Foreman集成带来以下好处：

• 节点provision（安装和配置）的端到端自动化，包括IPMI，使节点可被视为“牛而非宠物”
• 集中分配所有场景的IP地址（EPFL-STI集群使用不同子网：IPMI用于生命周期管理、RFC1918 IPv4用于特权服务、可路由IPv6用于租户）
• 持续（重新）配置：无需重装/重启即可添加或修改服务
• 对单个节点的专门配置：etcd quorum成员、带外部物理以太网连接的网关节点等
• 将关键事实（MAC地址、dmidecode序列号）收集到Foreman集中数据库
• 基础监控：节点过去30分钟是否处于活动状态？

工作原理

Docker中的Puppet

在CoreOS上运行Puppet依赖两个Docker镜像：

• Puppetmaster镜像：与Foreman捆绑在 https://github.com/epfl-sti/cluster.foreman 项目中
• Puppet agent镜像：见本项目的puppet-agent/Dockerfile

Puppet agent的Docker容器作为systemd服务运行，容器与服务名称均为puppet.service。

两阶段引导

标准部署中，cluster.foreman与cluster.coreos.install协作，在CoreOS安装后、重启前首次运行Docker化Puppet agent，负责将自身安装到磁盘系统镜像中。

Puppet通过环境变量FACTER_lifecycle_stage=bootstrap区分引导阶段，重启后以FACTER_lifecycle_stage=production运行。这种设置确保Foreman将节点从“构建中”转为“已构建”，引导节点从本地磁盘启动。

未识别$::lifecycle_stage的Puppet类会在引导阶段被manifests/init.pp排除，详情见各manifests/*.pp文件注释。