Docker Compose基本使用

雨点打透心脏的1/2处 2022-01-29 01:09 246阅读 0赞

# 开始使用Docker Compose #

*预计阅读时间： 10分钟，转自[docker官方文档][docker]*

在此页面上，您将构建一个在Docker Compose上运行的简单Python Web应用程序。该应用程序使用Flask框架并在Redis中维护一个命中计数器。虽然该示例使用Python，但即使您不熟悉它，此处演示的概念也应该是可以理解的。

## 先决条件 ##

确保您已经安装了[Docker Engine][]和[Docker Compose][]。您不需要安装Python或Redis，因为它们都是由Docker镜像提供的。

## 第1步：安装 ##

定义应用程序依赖项。

1. 为项目创建一个目录：
 
 <code>$ mkdir composetest
 $ cd composetest
 </code>
2. 创建一个`app.py`在项目目录中调用的文件并将其粘贴到：
 
 <code>import time
 
 import redis
 from flask import Flask
 
 
 app = Flask(__name__)
 cache = redis.Redis(host='redis', port=6379)
 
 
 def get_hit_count():
 retries = 5
 while True:
 try:
 return cache.incr('hits')
 except redis.exceptions.ConnectionError as exc:
 if retries == 0:
 raise exc
 retries -= 1
 time.sleep(0.5)
 
 
 @app.route('/')
 def hello():
 count = get_hit_count()
 return 'Hello World! I have been seen {} times.\n'.format(count)
 
 if __name__ == "__main__":
 app.run(host="0.0.0.0", debug=True)
 </code>
 
 在此示例中，`redis`是应用程序网络上redis容器的主机名。我们使用Redis的默认端口`6379`。
 
 > **处理瞬态错误**
 > 
 > 注意`get_hit_count`函数的编写方式。如果redis服务不可用，这个基本的重试循环允许我们多次尝试我们的请求。这在应用程序联机时启动时非常有用，但如果需要在应用程序生命周期内的任何时间重新启动Redis服务，这也会使我们的应用程序更具弹性。在群集中，这还有助于处理节点之间的瞬时连接丢弃。
3. 创建`requirements.txt`项目目录中调用的另一个文件并将其粘贴到：
 
 <code>flask
 redis
 </code>

## 第2步：创建Dockerfile ##

在此步骤中，您将编写一个构建Docker镜像的Dockerfile。该图像包含Python应用程序所需的所有依赖项，包括Python本身。

在项目目录中，创建一个名为的文件`Dockerfile`并粘贴以下内容：

<code>FROM python:3.4-alpine
 ADD . /code
 WORKDIR /code
 RUN pip install -r requirements.txt
 CMD ["python", "app.py"]
 </code>

这告诉Docker：

*  从Python 3.4映像开始构建映像。
 *  将当前目录添加`.`到`/code`映像中的路径中。
 *  将工作目录设置为`/code`。
 *  安装Python依赖项。
 *  将容器的默认命令设置为`python app.py`。

有关如何编写Dockerfiles的更多信息，请参阅[Docker用户指南][Docker] 和[Dockerfile参考][Dockerfile]。

## 第3步：在Compose文件中定义服务 ##

创建`docker-compose.yml`在项目目录中调用的文件并粘贴以下内容：

<code>version: '3'
 services:
 web:
 build: .
 ports:
 - "5000:5000"
 redis:
 image: "redis:alpine"
 </code>

此Compose文件定义了两个服务：`web`和`redis`。

### 网络服务 ###

该`web`服务使用从`Dockerfile`当前目录中构建的映像。然后它将容器和主机绑定到暴露的端口`5000`。此示例服务使用Flask Web服务器的默认端口`5000`。

### Redis服务 ###

该`redis`服务使用 从Docker Hub注册表中提取的公共[Redis][]映像。

## 第4步：使用Compose构建并运行您的应用程序 ##

