kube-utils 0.1.2

Minimal client for kubernetes internal API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

//!Minimal data model to allow extraction of only useful information (for the purposes of this crate)

#[derive(Debug, serde_derive::Deserialize)]
///Common metadata for kubernetes objects
pub struct Metadata {
    ///Name of the pod within namespace
    pub name: String,
    #[serde(default)]
    ///Namespace of the object. Can be empty for default namespace
    pub namespace: String,
    #[serde(default)]
    ///Unique identifier of the object, unchanged once object is created.
    ///
    ///Normally it is UUID
    pub uid: String,
}

#[derive(Debug, serde_derive::Deserialize)]
///Container object definition
pub struct Container {
    ///Name of the container
    pub name: String,
    ///Image used by the container
    pub image: String,
}

#[derive(Debug, Default, serde_derive::Deserialize)]
///Pod spec
pub struct PodSpec {
    #[serde(default)]
    ///List of containers within the pod. Always at least 1 in normal kubernetes deployment
    pub containers: Vec<Container>,
}

#[derive(Debug, serde_derive::Deserialize)]
///Container object definition
pub struct ContainerStatus {
    ///Unique identifier of the container
    ///
    ///It normally starts with `containerd://` in kubernetes cluster
    pub container_id: String,
    ///Name of the container
    pub name: String,
    ///Image used by the container
    pub image: String,
    ///Indicates container status to be ready or not
    pub ready: bool,
    ///Indicates restart count
    pub restart_count: i32,
}

impl ContainerStatus {
    #[inline]
    ///Access unique id of container without type prefix
    pub fn container_id_suffix(&self) -> &str {
        let mut parts = self.container_id.split("://");
        let type_or_not = parts.next().unwrap();
        parts.next().unwrap_or(type_or_not)
    }
}

#[derive(Debug, Default, serde_derive::Deserialize)]
///Pod status
pub struct PodStatus {
    #[serde(default)]
    ///Statuses of the containers within pod
    pub container_statuses: Vec<ContainerStatus>,
}

#[derive(Debug, serde_derive::Deserialize)]
///Pod object definition
pub struct Pod {
    ///Pod metadata
    pub metadata: Metadata,
    #[serde(default)]
    ///Pod desired specification
    pub spec: PodSpec,
    #[serde(default)]
    ///Pod current status
    pub status: PodStatus,
}