为Ruby on Rails Web应用容器添加tmp-data卷时出错求助

问题分析 #

你的docker-compose.production.yml中，web服务挂载了tmp-data命名卷到/rails-lyrics-site/tmp，导致Rails无法写入该目录而启动失败。核心原因是Docker命名卷默认由root用户拥有，而生产环境中Rails通常以非root用户运行（比如镜像中创建的rails用户），没有该目录的写入权限。移除卷配置后，容器使用内部的tmp目录（权限已在Dockerfile中配置正确），所以能正常启动。

解决方案 #

方案1：启动命令中临时修复权限 #

修改web服务的command，在启动前先调整tmp目录的权限：

web:
  # ... 其他配置不变
  command: bash -c "chown -R $(id -u):$(id -g) /rails-lyrics-site/tmp && rm -f tmp/pids/server.pid && bundle exec puma -C config/puma.rb"

$(id -u):$(id -g)会获取当前运行容器的用户UID/GID，确保权限匹配。

方案2：使用Entrypoint脚本（推荐） #

创建一个entrypoint.sh脚本，统一处理权限初始化和启动前操作：

#!/bin/bash
set -e

# 确保tmp目录及子目录权限正确
chown -R $(id -u):$(id -g) /rails-lyrics-site/tmp

# 清理残留的server.pid文件
rm -f /rails-lyrics-site/tmp/pids/server.pid

# 执行传入的命令
exec "$@"

然后在Dockerfile中配置该脚本为entrypoint：

# ... 其他Dockerfile指令
COPY entrypoint.sh /usr/bin/
RUN chmod +x /usr/bin/entrypoint.sh
ENTRYPOINT ["entrypoint.sh"]
CMD ["bundle", "exec", "puma", "-C", "config/puma.rb"]

最后修改docker-compose中的web服务command（可简化）：

web:
  # ... 其他配置不变
  command: bundle exec puma -C config/puma.rb

方案3：调整卷的初始化权限 #

如果你希望在卷创建时就设置好权限，可以先运行一个临时容器初始化卷：

docker run --rm -v tmp-data:/rails-lyrics-site/tmp ruby:3.2 chown -R rails:rails /rails-lyrics-site/tmp

这里假设你的Rails运行用户是rails，请根据实际镜像中的用户调整。之后再启动服务即可。

验证 #

执行docker-compose -f docker-compose.production.yml up，检查web服务是否正常启动，也可以进入容器验证tmp目录权限：

docker exec -it <web-container-id> ls -ld /rails-lyrics-site/tmp

输出应该显示所属用户为Rails运行用户。

内容的提问来源于stack exchange，提问作者Hoang Duc Quan