Skip to content

Commit 4a5ff3c

Browse files
authored
Add note on reproducibility
1 parent 4eaf096 commit 4a5ff3c

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

docs/source/howto/base_image.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,3 +19,15 @@ Only images that match the following criteria are supported:
1919
- Contains a set of base packages installed with [the `buildpack-deps` image family](https://hub.docker.com/_/buildpack-deps).
2020

2121
Other images _may_ work, but are not officially supported.
22+
23+
## This will affect reproducibility 🚨
24+
25+
Changing the base image may have an impact on the reproducibility of repositories that are built.
26+
There are **no guarantees that repositories will behave the same way as other repo2docker builds if you change the base image**.
27+
For example these are two scenarios that would make your repositories non-reproducible:
28+
29+
- **Your base image is different from `Ubuntu:bionic`.**
30+
If you change the base image in a way that is different from repo2docker's default (the Ubuntu `bionic` image), then repositories that **you** build with repo2docker may be significantly different from those that **other** instances of repo2docker build (e.g., those from [`mybinder.org`](https://mybinder.org)).
31+
- **Your base image changes over time.**
32+
If you choose a base image that changes its composition over time (e.g., an image provided by some other community), then it may cause repositories build with your base image to change in unpredictable ways.
33+
We recommend choosing a base image that you know to be stable and trustworthy.

0 commit comments

Comments
 (0)