基于 Cookiecutter Django,后端为 Django + Django REST Framework
django-rest-api-ci-cd-template — Django 文档模板
作者 aidoskanapyanov
基于 Cookiecutter Django 的 REST API 模板,集成 GitHub Actions、Docker Swarm 零停机部署与 DRF-Spectacular 文档。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
目前只有 1 张可用预览,尚未找到可用演示站,暂无法补充内页和手机端截图。
目前有 1 张原始预览,可打开完整图片查看设计细节。
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
DRF-Spectacular 动态生成 OpenAPI/Swagger UI 文档
GitHub Actions 驱动的 CI/CD,含 DockerHub 推送与 Docker Swarm 部署
Traefik + Let's Encrypt 实现自动 SSL 与零停机证书轮换
pytest、Coverage.py、pre-commit、Black、Ruff、mypy 组成的质量工具链
docs 目录提供设计规格、CI、CD、风格指南四份独立文档
模板详细介绍
这个模板的定位很明确:不是单纯的 Django 项目脚手架,而是把「从代码提交到生产部署」的完整链路打包进来。它基于 Cookiecutter Django 生成,后端采用 Django + Django REST Framework,API 文档由 DRF-Spectacular 动态生成 OpenAPI/Swagger UI,数据库固定为 PostgreSQL。仓库本身以文档为核心,docs 目录下拆分了项目设计规格、持续集成、持续交付和代码风格四份说明,适合想先看架构再决定是否采用的开发者。
在工程化能力上,模板覆盖了 pre-commit 钩子、pytest + pytest-django 测试、Coverage.py 覆盖率报告,以及 Black、Ruff、mypy 组成的代码质量工具链。CI/CD 部分使用 GitHub Actions,交付环节包含 Docker 镜像构建、DockerHub 推送和 DigitalOcean Docker Swarm 部署,并通过 Traefik 与 Let's Encrypt 实现自动 SSL 证书签发和轮换,宣称支持滚动更新与失败回滚。这些描述来自 README,实际可用性需要结合你的云厂商和域名环境验证。
需要留意的是,仓库 stars 数较少,license 状态标注为 review,README 中展示的示例站点是 Airplane Fuel Tracker,说明模板可能由真实项目抽取而来,通用性尚未经过大规模验证。另外,Swarm 部署、零停机 SSL 这类能力依赖具体基础设施配置,README 没有给出完整的生产环境变量清单和密钥管理方案,上线前建议逐项核对 docs 中的交付文档,并确认 MIT 许可的实际文件是否存在。
适合你的项目吗?
适用场景
- 需要一套可直接参考的 Django REST API 工程化基线,包含测试与代码检查
- 计划使用 Docker Swarm 而非 Kubernetes 进行容器编排的小型团队
- 希望 API 文档随代码自动生成、并接入 Swagger UI 的项目
- 想研究 GitHub Actions 与 Docker 镜像发布流程如何串联的开发者
适合人群
- 熟悉 Django 与 Docker、能自行调整部署配置的后端开发者
- 需要 PostgreSQL 作为主数据库的 REST API 项目
- 接受以文档为主要参考、愿意阅读 docs 目录的使用者
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
本地运行可选择非 Docker 方式,需先启动 PostgreSQL 16 容器并安装 requirements/local.txt
- 2
Docker 方式使用 docker-compose.local.yml 构建与启动,迁移需单独执行
- 3
README 未列出生产环境所需的环境变量与密钥管理方式,部署前需核对 docs/continuous-delivery.md
- 4
Docker Swarm、Traefik、Let's Encrypt 的实际效果依赖域名与服务器配置,需自行验证
- 5
license 状态标注为 review,使用前建议确认仓库中 MIT 许可文件的实际情况
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可证允许免费使用、修改、分发和商用,仅需保留版权与许可声明。README仅说明MIT许可,无额外限制。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 保留版权声明和许可声明于所有副本或实质部分
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy of this software
许可证原文
This project is licensed under the MIT License.
README 原文
https://github.com/aidoskanapyanov/django-rest-api-ci-cd-template/blob/main/LICENSEhttps://github.com/aidoskanapyanov/django-rest-api-ci-cd-template/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料一般 · 63 / 100
- 技术栈
- Django
- 网站类型
- 文档
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2025-02-22
- 截图检查日期
- 2026-09-07
目前没有记录演示链接。请依据仓库说明在本地评估;仅凭截图无法确认交互行为。
目录记录的主要技术栈是 Django。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

minimal-mistakes
:triangular_ruler: Jekyll theme for building a personal site, blog, project documentation, or portfolio.
Jekyll · 作品集

hugo-book
Hugo Book 是一个面向文档场景的 Hugo 主题,定位很直接:把文档站点做得像一本朴素的书。
Hugo · 文档

jekyll-TeXt-theme
💎 🐳 A super customizable Jekyll theme for personal site, team site, blog, project, documentation, etc.
Jekyll · 博客

docsy
Hugo theme for open source documentation
Hugo · 文档

hextra
Hextra 是一个 Hugo 主题,定位在文档站与博客之间:既提供侧边栏导航、目录、面包屑、分页这类文档站结构,也能承载博客内容。
Hugo · 文档

doks
Doks 是 Thulite 生态下的文档主题,底层是 Hugo 静态站点生成器。 它把重点放在长文阅读体验上:极简且响应式的布局、为文档优化的排版,以及代码块语法高亮,整体更接近技术手册的形态,而不是通用营销页模板。
Hugo · 工具站