k8s_openapi/v1_30/api/apps/v1/
rolling_update_daemon_set.rs

1// Generated from definition io.k8s.api.apps.v1.RollingUpdateDaemonSet
2
3/// Spec to control the desired behavior of daemon set rolling update.
4#[derive(Clone, Debug, Default, PartialEq)]
5pub struct RollingUpdateDaemonSet {
6    /// The maximum number of nodes with an existing available DaemonSet pod that can have an updated DaemonSet pod during during an update. Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%). This can not be 0 if MaxUnavailable is 0. Absolute number is calculated from percentage by rounding up to a minimum of 1. Default value is 0. Example: when this is set to 30%, at most 30% of the total number of nodes that should be running the daemon pod (i.e. status.desiredNumberScheduled) can have their a new pod created before the old pod is marked as deleted. The update starts by launching new pods on 30% of nodes. Once an updated pod is available (Ready for at least minReadySeconds) the old DaemonSet pod on that node is marked deleted. If the old pod becomes unavailable for any reason (Ready transitions to false, is evicted, or is drained) an updated pod is immediatedly created on that node without considering surge limits. Allowing surge implies the possibility that the resources consumed by the daemonset on any given node can double if the readiness check fails, and so resource intensive daemonsets should take into account that they may cause evictions during disruption.
7    pub max_surge: Option<crate::apimachinery::pkg::util::intstr::IntOrString>,
8
9    /// The maximum number of DaemonSet pods that can be unavailable during the update. Value can be an absolute number (ex: 5) or a percentage of total number of DaemonSet pods at the start of the update (ex: 10%). Absolute number is calculated from percentage by rounding up. This cannot be 0 if MaxSurge is 0 Default value is 1. Example: when this is set to 30%, at most 30% of the total number of nodes that should be running the daemon pod (i.e. status.desiredNumberScheduled) can have their pods stopped for an update at any given time. The update starts by stopping at most 30% of those DaemonSet pods and then brings up new DaemonSet pods in their place. Once the new pods are available, it then proceeds onto other DaemonSet pods, thus ensuring that at least 70% of original number of DaemonSet pods are available at all times during the update.
10    pub max_unavailable: Option<crate::apimachinery::pkg::util::intstr::IntOrString>,
11}
12
13impl crate::DeepMerge for RollingUpdateDaemonSet {
14    fn merge_from(&mut self, other: Self) {
15        crate::DeepMerge::merge_from(&mut self.max_surge, other.max_surge);
16        crate::DeepMerge::merge_from(&mut self.max_unavailable, other.max_unavailable);
17    }
18}
19
20impl<'de> crate::serde::Deserialize<'de> for RollingUpdateDaemonSet {
21    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where D: crate::serde::Deserializer<'de> {
22        #[allow(non_camel_case_types)]
23        enum Field {
24            Key_max_surge,
25            Key_max_unavailable,
26            Other,
27        }
28
29        impl<'de> crate::serde::Deserialize<'de> for Field {
30            fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where D: crate::serde::Deserializer<'de> {
31                struct Visitor;
32
33                impl crate::serde::de::Visitor<'_> for Visitor {
34                    type Value = Field;
35
36                    fn expecting(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
37                        f.write_str("field identifier")
38                    }
39
40                    fn visit_str<E>(self, v: &str) -> Result<Self::Value, E> where E: crate::serde::de::Error {
41                        Ok(match v {
42                            "maxSurge" => Field::Key_max_surge,
43                            "maxUnavailable" => Field::Key_max_unavailable,
44                            _ => Field::Other,
45                        })
46                    }
47                }
48
49                deserializer.deserialize_identifier(Visitor)
50            }
51        }
52
53        struct Visitor;
54
55        impl<'de> crate::serde::de::Visitor<'de> for Visitor {
56            type Value = RollingUpdateDaemonSet;
57
58            fn expecting(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
59                f.write_str("RollingUpdateDaemonSet")
60            }
61
62            fn visit_map<A>(self, mut map: A) -> Result<Self::Value, A::Error> where A: crate::serde::de::MapAccess<'de> {
63                let mut value_max_surge: Option<crate::apimachinery::pkg::util::intstr::IntOrString> = None;
64                let mut value_max_unavailable: Option<crate::apimachinery::pkg::util::intstr::IntOrString> = None;
65
66                while let Some(key) = crate::serde::de::MapAccess::next_key::<Field>(&mut map)? {
67                    match key {
68                        Field::Key_max_surge => value_max_surge = crate::serde::de::MapAccess::next_value(&mut map)?,
69                        Field::Key_max_unavailable => value_max_unavailable = crate::serde::de::MapAccess::next_value(&mut map)?,
70                        Field::Other => { let _: crate::serde::de::IgnoredAny = crate::serde::de::MapAccess::next_value(&mut map)?; },
71                    }
72                }
73
74                Ok(RollingUpdateDaemonSet {
75                    max_surge: value_max_surge,
76                    max_unavailable: value_max_unavailable,
77                })
78            }
79        }
80
81        deserializer.deserialize_struct(
82            "RollingUpdateDaemonSet",
83            &[
84                "maxSurge",
85                "maxUnavailable",
86            ],
87            Visitor,
88        )
89    }
90}
91
92impl crate::serde::Serialize for RollingUpdateDaemonSet {
93    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where S: crate::serde::Serializer {
94        let mut state = serializer.serialize_struct(
95            "RollingUpdateDaemonSet",
96            self.max_surge.as_ref().map_or(0, |_| 1) +
97            self.max_unavailable.as_ref().map_or(0, |_| 1),
98        )?;
99        if let Some(value) = &self.max_surge {
100            crate::serde::ser::SerializeStruct::serialize_field(&mut state, "maxSurge", value)?;
101        }
102        if let Some(value) = &self.max_unavailable {
103            crate::serde::ser::SerializeStruct::serialize_field(&mut state, "maxUnavailable", value)?;
104        }
105        crate::serde::ser::SerializeStruct::end(state)
106    }
107}
108
109#[cfg(feature = "schemars")]
110impl crate::schemars::JsonSchema for RollingUpdateDaemonSet {
111    fn schema_name() -> String {
112        "io.k8s.api.apps.v1.RollingUpdateDaemonSet".to_owned()
113    }
114
115    fn json_schema(__gen: &mut crate::schemars::gen::SchemaGenerator) -> crate::schemars::schema::Schema {
116        crate::schemars::schema::Schema::Object(crate::schemars::schema::SchemaObject {
117            metadata: Some(Box::new(crate::schemars::schema::Metadata {
118                description: Some("Spec to control the desired behavior of daemon set rolling update.".to_owned()),
119                ..Default::default()
120            })),
121            instance_type: Some(crate::schemars::schema::SingleOrVec::Single(Box::new(crate::schemars::schema::InstanceType::Object))),
122            object: Some(Box::new(crate::schemars::schema::ObjectValidation {
123                properties: [
124                    (
125                        "maxSurge".to_owned(),
126                        {
127                            let mut schema_obj = __gen.subschema_for::<crate::apimachinery::pkg::util::intstr::IntOrString>().into_object();
128                            schema_obj.metadata = Some(Box::new(crate::schemars::schema::Metadata {
129                                description: Some("The maximum number of nodes with an existing available DaemonSet pod that can have an updated DaemonSet pod during during an update. Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%). This can not be 0 if MaxUnavailable is 0. Absolute number is calculated from percentage by rounding up to a minimum of 1. Default value is 0. Example: when this is set to 30%, at most 30% of the total number of nodes that should be running the daemon pod (i.e. status.desiredNumberScheduled) can have their a new pod created before the old pod is marked as deleted. The update starts by launching new pods on 30% of nodes. Once an updated pod is available (Ready for at least minReadySeconds) the old DaemonSet pod on that node is marked deleted. If the old pod becomes unavailable for any reason (Ready transitions to false, is evicted, or is drained) an updated pod is immediatedly created on that node without considering surge limits. Allowing surge implies the possibility that the resources consumed by the daemonset on any given node can double if the readiness check fails, and so resource intensive daemonsets should take into account that they may cause evictions during disruption.".to_owned()),
130                                ..Default::default()
131                            }));
132                            crate::schemars::schema::Schema::Object(schema_obj)
133                        },
134                    ),
135                    (
136                        "maxUnavailable".to_owned(),
137                        {
138                            let mut schema_obj = __gen.subschema_for::<crate::apimachinery::pkg::util::intstr::IntOrString>().into_object();
139                            schema_obj.metadata = Some(Box::new(crate::schemars::schema::Metadata {
140                                description: Some("The maximum number of DaemonSet pods that can be unavailable during the update. Value can be an absolute number (ex: 5) or a percentage of total number of DaemonSet pods at the start of the update (ex: 10%). Absolute number is calculated from percentage by rounding up. This cannot be 0 if MaxSurge is 0 Default value is 1. Example: when this is set to 30%, at most 30% of the total number of nodes that should be running the daemon pod (i.e. status.desiredNumberScheduled) can have their pods stopped for an update at any given time. The update starts by stopping at most 30% of those DaemonSet pods and then brings up new DaemonSet pods in their place. Once the new pods are available, it then proceeds onto other DaemonSet pods, thus ensuring that at least 70% of original number of DaemonSet pods are available at all times during the update.".to_owned()),
141                                ..Default::default()
142                            }));
143                            crate::schemars::schema::Schema::Object(schema_obj)
144                        },
145                    ),
146                ].into(),
147                ..Default::default()
148            })),
149            ..Default::default()
150        })
151    }
152}