Docker Compose 文档的日语参考翻译 摘要和目录
这是一个参考翻译。
请编写文档目录(中文翻译)。
-
- ユーザ・ガイド(このページです)
-
- インストール
-
- Compose をプロダクションで使うには
-
- Compose の拡張サービス
-
- コマンド補完
-
- クイックスタート・ガイド:Compose と Django
-
- クイックスタート・ガイド:Compose と Rails
- クイックスタート・ガイド:Compose と WordPress
创作一个“参考目录”(中文翻译)。
-
- CLI リファレンス
-
- docker-compose.yml リファレンス
- 環境変数リファレンス
Docker Compose 文档参考日本语翻译 概要
原文:Docker Compose 概述
https://docs.docker.com/compose/
Chinese paraphrase:
Docker Compose 概览
https://docs.docker.com/compose/
Compose 是一种基于Docker 使用多个容器定义和运行应用程序的工具。通过使用Compose,您可以在一个文件中定义使用多个容器的应用程序。然后,只需执行一个命令,即可启动应用程序所需的所有内容。
這個工具非常適合開發環境、演示伺服器和持續整合。然而,我們不建議在正式環境中使用它(翻譯註:因為目前的版本0.3.0處於測試版階段,已知的錯誤和功能改進可能會導致本文件本身也發生變化)。
要使用Compose,基本上需要经过三个步骤。
-
- 使用 Dockerfile 配置应用程序的环境。此文件可在任何地方重复使用。
-
- 在 docker-compose.yml 文件中,将应用程序组合在一起并定义为服务,这样可以在同一环境中同时运行。
- 然后,执行 docker-compose up,Compose 将启动和执行整个应用程序。
这个 docker-compose.yml 文件的内容如下:
web:
build: .
ports:
- "5000:5000"
volumes:
- .:/code
links:
- redis
redis:
image: redis
Compose包含有管理应用程序生命周期的命令。
-
- 起動、停止、サービスの再構築
-
- 実行中のサービスの状態を参照
-
- 実行中のサービスのストリーム・ログ出力
- 1回だけのサービスをコマンドで実行
写一个文章
-
- Compose のインストール
-
- Django の始め方
-
- Rails の始め方
-
- WordPress の始め方
-
- コマンドライン・リファレンス
-
- YAML ファイル・リファレンス
-
- Compose 環境変数
- Compose コマンドライン補完
快速启动
让我们开始练习使用Compose来运行一个简单的Python Web应用程序。虽然需要一些Python知识,但即使对Python不熟悉,您也可以理解所显示内容的概念。
安装和设置
首先,安装Docker和Compose。
接下来,我们将创建项目(译者注:用于工作)的目录:
$ mkdir composetest
$ cd composetest
在目录中切换,并创建一个名为app.py的文件。在文件中使用Flask框架创建一个简单的Web应用程序,用于将值递增到Redis中。
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 镜像
那么,我们将创建一个包含应用程序所依赖的所有内容的 Docker 镜像。通过一个称为 Dockerfile 的文件来描述要创建的镜像类型。
FROM python:2.7
ADD . /code
WORKDIR /code
RUN pip install -r requirements.txt
CMD python app.py
这个文件要传达给Docker的是
-
- Python 2.7 イメージを使ってイメージの構築を始める
-
- 現在のディレクトリ . を、イメージの /code に追加する
-
- 作業ディレクトリを /code に指定する
-
- Python に依存するパッケージをインストールする
python app.py をコンテナのデフォルト・コマンドに指定する
请阅读 Docker 用户指南和 Docker 参考手册,以获取有关 Dockerfile 的详细信息。
要构建,请运行 docker build -t web .。
服务的定义
接下来,我们使用docker-compose.yml来定义一组服务。
web:
build: .
ports:
- "5000:5000"
volumes:
- .:/code
links:
- redis
redis:
image: redis
在这里,我们定义了两个服务:
互联网
-
- 現在のディレクトリにある Dockerfile から構築する
-
- コンテナの公開ポート 5000 をホストマシン上のポート 5000 に転送する
-
- web コンテナを Redis サービスにリンクして接続する
- ホスト上の現在のディレクトリをコンテナの /code にマウントし、コードを変更したいときのイメージ再構築を不要にする
Redis,仅提供一种选择,请在中文中进行释义
- Docker Hub レジストリから公開 Redis イメージを取得する
使用Compose构建和运行应用程序
当执行 docker-compose up 时,Compose 会拉取 Redis 镜像并创建用于代码的镜像,然后启动全部服务。
$ docker-compose up
Pulling image redis...
Building web...
Starting composetest_redis_1...
Starting composetest_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命令查看IP地址)。在浏览器中打开http://boot2docker的IP地址:5000,将显示如下内容:
你好,世界!我已经被看到了一次。
当您刷新页面时,编号会增加。
如果想在后台运行服务,请使用-d标志(“detached”模式)执行docker-compose up命令,然后使用docker-compose ps命令查看正在运行的服务:
$ docker-compose up -d
Starting composetest_redis_1...
Starting composetest_web_1...
$ docker-compose ps
Name Command State Ports
-------------------------------------------------------------------
composetest_redis_1 /usr/local/bin/run Up
composetest_web_1 /bin/sh -c python app.py Up 5000->5000/tcp
docker-compose run 是一条命令,只运行一次服务。例如,要查看在 web 服务中可用的环境变量:
$ docker-compose run web env
请查看 docker-compose –help 以获得可用命令的相关信息。
如果使用docker-compose up -d 来运行Compose,那么一旦完成,很可能会停止服务。
$ docker-compose stop
我們已經看過以上、Compose的基本操作了。
-
- 次は、Django、Rails、Wordpress を試しましょう。
コマンド、設定ファイル、環境変数に関するリファレンス・ガイドもご覧ください。
发布说明
版本1.2.0(2015年4月7日)
请阅读1.2.0里程碑项目页面(英语)以获取有关发布的所有信息。
-
- extends キーワードは、共有設定ファイルをでサービスを拡張することができます。詳細はプルリクエスト #1088(英語)をご覧ください。
- Swarm とう上手く連携できます。Swarm は同じホスト上にあるコンテナの、相互依存をスケジュールします。“詳細はプルリクエスト #972をご覧ください。
要获取帮助,请
如果需要帮助,可以向贡献者或在项目中有相同想法的人求助。我们提供沟通渠道,Docker Compose仍处于初期阶段,并且正在积极开发中。
-
- バグや機能リクエスト:GitHub の issue trackerをお使いください。
-
- プロジェクトの方とリアルタイムに話したい:IRC の #docker-compose チャンネルに参加ください。
- コードの貢献やドキュメントの変更:GitHub 上でプルリクエストをください。
请参阅“取得帮助项目页面”以获取更详细的信息和资源。
如果有任何问题,请提出修改请求或者给出评论,谢谢。