转载

使用Rancher-Gen动态更新配置文件

Docker和Rancher让大家能更轻易地部署和管理基于微服务的应用程序。然而，如果有些服务是依赖于其他动态服务的，那该如何管理它们的配置？你是否时常觉得，要是有方法能自动检测后端服务的变化，并实现配置文件的动态更新就好了？本文给你答案。

前言

Docker和Rancher让大家能更轻易地部署和管理基于微服务的应用程序。然而，有一个关键的挑战是，如果有些服务是依赖于其他动态服务的，那该如何管理它们的配置？

试想以下情形：您有多个运行Web应用程序的后端容器，和一些将所有的请求都代理到这些后端容器的nginx容器。现在，你必须要部署一个新版本的Web应用程序，这意味着你需要构建和部署新版本的后端容器。在这些部署工作完成之后，nginx的配置需要更改为指向新的后端容器。那么，你该怎样处理nginx呢？改变其配置，构建一个新的容器并部署它？此刻的你是不是会觉得，要是有方法能自动检测后端服务的变化，并实现nginx的动态更新就好了？

这就是Rancher-Gen要闪亮登场的时刻！

Rancher-Gen是一个Python的工具，它能监听的Rancher服务的变化，并呈现一个用户指定的Jinja2模板。这允许用户为现有的、并基于这些变化的服务生成配置文件。另外，Rancher-Gen提供了一种机制，在模板呈现之后会运行通知命令。下面的教程会介绍如何自动生成运行ghost博客平台后端服务的nginx配置文件。

教程

下面介绍的所有配置文件都可以在Rancher-Gen库中的演示目录下找到。

第1步 – 部署Ghost服务

为简单起见，我们打算使用Docker hub中的官方ghost镜像。因此，创建一个docker-compose.yml 文件，并添加以下的ghost服务：

ghost:

image: ghost

expose:

- "2368"

现在，用Rancher Compose部署ghost服务：

$ rancher-compose -p demo up -d ghost

第2步 – 用Rancher-Gen创建nginx镜像

下面是用以搭建nginx镜像的Dockerfile：

FROM phusion/baseimage:0.9.17

MAINTAINER pitrho

Step 1 - Install nginx and python

ENV DEBIAN_FRONTEND noninteractive

RUN /

apt-add-repository -y ppa:nginx/stable && /

apt-get update && /

apt-get install -y python-software-properties /

wget /

nginx /

python-dev /

python-pip /

libev4 /

libev-dev /

expect-dev && /

rm -rf /var/lib/apt/lists/* && /

chown -R www-data:www-data /var/lib/nginx && /

apt-get clean

Step 2 - Install rancher-gen

ENV RANCHER_GEN_VERSION 0.1.2

RUN pip install rancher-gen==$RANCHER_GEN_VERSION

Step 3 - Define services

RUN mkdir /etc/service/nginx /etc/service/rancher_gen /nginxconf

COPY nginx_run /etc/service/nginx/run

COPY rancher-gen_run /etc/service/rancher_gen/run

COPY default.j2 /nginxconf

Step 4 - Use baseimage-docker's init system.

CMD ["/sbin/my_init"]

Step 5 - Expose ports.

EXPOSE 80

EXPOSE 443

让我们来一步一步拆解Dockerfile。步骤1和2不言自明：只需安装nginx、Python和Rancher-Gen。

第3步要设置镜像启动时运行的服务。第一个服务是nginx，它用/etc/servce/nginx文件运行。该文件的内容是：

!/bin/bash

rancher-gen --host $RANCHER_GEN_HOST /

--port $RANCHER_GEN_PORT /

--access-key $RANCHER_GEN_ACCESS_KEY /

--secret-key $RANCHER_GEN_SECRET_KEY /

--project-id $RANCHER_GEN_PROJECT_ID /

$RANCHER_GEN_OPTIONS /

--notify "service nginx reload" /nginxconf/default.j2 /etc/nginx/sites-available/default

注意一下在通知步骤之后，我们是怎样通过名为 /nginxconf/default.j2 和/etc/nginx/sites-available/default 的这两个路径的。前者是Jinjia2模板，后者是渲染模板的输出位置。以下是在default.j2文件的内容：

upstream ghost.backend {

{% for container in containers %}

{% if container['state'] == "running" %}

server {{container['primaryIpAddress']}}:2368;

{% endif %}

{% endfor %}

}



server {

listen 80;

server_name ghost_demo;

location / {

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header HOST $http_host;

proxy_set_header X-NginX-Proxy true;

proxy_pass http://ghost.backend;

proxy_redirect off;

}

}

Dockerfile的第4步和第5步在镜像中设置了运行命令“/sbin/my_init”并暴露端口80和443。

现在是时候构建镜像了：

$ docker build -t="pitrho/nginx-rancher-gen-demo" .

第3步 – 创建并部署nginx服务

现在我们已有了nginx镜像，就可以开始向我们在第1步中创建的docker-compose.yml文件中添加nginx服务了。

ghost:

image: ghost

expose:

- "2368"



nginx:

image: pitrho/nginx-rancher-gen-demo:latest

ports:

- 80:80

links:

- ghost

environment:

NGINX_RUN_TYPE: rancher-gen

RANCHER_GEN_HOST: $RANCHER_HOST

RANCHER_GEN_PORT: $RANCHER_PORT

RANCHER_GEN_ACCESS_KEY: $RANCHER_ACCESS_KEY

RANCHER_GEN_SECRET_KEY: $RANCHER_SECRET_KEY

RANCHER_GEN_PROJECT_ID: $RANCHER_GEN_PROJECT_ID

RANCHER_GEN_OPTIONS: --stack demo --service ghost

上述可变的RANCHER_GEN_OPTIONS环境是用于向Rancher-Gen传递附加命令行选项的。你可以在Rancher-Gen文档中查看这些选项的说明。

现在运行rancher-compose来启动nginx服务：

$ rancher-compose -p demo up -d nginx

此时，ghost和nginx服务都启动并运行了：

而且，将浏览器指向运行中的nginx容器中主机的IP地址，你就可以访问ghost了：

如果你使用shell来检查nginx容器，并打开渲染的文件 /etc/nginx/sites-enabled/default，你将会看到以下的输出：

upstream ghost.backend {

server 10.42.136.216:2368;

}



server {

 listen 80;

 server_name ghost_demo;



 location / {

     proxy_set_header X-Real-IP $remote_addr;

     proxy_set_header HOST $http_host;

     proxy_set_header X-NginX-Proxy true;

     proxy_pass http://ghost.backend;

     proxy_redirect off;

 }

}

正如预期的那样，这是在运行rancher-gen命令时的基于指定模板的渲染输出。此时，如果你要升级ghost服务，并再次查看渲染文件，你会发现上游部分下的IP地址已经改变了。