【运维】使用 Docker Compose 快速启动项目全流程指南

docker-compose启动项目流程

要使用 docker-compose.yaml 文件启动一个 Python 代码工程，您可以按照以下步骤操作：
1. 安装 Docker 和 Docker Compose

假如您的系统上还没有安装 Docker 和 Docker Compose，您必要先安装它们。

• 安装 Docker：
  对于 Ubuntu：
  
  1. sudo apt-get update
  2. sudo apt-get install docker-ce docker-ce-cli containerd.io

  复制代码
  对于 Windows 和 macOS，可以从 Docker 官网 下载 Docker Desktop 并按照提示举行安装。
  
• 安装 Docker Compose：
  对于 Ubuntu：
  
  1. sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
  2. sudo chmod +x /usr/local/bin/docker-compose

  复制代码
  对于 Windows 和 macOS，Docker Compose 已经包罗在 Docker Desktop 中，无需额外安装。
  

2. 准备 Docker Compose 文件

确保 docker-compose.yaml 文件在您的项目根目录中。该文件界说了您的服务，包罗镜像、容器名称、网络配置、挂载卷等。
3. 启动 Docker Compose 服务

打开终端或命令行窗口，导航到包罗 docker-compose.yaml 文件的项目根目录，然后运行以下命令：

1. docker-compose up
3. -d

复制代码

这个命令会在后台启动所有界说在 docker-compose.yaml 文件中的服务。假如希望在前台运行并查看日志输出，可以去掉 -d 参数：

1. docker-compose up

复制代码

4. 检查运行状态

您可以使用以下命令检查服务是否正常运行：

1. docker-compose ps

复制代码

这个命令会列出所有由 docker-compose 启动的容器及其状态。
5. 停止服务

假如您必要停止服务，可以在项目根目录中运行以下命令：

1. docker-compose down

复制代码

这个命令会停止并删除所有由 docker-compose 启动的容器。
示例 docker-compose.yaml 文件

以下是一个简单的 docker-compose.yaml 文件示例：

1. version: '3.8'
3. services:
4.   web:
5.     image: python:3.8
6.     volumes:
7.       - .:/code
8.     working_dir: /code
9.     command: python app.py
10.     ports:
11.       - "5000:5000"
12.   db:
13.     image: postgres:13
14.     environment:
15.       POSTGRES_USER: user
16.       POSTGRES_PASSWORD: password
17.       POSTGRES_DB: mydatabase
18.     ports:
19.       - "5432:5432"

复制代码

为什么要用docker-compose

docker-compose 是为了启动和管理多个容器以便它们能够协同工作。这么做有几个主要原因和利益：
1. 微服务架构的实现

现代应用程序往往采用微服务架构，将应用程序拆分为多个独立的服务（如数据库服务、Web服务、缓存服务等）。这些服务各自运行在独立的容器中，可以独立开辟、摆设和扩展。
2. 依赖管理

复杂的应用程序通常依赖于多个组件和服务。例如，一个典范的Web应用程序大概必要一个Web服务器、一个数据库和一个缓存系统。使用 docker-compose 可以轻松地界说和管理这些依赖关系，确保所有组件按预期启动和运行。
3. 简化开辟和测试环境

在开辟和测试过程中，必要保证开辟环境与生产环境尽大概一致。使用 docker-compose 可以界说一致的开辟、测试和生产环境，使得在当地运行的环境与摆设到服务器上的环境尽量相同，从而淘汰环境差别带来的问题。
4. 方便的服务管理

docker-compose 提供了简单的命令来启动、停止和查看所有服务的状态。例如，通过一个 docker-compose up

命令，就可以启动所有服务；通过 docker-compose down

命令，可以停止并清理所有服务。
5. 网络配置

docker-compose 自动为所有界说的服务创建一个专用网络，使得这些服务之间能够相互通信，而不必要额外配置复杂的网络设置。每个服务都可以通过服务名直接访问其他服务。
示例应用场景

假设我们有一个简单的博客应用程序，它包罗以下组件：

• 一个前端Web服务器（例如，使用Nginx）
  
• 一个后端API服务器（例如，使用Flask或Django）
  
• 一个数据库服务器（例如，使用PostgreSQL）
  

在没有 docker-compose 的情况下，我们必要分别配置和管理这些服务，这大概会非常复杂且容易堕落。而使用 docker-compose，我们可以界说一个简单的 docker-compose.yaml 文件来描述这些服务及其依赖关系：

1. version: '3.8'
3. services:
4.   web:
5.     image: nginx:latest
6.     ports:
7.       - "80:80"
8.     volumes:
9.       - ./nginx.conf:/etc/nginx/nginx.conf
10.     depends_on:
11.       - api
13.   api:
14.     image: my-api-server:latest
15.     build: ./api
16.     ports:
17.       - "5000:5000"
18.     environment:
19.       - DATABASE_URL=postgres://user:password@db:5432/mydatabase
21.   db:
22.     image: postgres:13
23.     environment:
24.       POSTGRES_USER: user
25.       POSTGRES_PASSWORD: password
26.       POSTGRES_DB: mydatabase
27.     ports:
28.       - "5432:5432"
29.     volumes:
30.       - postgres-data:/var/lib/postgresql/data
32. volumes:
33.   postgres-data:

复制代码

