Dawarich项目Docker部署常见问题及解决方案

概述

Dawarich是一个基于Ruby on Rails开发的地理位置记录应用。在使用Docker Compose部署Dawarich项目时，开发者可能会遇到一些典型问题。本文将详细介绍这些问题的成因及解决方案。

主要问题分析

1. 容器启动失败问题

在部署过程中，最常见的错误是容器启动失败，具体表现为dawarich_app容器无法健康启动，导致依赖它的dawarich_sidekiq容器也无法正常运行。

错误特征：

• 容器创建成功但启动失败
• 健康检查无法通过
• 依赖服务无法启动

根本原因：

• 错误的命令格式导致容器无法正常启动
• 数据库连接配置问题
• 缺少必要的PostGIS扩展

2. 命令格式错误

在原始配置中，dawarich_app容器的command字段存在格式问题：

command: ['bin/rails', 'server', '-p', '3000', '-b', '::','rm /var/app/tmp/pids/server.pid']

问题分析：

• 将两个不相关的命令合并到了一个数组中
• rm命令不应该与Rails服务器启动命令放在一起
• 这种格式会导致容器无法正确解析启动命令

解决方案：

command: ['bin/rails', 'server', '-p', '3000', '-b', '::']

3. 数据库连接问题

从错误日志中可以看到PostGIS扩展加载失败：

PG::UndefinedFile: ERROR: could not open extension control file "/usr/local/share/postgresql/extension/postgis.control"

问题分析：

• 数据库服务缺少PostGIS扩展
• 这是地理空间应用的常见依赖
• 需要确保PostgreSQL服务已安装PostGIS扩展

解决方案：

• 在PostgreSQL服务器上安装PostGIS扩展
• 对于Debian/Ubuntu系统：apt-get install postgresql-XX-postgis
• 创建数据库后执行：CREATE EXTENSION postgis;

完整解决方案

1. 修正Docker Compose配置

services:
  dawarich_app:
    # ...其他配置保持不变...
    command: ['bin/rails', 'server', '-p', '3000', '-b', '::']
    # ...其他配置保持不变...

2. 确保数据库服务准备就绪

在部署Dawarich前，确保：

1. PostgreSQL服务已启动并运行
2. 已创建指定用户和数据库
3. 已安装PostGIS扩展
4. 网络连接通畅，访问权限设置正确

3. 资源限制调整

根据实际硬件配置调整资源限制：

deploy:
  resources:
    limits:
      cpus: '0.50'
      memory: '2G'

对于资源有限的设备，可以适当降低这些值。

部署最佳实践

1. 分阶段部署：先单独部署数据库服务，确认正常后再部署应用
2. 日志监控：启用详细日志记录，便于排查问题
3. 健康检查：合理设置健康检查间隔和超时时间
4. 资源隔离：为不同服务分配独立的资源限制
5. 环境验证：部署前验证所有环境变量是否正确

总结

Dawarich项目的Docker部署主要问题集中在命令格式、数据库依赖和资源配置三个方面。通过修正命令格式、确保数据库服务完整配置以及合理分配资源，可以解决大多数部署问题。对于地理空间应用特有的PostGIS依赖，需要特别注意在数据库服务中提前安装配置。