docker-compose文件的简介及使用

Docker Compose是Docker官方的开源项目，主要用于定义和运行多容器Docker应用。以下是对Docker Compose的详细介绍：

一、主要功能：

• 容器编排：Docker Compose允许用户通过一个单独的docker-compose.yml模板文件（YAML格式）来定义一组相关联的应用容器为一个项目（project）。这个文件可以配置应用所需的所有服务，并通过一个单一命令来创建和启动所有服务。
• 简化管理：Docker Compose简化了多容器应用的管理，使得开发、测试和部署变得更加容易和高效。
• 服务依赖管理：通过配置服务依赖，可以确保服务按顺序启动。
• 可重复的开发环境：Docker Compose能够确保在不同环境中（如开发、测试、生产）应用的行为一致。

二、核心概念

• 服务（Service）：服务是一个独立的容器实例，它可以包含具体的应用程序代码及其依赖。在docker-compose.yml文件中，服务通过"services"关键字来定义，并且可以为每个服务指定镜像、端口、环境变量、卷等配置。
• 项目（Project）：项目是由一组关联的服务定义组成的独立环境，通常由一个docker-compose.yml文件定义。

三、常用命令

• 1，启动服务：使用docker-compose up命令可以启动所有服务。如果需要在后台运行，可以添加-d选项，即docker-compose up -d。

• 2，停止服务：使用docker-compose down命令可以停止并删除所有服务、网络和卷（如果需要同时删除挂载的卷，可以添加--volumes选项）。

• 3，构建服务：使用docker-compose build命令可以构建或重建服务的Docker镜像。

• 4，查看日志：使用docker-compose logs命令可以查看服务的日志输出。如果需要实时跟踪日志，可以添加-f选项。同时，也可以查看特定服务的日志，例如docker-compose logs <service_name>。

• 5，列出服务：使用docker-compose ps命令可以列出运行中的容器及其状态。

• 6，重启服务：使用docker-compose restart命令可以重启服务容器。

• 7，扩展服务：使用docker-compose up --scale <service_name>=命令可以方便地扩展服务实例数量。

  MacBook-Pro:dockercompose jd$ docker compose --help

  Usage: docker compose [OPTIONS] COMMAND

  Define and run multi-container applications with Docker

  Options:
  --all-resources Include all resources, even those not used by services
  --ansi string Control when to print ANSI control characters ("never"|"always"|"auto") (default "auto")
  --compatibility Run compose in backward compatibility mode
  --dry-run Execute command in dry run mode
  --env-file stringArray Specify an alternate environment file
  -f, --file stringArray Compose configuration files（指定compose文件的路径和名称）
  --parallel int Control max parallelism, -1 for unlimited (default -1)
  --profile stringArray Specify a profile to enable
  --progress string Set type of progress output (auto, tty, plain, json, quiet) (default "auto")
  --project-directory string Specify an alternate working directory
  (default: the path of the, first specified, Compose file)
  -p, --project-name string Project name

  Commands:
  attach Attach local standard input, output, and error streams to a service's running container
  build Build or rebuild services
  config Parse, resolve and render compose file in canonical format
  cp Copy files/folders between a service container and the local filesystem
  create Creates containers for a service
  down Stop and remove containers, networks（停止并移除所有所有容器）
  events Receive real time events from containers
  exec Execute a command in a running container（在一个运行的容器中执行命令）
  images List images used by the created containers
  kill Force stop service containers
  logs View output from containers （查看指定容器的日志）
  ls List running compose projects
  pause Pause services
  port Print the public port for a port binding
  ps List containers（列出所有的容器）
  pull Pull service images
  push Push service images
  restart Restart service containers
  rm Removes stopped service containers
  run Run a one-off command on a service
  scale Scale services
  start Start services
  stats Display a live stream of container(s) resource usage statistics
  stop Stop services
  top Display the running processes
  unpause Unpause services
  up Create and start containers（创建并启动所有容器）
  version Show the Docker Compose version information
  wait Block until containers of all (or specified) services stop.
  watch Watch build context for service and rebuild/refresh containers when files are updated

  Run 'docker compose COMMAND --help' for more information on a command.

四、文件结构

• Docker Compose的配置文件默认为docker-compose.yml，该文件定义了多个有依赖关系的服务及每个服务运行的容器。以下是一个典型的docker-compose.yml文件示例：

  version: '3.8'

  services:
  # MySQL 数据库服务
  mysql:
  image: mysql:5.7 # 使用官方的 MySQL 镜像，版本为 5.7
  container_name: my_mysql # 创建mysql容器名称
  environment:
  TZ: Asia/Shanghai
  MYSQL_ROOT_PASSWORD: root_password # 设置 root 用户的密码
  MYSQL_DATABASE: mydb # 创建一个名为 mydb 的数据库
  MYSQL_USER: myuser # 创建一个名为 myuser 的用户
  MYSQL_PASSWORD: mypassword # 设置 myuser 用户的密码
  volumes:
  - "./mysql/data:/var/lib/mysql" # 挂在的数据目录
  - "./mysql/conf:/etc/mysql/confi.d"
  - "./mysql/init:/docker-entrypoint-initdb.d"
  ports:
  - "3306:3306" # 将宿主机的 3306 端口映射到容器的 3306 端口
  networks:
  - my_net # 创建的桥接网络
  aipro:
  build: # 根据Dockerfile文件构建镜像
  context: .
  dockerfile: Dockerfile # 服务后端创建一Dockerfile文件编辑
  container_name: aipro
  ports:
  - "8080:8080" # 将宿主机的 8080 端口映射到容器的 8080 端口（根据你的后端应用配置调整）
  networks:
  - my_net
  depends_on:
  - my_mysql # 确保 MySQL 服务先启动
  # Nginx 服务，用于反向代理前端和后端
  nginx:
  image: nginx:latest # 使用官方的 Nginx 镜像，版本为 latest
  container_name: my_nginx
  volumes:
  - "./nginx/nginx.conf:/etc/nginx/nginx.conf" # 使用自定义的 Nginx 配置文件
  - "./nginx/frontend/dist:/usr/share/nginx/html" # 将前端应用的静态文件映射到 Nginx 的默认根目录
  ports:
  - "80:80" # 将宿主机的 80 端口映射到容器的 80 端口
  depends_on:
  - aipro # 确保后端服务先启动（如果 Nginx 需要代理到后端）
  networks:
  - my_net
  networks:
  my_net:
  name: aipro

  volumes:

  my-data: #定义了一个命名卷my-data用于持久化数据

五、应用场景

Docker Compose非常适合用于需要组合使用多个容器进行开发的场景，如微服务架构、全栈应用开发等。通过Docker Compose，可以轻松地定义、启动和管理多个容器化的服务，从而简化开发、测试和部署流程。

综上所述，Docker Compose是一个强大的工具，它可以帮助用户更方便地管理和部署多容器Docker应用。