docker-compose 为开辟职员提供了一种简便的方法来界说、管理和运行多容器Docker应用程序。它在微服务架构、依赖管理、一致的开辟和生产环境、服务管理以及网络配置方面提供了显著的优势，使得复杂应用程序的管理和维护变得更加容易和高效。
语法

Docker Compose 是一个用于界说和运行多容器 Docker 应用的工具。通过一个 docker-compose.yml 文件，你可以配置应用的服务，并使用一个命令启动或关闭它们。以下是 Docker Compose 语法的详细先容及示例：
基本语法结构

docker-compose.yml 文件是一个 YAML 文件，通常包罗以下几部门：

• version：指定 Docker Compose 文件的版本。
  
• services：界说应用程序中的服务。
  
• volumes：界说数据卷。
  
• networks：界说网络。
  

示例 docker-compose.yml 文件

1. version: '3.8'  # Docker Compose 文件版本
3. services:
4.   web:
5.     image: nginx:latest  # 使用的镜像
6.     ports:
7.       - "80:80"  # 映射端口
8.     volumes:
9.       - ./html:/usr/share/nginx/html  # 挂载主机目录到容器
10.     networks:
11.       - webnet  # 使用的网络
13.   app:
14.     build:
15.       context: ./app  # Dockerfile 所在目录
16.       dockerfile: Dockerfile
17.     ports:
18.       - "5000:5000"
19.     volumes:
20.       - ./app:/app
21.     networks:
22.       - webnet
23.     depends_on:
24.       - db  # 指定依赖的服务
26.   db:
27.     image: postgres:latest
28.     environment:
29.       POSTGRES_DB: mydatabase
30.       POSTGRES_USER: user
31.       POSTGRES_PASSWORD: password
32.     volumes:
33.       - db_data:/var/lib/postgresql/data
34.     networks:
35.       - webnet
37. volumes:
38.   db_data:  # 定义一个名为 db_data 的卷
40. networks:
41.   webnet:  # 定义一个名为 webnet 的网络

复制代码

关键字详解

version

指定 Compose 文件的版本。不同版本支持的语法和功能有所不同。常用的版本包罗 2、2.1、3、3.8 等。
services

界说应用中的各个服务。每个服务可以包罗以下字段：

• image：指定服务使用的 Docker 镜像。
  
• build：构建镜像的配置，通常包罗 context 和 dockerfile。
  
• ports：暴露和映射端口。
  
• volumes：挂载卷。
  
• networks：服务使用的网络。
  
• environment：环境变量配置。
  
• depends_on：指定服务依赖关系。
  

volumes

界说数据卷。数据卷用于持久化数据，避免因容器销毁而丢失数据。
networks

界说网络。网络用于容器之间的通信。Compose 默认提供一个 bridge 网络，但可以自界说网络以满足复杂的需求。
常用命令

• 启动服务：
  

1. docker-compose up

复制代码

• 后台启动服务：
  

1. docker-compose up
3. -d

复制代码

• 停止服务：
  

1. docker-compose down

复制代码

• 查看服务日志：
  

1. docker-compose logs

复制代码

• 重新构建服务：
  

1. docker-compose build

复制代码

• 列出正在运行的服务：
  

1. docker-compose ps

复制代码

进阶用法

使用 .env 文件

Docker Compose 支持使用 .env 文件来设置环境变量。这些变量可以在 docker-compose.yml 文件中使用。
.env 文件示例：

1. POSTGRES_DB=mydatabase
2. POSTGRES_USER=user
3. POSTGRES_PASSWORD=password

复制代码

docker-compose.yml 文件中使用环境变量：

1. services:
2.   db:
3.     image: postgres:latest
4.     environment:
5.       POSTGRES_DB: ${POSTGRES_DB}
6.       POSTGRES_USER: ${POSTGRES_USER}
7.       POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}

复制代码

多个 Compose 文件

在复杂的应用中，你大概必要使用多个 Compose 文件。例如，一个用于开辟环境，一个用于生产环境：

• docker-compose.yml：基本配置。
  
• docker-compose.override.yml：覆盖或扩展基本配置。
  

启动时可以指定多个文件：

1. docker-compose -f docker-compose.yml -f docker-compose.override.yml up

复制代码

Docker Compose 是一个强盛的工具，可以简化多容器应用的管理。通过界说清晰的 docker-compose.yml 文件，可以方便地启动、停止和管理你的应用程序。
一个示例工程

https://github.com/fevolq/Money/blob/main/docker-compose.yaml

1. version: '3'
2. services:
3.   money:
4.     image: infq/money:latest
5.     container_name: money
6.     environment:
7.       - PORT=8888
8.       - WorthUseCache=true
9.     ports:
10.       - "8888:8888"
11.     volumes:
12.       - ./data:/app/money/data
13.       - ./conf:/app/money/conf
14.     networks:
15.       - money
16.     restart: always
17.     command: [
18.       "uvicorn",
19.       "app:app",
20.       "--host", "0.0.0.0",
21.       "--port", "8888"
22.     ]
24.   money-frontend:
25.     image: infq/money-front:latest
26.     container_name: money-frontend
27.     ports:
28.       - "80:80"
29.     depends_on:
30.       - money
31.     networks:
32.       - money
33.     environment:
34.       - SERVER=http://money:8888
35.       - PORT=80
36.     restart: always
38. networks:
39.   money:

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。