Enum kube::api::Patch

#[non_exhaustive]
pub enum Patch<T> where
    T: Serialize,  {
    Apply(T),
    Json(Patch),
    Merge(T),
    Strategic(T),
}

This is supported on crate feature client only.

Describes changes that should be applied to a resource

Takes arbitrary serializable data for all strategies except Json.

We recommend using (server-side) Apply patches on new kubernetes releases.

See kubernetes patch docs for the older patch types.

Note that patches have different effects on different fields depending on their merge strategies. These strategies are configurable when deriving your CustomResource.

Creating a patch via serde_json

use kube::api::Patch;
let patch = serde_json::json!({
    "apiVersion": "v1",
    "kind": "Pod",
    "metadata": {
        "name": "blog"
    },
    "spec": {
        "activeDeadlineSeconds": 5
    }
});
let patch = Patch::Apply(&patch);

Creating a patch from a type

use kube::api::Patch;
use k8s_openapi::api::rbac::v1::Role;
use k8s_openapi::apimachinery::pkg::apis::meta::v1::ObjectMeta;
let r = Role {
    metadata: ObjectMeta { name: Some("user".into()), ..ObjectMeta::default() },
    rules: Some(vec![])
};
let patch = Patch::Apply(&r);

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Apply(T)

Server side apply

Requires kubernetes >= 1.16

Tuple Fields of Apply

0: T

Json(Patch)

This is supported on crate feature jsonpatch only.

JSON patch

Using this variant will require you to explicitly provide a type for T at the moment.

Example

use kube::api::Patch;
let json_patch = json_patch::Patch(vec![]);
let patch = Patch::Json::<()>(json_patch);

Tuple Fields of Json

0: Patch

Merge(T)

JSON Merge patch

Tuple Fields of Merge

0: T

Strategic(T)

Strategic JSON Merge patch

Tuple Fields of Strategic

0: T

Trait Implementations

impl<T> Debug for Patch<T> where
    T: Debug + Serialize, 

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.