|
|
@@ -16,30 +16,55 @@ WARNING:
|
|
|
|
|
|
# Supported tags and respective `Dockerfile` links
|
|
|
|
|
|
+## Shared Tags
|
|
|
+
|
|
|
+- `3.7.0a1`, `3.7-rc`, `rc`:
|
|
|
+ - [`3.7.0a1-stretch` (*3.7-rc/stretch/Dockerfile*)](https://github.com/docker-library/python/blob/45685613e1189227b91affba86dfcb2c764d7fa4/3.7-rc/stretch/Dockerfile)
|
|
|
+ - [`3.7.0a1-windowsservercore` (*3.7-rc/windows/windowsservercore/Dockerfile*)](https://github.com/docker-library/python/blob/45685613e1189227b91affba86dfcb2c764d7fa4/3.7-rc/windows/windowsservercore/Dockerfile)
|
|
|
+- `3.6.2`, `3.6`, `3`, `latest`:
|
|
|
+ - [`3.6.2-jessie` (*3.6/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/d3c5f47b788adb96e69477dadfb0baca1d97f764/3.6/jessie/Dockerfile)
|
|
|
+ - [`3.6.2-windowsservercore` (*3.6/windows/windowsservercore/Dockerfile*)](https://github.com/docker-library/python/blob/761d766baa0ff33754436c0a1fd9aedc68cf7947/3.6/windows/windowsservercore/Dockerfile)
|
|
|
+- `3.5.4`, `3.5`:
|
|
|
+ - [`3.5.4-jessie` (*3.5/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/6ebbaa8a56cdf4021c78e87b3872be3861ac072a/3.5/jessie/Dockerfile)
|
|
|
+ - [`3.5.4-windowsservercore` (*3.5/windows/windowsservercore/Dockerfile*)](https://github.com/docker-library/python/blob/6ebbaa8a56cdf4021c78e87b3872be3861ac072a/3.5/windows/windowsservercore/Dockerfile)
|
|
|
+- `3.4.7`, `3.4`:
|
|
|
+ - [`3.4.7-jessie` (*3.4/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/27516b7347b3236a3accd4b2e1242a53fb54d04c/3.4/jessie/Dockerfile)
|
|
|
+- `3.3.7`, `3.3`:
|
|
|
+ - [`3.3.7-jessie` (*3.3/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/eb5fcfeb040c4ecdb32fd79caa547943e18f9c97/3.3/jessie/Dockerfile)
|
|
|
+- `2.7.14`, `2.7`, `2`:
|
|
|
+ - [`2.7.14-jessie` (*2.7/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/b1512ead24c6b111506a8d4229134a29da240597/2.7/jessie/Dockerfile)
|
|
|
+ - [`2.7.14-windowsservercore` (*2.7/windows/windowsservercore/Dockerfile*)](https://github.com/docker-library/python/blob/b1512ead24c6b111506a8d4229134a29da240597/2.7/windows/windowsservercore/Dockerfile)
|
|
|
+
|
|
|
+## Simple Tags
|
|
|
+
|
|
|
+- [`3.7.0a1-stretch`, `3.7-rc-stretch`, `rc-stretch` (*3.7-rc/stretch/Dockerfile*)](https://github.com/docker-library/python/blob/45685613e1189227b91affba86dfcb2c764d7fa4/3.7-rc/stretch/Dockerfile)
|
|
|
+- [`3.7.0a1-slim`, `3.7-rc-slim`, `rc-slim` (*3.7-rc/stretch/slim/Dockerfile*)](https://github.com/docker-library/python/blob/45685613e1189227b91affba86dfcb2c764d7fa4/3.7-rc/stretch/slim/Dockerfile)
|
|
|
+- [`3.7.0a1-alpine3.6`, `3.7-rc-alpine3.6`, `rc-alpine3.6`, `3.7.0a1-alpine`, `3.7-rc-alpine`, `rc-alpine` (*3.7-rc/alpine3.6/Dockerfile*)](https://github.com/docker-library/python/blob/45685613e1189227b91affba86dfcb2c764d7fa4/3.7-rc/alpine3.6/Dockerfile)
|
|
|
+- [`3.7.0a1-windowsservercore`, `3.7-rc-windowsservercore`, `rc-windowsservercore` (*3.7-rc/windows/windowsservercore/Dockerfile*)](https://github.com/docker-library/python/blob/45685613e1189227b91affba86dfcb2c764d7fa4/3.7-rc/windows/windowsservercore/Dockerfile)
|
|
|
- [`3.6.2-stretch`, `3.6-stretch`, `3-stretch`, `stretch` (*3.6/stretch/Dockerfile*)](https://github.com/docker-library/python/blob/c9954b06c8b178d7888bc1626bed5a14e43a9203/3.6/stretch/Dockerfile)
|
|
|
-- [`3.6.2-jessie`, `3.6-jessie`, `3-jessie`, `jessie`, `3.6.2`, `3.6`, `3`, `latest` (*3.6/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/d3c5f47b788adb96e69477dadfb0baca1d97f764/3.6/jessie/Dockerfile)
|
|
|
-- [`3.6.2-slim`, `3.6-slim`, `3-slim`, `slim` (*3.6/jessie/slim/Dockerfile*)](https://github.com/docker-library/python/blob/d3c5f47b788adb96e69477dadfb0baca1d97f764/3.6/jessie/slim/Dockerfile)
|
|
|
+- [`3.6.2-jessie`, `3.6-jessie`, `3-jessie`, `jessie` (*3.6/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/d3c5f47b788adb96e69477dadfb0baca1d97f764/3.6/jessie/Dockerfile)
|
|
|
+- [`3.6.2-slim`, `3.6-slim`, `3-slim`, `slim` (*3.6/jessie/slim/Dockerfile*)](https://github.com/docker-library/python/blob/45685613e1189227b91affba86dfcb2c764d7fa4/3.6/jessie/slim/Dockerfile)
|
|
|
- [`3.6.2-onbuild`, `3.6-onbuild`, `3-onbuild`, `onbuild` (*3.6/jessie/onbuild/Dockerfile*)](https://github.com/docker-library/python/blob/d3c5f47b788adb96e69477dadfb0baca1d97f764/3.6/jessie/onbuild/Dockerfile)
|
|
|
- [`3.6.2-alpine3.6`, `3.6-alpine3.6`, `3-alpine3.6`, `alpine3.6` (*3.6/alpine3.6/Dockerfile*)](https://github.com/docker-library/python/blob/5d86c858d58f84b8dd1274ac61ac1c9c9ebc7739/3.6/alpine3.6/Dockerfile)
|
|
|
- [`3.6.2-alpine3.4`, `3.6-alpine3.4`, `3-alpine3.4`, `alpine3.4`, `3.6.2-alpine`, `3.6-alpine`, `3-alpine`, `alpine` (*3.6/alpine3.4/Dockerfile*)](https://github.com/docker-library/python/blob/d3c5f47b788adb96e69477dadfb0baca1d97f764/3.6/alpine3.4/Dockerfile)
|
|
|
- [`3.6.2-windowsservercore`, `3.6-windowsservercore`, `3-windowsservercore`, `windowsservercore` (*3.6/windows/windowsservercore/Dockerfile*)](https://github.com/docker-library/python/blob/761d766baa0ff33754436c0a1fd9aedc68cf7947/3.6/windows/windowsservercore/Dockerfile)
|
|
|
-- [`3.5.4-jessie`, `3.5-jessie`, `3.5.4`, `3.5` (*3.5/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/6ebbaa8a56cdf4021c78e87b3872be3861ac072a/3.5/jessie/Dockerfile)
|
|
|
-- [`3.5.4-slim`, `3.5-slim` (*3.5/jessie/slim/Dockerfile*)](https://github.com/docker-library/python/blob/6ebbaa8a56cdf4021c78e87b3872be3861ac072a/3.5/jessie/slim/Dockerfile)
|
|
|
+- [`3.5.4-jessie`, `3.5-jessie` (*3.5/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/6ebbaa8a56cdf4021c78e87b3872be3861ac072a/3.5/jessie/Dockerfile)
|
|
|
+- [`3.5.4-slim`, `3.5-slim` (*3.5/jessie/slim/Dockerfile*)](https://github.com/docker-library/python/blob/45685613e1189227b91affba86dfcb2c764d7fa4/3.5/jessie/slim/Dockerfile)
|
|
|
- [`3.5.3-onbuild`, `3.5-onbuild` (*3.5/jessie/onbuild/Dockerfile*)](https://github.com/docker-library/python/blob/d3c5f47b788adb96e69477dadfb0baca1d97f764/3.5/jessie/onbuild/Dockerfile)
|
|
|
- [`3.5.4-alpine3.4`, `3.5-alpine3.4`, `3.5.4-alpine`, `3.5-alpine` (*3.5/alpine3.4/Dockerfile*)](https://github.com/docker-library/python/blob/6ebbaa8a56cdf4021c78e87b3872be3861ac072a/3.5/alpine3.4/Dockerfile)
|
|
|
- [`3.5.4-windowsservercore`, `3.5-windowsservercore` (*3.5/windows/windowsservercore/Dockerfile*)](https://github.com/docker-library/python/blob/6ebbaa8a56cdf4021c78e87b3872be3861ac072a/3.5/windows/windowsservercore/Dockerfile)
|
|
|
-- [`3.4.7-jessie`, `3.4-jessie`, `3.4.7`, `3.4` (*3.4/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/27516b7347b3236a3accd4b2e1242a53fb54d04c/3.4/jessie/Dockerfile)
|
|
|
-- [`3.4.7-slim`, `3.4-slim` (*3.4/jessie/slim/Dockerfile*)](https://github.com/docker-library/python/blob/27516b7347b3236a3accd4b2e1242a53fb54d04c/3.4/jessie/slim/Dockerfile)
|
|
|
+- [`3.4.7-jessie`, `3.4-jessie` (*3.4/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/27516b7347b3236a3accd4b2e1242a53fb54d04c/3.4/jessie/Dockerfile)
|
|
|
+- [`3.4.7-slim`, `3.4-slim` (*3.4/jessie/slim/Dockerfile*)](https://github.com/docker-library/python/blob/45685613e1189227b91affba86dfcb2c764d7fa4/3.4/jessie/slim/Dockerfile)
|
|
|
- [`3.4.6-onbuild`, `3.4-onbuild` (*3.4/jessie/onbuild/Dockerfile*)](https://github.com/docker-library/python/blob/d3c5f47b788adb96e69477dadfb0baca1d97f764/3.4/jessie/onbuild/Dockerfile)
|
|
|
- [`3.4.7-wheezy`, `3.4-wheezy` (*3.4/wheezy/Dockerfile*)](https://github.com/docker-library/python/blob/27516b7347b3236a3accd4b2e1242a53fb54d04c/3.4/wheezy/Dockerfile)
|
|
|
- [`3.4.7-alpine3.4`, `3.4-alpine3.4`, `3.4.7-alpine`, `3.4-alpine` (*3.4/alpine3.4/Dockerfile*)](https://github.com/docker-library/python/blob/27516b7347b3236a3accd4b2e1242a53fb54d04c/3.4/alpine3.4/Dockerfile)
|
|
|
-- [`3.3.7-jessie`, `3.3-jessie`, `3.3.7`, `3.3` (*3.3/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/eb5fcfeb040c4ecdb32fd79caa547943e18f9c97/3.3/jessie/Dockerfile)
|
|
|
-- [`3.3.7-slim`, `3.3-slim` (*3.3/jessie/slim/Dockerfile*)](https://github.com/docker-library/python/blob/eb5fcfeb040c4ecdb32fd79caa547943e18f9c97/3.3/jessie/slim/Dockerfile)
|
|
|
+- [`3.3.7-jessie`, `3.3-jessie` (*3.3/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/eb5fcfeb040c4ecdb32fd79caa547943e18f9c97/3.3/jessie/Dockerfile)
|
|
|
+- [`3.3.7-slim`, `3.3-slim` (*3.3/jessie/slim/Dockerfile*)](https://github.com/docker-library/python/blob/45685613e1189227b91affba86dfcb2c764d7fa4/3.3/jessie/slim/Dockerfile)
|
|
|
- [`3.3.6-onbuild`, `3.3-onbuild` (*3.3/jessie/onbuild/Dockerfile*)](https://github.com/docker-library/python/blob/d3c5f47b788adb96e69477dadfb0baca1d97f764/3.3/jessie/onbuild/Dockerfile)
|
|
|
- [`3.3.7-wheezy`, `3.3-wheezy` (*3.3/wheezy/Dockerfile*)](https://github.com/docker-library/python/blob/eb5fcfeb040c4ecdb32fd79caa547943e18f9c97/3.3/wheezy/Dockerfile)
|
|
|
- [`3.3.7-alpine3.4`, `3.3-alpine3.4`, `3.3.7-alpine`, `3.3-alpine` (*3.3/alpine3.4/Dockerfile*)](https://github.com/docker-library/python/blob/eb5fcfeb040c4ecdb32fd79caa547943e18f9c97/3.3/alpine3.4/Dockerfile)
|
|
|
- [`2.7.14-stretch`, `2.7-stretch`, `2-stretch` (*2.7/stretch/Dockerfile*)](https://github.com/docker-library/python/blob/b1512ead24c6b111506a8d4229134a29da240597/2.7/stretch/Dockerfile)
|
|
|
-- [`2.7.14-jessie`, `2.7-jessie`, `2-jessie`, `2.7.14`, `2.7`, `2` (*2.7/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/b1512ead24c6b111506a8d4229134a29da240597/2.7/jessie/Dockerfile)
|
|
|
+- [`2.7.14-jessie`, `2.7-jessie`, `2-jessie` (*2.7/jessie/Dockerfile*)](https://github.com/docker-library/python/blob/b1512ead24c6b111506a8d4229134a29da240597/2.7/jessie/Dockerfile)
|
|
|
- [`2.7.14-slim`, `2.7-slim`, `2-slim` (*2.7/jessie/slim/Dockerfile*)](https://github.com/docker-library/python/blob/b1512ead24c6b111506a8d4229134a29da240597/2.7/jessie/slim/Dockerfile)
|
|
|
- [`2.7.13-onbuild`, `2.7-onbuild`, `2-onbuild` (*2.7/jessie/onbuild/Dockerfile*)](https://github.com/docker-library/python/blob/d3c5f47b788adb96e69477dadfb0baca1d97f764/2.7/jessie/onbuild/Dockerfile)
|
|
|
- [`2.7.14-wheezy`, `2.7-wheezy`, `2-wheezy` (*2.7/wheezy/Dockerfile*)](https://github.com/docker-library/python/blob/b1512ead24c6b111506a8d4229134a29da240597/2.7/wheezy/Dockerfile)
|
|
|
@@ -145,16 +170,6 @@ This is the defacto image. If you are unsure about what your needs are, you prob
|
|
|
|
|
|
This image does not contain the common packages contained in the default tag and only contains the minimal packages needed to run `python`. Unless you are working in an environment where *only* the `python` image will be deployed and you have space constraints, we highly recommend using the default image of this repository.
|
|
|
|
|
|
-## `python:onbuild`
|
|
|
-
|
|
|
-The `ONBUILD` image variants are deprecated, and their usage is discouraged. For more details, see [docker-library/official-images#2076](https://github.com/docker-library/official-images/issues/2076).
|
|
|
-
|
|
|
-This image feeds your `requirements.txt` file automatically to `pip` in order to make building derivative images easier. For most use cases, creating a `Dockerfile` in the base of your project directory with the line `FROM python:onbuild` will be enough to create a stand-alone image for your project.
|
|
|
-
|
|
|
-While the `onbuild` variant is really useful for "getting off the ground running" (zero to Dockerized in a short period of time), it's not recommended for long-term usage within a project due to the lack of control over *when* the `ONBUILD` triggers fire (see also [`docker/docker#5714`](https://github.com/docker/docker/issues/5714), [`docker/docker#8240`](https://github.com/docker/docker/issues/8240), [`docker/docker#11917`](https://github.com/docker/docker/issues/11917)).
|
|
|
-
|
|
|
-Once you've got a handle on how your project functions within Docker, you'll probably want to adjust your `Dockerfile` to inherit from a non-`onbuild` variant and copy the commands from the `onbuild` variant `Dockerfile` (moving the `ONBUILD` lines to the end and removing the `ONBUILD` keywords) into your own file so that you have tighter control over them and more transparency for yourself and others looking at your `Dockerfile` as to what it does. This also makes it easier to add additional requirements as time goes on (such as installing more packages before performing the previously-`ONBUILD` steps).
|
|
|
-
|
|
|
## `python:alpine`
|
|
|
|
|
|
This image is based on the popular [Alpine Linux project](http://alpinelinux.org), available in [the `alpine` official image](https://hub.docker.com/_/alpine). Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general.
|
|
|
@@ -172,6 +187,16 @@ For information about how to get Docker running on Windows, please see the relev
|
|
|
- [Windows Server Quick Start](https://msdn.microsoft.com/en-us/virtualization/windowscontainers/quick_start/quick_start_windows_server)
|
|
|
- [Windows 10 Quick Start](https://msdn.microsoft.com/en-us/virtualization/windowscontainers/quick_start/quick_start_windows_10)
|
|
|
|
|
|
+## `python:onbuild`
|
|
|
+
|
|
|
+The `ONBUILD` image variants are deprecated, and their usage is discouraged. For more details, see [docker-library/official-images#2076](https://github.com/docker-library/official-images/issues/2076).
|
|
|
+
|
|
|
+This image feeds your `requirements.txt` file automatically to `pip` in order to make building derivative images easier. For most use cases, creating a `Dockerfile` in the base of your project directory with the line `FROM python:onbuild` will be enough to create a stand-alone image for your project.
|
|
|
+
|
|
|
+While the `onbuild` variant is really useful for "getting off the ground running" (zero to Dockerized in a short period of time), it's not recommended for long-term usage within a project due to the lack of control over *when* the `ONBUILD` triggers fire (see also [`docker/docker#5714`](https://github.com/docker/docker/issues/5714), [`docker/docker#8240`](https://github.com/docker/docker/issues/8240), [`docker/docker#11917`](https://github.com/docker/docker/issues/11917)).
|
|
|
+
|
|
|
+Once you've got a handle on how your project functions within Docker, you'll probably want to adjust your `Dockerfile` to inherit from a non-`onbuild` variant and copy the commands from the `onbuild` variant `Dockerfile` (moving the `ONBUILD` lines to the end and removing the `ONBUILD` keywords) into your own file so that you have tighter control over them and more transparency for yourself and others looking at your `Dockerfile` as to what it does. This also makes it easier to add additional requirements as time goes on (such as installing more packages before performing the previously-`ONBUILD` steps).
|
|
|
+
|
|
|
# License
|
|
|
|
|
|
View license information for [Python 2](https://docs.python.org/2/license.html) and [Python 3](https://docs.python.org/3/license.html).
|