ncsa/puppet-enc

Puppet外部节点分类器（ENC）

本镜像实现了Puppet的外部节点分类器功能，通过REST API控制节点分类逻辑，可轻松集成到Puppet Server的Helm部署中。支持按主机名模式或显式主机名分组管理节点，并提供多角色用户权限控制，满足不同团队协作需求。

核心功能

• REST API管理：支持主机、组、用户的增删改查操作
• 角色权限控制：分为admin（全权限）、user（修改主机）、viewer（只读）三种角色
• 节点分组：按主机名模式或显式列表定义节点组，支持默认配置 fallback
• 健康检查：提供/healthz端点用于服务状态检测

使用场景

• Puppet环境中节点分类的集中化管理
• 集群内Puppet Server的ENC集成部署
• 多团队协作管理节点配置（基于角色权限隔离）

配置说明

本地运行

bash
pip install -r requirements.txt
waitress-server enc.py

Docker运行

bash
docker run --name enc --volume ${PWD}/enc:/app/data --ports 8080:8080 ncsa/puppet-enc

访问地址：http://localhost:8080

Helm集成（Puppet Server）

在values.yaml中添加以下配置启用ENC：

yaml
puppetserver:
  customentrypoints:
    enabled: true
    configmaps:
      90-custom.sh: |
        #!/bin/bash
        cat << EOF > /enc.sh
        #!/bin/bash
        curl -s -u puppet:viewer http://enc:8080/enc/hosts/\$1
        EOF
        chmod 755 /enc.sh
        /opt/puppetlabs/bin/puppet config set node_terminus "exec"
        /opt/puppetlabs/bin/puppet config set external_nodes "/enc.sh"

然后使用deploy.yaml部署puppet-enc到集群。

REST API参考

主机管理（HOSTS）

• GET /hosts：获取所有显式定义的主机列表（需admin/user/viewer权限）
• GET /hosts/:fqdn：获取指定主机或匹配组的分类配置（需admin/user/viewer权限）
• POST /hosts：创建新主机条目（需admin/user权限）
• PUT /hosts/:fqdn：更新主机配置（需admin/user权限）
• DELETE /hosts/:fqdn：删除主机条目（需admin权限）

组管理（GROUPS）

• GET /groups：获取所有组列表（需admin/user/viewer权限）
• GET /groups/:name：获取指定组配置（需admin/user/viewer权限）
• POST /groups：创建新组（需admin权限）
• PUT /groups/:name：更新组配置（需admin权限）
• DELETE /groups/:name：删除组（不可删除default组，需admin权限）

用户管理（USERS）

• GET /users：获取所有用户列表（需admin权限）
• GET /users/:username：获取指定用户信息（admin可查所有，普通用户仅查自身）
• POST /users：创建新用户（需admin权限）
• PUT /users/:username：更新用户配置（需admin权限）
• DELETE /users/:username：删除用户（需admin权限）

健康检查（MISC）

• GET /healthz：返回OK，用于检测服务状态