Tandoor Recipes在树莓派3B+上的部署与数据库恢复经验分享

背景介绍

Tandoor Recipes是一款优秀的开源食谱管理系统，基于Django框架开发。本文将分享在树莓派3B+设备上部署Tandoor Recipes时遇到的两个典型问题及其解决方案，特别是关于端口配置和数据库恢复的实践经验。

部署问题分析

在树莓派3B+上使用Docker Compose部署Tandoor Recipes时，用户遇到了服务无法访问的问题。通过日志分析发现，问题根源在于Nginx容器的端口映射配置不当。

错误配置示例

nginx_recipes:
  image: nginx:mainline-alpine
  ports:
    - 100:100  # 错误的端口映射

正确配置方式

Nginx默认监听80端口，正确的映射应该是将主机端口映射到容器的80端口：

nginx_recipes:
  image: nginx:mainline-alpine
  ports:
    - 100:80  # 正确的主机端口:容器端口映射

数据库恢复问题

在成功部署后，用户尝试从旧版本恢复PostgreSQL数据库时遇到了困难。主要问题包括：

1. 角色权限冲突
2. 数据库名称不匹配
3. 用户权限不一致

恢复步骤详解

1. 清理环境：首先需要完全清理现有的PostgreSQL数据目录
2. 备份文件检查：确保备份只包含Tandoor使用的数据库(默认为djangodb)
3. 恢复操作：

# 停止相关容器
docker-compose stop db_recipes

# 删除旧数据
sudo rm -rf ./postgresql/*

# 启动数据库容器(不启动web容器)
docker-compose up -d db_recipes

# 执行恢复
docker exec -i db_recipes psql -U djangouser -d djangodb < backup.sql

关键配置匹配

恢复时需确保.env文件中的数据库配置与备份时的设置一致：

POSTGRES_DB=djangodb  # 必须与备份数据库名一致
POSTGRES_USER=djangouser  # 必须与备份用户一致

经验总结

1. 端口映射：理解容器服务的默认端口至关重要，Nginx默认使用80端口而非任意端口
2. 数据库恢复：
   • 保持环境清洁，避免残留数据干扰
   • 确保配置参数与备份环境一致
   • 按正确顺序操作：先恢复数据库，再启动应用
3. 日志分析：遇到问题时，仔细阅读容器日志能快速定位问题根源

通过这些问题解决过程，我们不仅掌握了Tandoor Recipes的部署技巧，也加深了对Docker和PostgreSQL的理解。这些经验同样适用于其他基于Docker的Web应用部署场景。