Commit Graph

506 Commits (release-1.32)

Author SHA1 Message Date
Tim Bannister 8633dda5d7 Improve explanation of Pod lifetime
- Explain that Pods do restart containers, but that's the only kind of
  self-healing inherent in Pods.
- Reword the page introduction for clarity
2024-06-19 18:27:33 +01:00
Tim Bannister 32be09bea1 Revise caption for multi-container example
What's being illustrated here is a volume that has the same lifecycle as
a Pod, so:
- don't use a PersistentVolume as the example
- highlight that the file puller is a sidecar

and give this aspect of the page its own heading.
2024-06-19 18:27:33 +01:00
Charles Uneze 2925e8b50e Update pod-lifecycle.md
Co-authored-by: Tim Bannister <tim@scalefactory.com>
2024-06-09 09:15:28 +00:00
Tim Bannister 347bd6a6ea Tweak heading level
Make “Container restart policy” fit within the topic of how Pods handle
container problems; it belongs there.
2024-05-24 21:55:04 +01:00
Lorenz Barnkow ce4f36a27a
fix superfluous white space 2024-05-08 16:23:30 +02:00
Kubernetes Prow Robot ea4444a849
Merge pull request #43214 from shannonxtreme/apparmor-seccomp
Add new page for kernel-level constraints
2024-04-30 04:56:15 -07:00
Ali Mehraji 2e84e962f2 Remove Redundant 'the' word in pod-lifecycle.md 2024-04-25 12:42:47 +03:30
Kubernetes Prow Robot c885404c17
Merge pull request #45845 from mrgiles/38843_pod_os_spec_description
Update Pod OS description spec.os.name
2024-04-22 14:00:29 -07:00
Ricardo Amaro e6599b218d
Adding documentation explaining what is a CrashLoopBackOff (#45928)
* Documentation on CrashLoopBackOff

* Update content/en/docs/concepts/workloads/pods/pod-lifecycle.md

Co-authored-by: Shannon Kularathna <ax3shannonkularathna@gmail.com>

* Update content/en/docs/concepts/workloads/pods/pod-lifecycle.md

Co-authored-by: Shannon Kularathna <ax3shannonkularathna@gmail.com>

* Update content/en/docs/concepts/workloads/pods/pod-lifecycle.md

Co-authored-by: Shannon Kularathna <ax3shannonkularathna@gmail.com>

* Update content/en/docs/concepts/workloads/pods/pod-lifecycle.md

Co-authored-by: Tim Bannister <tim@scalefactory.com>

* Update content/en/docs/concepts/workloads/pods/pod-lifecycle.md

Co-authored-by: Shannon Kularathna <ax3shannonkularathna@gmail.com>

* Address some feedback

* exponential backoff delay

* Address some feedback

* Start by explaing handle

* break lines

* Update content/en/docs/concepts/workloads/pods/pod-lifecycle.md

Co-authored-by: Gulcan Topcu <96833570+colossus06@users.noreply.github.com>

* Update content/en/docs/concepts/workloads/pods/pod-lifecycle.md

Co-authored-by: Gulcan Topcu <96833570+colossus06@users.noreply.github.com>

* Update content/en/docs/concepts/workloads/pods/pod-lifecycle.md

Co-authored-by: Tim Bannister <tim@scalefactory.com>

* address feedback

---------

Co-authored-by: Shannon Kularathna <ax3shannonkularathna@gmail.com>
Co-authored-by: Tim Bannister <tim@scalefactory.com>
Co-authored-by: Gulcan Topcu <96833570+colossus06@users.noreply.github.com>
2024-04-21 20:40:49 -07:00
steve-hardman aeb36c0c72
Fixed the featue state in pod-qos.md 2024-04-20 00:16:58 +01:00
Kubernetes Prow Robot f812c08cde
Merge pull request #45439 from pranav-pandey0804/envVar
Fix misleading advice about sharing of environment variables
2024-04-17 22:41:20 -07:00
Shannon Kularathna 610753c768 Add page for kernel-level security concepts 2024-04-17 17:00:13 -04:00
drewhagen 4c6ba12390 Merge main into dev-1.30 to keep in sync 2024-04-16 15:55:38 -05:00
Marcelo Giles eb19a43bed
Update Pod OS description spec.os.name
Update Pod OS spec.os.name
2024-04-12 09:09:04 -07:00
Marcelo Giles 5270c7a1c9
Mention container environment variables in concepts/pods
Mention container environment variables in pods
2024-04-05 12:03:45 -07:00
Daniel Chan cdf1ed1236 Merge remote-tracking branch 'upstream/main' into dev-1.30
Merge main into dev-1.30 to keep in sync
2024-04-02 10:05:03 -04:00
Kubernetes Prow Robot f089d6debc
Merge pull request #45496 from dipesh-rawat/api-ref-link-shortcode
Add mechanism to retrieve API reference page link based on metadata
2024-03-31 19:25:34 -07:00
petroselo 1808b6277e
Update sidecar-containers.md
Fix a spelling mistake: effecting -> affecting
2024-03-26 12:17:50 +00:00
Kubernetes Prow Robot c7cd6c5644
Merge pull request #45178 from kinvolk/rata/userns-1.30
User namespaces doc changes for 1.30
2024-03-21 01:46:52 -07:00
Rodrigo Campos 89e0ec8a77 content: Add OCI runtime requirements for userns
Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2024-03-19 14:59:40 +01:00
Rodrigo Campos 2c3ef64fee content: Document custom ranges for userns
Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2024-03-19 14:59:39 +01:00
Rodrigo Campos 271bb1a8fb content: Mark userns as beta in 1.30
Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2024-03-19 14:59:39 +01:00
Dipesh Rawat c889d9b251
Add metadata to use mechanism for API reference links 2024-03-14 14:50:24 +00:00
PRANAV PANDEY 98e5b0864a
Update content/en/docs/concepts/workloads/pods/sidecar-containers.md
Co-authored-by: Tim Bannister <tim@scalefactory.com>
2024-03-07 10:42:00 +05:30
pranav-pandey0804 d986834008 removed misleading reference about sharing of env variables 2024-03-05 21:49:31 +05:30
Dan Winship 2a93b5e0eb KEP-2681 PodHostIPs to stable 2024-02-22 16:30:46 -05:00
Oluebube Princes Egbuna e1465e035a Merge remote-tracking branch 'upstream/main' into dev-1.30 2024-02-20 11:46:04 +01:00
Tim Bannister e4731338d3 Switch some feature-state shortcodes to be data driven
When the feature gates graduate (or get deprecated), the associated
shortcode will update automatically.

Co-authored-by: Dipesh Rawat <rawat.dipesh@gmail.com>
2024-02-16 12:49:31 +00:00
Kubernetes Prow Robot 90534c5f38
Merge pull request #44953 from chtitux/fix-typo-pod-lifecycle
Add missing space in Pod Lifecycle concept page
2024-02-13 22:39:53 -08:00
Théophile Helleboid 769ea8afad Add missing space in Pod Lifecycle concept page 2024-01-30 17:34:36 +00:00
Tim Bannister d9723d7e04
Fix spelling
Co-authored-by: Ritika <52399571+Ritikaa96@users.noreply.github.com>
2024-01-23 09:33:51 +00:00
Tim Bannister 2b4b4b4e66 Improve docs for Pods
- Add glossary entry for sidecar container
- Revise glossary entry for init container to match
- Revise the Pod concept overview
- Reorder pages in that section
2024-01-19 01:06:53 +00:00
Tim Bannister 5bbb5ace30 Update docs around sidecar containers 2024-01-18 23:57:04 +00:00
lakshmi e11ca2588c Revise details for sidecar containers 2023-12-20 13:35:29 +05:30
Tim Bannister e57cf329a6 Merge 'dev-1.29' with main 2023-12-11 17:11:37 +00:00
lakshmi b23c499c23 Revise details for Resource sharing within containers 2023-12-11 17:33:21 +05:30
lakshmi bc7c1dbd96 added a new concept page Sidecar containers and revise details details of init containers and pod lifecycle. 2023-12-01 16:34:15 +05:30
Sascha Grunert 4e156c738d
Add documentation about user namespaces and PSS
Adding required documentation for
[KEP-127](https://github.com/kubernetes/enhancements/issues/127).

Signed-off-by: Sascha Grunert <sgrunert@redhat.com>
Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
Co-authored-by: Tim Bannister <tim@scalefactory.com>
Signed-off-by: Sascha Grunert <sgrunert@redhat.com>
2023-11-28 11:41:13 +01:00
Kubernetes Prow Robot 4a17ee3c73
Merge pull request #43533 from charles-chenzz/dev-1.29
update docs to promote PodReadyToStartContainersCondition into beta
2023-11-27 16:06:57 +01:00
charles-chenzz a8d08be631 third round of comment address 2023-11-21 07:54:04 +08:00
charles-chenzz e109ce70ba first round of comment address 2023-11-16 21:17:48 +08:00
charles-chenzz 50ea97524e update pod-lifecycle.md to reflect the state of podreadytostartcontainer 2023-11-16 20:03:14 +08:00
Matthias Bertschy 8f7cfdbf9c
modifying docs for SidecarContainers beta graduation (#43471)
Signed-off-by: Matthias Bertschy <matthias.bertschy@gmail.com>
2023-11-15 08:21:56 +08:00
Jorin Vermeulen 0676a58a46
Fix: broken link in init-containers.md (#43035) 2023-09-15 09:20:33 +08:00
Mengjiao Liu e8b136c3b3 Use code_sample shortcode instead of code shortcode 2023-09-05 17:10:14 +08:00
windsonsea 6d2afd4b44 remove an extra asterisk in init-containers 2023-08-16 17:10:03 +08:00
Kubernetes Prow Robot eb9db45aa3
Merge pull request #41987 from sftim/20230712_revise_home_page
Revise docs home page
2023-08-15 21:22:27 -07:00
Kubernetes Prow Robot acc735f769
Merge pull request #39637 from Dentrax/container-kill-order
Add detail about execution sequence for container kill order during Pod Termination
2023-08-15 21:06:28 -07:00
Rishit Dagli c8634cd940
Merged main dev-1.28 2023-08-14 09:01:47 -04:00
pcsegal c6ef33f06c
Update pod-qos.md to fix typo 2023-08-12 17:10:05 -03:00
Furkan 53b345db18 Fix reviews
Signed-off-by: Furkan <furkan.turkal@trendyol.com>
2023-08-12 15:07:44 +03:00
Furkan 1c7cb802a1 Add detail about execution sequence for container termination
Signed-off-by: Furkan <furkan.turkal@trendyol.com>
2023-08-11 14:07:04 +03:00
Kubernetes Prow Robot 6cd9b4e9cb
Merge pull request #42471 from sftim/dev-1.28-update-merge-main
Update dev-1.28 from main
2023-08-09 08:25:51 -07:00
Kubernetes Prow Robot eb175c35ed
Merge pull request #42447 from matthyx/sidecar-nits
nit edits for Sidecar containers
2023-08-09 04:55:50 -07:00
Tim Bannister 9520b96a61 Revise docs home page
Reorder and replace cards to better (I hope!) serve our readers.
2023-08-09 11:49:12 +01:00
Tim Bannister 20b43d6095
Merge branch 'main' into 'dev-1.28' 2023-08-09 11:13:31 +01:00
Matthias Bertschy de8c969241 nit edits for Sidecar containers
Signed-off-by: Matthias Bertschy <matthias.bertschy@gmail.com>
2023-08-09 11:36:37 +02:00
Kubernetes Prow Robot b23511b9d0
Merge pull request #41908 from kinvolk/rata/userns-1.28
Doc update for userns in 1.28
2023-08-08 11:33:52 -07:00
Kubernetes Prow Robot 962bf89914
Merge pull request #41802 from matthyx/sidecar
Add initial (alpha) documentation about sidecar containers
2023-08-07 08:50:32 -07:00
Rodrigo Campos 6c2a9c574c content: Expand version requirements for userns explanation 2023-08-07 17:16:28 +02:00
Rodrigo Campos c34f1ebb8e content: Userns now supports stateful pods
Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2023-08-07 17:16:28 +02:00
Rodrigo Campos 922458da9a content: Make userns statement about dockerd timeless
Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2023-08-07 16:34:43 +02:00
Rodrigo Campos 5e70c9a88a content: Remove old note about userns
The note is no longer valid (the branch was already merged and the
merged was done correctly).

Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2023-08-07 16:34:43 +02:00
Rodrigo Campos 73d698edf1 content: Fix typos in versions requirements for userns
The variable expansion is wrong: it currently expands to 1.27.3 on the
rendered website, so it says it is supported in 1.27 and that it is not.

Let's just re-work this paragraph so it is cleaerer and the variable
expansion is what we want (1.27 and not 1.27.3)-

Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2023-08-07 16:34:43 +02:00
Shiming Zhang 595925cb7d Docs update for Alpha PodHostIPs 2023-08-03 17:36:40 +08:00
Matthias Bertschy fde22b5031 adding Sidecar Containers alpha feature
Signed-off-by: Matthias Bertschy <matthias.bertschy@gmail.com>
2023-08-01 17:13:12 +02:00
Mengjiao Liu 68ba9633a2 Switch English to use code not codenew shortcode 2023-08-01 16:57:17 +08:00
TariqueNasrullah d722028f4c linked Static Pod Task page with Static Pod Concept 2023-07-27 01:09:33 +06:00
Andrey Goran eb522c126f
Replace {{< codenew ... >}} with {{% codenew ... %}} in all English docs (#42180)
* Replaced {{< codenew ... >}} with {{% codenew ... %}} in all files

* Reverted changes in non-english localizations
2023-07-25 05:54:06 -07:00
Marcelo Giles dcd3337cbc
Rewrite note on container runtimes 2023-07-07 18:28:36 -07:00
Rodrigo Campos cc2ca7a644 content: Make userns statement about dockerd timeless
Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2023-07-07 15:23:13 +02:00
Rodrigo Campos aa5975d39d content: Remove old not about userns
The note is no longer valid (the branch was already merged and the
merged was done correctly).

Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2023-07-07 12:47:17 +02:00
Rodrigo Campos 0797a850da content: Fix typos in versions requirements for userns
The variable expansion is wrong: it currently expands to 1.27.3 on the
rendered website, so it says it is supported in 1.27 and that it is not.

Let's just re-work this paragraph so it is cleaerer and the variable
expansion is what we want (1.27 and not 1.27.3)-

Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2023-07-07 12:45:50 +02:00
Kubernetes Prow Robot b305fdaa5a
Merge pull request #41157 from able8/fix-a-shell-command-in-examples
Fix a shell command in examples of "Init Containers" page
2023-07-05 15:19:03 -07:00
Kubernetes Prow Robot 3342cbf645
Merge pull request #41297 from tengqm/clarify-prestop-hook
Clarify prestop hook invocation condition
2023-07-05 15:15:04 -07:00
yanggang 67ec5feea2
fix typo words in pod describe.
Signed-off-by: yanggang <gang.yang@daocloud.io>
2023-07-03 10:07:37 +08:00
Rishit Dagli e2dc67dbc1
Merge pull request #3 from Rishit-dagli/main
Merged main dev-1.28
2023-06-21 13:09:03 -04:00
Kevin Hannon 01c9decf7d
rename PodHasNetwork to PodReadyToStartContainers (#40945)
* rename PodHasNetwork to PodReadyToStartContainers

* add note for condition rename

* add feature gate removal

* Update content/en/docs/reference/command-line-tools-reference/feature-gates.md

Co-authored-by: Qiming Teng <tengqm@outlook.com>

* Update content/en/docs/reference/command-line-tools-reference/feature-gates-removed.md

Co-authored-by: Qiming Teng <tengqm@outlook.com>

* Update content/en/docs/reference/command-line-tools-reference/feature-gates-removed.md

Co-authored-by: Qiming Teng <tengqm@outlook.com>

---------

Co-authored-by: Qiming Teng <tengqm@outlook.com>
2023-06-16 16:44:19 -07:00
lakshmi a3fc330e0c incorporated the review comments. 2023-06-08 15:14:29 +05:30
lakshmi ff636abaa4 updated init-containers page 2023-06-07 11:49:01 +05:30
Michael 50bec1f123 replace currentVersion with currentPatchVersion in concepts 2023-06-02 18:56:23 +08:00
Qiming Teng 06852a5c95 Apply some tidy up to the page 2023-05-25 10:50:36 +08:00
Qiming Teng ef1b3bfd4e Clarify the condition when preStop hook is invoked 2023-05-24 12:07:55 +08:00
Sai Ramesh Vanka 0ef0dedf3a Add a caution regarding the `exec` probe mechanism
Reference Issue: https://github.com/kubernetes/website/issues/41084
1. Exec probe's implementation involves the Kubelet making a gRPC call to the
underlying CRI which inturn involves in the creation of multiple processes that
require a good amount of cpu usage whenever the probe is executed.
2. Whereas the other probes namely `http/gRPC/tcp` involves the Kubelet alone making
a call to the container.
3. There might be a significant amount of cpu overhead in the cases of
higher pod densities, lower periodic intervals when the exec probe is configured.
4. Hence, it would be a good idea to alert the user to opt for the other available probes
in case of the above mentioned scenarios.

Signed-off-by: Sai Ramesh Vanka <svanka@redhat.com>
2023-05-23 21:54:18 +05:30
able8 c6ff7aa739 fix a shell command in examples 2023-05-16 00:17:43 +08:00
Kubernetes Prow Robot eb7c049f04
Merge pull request #40376 from dtzar/patch-1
clarify Windows privileged containers feature enablement
2023-05-07 03:51:16 -07:00
David Tesar 8f3790c3a9
clarify Windows privileged containers feature enablement 2023-04-07 10:50:25 -07:00
Kubernetes Prow Robot 9fe8b9c942
Merge pull request #40513 from pacoxu/patch-16
add memory qos
2023-04-05 20:47:46 -07:00
Paco Xu e475112590 add memory qos 2023-04-06 11:42:37 +08:00
Mickey Boxell 31439e3d56 Merge branch 'upstream/main' into dev-1.27 2023-04-05 14:20:36 -05:00
Sergey Kanzhelev 81dfd0cd00
gRPC GA (#39919) 2023-04-04 05:57:54 -07:00
Kubernetes Prow Robot 9360bc5ab8
Merge pull request #40264 from kinvolk/rata/userns-1.25
content: Mention containerd 1.7 supports user namespaces
2023-04-03 22:59:51 -07:00
Filip Křepinský 24b259fa36 Promote PodDisruptionBudget UnhealthyPodEvictionPolicy to Beta 2023-04-03 11:28:38 +02:00
Kubernetes Prow Robot 2da2c6c277
Merge pull request #40407 from mickeyboxell/merged-main-dev-1.27
Merged main dev 1.27
2023-03-31 21:49:49 -07:00
Rodrigo Campos 2ffb037188
Document user namespace changes in v1.27 (KEP-127) (#39860)
* content: Update user namespaces version requirements

Also, with the new implementation, the fsGroup was dropped. So removed
the mention to those limitations.

Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>

* content: Add reference to the userns task in the concepts page

Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>

---------

Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2023-03-30 20:01:48 -07:00
Mickey Boxell a15fa4ae31 Merge remote-tracking branch 'upstream/main' into dev-1.27 2023-03-29 15:54:33 -05:00
Rodrigo Campos d2cd6ca266 content: Mention containerd 1.7 supports user namespaces
containerd 1.7 was just released with user namespaces support. Let's
mention which kubernetes versions should work with container 1.7.

While we are there, let's clarify the CRI-O version and not duplicate
the requirements in the concept and task pages and just add a link

Signed-off-by: Rodrigo Campos <rodrigoca@microsoft.com>
2023-03-27 16:20:08 +02:00
windsonsea e6ba669447 fix a 404 link in pod-qos.md 2023-03-23 23:45:20 +08:00
Kubernetes Prow Robot 0cbb4d0e7a
Merge pull request #39809 from mimowo/update-docs-about-handling-deleted-pods
Update docs for KEP3329: "Retriable and non-retriable Pod failures for jobs
2023-03-22 22:28:22 -07:00
Kubernetes Prow Robot b399d833f8
Merge pull request #39905 from saschagrunert/dev-1.27-downward-api-hugepages
[KEP-2053] Add docs for DownwardAPIHugepages graduation
2023-03-22 02:08:36 -07:00