Docker 入门篇（八）-- Docker Compose 使用指南

news2024/12/24 7:54:25

一、Docker Compose 简介

Docker Compose 是用于定义和运行多容器 Docker 应用程序的工具。通过 Compose，您可以使用 YML 文件来配置应用程序需要的所有服务。然后，使用一个命令，就可以从 YML 文件配置中创建并启动所有服务。

Compose 使用的三个步骤：

使用 Dockerfile 定义应用程序的环境。
使用 docker-compose.yml 定义构成应用程序的服务，这样它们可以在隔离环境中一起运行。
最后，执行 docker-compose up 命令来启动并运行整个应用程序。

二、离线安装 docker-compose

1. 下载docker-compose

官方地址：

> https://github.com/docker/compose/releases/download/v2.2.2/docker-compose-linux-x86_64

2. 安装

将 docker-compose-linux-x86_64 文件上传到 /root 目录，执行下列命令

#移动文件到/usr/local/bin/，并重命名为docker-compose
sudo mv /root/docker-compose-linux-x86_64  /usr/local/bin/docker-compose
#赋予docker-compose 可执行权限。
sudo chmod +x /usr/local/bin/docker-compose

#查看版本 docker-compose version

docker-compose -v

在这里插入图片描述

三、yml 配置指令参考

1. version

指定本 yml 依从的 compose 哪个版本制定的。

2. build

指定为构建镜像上下文路径：

例如 webapp 服务，指定为从上下文路径 ./dir/Dockerfile 所构建的镜像：

version: "3.7"
services:
  webapp:
    build: ./dir

或者，作为具有在上下文指定的路径的对象，以及可选的 Dockerfile 和 args：

version: "3.7"
services:
  webapp:
    build:
      context: ./dir
      dockerfile: Dockerfile-alternate
      args:
        buildno: 1
      labels:
        - "com.example.description=Accounting webapp"
        - "com.example.department=Finance"
        - "com.example.label-with-empty-value"
      target: prod

context：上下文路径。
dockerfile：指定构建镜像的 Dockerfile 文件名。
args：添加构建参数，这是只能在构建过程中访问的环境变量。
labels：设置构建镜像的标签。
target：多层构建，可以指定构建哪一层。

3. command

覆盖容器启动的默认命令。

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

4.container_name

指定自定义容器名称，而不是生成的默认名称。

container_name: my-web-container

5.depends_on

设置依赖关系。

docker-compose up ：以依赖性顺序启动服务。在以下示例中，先启动 db 和 redis ，才会启动 web。
docker-compose up SERVICE ：自动包含 SERVICE 的依赖项。在以下示例中，docker-- compose up web 还将创建并启动 db 和 redis。
docker-compose stop ：按依赖关系顺序停止服务。在以下示例中，web 在 db 和 redis 之前停止。

version: "3.7"
services:
  web:
    build: .
    depends_on:
      - db
      - redis
  redis:
    image: redis
  db:
    image: postgres

6.expose

暴露端口，但不映射到宿主机，只被连接的服务访问。

仅可以指定内部端口为参数：

expose:
 - "3000"
 - "8000"

7. image

指定容器运行的镜像。以下格式都可以：

image: redis
image: ubuntu:14.04
image: tutum/influxdb
image: example-registry.com:4000/postgresql
image: a4bc65fd # 镜像id

更多配置参考：runoob：docker-compose

8.volumes

将主机的数据卷或者文件挂载到容器里。

version: "3.7"
services:
  db:
    image: postgres:latest
    volumes:
      - "/localhost/postgres.sock:/var/run/postgres/postgres.sock"
      - "/localhost/data:/var/lib/postgresql/data"

9.networks

默认网络：默认情况下，Docker Compose 会为应用程序创建一个网络，名称为 Docker Compose 配置文件（docker-compose.yml）所在目录名称的小写形式加上 “_default”。例如，如果配置文件位于名为 “myapp” 的目录中，那么默认网络的名称就是 “myapp_default”。每个在 docker-compose.yml 文件中定义的服务（services）都会加入这个默认网络中，使得它们可以相互通信。
自定义网络：除了默认网络之外，你还可以在 docker-compose.yml 文件中定义自定义网络。这样，你可以为应用程序创建具有特定名称和配置的网络。例如：

version: '3'  
services:  
  web:  
    build: .  
    ports:  
      - "80:80"  
    networks:  
      - mynetwork  
  db:  
    image: mysql:latest  
    networks:  
      - mynetwork  
networks:  
  mynetwork:  
    driver: bridge

使用已存在的网络：如果你已经使用 docker network create 命令创建了一个网络，并且希望 Docker Compose 的服务能够加入这个网络，你可以在 docker-compose.yml 文件中使用 external 关键字来引用这个网络。例如：

version: '3'  
services:  
  web:  
    build: .  
    ports:  
      - "80:80"  
    networks:  
      - myexistingnetwork  
networks:  
  myexistingnetwork:  
    external: true

在这个例子中，“web” 服务将加入名为 “myexistingnetwork” 的已存在网络。注意，在引用已存在网络时，你不需要指定网络驱动程序或其他配置选项，只需要设置 external: true 即可。

四、Docker Compose 实例

1. 配置 nginx 启动的 docker-compose.yml

version: '3'  
services:  
  nginx:  
    image: nginx:latest  
    container_name: my-nginx
    ports:  
      - "80:80"  
    volumes:  
      - /home/docker_data/nginx/conf:/etc/nginx 	
      - /home/docker_data/nginx/html:/usr/share/nginx/html
      - /home/docker_data/nginx/logs:/var/log/nginx  
    environment:
      - NGINX_PORT=80
  
# 如果有需要，可以添加其他的服务或配置

要启动由 docker-compose.yml 文件定义的服务，您可以在文件所在的目录下运行以下命令：