|
1 |
| -# Change the base image used by Docker |
2 |
| - |
3 |
| -You may change the base image used in the `Dockerfile` that creates images by repo2docker. |
4 |
| -This is equivalent to changing the `FROM <base_image>` in the Dockerfile. |
5 |
| - |
6 |
| -To do so, use the `base_image` traitlet when invoking `repo2docker`. |
7 |
| -Note that this is not configurable by individual repositories, it is configured when you invoke the `repo2docker` command. |
8 |
| - |
9 |
| -```{note} |
10 |
| -By default repo2docker builds on top of the `buildpack-deps:bionic` base image, an Ubuntu-based image. |
11 |
| -``` |
12 |
| - |
13 |
| -## Requirements for your base image |
14 |
| - |
15 |
| -`repo2docker` will only work if a specific set of packages exists in the base image. |
16 |
| -Only images that match the following criteria are supported: |
17 |
| - |
18 |
| -- Ubuntu based distributions (minimum `18.04`) |
19 |
| -- Contains a set of base packages installed with [the `buildpack-deps` image family](https://hub.docker.com/_/buildpack-deps). |
20 |
| - |
21 |
| -Other images *may* work, but are not officially supported. |
| 1 | +# Change the base image used by Docker |
| 2 | + |
| 3 | +You may change the base image used in the `Dockerfile` that creates images by repo2docker. |
| 4 | +This is equivalent to changing the `FROM <base_image>` in the Dockerfile. |
| 5 | + |
| 6 | +To do so, use the `base_image` traitlet when invoking `repo2docker`. |
| 7 | +Note that this is not configurable by individual repositories, it is configured when you invoke the `repo2docker` command. |
| 8 | + |
| 9 | +```{note} |
| 10 | +By default repo2docker builds on top of the `buildpack-deps:bionic` base image, an Ubuntu-based image. |
| 11 | +``` |
| 12 | + |
| 13 | +## Requirements for your base image |
| 14 | + |
| 15 | +`repo2docker` will only work if a specific set of packages exists in the base image. |
| 16 | +Only images that match the following criteria are supported: |
| 17 | + |
| 18 | +- Ubuntu based distributions (minimum `18.04`) |
| 19 | +- Contains a set of base packages installed with [the `buildpack-deps` image family](https://hub.docker.com/_/buildpack-deps). |
| 20 | + |
| 21 | +Other images _may_ work, but are not officially supported. |
0 commit comments