Status Events and Conditions

To make it easier for users to understand and debug the etcd-operator, the actions of the operator and the state of the cluster are communicated to the user in the standard Kubernetes convention.

Use kubectl describe to view information about an object, including Events and Conditions associated with the resource.

The etcd-operator exposes the Events and Conditions for each EtcdCluster Custom Resource.


The following types of Events and their specific instances are common in the lifecycle of an EtcdCluster:

  • A new member is added
  • A member is removed
  • A member is upgraded
  • A dead member is replaced


The etcd cluster Condition and its statuses are defined as:

  • Available
    • True: Majority members up
    • False: Reason for not being available (majority down only)
  • Recovering
    • True: Reason for recovery (all members down, or majority down)
    • False: Reason for recovery failure (for example: no backup found)
    • Not present
  • Scaling
    • True: Scaling from current members size X to spec.size Y
    • False: Reason for failure (for example: no more nodes to place member due to anti-affinity)
    • Not present
  • Upgrading
    • True: Upgrading from version X to Y
    • False: Reason for failure
    • Not present