Updated container garbage collection with accurate information

[T-Lakshmi]

Fixes: kubernetes/kubernetes#127157

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign princesso for approval. For more information see the Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

• content/en/docs/OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[netlify]

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	e661ab0
🔍 Latest deploy log	https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/66ecf727b594800007af69ee
😎 Deploy Preview	https://deploy-preview-48001--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[T-Lakshmi]

/sig node
/kind documentation

[T-Lakshmi]

Preview page

Hi @dipesh-rawat, @Princesso,
Pinging for review, PTAL!

[bart0sh]

/cc @haircommander @esotsal

[haircommander]

in favour *

[haircommander]

will*

[haircommander]

thanks! content wise it looks good, I just have a couple of stylistic nits

[T-Lakshmi]

@haircommander,
Thanks for the review and suggestions.
I have updated the content with your suggestions, PTAL!

[esotsal]

Thanks
/lgtm

[T-Lakshmi]

Thnks for the review @haircommander, @esotsal

/assign @Princesso
Assigning to @Princesso for approval, PTAL!

[sftim]

This does need an update before we can merge it, to make sure the heading is right.

/lgtm cancel

[sftim]

These command line arguments are deprecated, and the format isn't right.
We also avoid statements about the future, although we do make reasonable exceptions to that general guidance.

Try this:

Suggested change

	### Container garbage collection {#container-image-garbage-collection} (deprecated)
	{{< caution >}}
	Container garbage collection is deprecated in favour of `--eviction-hard` or
	`--eviction-soft` and will be removed in a future version. For more details on
	eviction policy, see [node-pressure-eviction](/docs/concepts/scheduling-eviction/node-pressure-eviction/).
	{{< /caution >}}
	### Legacy garbage collection for containers (deprecated) {#container-image-garbage-collection}
	{{< feature-state for_k8s_version="v1.9" state="deprecated" >}}
	{{< note >}}
	Container garbage collection is deprecated, in favor of using the kubelet configuration file
	entries `evictionHard` and `evictionSoft` to manage overall Pod
	{{< glossary_tooltip text="eviction" term_id="eviction" >}}.
	{{< /note >}}

ℹ️ I am not sure about which version deprecated setting these command line arguments.

Am I right that eviction is always at the Pod level, whereas these deprecated settings apply at the container level?

[sftim]

Is this right?

Suggested change

	The kubelet garbage collects unused containers based on the following variables,
	which you can define:
	* `MinAge`: the minimum age at which the kubelet can garbage collect a
	container. Disable by setting to `0`.
	* `MaxPerPodContainer`: the maximum number of dead containers each Pod
	can have. Disable by setting to less than `0`.
	* `MinAge`: the minimum age at which the kubelet can garbage collect a container.
	Disable by setting a kubelet config flag `--minimum-container-ttl-duration` to `0`.
	* `MaxPerPodContainer`: the maximum number of dead containers each Pod can have.
	Disable by setting a kubelet config flag `--maximum-dead-containers-per-container`
	to less than `0`.
	* `MaxContainers`: the maximum number of dead containers the cluster can have.
	Disable by setting to less than `0`.
	Disable by setting a kubelet config flag `--maximum-dead-containers`
	to less than `0`.
	The kubelet garbage collects dead containers within existing Pods. This garbage collection is
	based on the values for several related command line arguments, that are all deprecated:
	`--minimum-container-ttl-duration`
	: the minimum age at which the kubelet can garbage collect a dead container. Disable by setting to 0. Setting a value for `--minimum-container-ttl-duration` is deprecated.
	`--maximum-dead-containers`
	: limits the total number of dead containers for this node. The default is unlimited. You can set this to an integer that is zero or higher in order to set legacy dead container limits, node-wide. Setting a value for `--maximum-dead-containers` is deprecated.
	`--maximum-dead-containers-per-container`: the maximum number of dead containers each Pod
	can have. The default value for this setting is 1; however, you can specify unlimited dead containers by setting this value to 0. Note that setting a value for `--maximum-dead-containers-per-container` is deprecated.