docker-library
/
docs
mirror of https://github.com/docker-library/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #2420 from fred-from-york/python-add-slim-variant-note 

python: Add note on `pip install` in slim variants
This commit is contained in:
Tianon Gravi 2024-02-21 10:15:44 -08:00 committed by GitHub
parent 0d426687a6 2aa35c6748
commit 4e47f1a642
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 8 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
python/variant-slim.md Normal file
View File

@ -0,0 +1,8 @@
## `%%IMAGE%%:<version>-slim`
This image does not contain the common Debian packages contained in the default tag and only contains the minimal Debian packages needed to run `%%IMAGE%%`. Unless you are working in an environment where *only* the `%%IMAGE%%` image will be deployed and you have space constraints, we highly recommend using the default image of this repository.
When using this image `pip install` will work if a suitable built distribution is available for the Python distribution package being installed. `pip install` may fail when installing a Python distribution package from a source distribution. This image does not contain the Debian packages required to compile extension modules written in other languages. Possible solutions if a `pip install` fails include:
- Use this image and install any required Debian packages before running `pip install`.
- Use the default image of this repository. The default image contains the most commonly required Debian packages. The majority of arbitrary `pip install`s should be successful without additional header/development Debian packages.