diff --git a/_images/fig-example-large.gif b/_images/fig-example-large.gif new file mode 100644 index 0000000..27a82a4 Binary files /dev/null and b/_images/fig-example-large.gif differ diff --git a/fig/README.md b/fig/README.md new file mode 100644 index 0000000..2a47bcf --- /dev/null +++ b/fig/README.md @@ -0,0 +1,2 @@ +#Fig +在你的应用里面添加一个 `fig.yml` 文件,并指定一些简单的内容,执行 `fig up` 它就能帮你快速建立起一个容器。 \ No newline at end of file diff --git a/fig/home.md b/fig/home.md new file mode 100644 index 0000000..07abbf8 --- /dev/null +++ b/fig/home.md @@ -0,0 +1,141 @@ +##快速搭建基于 Docker 的隔离开发环境 + +使用 `Dockerfile` 文件指定你的应用环境,让它能在任意地方复制使用: + +``` +FROM python:2.7 +ADD . /code +WORKDIR /code +RUN pip install -r requirements.txt +``` + +在 `fig.yml` 文件中指定应用使用的不同服务,让它们能够在一个独立的环境中一起运行: + +``` +web: + build: . + command: python app.py + links: + - db + ports: + - "8000:8000" +db: + image: postgres +``` +*注意不需要再额外安装 Postgres 了!* + +接着执行命令 `fig up` ,然后 Fig 就会启动并运行你的应用了。 + +![Docker](../_images/fig-example-large.gif) + +Fig 可用的命令有: + +* 启动、停止,和重建服务 +* 查看服务的运行状态 +* 查看运行中的服务的输入日志 +* 对服务发送命令 + +##快速上手 +我们试着让一个基本的 Python web 应用运行在 Fig 上。这个实验假设你已经知道一些 Python 知识,如果你不熟悉,但清楚概念上的东西也是没有问题的。 + +首先,[安装 Docker 和 Fig](install.md) + +为你的项目创建一个目录 + +``` +$ mkdir figtest +$ cd figtest +``` +进入目录,创建 `app.py`,这是一个能够让 Redis 上的一个值自增的简单 web 应用,基于 Flask 框架。 + +``` +from flask import Flask +from redis import Redis +import os +app = Flask(__name__) +redis = Redis(host='redis', port=6379) + +@app.route('/') +def hello(): + redis.incr('hits') + return 'Hello World! I have been seen %s times.' % redis.get('hits') + +if __name__ == "__main__": + app.run(host="0.0.0.0", debug=True) +``` +在 `requirements.txt` 文件中指定应用的 Python 依赖包。 + +``` +flask +redis +``` +下一步我们要创建一个包含应用所有依赖的 Docker 镜像,这里将阐述怎么通过 `Dockerfile` 文件来创建。 + +``` +FROM python:2.7 +ADD . /code +WORKDIR /code +RUN pip install -r requirements.txt +``` +以上的内容首先告诉 Docker 在容器里面安装 Python ,代码的路径还有Python 依赖包。关于 Dockerfile 的更多信息可以查看 [镜像创建](../image/create.md#利用 Dockerfile 来创建镜像) 和 [Dockerfile 使用](../dockerfile/README.md) + +接着我们通过 `fig.yml` 文件指定一系列的服务: + +``` +web: + build: . + command: python app.py + ports: + - "5000:5000" + volumes: + - .:/code + links: + - redis +redis: + image: redis + ``` +这里指定了两个服务: + +* web 服务,通过当前目录的 `Dockerfile` 创建。并且说明了在容器里面执行`python app.py ` 命令 ,转发在容器里开放的 5000 端口到本地主机的 5000 端口,连接 Redis 服务,并且挂载当前目录到容器里面,这样我们就可以不用重建镜像也能直接使用代码。 +* redis 服务,我们使用公用镜像 [redis](https://registry.hub.docker.com/_/redis/)。 +* +现在如果执行 `fig up` 命令 ,它就会拉取 redis 镜像,启动所有的服务。 + +``` +$ fig up +Pulling image redis... +Building web... +Starting figtest_redis_1... +Starting figtest_web_1... +redis_1 | [8] 02 Jan 18:43:35.576 # Server started, Redis version 2.8.3 +web_1 | * Running on http://0.0.0.0:5000/ +``` +这个 web 应用已经开始在你的 docker 守护进程里面监听着 5000 端口了(如果你有使用 boot2docker ,执行 `boot2docker ip` ,就会看到它的地址)。 + +如果你想要在后台运行你的服务,可以在执行 `fig up` 命令的时候添加 `-d` 参数,然后使用 `fig ps` 查看有什么进程在运行。 + +``` +$ fig up -d +Starting figtest_redis_1... +Starting figtest_web_1... +$ fig ps + Name Command State Ports +------------------------------------------------------------------- +figtest_redis_1 /usr/local/bin/run Up +figtest_web_1 /bin/sh -c python app.py Up 5000->5000/tcp +``` + +`fig run` 指令可以帮为你的服务发送命令。例如:查看 web 服务可以获取到的环境变量: + +``` +$ fig run web env +``` +执行帮助命令 `fig --help` 查看其它可用的参数。 + +假设你使用了 `fig up -d` 启动 Fig,可以通过以下命令停止你的服务: + +``` +$ fig stop +``` +以上内容或多或少得讲述了如何 Fig 。通过查看下面的引用章节可以了解到关于命令、配置和环境变量的更多细节。如果你任何想法或建议,[可以在 GitHub 上提出](https://github.com/docker/fig)。 + diff --git a/fig/install.md b/fig/install.md new file mode 100644 index 0000000..9a81d3a --- /dev/null +++ b/fig/install.md @@ -0,0 +1,28 @@ +##安装 Fig + +首先,安装 1.3 或者更新的 Docker 版本。 + +如果你的工作环境是 OS X ,可以通过查看 [Mac 安装指南(英文)](https://docs.docker.com/installation/mac/) ,完成安装 Docker 和 boot2docker 。一旦 boot2docker 运行后,执行以下指令设置一个环境变量,接着 Fig 就可以和它交互了。 + +``` +$(boot2docker shellinit) +``` +**如果想避免重启后重新设置,可以把上面的命令加到你的 ` ~/.bashrc` 文件里。* + +关于 `Ubuntu` 还有 `其它的平台` 的安装,可以参照 [Ubuntu 安装指南(中文)](../install/ubuntu.md) 以及 [官方安装手册(英文)](https://docs.docker.com/installation/)。 + + +下一步,安装 Fig : + +``` +curl -L https://github.com/docker/fig/releases/download/1.0.1/fig-`uname -s`-`uname -m` > /usr/local/bin/fig; chmod +x /usr/local/bin/fig +``` +**如果你的 Docker 是管理员身份安装,以上命令可能也需要相同的身份。* + +目前 Fig 的发行版本只支持 OSX 和 64 位的 Linux 系统。但因为它是用 Python 语言写的,所以对于其它平台上的用户,可以通过 Python 安装包来完成安装(支持的系统同样适用)。 + +``` +$ sudo pip install -U fig +``` +到这里就已经完成了。 执行 `fig --version` ,确认能够正常运行。 +