Docker-Compose入门，及其问题思考

程序员二毛
267 阅读6分钟

介绍

什么是 Docker Compose

Docker Compose 是一个用于定义和运行多容器 Docker 应用程序的工具。通过一个配置文件（默认是 docker-compose.yml），你可以定义应用程序的服务、网络和卷，并使用简单的命令来管理这些服务的生命周期。

Docker Compose 的主要功能

  • 定义多容器应用：使用 docker-compose.yml 文件来定义应用程序的服务。
  • 管理服务的生命周期：通过简单的命令来启动、停止和重启服务。
  • 设置服务的依赖关系：确保服务按照指定的顺序启动和停止。
  • 共享和重用配置：将配置文件共享给团队成员，使环境设置更加一致。

Docker Compose 的安装

在使用 Docker Compose 之前，需要确保 Docker 已经安装。Docker Compose 通常与 Docker 一起安装。如果没有，可以通过以下命令单独安装：

sudo curl -L "https://github.com/docker/compose/releases/download/$(docker-compose version --short)/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Docker Compose 基本用法

  1. 创建 docker-compose.yml 文件：定义你的应用程序服务。
  2. 运行 docker-compose 命令：管理你的服务。

基本命令

  • 启动服务：
docker-compose up

使用 -d 选项在后台运行服务：

docker-compose up -d
  • 停止服务：
docker-compose down
  • 查看服务状态：
docker-compose ps
  • 构建服务：
docker-compose build
  • 查看日志：
docker-compose logs

实战例子

下面是一个简单的例子，演示如何使用 Docker Compose 来运行一个包含 Nginx 和 PostgreSQL 的应用程序。

项目结构

myapp/
│
├── docker-compose.yml
├── nginx/
│   └── default.conf
└── pgdata/

docker-compose.yml 文件

version: '3.8'

services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
    networks:
      - mynetwork

  database:
    image: postgres:latest
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
      POSTGRES_DB: mydb
    volumes:
      - pgdata:/var/lib/postgresql/data
    networks:
      - mynetwork

volumes:
  pgdata:

networks:
  mynetwork:

nginx/default.conf 文件

