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/home.md b/fig/home.md index e69de29..421f211 100644 --- a/fig/home.md +++ b/fig/home.md @@ -0,0 +1,140 @@ +##快速搭建基于 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](../_imagess/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 +``` +下一步我们要创建一个包含应用所有依赖的 Doker 镜像,这里将阐述怎么通过 `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)。 +