1. 从项目目录中，通过运行启动应用程序`docker-compose up`。
 
 <code>$ docker-compose up
 Creating network "composetest_default" with the default driver
 Creating composetest_web_1 ...
 Creating composetest_redis_1 ...
 Creating composetest_web_1
 Creating composetest_redis_1 ... done
 Attaching to composetest_web_1, composetest_redis_1
 web_1 | * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)
 redis_1 | 1:C 17 Aug 22:11:10.480 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
 redis_1 | 1:C 17 Aug 22:11:10.480 # Redis version=4.0.1, bits=64, commit=00000000, modified=0, pid=1, just started
 redis_1 | 1:C 17 Aug 22:11:10.480 # Warning: no config file specified, using the default config. In order to specify a config file use redis-server /path/to/redis.conf
 web_1 | * Restarting with stat
 redis_1 | 1:M 17 Aug 22:11:10.483 * Running mode=standalone, port=6379.
 redis_1 | 1:M 17 Aug 22:11:10.483 # WARNING: The TCP backlog setting of 511 cannot be enforced because /proc/sys/net/core/somaxconn is set to the lower value of 128.
 web_1 | * Debugger is active!
 redis_1 | 1:M 17 Aug 22:11:10.483 # Server initialized
 redis_1 | 1:M 17 Aug 22:11:10.483 # WARNING you have Transparent Huge Pages (THP) support enabled in your kernel. This will create latency and memory usage issues with Redis. To fix this issue run the command 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' as root, and add it to your /etc/rc.local in order to retain the setting after a reboot. Redis must be restarted after THP is disabled.
 web_1 | * Debugger PIN: 330-787-903
 redis_1 | 1:M 17 Aug 22:11:10.483 * Ready to accept connections
 </code>
 
 Compose拉取Redis图像，为您的代码构建图像，并启动您定义的服务。在这种情况下，代码在构建时静态复制到映像中。
2. `http://0.0.0.0:5000/`在浏览器中输入以查看正在运行的应用程序。
 
 如果您在Linux，Docker Desktop for Mac或Docker Desktop for Windows上本机使用Docker，那么Web应用程序现在应该在Docker守护程序主机上的端口5000上进行侦听。指向您的Web浏览器`http://localhost:5000`以查找`Hello World`消息。如果这不能解决，您也可以尝试 `http://0.0.0.0:5000`。
 
 如果您在Mac或Windows上使用Docker Machine，请使用`docker-machine ip MACHINE_VM`获取Docker主机的IP地址。然后，`http://MACHINE_VM_IP:5000`在浏览器中打开 。
 
 您应该在浏览器中看到一条消息：
 
 <code>Hello World! I have been seen 1 times.
 </code>
 
 ![浏览器中的hello world][hello world]
3. 刷新页面。
 
 数字应该增加。
 
 <code>Hello World! I have been seen 2 times.
 </code>
 
 ![浏览器中的hello world][hello world 1]
4. 切换到另一个终端窗口，然后键入`docker image ls`以列出本地图像。
 
 此时列出图像应返回`redis`和`web`。
 
 <code>$ docker image ls
 REPOSITORY TAG IMAGE ID CREATED SIZE
 composetest_web latest e2c21aa48cc1 4 minutes ago 93.8MB
 python 3.4-alpine 84e6077c7ab6 7 days ago 82.5MB
 redis alpine 9d8fa9aa0e5b 3 weeks ago 27.5MB
 </code>
 
 你可以检查图像`docker inspect <tag or id>`。
5. 通过`docker-compose down` 在第二个终端的项目目录中运行，或者在启动应用程序的原始终端中按CTRL + C来停止应用程序。

## 步骤5：编辑Compose文件以添加绑定装载 ##

编辑`docker-compose.yml`在项目目录添加[绑定安装][Link 1]的`web`服务：

<code>version: '3'
 services:
 web:
 build: .
 ports:
 - "5000:5000"
 volumes:
 - .:/code
 redis:
 image: "redis:alpine"
 </code>

新`volumes`密钥将主机上的项目目录（当前目录）`/code`安装到容器内，允许您动态修改代码，而无需重建映像。

## 第6步：使用Compose重新构建并运行应用程序 ##

从项目目录中，键入`docker-compose up`以使用更新的Compose文件构建应用程序，然后运行它。

<code>$ docker-compose up
 Creating network "composetest_default" with the default driver
 Creating composetest_web_1 ...
 Creating composetest_redis_1 ...
 Creating composetest_web_1
 Creating composetest_redis_1 ... done
 Attaching to composetest_web_1, composetest_redis_1
 web_1 | * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)
 ...
 </code>

`Hello World`再次在Web浏览器中检查消息，然后刷新以查看计数增量。

