Operator에서 idempotency(멱등성)를 보장하는 방법

“Operator는 Kubernetes의 Reconciliation Loop 기반으로 동작하기 때문에, 같은 이벤트가 반복적으로 들어오더라도 결과가 동일해야 하는 멱등성(idempotency) 이 매우 중요합니다.

이를 보장하기 위해 저는 다음과 같은 전략을 사용합니다:

1. 현재 상태와 Desired 상태를 비교한 후 필요한 작업만 수행합니다. 예를 들어, 리소스를 항상 다시 생성하는 것이 아니라, 이미 존재하고 원하는 상태와 같다면 아무 작업도 하지 않습니다.
2. Status 필드를 적극 활용합니다. 작업이 완료된 경우 해당 상태를 기록하고, 이후 동일한 작업이 재요청되더라도 다시 실행하지 않도록 합니다.
3. 생성 시에는 항상 CreateOrUpdate 패턴을 사용하고, 삭제나 업데이트 시에도 리소스가 실제 존재하고 변경 사항이 있는 경우에만 처리합니다.
4. client-go의 patch 기능을 활용해 최소 변경만 적용함으로써 중복 작업을 방지하고, 충돌도 줄입니다.

또한, 멱등성은 테스트 자동화를 통해 검증이 중요하다고 생각해서, 같은 이벤트가 여러 번 들어왔을 때 상태가 변하지 않는 것을 테스트케이스로 확인합니다.”

 

핵심 키워드 정리

• Reconciliation Loop
• 현재 상태 vs Desired 상태 비교
• Status 필드
• CreateOrUpdate, Patch 사용
• 중복 작업 방지
• 테스트로 idempotency 보장