9.1 调试工具和命令
Docker Compose 大大简化了多容器应用的开发和部署，但就像任何技术一样，可能会出现需要调试和解决的问题。在这节课中，我们会讲解在 Docker Compose 中查找错误和调试的主要方法和工具。
主要问题及其解决方法：
- 容器启动问题：
- 检查容器日志。
- 检查容器状态。
- 检查配置文件。
- 网络问题：
- 检查网络连接。
- 在容器内使用网络工具。
- 卷相关问题：
- 检查卷挂载。
- 检查卷的访问权限。
调试工具和命令：
1. 查看容器日志
容器日志 是在问题发生时应首先查看的地方。docker compose logs 命令可以查看 compose.yaml 定义的所有服务的日志。
docker compose logs
你可以指定某个具体的服务来查看它的日志：
docker compose logs <service_name>
2. 检查容器状态
docker compose ps 命令显示由 Docker Compose 管理的所有容器的状态信息。
docker compose ps
此命令的输出会显示容器的状态、端口和 ID。
3. 重新启动容器
如果容器运行异常，试试重启它：
docker compose restart <service_name>
4. 连接正在运行的容器
为了更深入地探查问题，你可以用 docker compose exec 命令连接到正在运行的容器。
docker compose exec <service_name> /bin/bash
这个命令 会在容器内打开一个终端，你可以在那里运行诊断命令。
5. 使用网络工具
在容器内检查网络连接能帮助诊断网络问题。你可以使用工具如 ping、curl、netcat 等。
docker compose exec <service_name> ping <hostname>
docker compose exec <service_name> curl http://<hostname>
docker compose exec <service_name> netcat -z -v <hostname> <port>
9.2 高级方法
查找错误的额外方法
1. 检查 Docker Compose 文件
文件 compose.yaml 中的错误可能会导致容器工作异常。使用以下命令检查文件语法:
docker compose config
此命令将检查文件中的错误并输出最终配置。
2. 使用 Healthcheck
你可以在 compose.yaml 文件中定义 healthcheck，让 Docker 自动检测容器的状态。
version: '3.8'
services:
web:
image: nginx:latest
ports:
- "80:80"
healthcheck:
test: ["CMD-SHELL", "curl -f http://localhost || exit 1"]
interval: 30s
timeout: 10s
retries: 3
3. 检查卷挂载
卷的问题可能由于挂载不正确或访问权限不足导致。确保卷已正确挂载且容器有权限访问它们。
version: '3.8'
services:
db:
image: postgres:latest
volumes:
- db-data:/var/lib/postgresql/data
volumes:
db-data:
3.1 检查卷的可访问性
为了检查容器中卷的可访问性，可以启动容器并运行命令检查卷 (例如，检查卷中的文件列表)。假设卷在容器中挂载路径是 /mnt/volume:
docker run --rm -v my_volume:/mnt/volume alpine ls /mnt/volume
如果卷是可访问的，命令 ls 会输出卷中的文件和目录列表。如果卷不可访问或为空，则会显示相应消息。
3.2 检查卷的可用空间
要检查卷内从容器中可用的空间，使用命令 df:
docker run --rm -v my_volume:/mnt/volume alpine df -h /mnt/volume
它会显示卷所在文件系统的可用空间。选项 -h 会以便于阅读的格式（如 MB, GB 等单位）显示信息。
4. 使用 IDE
为了简化调试，可以使用带有调试功能和日志记录功能的 IDE。你可以为开发和生产创建单独的配置文件，使用参数 --file。
docker compose --file docker-compose.dev.yml up
重要! 这里有一份有用的指南，教你通过 IntelliJ IDEA 设置运行在 Docker 中的应用的远程调试： 远程调试设置 .
5. 检查环境变量
不正确或缺失的环境变量可能会引发问题。确保所有必要的变量在文件 .env 或直接在 compose.yaml 中定义。
version: '3.8'
services:
app:
image: myapp:latest
environment:
- APP_ENV=development
- DEBUG=true
9.3 调试命令示例
调试命令的使用示例
示例 1: 检查并修正连接数据库的错误
查看服务 web 的日志:
docker compose logs web
检查 web 和 db 之间的网络连接:
docker compose exec web ping db
docker compose exec web curl http://db:5432
连接到容器 web 进行诊断:
docker compose exec web /bin/bash
示例 2: 检查卷的问题
检查卷的挂载:
version: '3.8'
services:
db:
image: postgres:latest
volumes:
- db-data:/var/lib/postgresql/data
volumes:
db-data:
连接到容器 db 并检查数据:
docker compose exec db /bin/bash
ls -l /var/lib/postgresql/data
GO TO FULL VERSION