파이널라이저는 쿠버네티스가 오브젝트를 완전히 삭제하기 이전, 삭제 표시를 위해 특정 조건이 충족될 때까지 대기하도록 알려주기 위한 네임스페이스에 속한 키(namespaced key)이다. 파이널라이저는 삭제 완료된 오브젝트가 소유한 리소스를 정리하기 위해 컨트롤러에게 알린다.
파이널라이저를 가진 특정한 오브젝트를 쿠버네티스가 삭제하도록 지시할 때,
쿠버네티스 API는 .metadata.deletionTimestamp을 덧붙여 삭제하도록 오브젝트에 표시하며,
202 상태코드(HTTP "Accepted")를 리턴한다. 대상 오브젝트가 Terminating 상태를 유지하는 동안 컨트롤 플레인
또는 다른 컴포넌트는 하나의 파이널라이저에서 정의한 작업을 수행한다.
정의된 작업이 완료 후에, 그 컨트롤러는 대상 오브젝트로부터 연관된 파이널라이저를 삭제한다.
metadata.finalizers 필드가 비어 있을 때, 쿠버네티스는
삭제가 완료된 것으로 간주하고 오브젝트를 삭제한다.
파이널라이저가 리소스들의 가비지 컬렉션을 제어하도록 사용할 수 있다. 예를 들어, 하나의 파이널라이저를 컨트롤러가 대상 리소스를 삭제하기 전에 연관된 리소스들 또는 인프라를 정리하도록 정의할 수 있다.
파이널라이저(Finalizer)를 사용하면 리소스를 삭제하기 전 특정 정리 작업을 수행하도록 컨트롤러에 경고하여 리소스의 가비지 컬렉션을 제어할 수 있다. 파이널라이저는 보통 실행할 코드를 지정하지 않는다. 대신 파이널라이저는 일반적으로 어노테이션과 비슷하게 특정 리소스에 대한 키들의 목록이다. 일부 파이널라이저는 쿠버네티스가 자동으로 지정하지만 사용자가 직접 지정할 수도 있다. ## 파이널라이저의 작동 방식 매니페스트 파일을 사용해 리소스를 생성하면 `metadata.finalizers` 필드에 파이널라이저를 명시할 수 있다. 리소스를 삭제하려 할 때 삭제 요청을 처리하는 API 서버가 `finalizers` 필드의 값을 인식하고 다음을 수행한다. * 삭제를 시작한 시각과 함께 `metadata.deletionTimestamp` 필드를 추가하도록 오브젝트를 수정한다. * 오브젝트의 `metadata.finalizers` 필드가 비워질 때까지 오브젝트가 제거되지 않도록 한다. * `202` 상태 코드를 리턴한다(HTTP "Accepted"). 이 파이널라이저를 관리하는 컨트롤러는 `metadata.deletionTimestamp`를 설정하는 오브젝트가 업데이트 되었음을 인지하여 오브젝트의 삭제가 요청되었음을 나타낸다. 그런 다음 컨트롤러는 그 리소스에 지정된 파이널라이저의 요구사항을 충족하려 시도한다. 컨트롤러는 파이널라이저 조건이 충족될 때 마다 리소스의 `finalizers` 필드에서 해당 키(key)를 제거한다. `finalizers` 필드가 비워지면 `deletionTimestamp` 필드가 설정된 오브젝트는 자동으로 삭제된다. 또한 파이널라이저를 사용하여 관리되지 않는 리소스가 삭제되지 않도록 할 수 있다. 파이널라이저의 일반적인 예로는 `퍼시스턴트 볼륨(Persistent Volume)` 오브젝트가 실수로 삭제되는 것을 방지하는 `kubernetes.io/pv-protection`가 있다. 파드가 `퍼시스턴트 볼륨` 오브젝트를 사용 중일 때, 쿠버네티스는 `pv-protection` 파이널라이저를 추가한다. `퍼시스턴트 볼륨`을 삭제하려 하면, `Terminating` 상태가 되지만 파이널라이저가 존재하기 때문에 컨트롤러가 삭제할 수 없다. 파드가 `퍼시스턴트 볼륨`의 사용을 중지하면 쿠버네티스가 `pv-protection` 파이널라이저를 해제하고 컨트롤러는 볼륨을 삭제한다.오브젝트를 DELETE하면, 쿠버네티스는 삭제 타임스탬프를 그 오브젝트에 추가하고 그 다음에
삭제 대기 중인 오브젝트의 .metadata.finalizers 필드에 대한 변경 사항을
즉시 제한하기 시작한다. 기존 파이널라이저를 제거할 수 있지만 (finalizers 목록에서 항목
삭제) 새 파이널라이저를 추가할 수는 없다. 또한, 한 번 설정된 오브젝트의 deletionTimestamp를
수정할 수 없다.
삭제 요청이 이루어진 다음에는 해당 오브젝트를 되살릴 수 없다. 삭제 후 유사한 오브젝트를 새롭게 만드는 방법밖에 없다.
example.com/finalizer-name과 같이 공개적으로 적격한 파이널라이저 이름이어야 한다.
쿠버네티스는 이 규칙을 강제하며, 변경된 오브젝트에 사용자 정의 파이널라이저가 적격한 파이널라이저 이름을 사용하지 않는다면 API 서버는 이를 저장하지 않는다.