Fullstaq Ruby Server Edition Docker 部署冲突排查与解决方案

常见冲突原因分析

1. 端口占用冲突

   • 现象：容器启动失败，报 port already allocated 错误
   • 检查命令：

     netstat -tuln | grep <端口号>  # 如 3000
     docker ps --format "table {{.ID}}\t{{.Ports}}" | grep <端口号>
     

2. 文件挂载冲突

   • 现象：容器内权限错误或文件路径不存在
   • 典型错误：
     Permission denied 或 No such file or directory

3. 镜像依赖冲突

   • 现象：Gemfile 依赖与基础镜像版本不兼容
   • 常见于：
     • OpenSSL 版本冲突
     • 原生扩展编译失败（如 nokogiri/puma）

4. 网络配置冲突

   • 现象：容器间通信失败或 DNS 解析错误
   • 检查点：
     • Docker 网络模式（bridge/host）
     • /etc/hosts 文件覆盖

---

排查流程

graph TD
    A[部署失败] --> B[查看日志]
    B --> C{docker logs <容器ID>}
    C --> D[端口冲突?]
    C --> E[文件权限?]
    C --> F[依赖错误?]
    D --> G[更换端口/停止占用进程]
    E --> H[检查挂载路径权限]
    F --> I[验证 Ruby/OS 版本兼容性]

---

解决方案

1. 端口冲突处理

修改 docker-compose.yml：

services:
  ruby_app:
    ports:
      - "8080:3000"  # 将宿主机端口改为 8080

2. 文件挂载修复

添加权限配置：

# Dockerfile 添加
RUN mkdir -p /app && chown -R ruby:ruby /app
USER ruby  # 切换非 root 用户

挂载示例：

docker run -v $(pwd):/app:Z -it fullstaq/ruby:3.1.7-se-jemalloc
# :Z 标志解决 SELinux 权限问题

3. 依赖冲突解决

重建依赖缓存：

# Dockerfile 优化层
FROM fullstaq/ruby:3.1.7-se-jemalloc
RUN bundle config set --local force_ruby_platform true  # 忽略原生扩展
COPY Gemfile* .
RUN bundle install --jobs=4 --retry=3

4. 网络配置调整

自定义网络：

docker network create ruby_net
docker run --network=ruby_net --name app1 fullstaq/ruby...
docker run --network=ruby_net --name app2 fullstaq/ruby...

---

高级调试技巧

1. 进入容器排查：

   docker run -it --entrypoint=/bin/bash fullstaq/ruby:3.1.7-se-jemalloc
   

2. 依赖兼容性检查：

   # 在容器内运行
   puts OpenSSL::OPENSSL_VERSION  # 验证 OpenSSL 版本
   puts RbConfig::CONFIG['ruby_version']  # 验证 Ruby 版本
   

3. 最小化测试：

   # 测试 Dockerfile
   FROM fullstaq/ruby:3.1.7-se-jemalloc
   RUN ruby -e "puts 'Hello from Fullstaq Ruby'"
   

关键提示：Fullstaq Ruby 的 Jemalloc 优化可能与其他内存工具冲突，若遇 malloc 相关错误，尝试使用 fullstaq/ruby:3.1.7-se 标准版本测试。

通过以上步骤，90% 的部署冲突可解决。若问题持续，建议提供完整的错误日志和 Dockerfile 进行深度分析。