一种 Dockerize 应用的简单方式

一种 Dockerize 应用的简单方式

标签（空格分隔）： Docker dockerize

---

做者是 jasonwilder。原文地址是 A Simple Way to Dockerize Applications

Dockerizing 一个应用是转化一个应用运行在 Docker 容器中的过程。虽然 dockering 大部分应用是简单的，可是这里每次都有一些问题围绕着工做。每次工做的时候有几个问题都须要待解决。

在 dockerization 时两个常见的问题是：

1. 当它依赖于配置文件时，使得应用使用环境变量
2. 发送应用日志到 STDOUT/STDERR，当它默认记录在 Docker 的文件系统

这篇文章介绍一个新工具：dockerize ，它简化了这两个常见的问题。

问题

配置

许多应用使用配置文件来控制它们怎么工做，不一样的运行环境有不一样的值。好比，对于一个开发环境的数据库链接细节将与生产环境的不一样。相似的，API keys 和其余的敏感细节在不一样环境将不一样。

使用 docker 容器有几个方法能够处理这些环境变量的问题：

1. 在镜像中嵌入全部的环境变量细节和使用一个控制环境变量变量来指出在运行时使用哪一个文件。（好比：APP_CONFIG=/etc/dev.config）
2. 在运行时，使用卷来挂载绑定配置文件的数据
3. 使用封装脚本，使用工具像 sed 那些环境变量来修改配置数据

嵌入全部的环境变量细节是不理想的，由于环境变量的改变应该不须要从新构建一个镜像。它也缺乏安全，由于敏感数据 API keys， login 证书等等,做为环境变量被存储在镜像中。私发一个开发环境可能会泄露生产环境细节。有些类型的细节在任何镜像中都应该避免的。
使用 volumes 保持这些细节在镜像外面，但会使得部署更复杂，由于你不只部署镜像。你必须使配置文件的变动和镜像协调。

注入环境变量到普通文件中也不是重要的。你可能有时会制做一个 sed 命令或写一些普通的脚本给它，但这是重复性的工做。这确实产生了一个镜像，但在 Docker 生态系统中工做的很好。

Logging

Docker 容器日志记录到 STDOUT 和 STDERR 更容易故障排解，监控和融入一个中央日志系统。日志能够经过 docker logs 命令和 Docker 日志 API 调用来直接访问。这也有许多工具能够自动拉取 docker 日志和运送它们若是日志记录进 STDOUT 和 STDERR。

不幸地是，默认，许多应用日志记录一个或多个文件到文件系统上。虽然这一般能够围绕工做，计算出每一个应用的日志配置的细微差异是乏味的。

使用 Dockerize

dockerize 是一个小型的 Golang 应用，能够经过如下简化 dockerization 过程：

1. 在启动时使用模板生成配置文件和容器环境变量
2. tail 任意的日志文件到 STDOUT 和 STDERR
3. 启动一个进程，运行在容器里面

一个示例

为了证实它怎样工做，咱们将详细讲述使用 dockerize 来 dockerizing 一个通常的 nginx 的过程。

FROM ubuntu:14.04

# Install Nginx.
RUN echo "deb http://ppa.launchpad.net/nginx/stable/ubuntu trusty main" > /etc/apt/sources.list.d/nginx-stable-trusty.list
RUN echo "deb-src http://ppa.launchpad.net/nginx/stable/ubuntu trusty main" >> /etc/apt/sources.list.d/nginx-stable-trusty.list
RUN apt-key adv --keyserver keyserver.ubuntu.com --recv-keys C300EE8C
RUN apt-get update
RUN apt-get install -y nginx

RUN echo "daemon off;" >> /etc/nginx/nginx.conf

EXPOSE 80

CMD nginx

下一步，咱们将安装 dockerize 和经过它运行 nginx：

FROM ubuntu:14.04

