update docs for ContainerStatus fields
This commit is contained in:
Sergey Kanzhelev
@@ -2443,24 +2443,57 @@ type ContainerState struct {
|
||||
Terminated *ContainerStateTerminated
|
||||
}
|
||||
|
||||
// ContainerStatus represents the status of a container
|
||||
// ContainerStatus contains details for the current status of this container.
|
||||
type ContainerStatus struct {
|
||||
// Each container in a pod must have a unique name.
|
||||
// Name is a DNS_LABEL representing the unique name of the container.
|
||||
// Each container in a pod must have a unique name across all container types.
|
||||
// Cannot be updated.
|
||||
Name string
|
||||
// State holds details about the container's current condition.
|
||||
// +optional
|
||||
State ContainerState
|
||||
// LastTerminationState holds the last termination state of the container to
|
||||
// help debug container crashes and restarts. This field is not
|
||||
// populated if the container is still running and RestartCount is 0.
|
||||
// +optional
|
||||
LastTerminationState ContainerState
|
||||
// Ready specifies whether the container has passed its readiness check.
|
||||
// Ready specifies whether the container is currently passing its readiness check.
|
||||
// The value will change as readiness probes keep executing. If no readiness
|
||||
// probes are specified, this field defaults to true once the container is
|
||||
// fully started (see Started field).
|
||||
//
|
||||
// The value is typically used to determine whether a container is ready to
|
||||
// accept traffic.
|
||||
Ready bool
|
||||
// Note that this is calculated from dead containers. But those containers are subject to
|
||||
// garbage collection. This value will get capped at 5 by GC.
|
||||
// RestartCount holds the number of times the container has been restarted.
|
||||
// Kubelet makes an effort to always increment the value, but there
|
||||
// are cases when the state may be lost due to node restarts and then the value
|
||||
// may be reset to 0. The value is never negative.
|
||||
RestartCount int32
|
||||
Image string
|
||||
ImageID string
|
||||
// Image is the name of container image that the container is running.
|
||||
// The container image may not match the image used in the PodSpec,
|
||||
// as it may have been resolved by the runtime.
|
||||
// More info: https://kubernetes.io/docs/concepts/containers/images.
|
||||
Image string
|
||||
// ImageID is the image ID of the container's image. The image ID may not
|
||||
// match the image ID of the image used in the PodSpec, as it may have been
|
||||
// resolved by the runtime.
|
||||
ImageID string
|
||||
// ContainerID is the ID of the container in the format '<type>://<container_id>'.
|
||||
// Where type is a container runtime identifier, returned from Version call of CRI API
|
||||
// (for example "containerd").
|
||||
// +optional
|
||||
ContainerID string
|
||||
Started *bool
|
||||
// Started indicates whether the container has finished its postStart lifecycle hook
|
||||
// and passed its startup probe.
|
||||
// Initialized as false, becomes true after startupProbe is considered
|
||||
// successful. Resets to false when the container is restarted, or if kubelet
|
||||
// loses state temporarily. In both cases, startup probes will run again.
|
||||
// Is always true when no startupProbe is defined and container is running and
|
||||
// has passed the postStart lifecycle hook. The null value must be treated the
|
||||
// same as false.
|
||||
// +optional
|
||||
Started *bool
|
||||
// ResourcesAllocated represents the compute resources allocated for this container by the
|
||||
// node. Kubelet sets this value to Container.Resources.Requests upon successful pod admission
|
||||
// and after successfully admitting desired pod resize.
|
||||
|
||||
18
pkg/generated/openapi/zz_generated.openapi.go
generated
18
pkg/generated/openapi/zz_generated.openapi.go
generated
@@ -17491,7 +17491,7 @@ func schema_k8sio_api_core_v1_ContainerStatus(ref common.ReferenceCallback) comm
|
||||
Properties: map[string]spec.Schema{
|
||||
"name": {
|
||||
SchemaProps: spec.SchemaProps{
|
||||
Description: "This must be a DNS_LABEL. Each container in a pod must have a unique name. Cannot be updated.",
|
||||
Description: "Name is a DNS_LABEL representing the unique name of the container. Each container in a pod must have a unique name across all container types. Cannot be updated.",
|
||||
Default: "",
|
||||
Type: []string{"string"},
|
||||
Format: "",
|
||||
@@ -17499,21 +17499,21 @@ func schema_k8sio_api_core_v1_ContainerStatus(ref common.ReferenceCallback) comm
|
||||
},
|
||||
"state": {
|
||||
SchemaProps: spec.SchemaProps{
|
||||
Description: "Details about the container's current condition.",
|
||||
Description: "State holds details about the container's current condition.",
|
||||
Default: map[string]interface{}{},
|
||||
Ref: ref("k8s.io/api/core/v1.ContainerState"),
|
||||
},
|
||||
},
|
||||
"lastState": {
|
||||
SchemaProps: spec.SchemaProps{
|
||||
Description: "Details about the container's last termination condition.",
|
||||
Description: "LastTerminationState holds the last termination state of the container to help debug container crashes and restarts. This field is not populated if the container is still running and RestartCount is 0.",
|
||||
Default: map[string]interface{}{},
|
||||
Ref: ref("k8s.io/api/core/v1.ContainerState"),
|
||||
},
|
||||
},
|
||||
"ready": {
|
||||
SchemaProps: spec.SchemaProps{
|
||||
Description: "Specifies whether the container has passed its readiness probe.",
|
||||
Description: "Ready specifies whether the container is currently passing its readiness check. The value will change as readiness probes keep executing. If no readiness probes are specified, this field defaults to true once the container is fully started (see Started field).\n\nThe value is typically used to determine whether a container is ready to accept traffic.",
|
||||
Default: false,
|
||||
Type: []string{"boolean"},
|
||||
Format: "",
|
||||
@@ -17521,7 +17521,7 @@ func schema_k8sio_api_core_v1_ContainerStatus(ref common.ReferenceCallback) comm
|
||||
},
|
||||
"restartCount": {
|
||||
SchemaProps: spec.SchemaProps{
|
||||
Description: "The number of times the container has been restarted.",
|
||||
Description: "RestartCount holds the number of times the container has been restarted. Kubelet makes an effort to always increment the value, but there are cases when the state may be lost due to node restarts and then the value may be reset to 0. The value is never negative.",
|
||||
Default: 0,
|
||||
Type: []string{"integer"},
|
||||
Format: "int32",
|
||||
@@ -17529,7 +17529,7 @@ func schema_k8sio_api_core_v1_ContainerStatus(ref common.ReferenceCallback) comm
|
||||
},
|
||||
"image": {
|
||||
SchemaProps: spec.SchemaProps{
|
||||
Description: "The image the container is running. More info: https://kubernetes.io/docs/concepts/containers/images.",
|
||||
Description: "Image is the name of container image that the container is running. The container image may not match the image used in the PodSpec, as it may have been resolved by the runtime. More info: https://kubernetes.io/docs/concepts/containers/images.",
|
||||
Default: "",
|
||||
Type: []string{"string"},
|
||||
Format: "",
|
||||
@@ -17537,7 +17537,7 @@ func schema_k8sio_api_core_v1_ContainerStatus(ref common.ReferenceCallback) comm
|
||||
},
|
||||
"imageID": {
|
||||
SchemaProps: spec.SchemaProps{
|
||||
Description: "ImageID of the container's image.",
|
||||
Description: "ImageID is the image ID of the container's image. The image ID may not match the image ID of the image used in the PodSpec, as it may have been resolved by the runtime.",
|
||||
Default: "",
|
||||
Type: []string{"string"},
|
||||
Format: "",
|
||||
@@ -17545,14 +17545,14 @@ func schema_k8sio_api_core_v1_ContainerStatus(ref common.ReferenceCallback) comm
|
||||
},
|
||||
"containerID": {
|
||||
SchemaProps: spec.SchemaProps{
|
||||
Description: "Container's ID in the format '<type>://<container_id>'.",
|
||||
Description: "ContainerID is the ID of the container in the format '<type>://<container_id>'. Where type is a container runtime identifier, returned from Version call of CRI API (for example \"containerd\").",
|
||||
Type: []string{"string"},
|
||||
Format: "",
|
||||
},
|
||||
},
|
||||
"started": {
|
||||
SchemaProps: spec.SchemaProps{
|
||||
Description: "Specifies whether the container has passed its startup probe. Initialized as false, becomes true after startupProbe is considered successful. Resets to false when the container is restarted, or if kubelet loses state temporarily. Is always true when no startupProbe is defined.",
|
||||
Description: "Started indicates whether the container has finished its postStart lifecycle hook and passed its startup probe. Initialized as false, becomes true after startupProbe is considered successful. Resets to false when the container is restarted, or if kubelet loses state temporarily. In both cases, startup probes will run again. Is always true when no startupProbe is defined and container is running and has passed the postStart lifecycle hook. The null value must be treated the same as false.",
|
||||
Type: []string{"boolean"},
|
||||
Format: "",
|
||||
},
|
||||
|
||||
Reference in New Issue
Block a user