server {
    listen 80;
    server_name localhost;

    location / {
        proxy_pass http://database:5432;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

运行应用程序

  1. 进入项目目录：
cd myapp
  1. 启动服务：
docker-compose up -d
  1. 查看服务状态：
docker-compose ps
  1. 查看日志：
docker-compose logs
  1. 停止服务：
docker-compose down

总结

Docker Compose 是一个强大的工具，用于定义和管理多容器 Docker 应用程序。通过一个简单的配置文件，你可以定义和管理复杂的服务体系结构，使开发和部署更加高效和一致。

---

语法规则

docker-compose.yml 文件使用 YAML 语法来定义多容器 Docker 应用程序。以下是详细介绍每个关键字及其作用：

基本结构

version: '3.8'  # Docker Compose 文件版本
services:       # 定义服务（容器）
  service_name: # 服务名称
    image:      # 使用的镜像
    build:      # 构建选项
    command:    # 覆盖默认命令
    ports:      # 端口映射
    volumes:    # 卷挂载
    environment: # 环境变量
    networks:   # 网络配置
    depends_on: # 依赖关系
networks:       # 定义网络
  network_name: # 网络名称
volumes:        # 定义卷
  volume_name:  # 卷名称

关键字及作用

version

指定 Compose 文件的版本，确保兼容性：

version: '3.8'

services

定义应用程序中的服务，每个服务对应一个容器：

services:
  web:
    image: nginx:latest
image

指定服务使用的镜像：

image: nginx:latest
build

定义构建镜像的配置：

build:
  context: .          # Dockerfile 所在的上下文
  dockerfile: Dockerfile # 指定 Dockerfile 文件
command

覆盖容器启动时的默认命令：

command: ["bundle", "exec", "thin", "-p", "3000"]
ports

定义端口映射，将主机端口映射到容器端口：

ports:
  - "80:80"          # 主机端口:容器端口
volumes

挂载卷，将主机目录挂载到容器中：

volumes:
  - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
environment

设置环境变量：

environment:
  POSTGRES_USER: user
  POSTGRES_PASSWORD: password
  POSTGRES_DB: mydb
networks

将服务连接到指定的网络：

networks:
  - mynetwork
depends_on

指定服务之间的依赖关系：

depends_on:
  - database

networks

定义网络，用于服务之间的通信：

networks:
  mynetwork:
    driver: bridge  # 使用桥接网络

volumes

定义卷，用于持久化数据：

volumes:
  pgdata:
    driver: local  # 使用本地卷

完整示例

以下是一个完整的 docker-compose.yml 示例，包括所有常用配置选项：

version: '3.8'

services:
  web:
    image: nginx:latest
    build:
      context: .
      dockerfile: Dockerfile
    command: ["nginx", "-g", "daemon off;"]
    ports:
      - "80:80"
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
    environment:
      - NGINX_HOST=localhost
      - NGINX_PORT=80
    networks:
      - mynetwork
    depends_on:
      - database

  database:
    image: postgres:latest
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
      POSTGRES_DB: mydb
    volumes:
      - pgdata:/var/lib/postgresql/data
    networks:
      - mynetwork

volumes:
  pgdata:
    driver: local

networks:
  mynetwork:
    driver: bridge

关键字详解

  • version: 指定 Compose 文件的版本，确保 Docker Compose 使用正确的功能和语法。
  • services: 定义服务（容器），每个服务可以包括镜像、构建配置、命令、端口、卷、环境变量、网络、依赖关系等。
  • image: 指定服务使用的 Docker 镜像。
  • build: 定义构建镜像的配置，包括上下文和 Dockerfile 文件。
  • command: 覆盖默认的容器启动命令。
  • ports: 将主机端口映射到容器端口，格式为 主机端口:容器端口。
  • volumes: 挂载卷，将主机目录或卷挂载到容器中。
  • environment: 设置环境变量，传递给容器。
  • networks: 定义服务所属的网络，服务之间可以通过网络进行通信。
  • depends_on: 定义服务之间的依赖关系，确保服务按照指定顺序启动。
  • volumes: 定义卷，用于持久化数据。
  • networks: 定义网络，用于服务之间的通信。

通过这些关键字，你可以灵活地配置和管理多容器 Docker 应用程序，确保服务之间的依赖关系和通信顺畅。

注意

  • 使用横线（-）来表示列表项。列表可以包含字符串、字典或其他数据结构。
  • 双引号使不使用都可以
    • 使用双引号：在可能包含特殊字符、空格、或冒号等的字符串中使用。
    • 不使用双引号：在普通的、无特殊字符或空格的字符串中可以省略双引号。

---

Networks 和 Volumes 介绍

在 docker-compose.yml 文件中，定义 networks 和 volumes 是为了配置容器间的网络通信和数据持久化。以下是详细解释：

Networks

作用

  • 容器间通信：定义网络，使同一网络下的容器能够互相通信。
  • 隔离：通过将服务放置在不同的网络中，可以隔离网络流量，提升安全性。
  • 自定义网络配置：可以配置网络驱动、子网等高级网络设置。

示例

version: '3.8'

services:
  web:
    image: nginx:latest
    networks:
      - frontend
  app:
    image: myapp:latest
    networks:
      - frontend
      - backend
  database:
    image: postgres:latest
    networks:
      - backend

networks:
  frontend:
    driver: bridge
  backend:
    driver: bridge

在上面的例子中：

  • web 和 app 服务在 frontend 网络中，可以相互通信。
  • app 和 database 服务在 backend 网络中，可以相互通信。
  • web 和 database 不能直接通信，因为它们不在同一个网络中。

Volumes

作用

  • 数据持久化：确保容器重启或删除后数据依然存在。
  • 数据共享：在多个容器之间共享数据。
  • 性能优化：使用本地存储卷可以提升性能，尤其是针对数据库等需要频繁读写的服务。

示例

version: '3.8'

services:
  database:
    image: postgres:latest
    volumes:
      - pgdata:/var/lib/postgresql/data
  web:
    image: nginx:latest
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf

volumes:
  pgdata:
    driver: local

在上面的例子中：

  • database 服务使用名为 pgdata 的卷，挂载到容器的 /var/lib/postgresql/data 目录。这样数据库的数据会保存在 pgdata 卷中，即使容器删除，数据仍然存在。
  • web 服务将本地目录 ./nginx/default.conf 挂载到容器的 /etc/nginx/conf.d/default.conf 文件中，方便配置 Nginx。

总结

  • networks：定义容器之间的网络连接方式，可以配置隔离和自定义网络参数。
  • volumes：定义持久化存储和数据共享，可以配置持久化数据和性能优化。

通过正确配置 networks 和 volumes，可以更好地管理容器化应用的网络通信和数据存储需求。

---

这里的 pgdata 是会存到本地的哪个文件夹下呢？如果想指明路径该怎么处理

在 docker-compose.yml 文件中，如果没有明确指定 pgdata 卷的本地路径，Docker 会将其存储在 Docker 的默认卷存储位置。这个位置因系统不同而异，通常是：

  • Linux: /var/lib/docker/volumes
  • macOS: ~/Library/Containers/com.docker.docker/Data/vms/0
  • Windows: C:\ProgramData\Docker\volumes

查看卷的默认存储位置

可以通过以下命令来查看卷的默认存储位置：

docker volume inspect pgdata

指定卷的本地路径

如果需要明确指定 pgdata 卷在本地文件系统中的路径，可以在 docker-compose.yml 文件中这样处理：

version: '3.8'

services:
  database:
    image: postgres:latest
    volumes:
      - pgdata:/var/lib/postgresql/data
  web:
    image: nginx:latest
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf

volumes:
  pgdata:
    driver: local
    driver_opts:
      o: bind
      type: none
      device: /path/to/your/local/pgdata

验证映射

可以通过以下命令验证卷是否正确映射：

docker-compose up -d
docker volume inspect pgdata

检查输出中 Mountpoint 是否指向 /path/to/your/local/pgdata

参考：

www.runoob.com/docker/dock…

avatar
文章
阅读
粉丝