Skip to content

Commit 8a7afb8

Browse files
authored
Merge pull request #42569 from matthyx/fixblog
correct sidecar section of 1.28 release blog
2 parents 7716c54 + 37d1076 commit 8a7afb8

File tree

1 file changed

+15
-13
lines changed

1 file changed

+15
-13
lines changed

content/en/blog/_posts/2023-08-15-kubernetes-1.28-blog.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -54,9 +54,9 @@ fine and is still completely supported.
5454

5555
## Generally available: recovery from non-graceful node shutdown
5656

57-
If a node shuts down down unexpectedly or ends up in a non-recoverable state (perhaps due to hardware failure or unresponsive OS), Kubernetes allows you to clean up afterwards and allow stateful workloads to restart on a different node. For Kubernetes v1.28, that's now a stable feature.
57+
If a node shuts down unexpectedly or ends up in a non-recoverable state (perhaps due to hardware failure or unresponsive OS), Kubernetes allows you to clean up afterward and allow stateful workloads to restart on a different node. For Kubernetes v1.28, that's now a stable feature.
5858

59-
This allows stateful workloads to failover to a different node successfully after the original node is shut down or in a non-recoverable state, such as the hardware failure or broken OS.
59+
This allows stateful workloads to fail over to a different node successfully after the original node is shut down or in a non-recoverable state, such as the hardware failure or broken OS.
6060

6161
Versions of Kubernetes earlier than v1.20 lacked handling for node shutdown on Linux, the kubelet integrates with systemd
6262
and implements graceful node shutdown (beta, and enabled by default). However, even an intentional
@@ -154,22 +154,24 @@ CDI provides a standardized way of injecting complex devices into a container (i
154154
## API awareness of sidecar containers (alpha) {#sidecar-init-containers}
155155

156156
Kubernetes 1.28 introduces an alpha `restartPolicy` field for [init containers](https://github.com/kubernetes/website/blob/main/content/en/docs/concepts/workloads/pods/init-containers.md),
157-
and uses that to indicate when an init container is also a _sidecar container_. The will start init containers with `restartPolicy: Always` in the order they are defined, along with other init containers. Instead of waiting for that sidecar container to complete before starting the main container(s) for the Pod, the kubelet only waits for
158-
the sidecar init container to have started.
159-
160-
The condition for startup completion will be that the startup probe succeeded (or if no startup probe is defined) and postStart handler is completed. This condition is represented with the field Started of ContainerStatus type. See the section "Pod startup completed condition" for considerations on picking this signal.
157+
and uses that to indicate when an init container is also a _sidecar container_.
158+
The kubelet will start init containers with `restartPolicy: Always` in the order
159+
they are defined, along with other init containers.
160+
Instead of waiting for that sidecar container to complete before starting the main
161+
container(s) for the Pod, the kubelet only waits for the sidecar init container to have started.
162+
163+
The kubelet will consider the startup for the sidecar container as being completed
164+
if the startup probe succeeds and the postStart handler is completed.
165+
This condition is represented with the field Started of ContainerStatus type.
166+
If you do not define a startup probe, the kubelet will consider the container
167+
startup to be completed immediately after the postStart handler completion.
161168

162169
For init containers, you can either omit the `restartPolicy` field, or set it to `Always`. Omitting the field
163170
means that you want a true init container that runs to completion before application startup.
164171

165172
Sidecar containers do not block Pod completion: if all regular containers are complete, sidecar
166173
containers in that Pod will be terminated.
167174

168-
For sidecar containers, the restart behavior is more complex than for init containers. In a Pod with
169-
`restartPolicy` set to `Never`, a sidecar container that fails during Pod startup will **not** be restarted
170-
and the whole Pod is treated as having failed. If the Pod's `restartPolicy` is `Always` or `OnFailure`,
171-
a sidecar that fails to start will be retried.
172-
173175
Once the sidecar container has started (process running, `postStart` was successful, and
174176
any configured startup probe is passing), and then there's a failure, that sidecar container will be
175177
restarted even when the Pod's overall `restartPolicy` is `Never` or `OnFailure`.
@@ -183,7 +185,7 @@ To learn more, read [API for sidecar containers](/docs/concepts/workloads/pods/i
183185
Kubernetes automatically sets a `storageClassName` for a PersistentVolumeClaim (PVC) if you don't provide
184186
a value. The control plane also sets a StorageClass for any existing PVC that doesn't have a `storageClassName`
185187
defined.
186-
Previous versions of Kubernetes also had this behavior; for Kubernetes v1.28 is is automatic and always
188+
Previous versions of Kubernetes also had this behavior; for Kubernetes v1.28 it is automatic and always
187189
active; the feature has graduated to stable (general availability).
188190

189191
To learn more, read about [StorageClass](/docs/concepts/storage/storage-classes/) in the Kubernetes
@@ -312,4 +314,4 @@ Have something you’d like to broadcast to the Kubernetes community? Share your
312314

313315
* Read more about what’s happening with Kubernetes on the [blog](https://kubernetes.io/blog/).
314316

315-
* Learn more about the [Kubernetes Release Team](https://github.com/kubernetes/sig-release/tree/master/release-team).
317+
* Learn more about the [Kubernetes Release Team](https://github.com/kubernetes/sig-release/tree/master/release-team).

0 commit comments

Comments
 (0)