Heroku Python 项目技术文档

1. 安装指南

环境准备

在使用 Heroku Python 项目之前，您需要确保已经安装了以下环境：

• Git
• Heroku CLI

创建 Heroku 应用

1. 登录到您的 Heroku 账户。
2. 在终端中使用 heroku create 命令创建一个新的 Heroku 应用。

heroku create

部署应用

1. 将您的项目代码克隆到本地。
2. 初始化 Git 仓库并添加 Heroku 为远程仓库。

git init
heroku git:remote -a your-heroku-app-name

3. 将代码提交到 Git 仓库。

git add .
git commit -am "Initial commit"

4. 将代码推送到 Heroku。

git push heroku master

2. 项目的使用说明

本项目为 Heroku 官方 Python 应用构建包，支持多种 Python Web 框架，如 Django 和 Flask。推荐使用 Gunicorn 作为 Web 服务器。所有通过 pip 安装的软件均可以使用，但 Web 进程必须绑定到环境变量 $PORT，并且只允许使用 HTTP 协议接收连接。

3. 项目API使用文档

由于本项目为 Heroku 构建包，不直接提供 API 接口。但您可以使用 Heroku 提供的 API 来管理您的应用。更多关于 Heroku API 的信息，请参考 Heroku Dev Center。

4. 项目安装方式

指定 Python 版本

建议您在应用中指定 Python 版本，而不是依赖构建包的默认 Python 版本。例如，若要请求 Python 3.13 的最新修复版本，请在项目根目录下创建一个 .python-version 文件，内容为：

3.13

构建包将按照以下顺序查找 Python 版本（优先级从高到低）：

1. runtime.txt 文件（已废弃）
2. .python-version 文件（推荐）
3. Pipfile.lock 文件中的 python_full_version 字段
4. Pipfile.lock 文件中的 python_version 字段

如果没有找到上述任何版本信息，构建包将为应用的第一次构建使用默认 Python 版本，并且除非清除构建缓存或请求其他版本，后续构建将固定使用该版本。

当前默认 Python 版本为：3.13

支持的 Python 版本包括：

• Python 3.13
• Python 3.12
• Python 3.11
• Python 3.10

以下 Python 版本已在 Heroku 上废弃：

• Python 3.9
• Python 3.8（仅在 Heroku-20 栈上可用）

上述列表之外的 Python 版本已不再受支持，因为它们已经达到了生命周期的终点 upstream。

额外配置

确保您的项目根目录中包含 requirements.txt、Pipfile 或 poetry.lock 文件，以便构建包能够正确安装依赖。