mirror of
https://github.com/kennethreitz/heroku-buildpack-python.git
synced 2026-06-05 23:10:16 +00:00
Yury V. Zaytsev
c732097d17
* Since pipenv is being pinned now, output pinned version in steps Signed-off-by: Yury V. Zaytsev <yury.zaytsev@moneymeets.com> * Update README.md example output to match new reality Signed-off-by: Yury V. Zaytsev <yury.zaytsev@moneymeets.com> * Update pipenv
63 lines
2.3 KiB
Markdown
63 lines
2.3 KiB
Markdown
|
|
|
|
# Heroku Buildpack: Python
|
|
|
|
[](https://travis-ci.org/heroku/heroku-buildpack-python)
|
|
|
|
This is the official [Heroku buildpack](https://devcenter.heroku.com/articles/buildpacks) for Python apps, powered by [Pipenv](http://docs.pipenv.org/), [pip](https://pip.pypa.io/) and other excellent software.
|
|
|
|
Recommended web frameworks include **Django** and **Flask**. The recommended webserver is **Gunicorn**. There are no restrictions around what software can be used (as long as it's pip-installable). Web processes must bind to `$PORT`, and only the HTTP protocol is permitted for incoming connections.
|
|
|
|
Python packages with C dependencies that are not [available on the stack image](https://devcenter.heroku.com/articles/stack-packages) are generally not supported, unless `manylinux` wheels are provided by the package maintainers (common). For recommended solutions, check out [this article](https://devcenter.heroku.com/articles/python-c-deps) for more information.
|
|
|
|
See it in Action
|
|
----------------
|
|
|
|
Deploying a Python application couldn't be easier:
|
|
|
|
$ ls
|
|
Pipfile Pipfile.lock Procfile web.py
|
|
|
|
$ heroku create --buildpack heroku/python
|
|
|
|
$ git push heroku master
|
|
…
|
|
-----> Python app detected
|
|
-----> Installing python-3.6.4
|
|
-----> Installing pip
|
|
-----> Installing requirements with Pipenv 11.7.1…
|
|
...
|
|
Installing dependencies from Pipfile…
|
|
-----> Discovering process types
|
|
Procfile declares types -> (none)
|
|
|
|
A `Pipfile` or `requirements.txt` must be present at the root of your application's repository.
|
|
|
|
You can also specify the latest production release of this buildpack for upcoming builds of an existing application:
|
|
|
|
$ heroku buildpacks:set heroku/python
|
|
|
|
|
|
Specify a Python Runtime
|
|
------------------------
|
|
|
|
Specific versions of the Python runtime can be specified in your `Pipfile`:
|
|
|
|
[requires]
|
|
python_version = "2.7"
|
|
|
|
Or, more specifically:
|
|
|
|
[requires]
|
|
python_full_version = "2.7.14"
|
|
|
|
Or, with a `runtime.txt` file:
|
|
|
|
$ cat runtime.txt
|
|
python-2.7.14
|
|
|
|
Runtime options include:
|
|
|
|
- `python-3.6.4`
|
|
- `python-2.7.14`
|