What is a Kubernetes StatefulSet?

Kubernetes Statefulsets are used specifically to run stateful, replicated services, like Databases inside the Kubernetes cluster.

Configuration of a Stateful Set:

apiVersion: apps/v1

kind: StatefulSet

metadata:

  name: mysql

spec:

  replicas: 3

  template:

    spec:

      containers:

        - name: mysql

          image: mysql:8.0

          env:

            - name: MYSQL_DATABASE

              value: my-db

            - name: MYSQL_ROOT_PASSWORD

              valueFrom:

                secretKeyRef:

                  name: mysql-credentials

                  key: password

          ports:

            - name: mysql

              containerPort: 3306

The main part of the Statefulset that makes it able to run databases is that each replica pod gets assigned a unique ID. This ID sticks to the pod even when it's rescheduled to another worker node. Through this unique ID, the pod retains the connection to the volume that holds the state of the database. However, because when rescheduling the pod, the volume gets detached and then reattached again, the storage volumes must be on a remote persistent disk, which means the storage needs to be hosted outside of the cluster itself.

So overall, each replica pod in a stateful set has its state and data. So when it gets restarted, it needs to regain that state. This means we can't use local storage for stateful sets since local storage is bound to a node, so when the pod is rescheduled to another node, its previous state won't be available for it. Instead, it should use remote storage that isn't bound to any specific node. ✅

---

Get started in Kubernetes with this 1 hour crash course: