开始使用Docker Compose

$ mkdir composetest
$ cd composetest
    
app.py在您的项目目录中创建一个名为的文件，并将其粘贴到：
    
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)
    
在此示例中，redis是应用程序网络上的redis容器的主机名。我们为Redis使用默认端口6379。
      
处理瞬态错误
      
注意get_hit_count函数的编写方式。如果redis服务不可用，此基本的重试循环可让我们多次尝试请求。这在应用程序联机时在启动时很有用，但是如果需要在应用程序的生命周期内随时重新启动Redis服务，则还可以使我们的应用程序更具弹性。在群集中，这还有助于处理节点之间的瞬时连接断开。
    
requirements.txt在项目目录中创建另一个名为的文件，并将其粘贴到：
    
flask
redis
在此步骤中，您将编写一个构建Docker映像的Dockerfile。该图像包含Python应用程序所需的所有依赖关系，包括Python本身。
在您的项目目录中，创建一个名为的文件Dockerfile并粘贴以下内容：
# syntax=docker/dockerfile:1
FROM python:3.7-alpine
WORKDIR /code
ENV FLASK_APP=app.py
ENV FLASK_RUN_HOST=0.0.0.0
RUN apk add --no-cache gcc musl-dev linux-headers
COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt
EXPOSE 5000
COPY . .
CMD ["flask", "run"]
这告诉Docker：
  
从Python 3.7映像开始构建映像。
  
将工作目录设置为/code。
  
设置flask命令使用的环境变量。
  
安装gcc和其他依赖项
  
复制requirements.txt并安装Python依赖项。
  
将元数据添加到图像以描述容器正在侦听端口5000
  
将.项目中的当前目录复制到.映像中的工作目录。
  
将容器的默认命令设置为flask run。
有关如何编写Dockerfile的更多信息，请参阅《
 Docker用户指南》
和《Dockerfile参考》。
步骤3：在撰写文件中定义服务
docker-compose.yml在您的项目目录中创建一个名为的文件，然后粘贴以下内容：
version: "3.9"
services:
  web:
    build: .
    ports:
      - "5000:5000"
  redis:
    image: "redis:alpine"
该Compose文件定义了两个服务：web和redis。
该web服务使用从Dockerfile当前目录中构建的映像。然后，它将容器和主机绑定到暴露的端口5000。此示例服务使用Flask Web服务器的默认端口5000。
Redis服务
该redis服务使用 
从Docker Hub注册表中提取的公共Redis映像。
步骤4：使用Compose构建和运行您的应用
    
在项目目录中，运行来启动应用程序docker-compose up。
    
$ 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
    
Compose提取一个Redis映像，为您的代码构建一个映像，然后启动您定义的服务。在这种情况下，代码会在构建时静态复制到映像中。
    
在浏览器中输入http：// localhost：5000 /以查看该应用程序正在运行。
    
如果您在Linux，Mac的Docker Desktop或Windows的Docker Desktop上本地使用Docker，则Web应用程序现在应该在Docker守护程序主机上的端口5000上进行侦听。将您的Web浏览器指向http：// localhost：5000以查找Hello World消息。如果仍然无法解决，您也可以尝试http://127.0.0.1:5000。
    
如果您在Mac或Windows上使用Docker Machine，请使用docker-machine ip
MACHINE_VM来获取Docker主机的IP地址。然后，http://MACHINE_VM_IP:5000在浏览器中打开
    
您应该在浏览器中看到一条消息，内容为：
    
Hello World! I have been seen 1 times.
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
    
您可以使用检查图像docker inspect <tag or id>。
    
通过docker-compose down
从第二个终端的项目目录中运行，或在启动该应用的原始终端中按CTRL + C来停止该应用。
步骤5：编辑Compose文件以添加绑定挂载
编辑docker-compose.yml在项目目录添加
绑定安装的web服务：
version: "3.9"
services:
  web:
    build: .
    ports:
      - "5000:5000"
    volumes:
      - .:/code
    environment:
      FLASK_ENV: development
  redis:
    image: "redis:alpine"
新volumes密钥将主机上的项目目录（当前目录）/code安装到容器内部，使您可以即时修改代码，而不必重建映像。该environment键设置了
FLASK_ENV环境变量，该变量指示flask run要在开发模式下运行并在更改时重新加载代码。此模式只能在开发中使用。
步骤6：使用Compose重建并运行应用程序
在项目目录中，键入docker-compose up以使用更新的Compose文件构建应用程序，然后运行它。
$ 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)
Hello World再次在Web浏览器中检查消息，然后刷新以查看计数增量。
  
共享文件夹，卷和绑定挂载
      
如果您的项目不在Users目录（cd ~）内，则需要共享所使用的Dockerfile和卷的驱动器或位置。如果出现运行时错误指示未找到应用程序文件，拒绝卷安装或服务无法启动，请尝试启用文件或驱动器共享。卷挂载需要用于C:\Users（Windows）或/Users（Mac）之外的项目的共享驱动器
，并且对于使用Linux容器的Windows Docker Desktop上的任何项目都是必需的。有关更多信息，请参阅适用于Mac的Docker上的文件共享，以及有关如何管理容器中数据的一般示例
      
如果您在较旧的Windows操作系统上使用Oracle VirtualBox，则可能会遇到共享文件夹的问题，如此VB故障单所述。较新的Windows系统满足Windows的Docker桌面的要求，并且不需要VirtualBox。
消息更改为Hello from Docker!：

return 'Hello from Docker! I have been seen {} times.\n'.format(count)
在浏览器中刷新应用。问候语应更新，并且计数器应仍在增加。
步骤8：尝试其他命令
如果要在后台运行服务，则可以将-d标志（用于“分离”模式）传递给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   docker-entrypoint.sh redis ...   Up      6379/tcp              
composetest_web_1     flask run                        Up      0.0.0.0:5000->5000/tcp
该docker-compose run命令允许您为服务运行一次性命令。例如，查看哪些环境变量可用于
web服务：
$ docker-compose run web env
请参阅docker-compose --help以查看其他可用命令。您还可以为bash和zsh shell安装命令完成功能，这还将显示可用的命令。
如果您开始使用Compose with docker-compose up -d，请在完成服务后停止它们：
$ docker-compose stop
您可以使用down
命令降低所有内容，完全删除容器。通过--volumes还删除Redis容器使用的数据量：
$ docker-compose down --volumes
至此，您已经了解了Compose的工作原理。
接下来要去哪里
  
接下来，尝试使用Compose的示例应用程序
  
探索Compose命令的完整列表
  
撰写配置文件参考
  
要了解有关卷和绑定挂载的更多信息，请参阅在Docker中管理数据
文档，docs，docker，compose，编排，容器