Docker学习之docker-compose.yml文件

原创已于 2025-08-05 15:32:34 修改 · 1.1k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#docker #学习 #java

于 2025-08-05 15:07:16 首次发布

docker-compose是用来编排管理多容器的工具，关键在于配置docker-compose.yml配置文件。

一、安装docker-compose

安装docker这里就不详细介绍了，介绍一下安装docker-compsoe

linux系统下执行：

此条命令下载比较缓慢，需要耐心等待
curl -SL https://github.com/docker/compose/releases/download/v2.29.1/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose


添加执行权限
chmod +x /usr/local/bin/docker-compose

验证
docker-compose --version
输出版本号即安装成功

二、编写docker-compose.yml文件

下面是一个单个容器的docker-compose.yml文件

version: '3'

networks:
  mynet:
    external: true

services:
  my_app:
    image: my_image:1.0.0
    container_name: my_app
    restart: always
    ports:
      - 8080:80
      - 1111:6666
    command: >
      sh -c "java -Xms512m -Xmx2g -Dspring.profiles.active=prod -jar app.jar"
    volumes:
      - /opt/my_app/logs:/opt/my_app/logs
    networks:
      - mynet

到这里，基本完成了一个基础的可运行的docker-compose.yml文件。当然这个配置在生产中使用还缺少一些配置，我们下一篇再讲。

先说一下这些配置的含义：

version：指定docker-compose文件的版本，通常有1、2.x、3.x。1和2.x版本比较老，新的3.x版本支持的功能更为完善

networks：定义网络的开始

mynet：网络名称，这个是自定义的网络，可以使用docker network create --driver=bridge mynet创建

external：true表示这个网络是预先存在的外部网络，false则表示这个网络由docker-compse自动创建和管理，不是一个外部存在的网络。

service：定义所有要启动的Docker服务（容器）的开始。

my_app：服务名称，可以自定义，但通常要有标识性

image：使用的docker镜像，如何使用Dockerfile制作镜像，在我上一篇文章中有介绍

container_name：指定启动时的容器名称

restart：设置容器的重启策略，always即无论容器因为什么原因停止，Docker都会尝试重启

ports：端口映射。将宿主机的端口映射到容器中。

command：覆盖容器启动时默认执行的命令。控制容器启动时运行什么命令。

volumes：数据卷挂载。将宿主机的目录挂载到容器内，一般用于数据持久化。

networks：将此容器连接到名为mynet的自定义网络。

这里command有多种写法

第一种：最简单直观

command: java -Xms512m -Xmx2g -jar app.jar
运行时，Docker会自动在前面加上 /bin/sh -c 来执行
适合简单命令，支持环境变量
缺点：不支持复杂逻辑，如管道、重定向等

第二种（推荐）：数组形式（Exec格式）

command: ["java", "-Xms512m", "-Xmx2g", "-jar", "app.jar"]
最推荐的写法，不经过shell解析，更安全高效
环境变量不会自动解析

第三种：使用sh -c执行复杂命令（带变量或逻辑），适合需要动态配置的场景

command: sh -c "java $$JAVA_OPTS -Dspring.profiles.active=$$PROFILE -jar app.jar"

可以写成多行

command: >
  sh -c "java $$JAVA_OPTS 
    -Dspring.profiles.active=$$PROFILE 
    -jar app.jar"

sh -c 的意思是让shell从后面的字符串中读取并执行命令，也就是把后面的字符串当作一条命令执行。
支持变量、条件、循环等复杂写法。
$$是为了在docker-compose.yml中转义成$。

三、docker-compsoe一些基本命令

1.启动容器

docker-compose up -d    # 启动docker-compsoe.yml配置的所有容器

docker-compose up -d  service-name   # 单独启动指定容器

2.重启容器

docker-compose restart  # 重启配置文件中的所有容器

docker-compose restart service-name  # 单独重启指定容器

3. 停止容器

docker-compose down   # 停止并删除所有容器，无法指定单独某一个容器

docker-compose stop   # 停止所有容器

docker-compose stop service-name  # 单独停止指定容器，不会删除

docker-compose rm -f service-name  # 单独删除指定容器（先停止运行，再销毁）