Kubernetes Engine V1 API - Class Google::Cloud::Container::V1::NodePool::UpgradeSettings (v0.8.0)

Reference documentation and code samples for the Kubernetes Engine V1 API class Google::Cloud::Container::V1::NodePool::UpgradeSettings.

These upgrade settings control the level of parallelism and the level of disruption caused by an upgrade.

maxUnavailable controls the number of nodes that can be simultaneously unavailable.

maxSurge controls the number of additional nodes that can be added to the node pool temporarily for the time of the upgrade to increase the number of available nodes.

(maxUnavailable + maxSurge) determines the level of parallelism (how many nodes are being upgraded at the same time).

Note: upgrades inevitably introduce some disruption since workloads need to be moved from old nodes to new, upgraded ones. Even if maxUnavailable=0, this holds true. (Disruption stays within the limits of PodDisruptionBudget, if it is configured.)

Consider a hypothetical node pool with 5 nodes having maxSurge=2, maxUnavailable=1. This means the upgrade process upgrades 3 nodes simultaneously. It creates 2 additional (upgraded) nodes, then it brings down 3 old (not yet upgraded) nodes at the same time. This ensures that there are always at least 4 nodes available.

Inherits

  • Object

Extended By

  • Google::Protobuf::MessageExts::ClassMethods

Includes

  • Google::Protobuf::MessageExts

Methods

#max_surge

def max_surge() -> ::Integer
Returns
  • (::Integer) — The maximum number of nodes that can be created beyond the current size of the node pool during the upgrade process.

#max_surge=

def max_surge=(value) -> ::Integer
Parameter
  • value (::Integer) — The maximum number of nodes that can be created beyond the current size of the node pool during the upgrade process.
Returns
  • (::Integer) — The maximum number of nodes that can be created beyond the current size of the node pool during the upgrade process.

#max_unavailable

def max_unavailable() -> ::Integer
Returns
  • (::Integer) — The maximum number of nodes that can be simultaneously unavailable during the upgrade process. A node is considered available if its status is Ready.

#max_unavailable=

def max_unavailable=(value) -> ::Integer
Parameter
  • value (::Integer) — The maximum number of nodes that can be simultaneously unavailable during the upgrade process. A node is considered available if its status is Ready.
Returns
  • (::Integer) — The maximum number of nodes that can be simultaneously unavailable during the upgrade process. A node is considered available if its status is Ready.