使用Cookiecutter-Django项目在Heroku上的部署指南

使用Cookiecutter-Django项目在Heroku上的部署指南

cookiecutter-django cookiecutter/cookiecutter-django: cookiecutter-django 是一个基于Cookiecutter项目的模板，用来快速生成遵循最佳实践的Django项目结构，包括了众多预配置的功能，如数据库迁移、静态文件处理、权限认证等。 项目地址: https://gitcode.com/gh_mirrors/co/cookiecutter-django

前言

Heroku是一个流行的云平台即服务(PaaS)，它简化了应用程序的部署和管理流程。对于使用Cookiecutter-Django项目生成的Django应用来说，Heroku提供了一个便捷的部署选择。本文将详细介绍如何将Cookiecutter-Django项目部署到Heroku平台。

准备工作

在开始部署前，请确保你已经：

1. 安装了Heroku CLI工具
2. 拥有Heroku账户并已登录
3. 完成了Cookiecutter-Django项目的初始化配置

基础部署步骤

1. 创建Heroku应用

首先需要创建一个新的Heroku应用，并指定Python构建包：

heroku create --buildpack heroku/python

2. 配置数据库

Cookiecutter-Django默认使用PostgreSQL数据库，在Heroku上需要添加相应服务：

heroku addons:create heroku-postgresql:essential-0

注意：这不是免费套餐，会产生费用

配置数据库自动备份：

heroku pg:backups schedule --at '02:00 America/Los_Angeles' DATABASE_URL
heroku pg:promote DATABASE_URL

3. 添加Redis服务

如果项目中使用了缓存或Celery，需要添加Redis服务：

heroku addons:create heroku-redis:mini

4. 配置邮件服务

默认使用Mailgun作为邮件服务：

heroku addons:create mailgun:starter

如果选择其他邮件服务，需要参考相关文档配置不同的环境变量。

5. 设置关键环境变量

配置Django生产环境所需的关键变量：

heroku config:set DJANGO_DEBUG=False
heroku config:set DJANGO_SETTINGS_MODULE=config.settings.production
heroku config:set DJANGO_SECRET_KEY="$(openssl rand -base64 64)"

设置管理员URL路径（增强安全性）：

heroku config:set DJANGO_ADMIN_URL="$(openssl rand -base64 4096 | tr -dc 'A-HJ-NP-Za-km-z2-9' | head -c 32)/"

配置允许的主机名（替换为你的Heroku应用域名）：

heroku config:set DJANGO_ALLOWED_HOSTS=your-app-name.herokuapp.com

6. 配置AWS S3存储（可选）

如果使用AWS S3存储静态文件和媒体文件：

heroku config:set DJANGO_AWS_ACCESS_KEY_ID=your-access-key
heroku config:set DJANGO_AWS_SECRET_ACCESS_KEY=your-secret-key
heroku config:set DJANGO_AWS_STORAGE_BUCKET_NAME=your-bucket-name

7. 部署代码

推送代码到Heroku远程仓库：

git push heroku main

8. 初始化数据库

创建超级用户：

heroku run python manage.py createsuperuser

9. 安全检查

运行部署检查：

heroku run python manage.py check --deploy

10. 打开应用

heroku open

高级配置选项

Celery配置

如果项目中使用了Celery，需要启动worker进程：

heroku ps:scale worker=1

Sentry错误监控

如果选择了Sentry作为错误监控工具，可以添加Sentry服务：

heroku addons:create sentry:f1

或者配置已有的Sentry DSN：

heroku config:set SENTRY_DSN=https://xxxx@sentry.io/12345

前端构建配置

如果项目中使用了Gulp或Webpack作为前端构建工具，需要添加Node.js构建包：

heroku buildpacks:add --index 1 heroku/nodejs

这将在部署时自动运行npm install和npm build命令，完成SASS编译和JS打包。

注意事项

1. Heroku的Docker支持目前不被Cookiecutter-Django官方支持
2. 邮件服务配置需要根据实际选择的服务进行调整
3. 生产环境务必确保DJANGO_DEBUG设置为False
4. 定期检查数据库备份是否正常执行

结语

通过以上步骤，你应该已经成功将Cookiecutter-Django项目部署到Heroku平台。Heroku提供了便捷的扩展和管理功能，适合中小型项目的快速部署。对于生产环境，建议定期监控应用性能和资源使用情况，并根据需要调整服务配置。

cookiecutter-django cookiecutter/cookiecutter-django: cookiecutter-django 是一个基于Cookiecutter项目的模板，用来快速生成遵循最佳实践的Django项目结构，包括了众多预配置的功能，如数据库迁移、静态文件处理、权限认证等。 项目地址: https://gitcode.com/gh_mirrors/co/cookiecutter-django