A Cloud Foundry buildpack for Python based apps.
This is based on the [Heroku buildpack] (https://github.com/heroku/heroku-buildpack-python).
This buildpack supports running Django and Flask apps.
Additional information can be found at CloudFoundry.org.
This buildpack will be used if there is a requirements.txt
or setup.py
file in the root directory of your project.
cf push my_app -b https://github.com/cloudfoundry/buildpack-python.git
To use this buildpack on Cloud Foundry, where the Cloud Foundry instance limits some or all internet activity, please read the Disconnected Environments documentation.
As stated in the Disconnected Environments documentation, your application must 'vendor' it's dependencies.
For the Python buildpack, use pip
:
cd <your app dir>
mkdir -p vendor
# vendors all the pip *.tar.gz into vendor/
pip install --download vendor -r requirements.txt
cf push
uploads your vendored dependencies. The buildpack will install them directly from the vendor/
.
- Make sure you have fetched submodules
git submodule update --init
- Get latest buildpack dependencies
BUNDLE_GEMFILE=cf.Gemfile bundle
- Build the buildpack
BUNDLE_GEMFILE=cf.Gemfile bundle exec buildpack-packager [ --uncached | --cached ]
-
Use in Cloud Foundry
Upload the buildpack to your Cloud Foundry and optionally specify it by name
cf create-buildpack custom_python_buildpack python_buildpack-cached-custom.zip 1 cf push my_app -b custom_python_buildpack
The buildpack only supports the stable patches for each dependency listed in the manifest.yml and releases page.
If you try to use a binary that is not currently supported, staging your app will fail and you will see the following error message:
Could not get translated url, exited with: DEPENDENCY_MISSING_IN_MANIFEST: ...
!
! exit
!
Staging failed: Buildpack compilation step failed
Buildpacks use the Machete framework for running integration tests.
To test a buildpack, run the following command from the buildpack's directory:
BUNDLE_GEMFILE=cf.Gemfile bundle exec buildpack-build
More options can be found on Machete's Github page.
Find our guidelines here.
Join the #buildpacks channel in our [Slack community] (http://slack.cloudfoundry.org/)
Open a GitHub issue on this project here
The project backlog is on Pivotal Tracker