Struct MachineDeploymentTemplateSpec

pub struct MachineDeploymentTemplateSpec {
    pub bootstrap: MachineDeploymentTemplateSpecBootstrap,
    pub cluster_name: String,
    pub failure_domain: Option<String>,
    pub infrastructure_ref: ObjectReference,
    pub node_deletion_timeout: Option<String>,
    pub node_drain_timeout: Option<String>,
    pub node_volume_detach_timeout: Option<String>,
    pub provider_id: Option<String>,
    pub readiness_gates: Option<Vec<MachineDeploymentTemplateSpecReadinessGates>>,
    pub version: Option<String>,
}

spec is the specification of the desired behavior of the machine. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

Fields

bootstrap: MachineDeploymentTemplateSpecBootstrap

bootstrap is a reference to a local struct which encapsulates fields to configure the Machine’s bootstrapping mechanism.

cluster_name: String

clusterName is the name of the Cluster this object belongs to.

failure_domain: Option<String>

failureDomain is the failure domain the machine will be created in. Must match a key in the FailureDomains map stored on the cluster object.

infrastructure_ref: ObjectReference

infrastructureRef is a required reference to a custom resource offered by an infrastructure provider.

node_deletion_timeout: Option<String>

nodeDeletionTimeout defines how long the controller will attempt to delete the Node that the Machine hosts after the Machine is marked for deletion. A duration of 0 will retry deletion indefinitely. Defaults to 10 seconds.

node_drain_timeout: Option<String>

nodeDrainTimeout is the total amount of time that the controller will spend on draining a node. The default value is 0, meaning that the node can be drained without any time limitations. NOTE: NodeDrainTimeout is different from kubectl drain --timeout

node_volume_detach_timeout: Option<String>

nodeVolumeDetachTimeout is the total amount of time that the controller will spend on waiting for all volumes to be detached. The default value is 0, meaning that the volumes can be detached without any time limitations.

provider_id: Option<String>

providerID is the identification ID of the machine provided by the provider. This field must match the provider ID as seen on the node object corresponding to this machine. This field is required by higher level consumers of cluster-api. Example use case is cluster autoscaler with cluster-api as provider. Clean-up logic in the autoscaler compares machines to nodes to find out machines at provider which could not get registered as Kubernetes nodes. With cluster-api as a generic out-of-tree provider for autoscaler, this field is required by autoscaler to be able to have a provider view of the list of machines. Another list of nodes is queried from the k8s apiserver and then a comparison is done to find out unregistered machines and are marked for delete. This field will be set by the actuators and consumed by higher level entities like autoscaler that will be interfacing with cluster-api as generic provider.

readiness_gates: Option<Vec<MachineDeploymentTemplateSpecReadinessGates>>

readinessGates specifies additional conditions to include when evaluating Machine Ready condition.

This field can be used e.g. by Cluster API control plane providers to extend the semantic of the Ready condition for the Machine they control, like the kubeadm control provider adding ReadinessGates for the APIServerPodHealthy, SchedulerPodHealthy conditions, etc.

Another example are external controllers, e.g. responsible to install special software/hardware on the Machines; they can include the status of those components with a new condition and add this condition to ReadinessGates.

NOTE: This field is considered only for computing v1beta2 conditions. NOTE: In case readinessGates conditions start with the APIServer, ControllerManager, Scheduler prefix, and all those readiness gates condition are reporting the same message, when computing the Machine’s Ready condition those readinessGates will be replaced by a single entry reporting “Control plane components: “ + message. This helps to improve readability of conditions bubbling up to the Machine’s owner resource / to the Cluster).

version: Option<String>

version defines the desired Kubernetes version. This field is meant to be optionally used by bootstrap providers.

Trait Implementations

impl Clone for MachineDeploymentTemplateSpec

fn clone(&self) -> MachineDeploymentTemplateSpec

Returns a duplicate of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MachineDeploymentTemplateSpec

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

Formats the value using the given formatter.

impl Default for MachineDeploymentTemplateSpec

fn default() -> MachineDeploymentTemplateSpec

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MachineDeploymentTemplateSpec

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for MachineDeploymentTemplateSpec

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl PartialEq for MachineDeploymentTemplateSpec

fn eq(&self, other: &MachineDeploymentTemplateSpec) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for MachineDeploymentTemplateSpec

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MachineDeploymentTemplateSpec