From 53155af28404f585470174b8496b2c6d6efd5aed Mon Sep 17 00:00:00 2001 From: Saverio Proto Date: Fri, 18 Nov 2022 17:21:04 +0100 Subject: [PATCH 1/2] Clarification on containers immutability --- content/en/docs/concepts/containers/_index.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/content/en/docs/concepts/containers/_index.md b/content/en/docs/concepts/containers/_index.md index 8c681ae454..233e33bcbe 100644 --- a/content/en/docs/concepts/containers/_index.md +++ b/content/en/docs/concepts/containers/_index.md @@ -31,10 +31,11 @@ software package, containing everything needed to run an application: the code and any runtime it requires, application and system libraries, and default values for any essential settings. -By design, a container is immutable: you cannot change the code of a -container that is already running. If you have a containerized application -and want to make changes, you need to build a new image that includes -the change, then recreate the container to start from the updated image. +Containers are designed to be stateless and immutable: you should not change +the code of a container that is already running. If you have a containerized +application and want to make changes, the correct process is to build a new +image that includes the change, then recreate the container to start from the +updated image. ## Container runtimes From dba449c2ee0ba14fe0620782cc54ed051c0f12d7 Mon Sep 17 00:00:00 2001 From: Saverio Proto Date: Mon, 21 Nov 2022 09:05:23 +0100 Subject: [PATCH 2/2] Update content/en/docs/concepts/containers/_index.md Co-authored-by: Tim Bannister --- content/en/docs/concepts/containers/_index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/content/en/docs/concepts/containers/_index.md b/content/en/docs/concepts/containers/_index.md index 233e33bcbe..7a1c1c9eec 100644 --- a/content/en/docs/concepts/containers/_index.md +++ b/content/en/docs/concepts/containers/_index.md @@ -31,7 +31,9 @@ software package, containing everything needed to run an application: the code and any runtime it requires, application and system libraries, and default values for any essential settings. -Containers are designed to be stateless and immutable: you should not change +Containers are intended to be stateless and +[immutable](https://glossary.cncf.io/immutable-infrastructure/): +you should not change the code of a container that is already running. If you have a containerized application and want to make changes, the correct process is to build a new image that includes the change, then recreate the container to start from the