> **共享文件夹，卷和绑定装入**
> 
>  *  如果您的项目位于`Users`目录（`cd ~`）之外，则需要共享Dockerfile的驱动器或位置以及您正在使用的卷。如果您收到运行时错误，指示未找到应用程序文件，则会拒绝卷装入，或者服务无法启动，请尝试启用文件或驱动器共享。卷安装需要共享驱动器用于`C:\Users`（Windows）或`/Users`（Mac）之外的项目 ，并且对于使用[Linux容器的][Linux] Docker Desktop for Windows上的*任何*项目都是必需的。有关更多信息，请参阅 适用于Windows的Docker Desktop上的[共享驱动器][Link 2]，适用于Mac的Docker上的[文件共享][Link 3]以及有关如何[管理容器中数据][Link 4]的一般示例。
>  *  如果您在较旧的Windows操作系统上使用Oracle VirtualBox，则可能会遇到此虚拟机[故障单中][Link 5]所述的共享文件夹[问题][Link 5]。较新的Windows系统满足[Docker Desktop for Windows][]的要求，不需要VirtualBox。

## 第7步：更新应用程序 ##

由于应用程序代码现在使用卷安装到容器中，因此您可以更改其代码并立即查看更改，而无需重建映像。

1. 更改问候语`app.py`并保存。例如，将`Hello World!`邮件更改为`Hello from Docker!`：
 
 <code>return 'Hello from Docker! I have been seen {} times.\n'.format(count)
 </code>
2. 在浏览器中刷新应用程序。问候语应该更新，计数器仍然应该递增。
 
 ![浏览器中的hello world][hello world 2]

## 第8步：尝试其他一些命令 ##

如果要在后台运行服务，可以将`-d`标志（用于“分离”模式）传递给`docker-compose up`并使用`docker-compose ps`以查看当前正在运行的内容：

<code>$ 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
 </code>

该`docker-compose run`命令允许您为服务运行一次性命令。例如，要查看`web`服务可用的环境变量 ：

<code>$ docker-compose run web env
 </code>

请`docker-compose --help`参阅其他可用命令。您还可以为bash和zsh shell 安装[命令完成][Link 6]，它还会显示可用的命令。

如果您开始使用Compose `docker-compose up -d`，请在完成后停止服务：

<code>$ docker-compose stop
 </code>

您可以使用该`down` 命令将所有内容放下，完全删除容器。传递`--volumes`还删除Redis容器使用的数据卷：

<code>$ docker-compose down --volumes
 </code>

此时，您已经了解了Compose如何工作的基础知识。

需要了解dockercompose编写格式，和它的安装使用的小伙伴可以点以下链接

[docker-compose安装][Docker Compose]

[docker-compose命令][docker-compose]

[docker-compose格式][docker-compose 1]

[docker]: https://docs.docker.com/compose/gettingstarted/
[Docker Engine]: https://docs.docker.com/install/
[Docker Compose]: https://docs.docker.com/compose/install/
[Docker]: https://docs.docker.com/engine/tutorials/dockerimages/#building-an-image-from-a-dockerfile
[Dockerfile]: https://docs.docker.com/engine/reference/builder/
[Redis]: https://registry.hub.docker.com/_/redis/
[hello world]: /images/20220129/709eaa589b9b45739e8e61987760a250.png
[hello world 1]: /images/20220129/71b7b4772ef04a718f871d97c85d50b2.png
[Link 1]: https://docs.docker.com/engine/admin/volumes/bind-mounts/
[Linux]: https://docs.docker.com/docker-for-windows/#switch-between-windows-and-linux-containers-beta-feature
[Link 2]: https://docs.docker.com/docker-for-windows/#shared-drives
[Link 3]: https://docs.docker.com/docker-for-mac/#file-sharing
[Link 4]: https://docs.docker.com/engine/tutorials/dockervolumes/
[Link 5]: https://www.virtualbox.org/ticket/14920
[Docker Desktop for Windows]: https://docs.docker.com/docker-for-windows/install/
[hello world 2]: /images/20220129/2079a1cda0144537977bab994eb6409f.png
[Link 6]: https://docs.docker.com/compose/completion/
[docker-compose]: https://docs.docker.com/compose/reference/
[docker-compose 1]: https://docs.docker.com/compose/compose-file/