summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKubernetes Prow Robot <k8s-ci-robot@users.noreply.github.com>2021-09-09 10:56:11 -0700
committerGitHub <noreply@github.com>2021-09-09 10:56:11 -0700
commitc34d339d35833bea932d3f4af43dfbb2fdfd240c (patch)
tree11a616a8be7d1751d07bffc16b6f131455119977
parent4ae8b8636cd8df40fbae62bf6cc7d7f2e007fe5c (diff)
parent06fcf734d74705a8d725770a18fc5280e9e3c484 (diff)
Merge pull request #5998 from endocrimes/dani/take-a-pause
sig-node: add doc with basic info for pause image updates
-rw-r--r--contributors/devel/sig-node/updating-pause-images.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/contributors/devel/sig-node/updating-pause-images.md b/contributors/devel/sig-node/updating-pause-images.md
new file mode 100644
index 00000000..f031c9b5
--- /dev/null
+++ b/contributors/devel/sig-node/updating-pause-images.md
@@ -0,0 +1,49 @@
+# Updating Pause Image References
+
+The Kubernetes `pause` image is used to run a 'parent' container for all
+the other containers inside your pod. This image is referenced across many
+projects within the Kubernetes ecosystem, and it's important that we keep them
+all up to date to ensure stable platform support and to avoid confusing things
+for end users.
+
+However, we do need to update those images in a somewhat staggered way across
+the ecosystem, rather than doing it all at once.
+
+### Useful Links
+
+- [Pause Image Changelog][pause-cl]
+- [What is the role of 'pause' container?](https://groups.google.com/g/kubernetes-users/c/jVjv0QK4b_o)
+- [The Almighty Pause Container](https://www.ianlewis.org/en/almighty-pause-container)
+
+### Coordinating updates
+
+When a new `pause` image is released, we generally try to update it in the
+following order, this is to try and ensure that repositories stay in sync, while
+keeping changes well tested and developers unblocked.
+
+#### First level (core projects)
+
+- [kubernetes/kubernetes][k-k-repo]
+- [kubernetes/test-infra][k-infra-repo]
+
+#### Second level (kubernetes-sigs)
+
+- [kubernetes-sigs/image-builder][ks-image-builder]
+- [kubernetes-sigs/kind][ks-kind]
+
+#### Third level (runtimes)
+
+- [cri-o/cri-o][crio]
+- [containerd/containerd][containerd]
+
+#### Fourth level (other projects)
+
+- [kubernetes/minikube][k-minikube]
+
+[k-k-repo]: https://github.com/kubernetes/kubernetes
+[k-infra-repo]: https://github.com/kubernetes/test-infra
+[ks-kind]: https://github.com/kubernetes-sigs/kind
+[crio]: https://github.com/cri-o/cri-o
+[containerd]: https://github.com/containerd/containerd
+[k-minikube]: https://github.com/kubernetes/minikube
+[pause-cl]: https://github.com/kubernetes/kubernetes/blob/master/build/pause/CHANGELOG.md