# Install Nginx.
RUN echo "deb http://ppa.launchpad.net/nginx/stable/ubuntu trusty main" > /etc/apt/sources.list.d/nginx-stable-trusty.list
RUN echo "deb-src http://ppa.launchpad.net/nginx/stable/ubuntu trusty main" >> /etc/apt/sources.list.d/nginx-stable-trusty.list
RUN apt-key adv --keyserver keyserver.ubuntu.com --recv-keys C300EE8C
RUN apt-get update
RUN apt-get install -y wget nginx

RUN echo "daemon off;" >> /etc/nginx/nginx.conf

RUN wget https://github.com/jwilder/dockerize/releases/download/v0.0.1/dockerize-linux-amd64-v0.0.1.tar.gz
RUN tar -C /usr/local/bin -xvzf dockerize-linux-amd64-v0.0.1.tar.gz

ADD dockerize /usr/local/bin/dockerize

EXPOSE 80

CMD dockerize nginx

默认 Nginx 在 /var/log/nginx 目录下记录两个不一样的文件。若是你交互式的运行这个容器，这将有 nginx 的 access and error 日志流到控制台，或者是你运行 docker logs nginx，所以你能够看到发生了什么。

咱们能够经过传递 -stdout <file> 和 -stderr <file> 命令行选项来解决它。若是你有几个文件须要 tail ，这里能够传递屡次。

CMD dockerize -stdout /var/log/nginx/access.log -stderr /var/log/nginx/error.log nginx

如今当你运行容器，nginx 日志经过 docker logs nginx 是可用的。

为了证实模板，咱们可使用环境变量配置让这个变成一个更通用的代理服务器。咱们将定义环境变量 PROXY_URL 做为一个站点的代理 URL。

PROXY_URL="http://jasonwilder.com"

当这个容器使用这个环境变量启动，dockerize 将使用它来生成一个 nginx 的location 路径。

这是模板：

server {
    listen 80 default_server;
    listen [::]:80 default_server ipv6only=on;

    root /usr/share/nginx/html;
    index index.html index.htm;

    # Make site accessible from http://localhost/
    server_name localhost;

    location / {
      access_log off;
      proxy_pass {{ .Env.PROXY_URL }};
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header Host $host;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

这时咱们最后的 Dockerfile 将看起来这样：

FROM ubuntu:14.04

# Install Nginx.
RUN echo "deb http://ppa.launchpad.net/nginx/stable/ubuntu trusty main" > /etc/apt/sources.list.d/nginx-stable-trusty.list
RUN echo "deb-src http://ppa.launchpad.net/nginx/stable/ubuntu trusty main" >> /etc/apt/sources.list.d/nginx-stable-trusty.list
RUN apt-key adv --keyserver keyserver.ubuntu.com --recv-keys C300EE8C
RUN apt-get update
RUN apt-get install -y wget nginx

RUN echo "daemon off;" >> /etc/nginx/nginx.conf

RUN wget https://github.com/jwilder/dockerize/releases/download/v0.0.1/dockerize-linux-amd64-v0.0.1.tar.gz
RUN tar -C /usr/local/bin -xvzf dockerize-linux-amd64-v0.0.1.tar.gz

ADD default.tmpl /etc/nginx/sites-available/default.tmpl

EXPOSE 80

CMD dockerize -template /etc/nginx/sites-available/default.tmpl:/etc/nginx/sites-available/default -stdout /var/log/nginx/access.log -stderr /var/log/nginx/error.log nginx

-template <src>:<dest> 选项指明 template 在 /etc/nginx/sites-available/default.tmpl 应该被生成并写入 /etc/nginx/sites-available/default。多个模板也能够被指定。

使用下面命令运行容器：

$ docker run -p 80:80 -e PROXY_URL="http://jasonwilder.com" --name nginx -d nginx

而后你能够经过 http://localhost 访问，它将代理到这个站点。

这是一个简化的例子，可是使用嵌入的 split 函数和 range 声明使它能够很容易的被扩展来处理多个代理值和其余选项。这里有一些其余的可用模板函数示例。

总结

虽然这个例子有点简单，许多应用须要一些 shims 来使得在 Docker 中运行的更好。dockerize 是一个通用的工具来帮助你处理这个过程。

你能够在 jwilder/dockerize 找到代码。