bernieke/recipes

镜像概述和主要用途

这是一个Django应用，用于管理食谱和创建可发送至OurGroceries的购物清单。支持通过Docker（使用现有PostgreSQL数据库或内置SQLite数据库）或结合PostgreSQL和nginx的docker-compose完整栈进行部署。

截图

!recipe
!index
!quantity
!shopping list
!admin

使用方法

使用docker-compose部署

执行以下命令启动服务并创建超级用户：

bash
docker-compose up -d && \
docker exec -it recipes_recipes_1 /opt/recipes/manage.py createsuperuser

升级时，需保存Django的SECRET_KEY以避免现有会话失效：

bash
docker pull bernieke/recipes && \
DJANGO_SECRET_KEY="`docker exec recipes_recipes_1 cat /opt/recipes/secret.key`" docker-compose up -d && \
docker image prune -f

构建并运行开发容器

执行以下命令构建并启动开发容器：

bash
docker rm -vf recipes; \
docker image rm recipes; \
docker image prune -f; \
docker build . -t recipes --force-rm && \
docker create --name recipes -p 8000:8000 recipes && \
docker start recipes && \
docker logs recipes -f

直接运行

注意：启用DEBUG时，食材不会实际发送至OurGroceries。

bash
pip install -r requirements.txt
GUNICORN=0 DEBUG=1 ./manage.py runserver

配置

Gunicorn配置

可通过为recipes容器添加前缀为GUNICORN_的环境变量来配置Gunicorn（例如GUNICORN_WORKERS将对应Gunicorn的WORKERS设置）。

nginx配置

可修改nginx.conf文件以更改nginx配置。

环境变量配置

Docker镜像通过以下环境变量进行配置（已在docker-compose.yml中预设）：

• GUNICORN：设为1时使用Gunicorn而非runserver（Django的DEBUG也会设为False）
• SQL_ENGINE：Django数据库引擎（默认为django.db.backends.sqlite3；使用PostgreSQL时设为django.db.backends.postgresql）
• SQL_DATABASE：数据库名称（SQLite时为路径，默认若/var/lib/recipes存在则为/var/lib/recipes/db.sqlite3，否则为./db.sqlite3）
• SQL_USER：数据库用户（仅PostgreSQL使用）
• SQL_PASSWORD：数据库密码（仅PostgreSQL使用）
• SQL_HOST：数据库主机名（仅PostgreSQL使用）
• SQL_PORT：数据库端口（仅PostgreSQL使用）