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

1// Generated from definition io.k8s.api.apps.v1.RollingUpdateStatefulSetStrategy
2
3/// RollingUpdateStatefulSetStrategy is used to communicate parameter for RollingUpdateStatefulSetStrategyType.
4#[derive(Clone, Debug, Default, PartialEq)]
5pub struct RollingUpdateStatefulSetStrategy {
6    /// The maximum number of pods that can be unavailable during the update. Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%). Absolute number is calculated from percentage by rounding up. This can not be 0. Defaults to 1. This field is alpha-level and is only honored by servers that enable the MaxUnavailableStatefulSet feature. The field applies to all pods in the range 0 to Replicas-1. That means if there is any unavailable pod in the range 0 to Replicas-1, it will be counted towards MaxUnavailable.
7    pub max_unavailable: Option<crate::apimachinery::pkg::util::intstr::IntOrString>,
8
9    /// Partition indicates the ordinal at which the StatefulSet should be partitioned for updates. During a rolling update, all pods from ordinal Replicas-1 to Partition are updated. All pods from ordinal Partition-1 to 0 remain untouched. This is helpful in being able to do a canary based deployment. The default value is 0.
10    pub partition: Option<i32>,
11}
12
13impl crate::DeepMerge for RollingUpdateStatefulSetStrategy {
14    fn merge_from(&mut self, other: Self) {
15        crate::DeepMerge::merge_from(&mut self.max_unavailable, other.max_unavailable);
16        crate::DeepMerge::merge_from(&mut self.partition, other.partition);
17    }
18}
19
20impl<'de> crate::serde::Deserialize<'de> for RollingUpdateStatefulSetStrategy {
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_unavailable,
25            Key_partition,
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 core::fmt::Formatter<'_>) -> core::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                            "maxUnavailable" => Field::Key_max_unavailable,
43                            "partition" => Field::Key_partition,
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 = RollingUpdateStatefulSetStrategy;
57
58            fn expecting(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
59                f.write_str("RollingUpdateStatefulSetStrategy")
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_unavailable: Option<crate::apimachinery::pkg::util::intstr::IntOrString> = None;
64                let mut value_partition: Option<i32> = None;
65
66                while let Some(key) = crate::serde::de::MapAccess::next_key::<Field>(&mut map)? {
67                    match key {
68                        Field::Key_max_unavailable => value_max_unavailable = crate::serde::de::MapAccess::next_value(&mut map)?,
69                        Field::Key_partition => value_partition = 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(RollingUpdateStatefulSetStrategy {
75                    max_unavailable: value_max_unavailable,
76                    partition: value_partition,
77                })
78            }
79        }
80
81        deserializer.deserialize_struct(
82            "RollingUpdateStatefulSetStrategy",
83            &[
84                "maxUnavailable",
85                "partition",
86            ],
87            Visitor,
88        )
89    }
90}
91
92impl crate::serde::Serialize for RollingUpdateStatefulSetStrategy {
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            "RollingUpdateStatefulSetStrategy",
96            self.max_unavailable.as_ref().map_or(0, |_| 1) +
97            self.partition.as_ref().map_or(0, |_| 1),
98        )?;
99        if let Some(value) = &self.max_unavailable {
100            crate::serde::ser::SerializeStruct::serialize_field(&mut state, "maxUnavailable", value)?;
101        }
102        if let Some(value) = &self.partition {
103            crate::serde::ser::SerializeStruct::serialize_field(&mut state, "partition", value)?;
104        }
105        crate::serde::ser::SerializeStruct::end(state)
106    }
107}
108
109#[cfg(feature = "schemars")]
110impl crate::schemars::JsonSchema for RollingUpdateStatefulSetStrategy {
111    fn schema_name() -> std::borrow::Cow<'static, str> {
112        "io.k8s.api.apps.v1.RollingUpdateStatefulSetStrategy".into()
113    }
114
115    fn json_schema(__gen: &mut crate::schemars::SchemaGenerator) -> crate::schemars::Schema {
116        crate::schemars::json_schema!({
117            "description": "RollingUpdateStatefulSetStrategy is used to communicate parameter for RollingUpdateStatefulSetStrategyType.",
118            "type": "object",
119            "properties": {
120                "maxUnavailable": ({
121                    let mut schema_obj = __gen.subschema_for::<crate::apimachinery::pkg::util::intstr::IntOrString>();
122                    schema_obj.ensure_object().insert("description".into(), "The maximum number of pods that can be unavailable during the update. Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%). Absolute number is calculated from percentage by rounding up. This can not be 0. Defaults to 1. This field is alpha-level and is only honored by servers that enable the MaxUnavailableStatefulSet feature. The field applies to all pods in the range 0 to Replicas-1. That means if there is any unavailable pod in the range 0 to Replicas-1, it will be counted towards MaxUnavailable.".into());
123                    schema_obj
124                }),
125                "partition": {
126                    "description": "Partition indicates the ordinal at which the StatefulSet should be partitioned for updates. During a rolling update, all pods from ordinal Replicas-1 to Partition are updated. All pods from ordinal Partition-1 to 0 remain untouched. This is helpful in being able to do a canary based deployment. The default value is 0.",
127                    "type": "integer",
128                    "format": "int32",
129                },
130            },
131        })
132    }
133}