auguster/cloud-config-server

cloud-config-server ![]([***]

Docker化的NodeJS服务器，使用EJS模板语言为云实例提供cloud-config配置。

用户手册

文件查询

通过包含参数的GET HTTP请求查询cloud-config文件，参数值为待提供的文件名。若文件是EJS模板，可通过GET参数传递任意变量以生成动态文件。

请求格式：http://<服务器地址>:<端口>/<文件名>?<参数...>

文件存储

cloud-config文件应存储在应用的data/目录下，且文件扩展名为.ejs。

模板功能

该服务器使用EJS进行文件模板化，支持代码复用（通过include）、变量注入、动态脚本等功能。

以下是一个工作示例：

#cloud-config
<% var host = host || 'host' -%>
<% var domain = domain ? '.' + domain : '' -%>
hostname: "<%= host %><%= domain %>"

ssh_authorized_keys:
  <% include partials/ssh_keys/main %>

coreos:
  update:
    reboot-strategy: best-effort
<% include partials/etcd %>
  units:
<% include partials/units/etcd2_unit.ejs %>
<% include partials/units/fleet_unit.ejs %>

注意：cloud-config文件采用YAML格式，对空格缩进敏感！更完整的示例可参考项目https://github.com/auguster/coreos-consul-haproxy%E3%80%82

构建镜像

运行以下命令构建Docker镜像：

docker build -t cloud-config-server .

Docker部署

该项目的最新镜像托管在Docker Hub上。

拉取镜像并运行（使用默认示例模板）：

docker run -d -P auguster/cloud-config-server

若需使用自定义模板，可挂载本地data/目录到容器：

docker run -d -p 8080:8080 -v $PWD/data:/data:ro auguster/cloud-config-server

使用场景

以下使用场景已在CoreOS上测试，其他发行版可能需调整：

PXE启动

通过PXE启动时，可在内核命令行中指定该服务器的URL。参考CoreOS官方文档通过PXE启动CoreOS。

若需在libvirt/virt-manager中启用内部TFTP，可参考Red Hat教程。

静态内容扩展

多数云提供商仅允许向实例传递静态配置，且无法后续编辑。在CoreOS上，可通过以下方式调用外部cloud-config文件：

#cloud-config

coreos:
  units:    
    - name: cloudinit-url.service
      command: restart
      content: |
        [Unit]
        Description=通过外部cloud-config文件重新配置Cloudinit

        [Service]
        Type=oneshot
        ExecStart=/usr/bin/coreos-cloudinit --from-url http://<cloud-config-server的URL>

外部cloud-config的配置会追加到现有配置中。虽然理论上可链式调用多个配置文件，但不建议这样做。

参考资料

• https://github.com/coreos/coreos-baremetal#bootcfg%EF%BC%9ACoreOS%E5%AE%98%E6%96%B9%E7%9A%84PXE/cloud-config%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E4%BD%BF%E7%94%A8go-template%E6%96%87%E4%BB%B6%E3%80%82

许可证

MIT许可证 (MIT) Copyright (c) 2016 Rémi AUGUSTE