Kubebuilder로 만드는 Kubernetes Operator: 충돌, 불필요한 재시도, 무한 reconciliation을 피하는 모범 사례

Kubebuilder로 만든 Kubernetes Operator에서 여러 controller가 같은 Custom Resource를 갱신할 때 충돌을 어떻게 다루는지 설명한다.

generation은 spec 변경을, resourceVersion은 실제 객체의 현재 버전을 나타내며, 둘은 용도가 다르다.

동시 업데이트는 409 Conflict를 유발할 수 있으므로, spec과 status를 분리하고 status subresource를 사용하는 것이 중요하다.

reconciler는 충돌을 명시적으로 처리하고, 재조회 후 필요한 경우에만 제한적으로 retry해야 한다.

지속적인 update로 인한 reconciliation loop를 피해야 Operator의 안정성과 확장성이 좋아진다.