Merge pull request #31924 from anencore94/ko_update_garbage_collection

[ko] update garbage collection

content/ko/docs/concepts/architecture/garbage-collection.md

@@ -0,0 +1,172 @@
+---
+title: 가비지(Garbage) 수집
+content_type: concept
+weight: 50
+---
+
+<!-- overview -->
+{{<glossary_definition term_id="garbage-collection" length="short">}}
+다음과 같은 리소스를 정리한다:
+
+  * [실패한 파드](/ko/docs/concepts/workloads/pods/pod-lifecycle/#pod-garbage-collection)
+  * [종료된 잡](/ko/docs/concepts/workloads/controllers/ttlafterfinished/)
+  * [소유자 참조가 없는 오브젝트](#owners-dependents)
+  * [사용되지 않는 컨테이너와 컨테이너 이미지](#containers-images)
+  * [반환 정책이 삭제인 스토리지클래스에 의해 동적으로 생성된 퍼시스턴트볼륨](/ko/docs/concepts/storage/persistent-volumes/#delete)
+  * [Stale 또는 만료된 CertificateSigningRequests (CSRs)](/docs/reference/access-authn-authz/certificate-signing-requests/#request-signing-process) <!-- en 글에서부터 링크가 깨져있어 /docs를 따로 추가-->
+  * {{<glossary_tooltip text="노드" term_id="node">}} 는 다음과 같은 상황에서 삭제된다:
+    * 클러스터가 [클라우드 컨트롤러 매니저](/ko/docs/concepts/architecture/cloud-controller/)를 사용하는 클라우드
+    * 클러스터가 클라우드 컨트롤러 매니저와 유사한 애드온을 사용하는 온프레미스
+  * [노드 리스(Lease) 오브젝트](/ko/docs/concepts/architecture/nodes/#heartbeats)
+
+## 소유자(Owners)와 종속(dependents) {#owners-dependents}
+
+쿠버네티스의 많은 오브젝트는 [*owner references*](/docs/concepts/overview/working-with-objects/owners-dependents/)를 통해 서로 연결되어 있다.
+
+소유자 참조(Owner references)는 컨트롤 플레인에게 어떤 오브젝트가 서로 종속적인지를 알려준다.
+쿠버네티스는 소유자 참조를 사용하여 컨트롤 플레인과 다른 API 클라이언트에게 오브젝트를 삭제하기 전 관련 리소스를 정리하는 기회를 제공한다. 대부분의 경우, 쿠버네티스는 소유자 참조를 자동으로 관리한다.
+
+소유권(Ownership)은 일부 리소스가 사용하는 [레이블과 셀렉터](/ko/docs/concepts/overview/working-with-objects/labels/)
+메커니즘과는 다르다. 예를 들어, 
+`EndpointSlice` 오브젝트를 생성하는 {{<glossary_tooltip text="서비스" term_id="service">}}를 
+생각해보자. 서비스는 *레이블*을 사용해 컨트롤 플레인이
+어떤 `EndpointSlice` 오브젝트가 해당 서비스에 의해 사용되는지 판단하는 데 도움을 준다. 레이블과 더불어,
+서비스를 대신해 관리되는 각 `EndpointSlice` 오브젝트는
+소유자 참조를 가진다. 소유자 참조는 쿠버네티스의 다른 부분이 제어하지 않는
+오브젝트를 방해하는 것을 방지하는 데 도움을 준다.
+
+
+{{< note >}}
+교차 네임스페이스(cross-namespace)의 소유자 참조는 디자인상 허용되지 않는다.
+네임스페이스 종속 오브젝트는 클러스터 범위 또는 네임스페이스 소유자를 지정할 수 있다.
+네임스페이스 소유자는 **반드시** 종속 오브젝트와 동일한 네임스페이스에 존재해야 한다.
+그렇지 않다면, 소유자 참조는 없는 것으로 간주되어, 종속 오브젝트는
+모든 소유자가 없는 것으로 확인되면 삭제될 수 있다.
+
+클러스터 범위의 종속 오브젝트는 클러스터 범위의 소유자만 지정할 수 있다.
+v1.20 이상에서, 클러스터 범위의 종속 오브젝트가 네임스페이스 종류를 소유자로 지정하면,
+확인할 수 없는 소유자 참조가 있는 것으로 간주되어 가비지 수집이 될 수 없다.
+
+v1.20 이상에서, 가비지 수집기가 잘못된 교차 네임스페이스 `ownerReference`
+또는 네임스페이스 종류를 참조하는 `ownerReference`가 있는 클러스터 범위의 종속 항목을 감지하면,
+`OwnerRefInvalidNamespace`가 원인인 경고 이벤트와 유효하지 않은 종속 항목의 `involvedObject`가 보고된다.
+`kubectl get events -A --field-selector=reason=OwnerRefInvalidNamespace`
+를 실행하여 이러한 종류의 이벤트를 확인할 수 있다.
+{{< /note >}}
+
+## 캐스케이딩(Cascading) 삭제 {#cascading-deletion}
+
+쿠버네티스는 오브젝트를 삭제할 때 더 이상 소유자 참조가 없는지,
+예를 들어 레플리카셋을 삭제할 때, 남겨진 파드가 없는지 확인하고 삭제한다.
+오브젝트를 삭제할 때 쿠버네티스가 오브젝트의 종속 오브젝트들을 자동으로 삭제할 지 여부를 제어할 수 있다.
+이 과정을 `캐스케이딩 삭제`라고 한다.
+캐스케이딩 삭제에는 다음과 같은 두 가지 종류가 있다.
+
+  * 포그라운드 캐스케이딩 삭제(Foreground cascading deletion)
+  * 백그라운드 캐스케이딩 삭제(Background cascading deletion)
+
+또한 쿠버네티스의 {{<glossary_tooltip text="finalizers" term_id="finalizer">}}를 사용하여 가비지 수집이 소유자 참조가 있는 자원을 언제 어떻게 삭제할 것인지 제어할 수 있다.
+
+### 포그라운드 캐스케이딩 삭제 {#foreground-deletion}
+
+포그라운드 캐스케이딩 삭제에서는 삭제하려는 소유자 오브젝트가 먼저
+*삭제 중* 상태가 된다. 이 상태에서는 소유자 오브젝트에게 다음과 같은 일이
+일어난다:
+
+  * 쿠버네티스 API 서버가 오브젝트의 `metadata.deletionTimestamp` 필드를
+    오브젝트가 삭제 표시된 시간으로 설정한다.
+  * 쿠버네티스 API 서버가 `metadata.finalizers` 필드를 `foregroundDeletion`로
+    설정한다. 
+  * 오브젝트는 삭제 과정이 완료되기 전까지 쿠버네티스 API를 통해 조회할 수 있다.
+
+소유자 오브젝트가 삭제 중 상태가 된 이후, 컨트롤러는 종속 오브젝트들을 삭제한다.
+모든 종속 오브젝트들이 삭제되고나면, 컨트롤러가 소유자 오브젝트를 삭제한다.
+이 시점에서 오브젝트는 더 이상 쿠버네티스 API를 통해 조회할 수 없다.
+
+포그라운드 캐스케이딩 삭제 중에 소유자 오브젝트의 삭제를 막는
+종속 오브젝트는`ownerReference.blockOwnerDeletion=true`필드를 가진 오브젝트다.
+더 자세한 내용은 [Use foreground cascading deletion](/docs/tasks/administer-cluster/use-cascading-deletion/#use-foreground-cascading-deletion)를
+참고한다.
+
+### 백그라운드 캐스케이딩 삭제 {#background-deletion}
+
+백그라운드 캐스케이딩 삭제에서는 쿠버네티스 API 서버가 소유자 오브젝트를 즉시 삭제하고
+백그라운드에서 컨트롤러가 종속 오브젝트들을 삭제한다.
+쿠버네티스는 수동으로 포그라운드 삭제를 사용하거나 종속 오브젝트를 분리하지 않는다면, 기본적으로 백그라운드 캐스케이딩 삭제를 사용한다.
+
+더 자세한 내용은 [Use background cascading deletion](/docs/tasks/administer-cluster/use-cascading-deletion/#use-background-cascading-deletion)를
+참고한다.
+
+### 분리된 종속 (Orphaned dependents)
+
+쿠버네티스가 소유자 오브젝트를 삭제할 때, 남은 종속 오브젝트는 *분리된* 오브젝트라고 부른다.
+기본적으로 쿠버네티스는 종속 오브젝트를 삭제한다.
+이 행동을 오버라이드하는 방법을 보려면,
+다음 [Delete owner objects and orphan dependents](/docs/tasks/administer-cluster/use-cascading-deletion/#set-orphan-deletion-policy)를 참고한다.
+
+## 사용되지 않는 컨테이너와 이미지 가비지 수집 {#containers-images}
+
+{{<glossary_tooltip text="kubelet" term_id="kubelet">}}은
+사용되지 않는 이미지에 대한 가비지 수집을 5분마다, 컨테이너에 대한 가비지 수집을 1분마다
+수행한다. 외부 가비지 수집 도구는 Kubelet 의 행동을 중단시키고
+존재해야만 하는 컨테이너를 삭제할 수 있으므로 사용을 피해야 한다.
+
+사용되지 않는 컨테이너와 이미지에 대한 가비지 수집 옵션을 구성하려면, 
+[configuration file](/docs/tasks/administer-cluster/kubelet-config-file/) 사용하여 Kubelet 을 수정하거나
+[`KubeletConfiguration`](/docs/reference/config-api/kubelet-config.v1beta1/#kubelet-config-k8s-io-v1beta1-KubeletConfiguration) 리소스 타입의
+가비지 수집과 관련된 파라미터를 수정한다.
+
+### 컨테이너 이미지 라이프사이클
+
+쿠버네티스는 Kubelet의 일부인 *이미지 관리자*가 {{< glossary_tooltip text="cadvisor" term_id="cadvisor" >}}와 협동하여
+모든 이미지의 라이프사이클을 관리한다.
+Kubelet은 가비지 수집 결정을 내릴 때, 다음 디스크 사용량 제한을 고려한다.
+
+  * `HighThresholdPercent`
+  * `LowThresholdPercent`
+
+`HighThresholdPercent` 값을 초과한 디스크 사용량은
+마지막으로 사용된 시간을 기준으로 오래된 이미지순서대로 이미지를 삭제하는
+가비지 수집을 트리거한다. Kubelet은 디스크 사용량이 `LowThresholdPercent` 값에 도달할 때까지
+이미지를 삭제한다.
+
+### 컨테이너 이미지 가비지 수집 {#container-image-garbage-collection}
+
+Kubelet은 사용자가 정의할 수 있는 다음 변수들을 기반으로 사용되지 않는 컨테이너들을 삭제한다:
+
+  * `MinAge`: Kubelet이 가비지 수집할 수 있는 최소 나이. `0`으로 세팅하여 비활성화할 수 있다.
+  * `MaxPerPodContainer`: 각 파드 쌍이 가질 수 있는 죽은 컨테이너의 최대 개수.
+    `0`으로 세팅하여 비활성화할 수 있다.
+  * `MaxContainers`: 클러스터가 가질 수 있는 죽은 컨테이너의 최대 개수
+    `0`으로 세팅하여 비활성화할 수 있다.
+
+위 변수와 더불어, Kubelet은 식별할 수 없고 삭제된 컨테이너들을 오래된 순서대로 가비지 수집한다.
+
+`MaxPerPodContainer`와 `MaxContainer`는
+파드의 최대 컨테이너 개수(`MaxPerPodContainer`)를 유지하는 것이
+전체 죽은 컨테이너의 개수 제한(`MaxContainers`)을 초과하게 될 때,
+서로 충돌이 발생할 수 있다.
+이 상황에서 Kubelet은 충돌을 해결하기 위해 `MaxPodPerContainer`를 조절한다.
+최악의 시나리오에서는 `MaxPerPodContainer`를 `1`로 다운그레이드하고
+가장 오래된 컨테이너들을 축출한다.
+또한, 삭제된 파드가 소유한 컨테이너들은 `MinAge`보다 오래되었을 때 삭제된다.
+
+{{<note>}}
+Kubelet은 자신이 관리하는 컨테이너에 대한 가비지 수집만을 수행한다.
+{{</note>}}
+
+## 가비지 수집 구성하기 {#configuring-gc}
+
+자원을 관리하는 컨트롤러의 옵션을 구성하여 가비지 컬렉션을 수정할 수 있다.
+다음 페이지에서 어떻게 가비지 수집을 구성할 수 있는지 확인할 수 있다:
+
+  * [쿠버네티스 오브젝트의 캐스케이딩 삭제 구성하기](/docs/tasks/administer-cluster/use-cascading-deletion/)
+  * [완료된 잡 자동 정리하기](/docs/concepts/workloads/controllers/ttlafterfinished/)
+  
+<!-- * [Configuring unused container and image garbage collection](/docs/tasks/administer-cluster/reconfigure-kubelet/) -->
+
+## {{% heading "whatsnext" %}}
+
+* [쿠버네티스 오브젝트의 소유권](/docs/concepts/overview/working-with-objects/owners-dependents/)에 대해 알아보자.
+* 쿠버네티스 [finalizers](/docs/concepts/overview/working-with-objects/finalizers/)에 대해 알아보자.
+* 완료된 잡을 정리하는 [TTL 컨트롤러](/docs/concepts/workloads/controllers/ttlafterfinished/) (beta) 에 대해 알아보자.

content/ko/docs/concepts/workloads/_index.md

@@ -70,7 +70,7 @@ _모든_ 파드가 가용한 경우가 아닌 경우 멈추고 싶다면(아마
 
 다음은 쿠버네티스가 애플리케이션의 파드를 어떻게 관리하는지를 알 수 있게 해주는
 두 가지 개념이다.
-* [가비지(Garbage) 수집](/ko/docs/concepts/workloads/controllers/garbage-collection/)은 _소유하는 리소스_ 가
+* [가비지(Garbage) 수집](/ko/docs/concepts/architecture/garbage-collection/)은 _소유하는 리소스_ 가
   제거된 후 클러스터에서 오브젝트를 정리한다.
 * [_time-to-live after finished_ 컨트롤러](/ko/docs/concepts/workloads/controllers/ttlafterfinished/)는
   잡이 완료된 이후에 정의된 시간이 경과되면 잡을 제거한다.

content/ko/docs/concepts/workloads/controllers/replicaset.md

@@ -26,7 +26,7 @@ weight: 20
 레플리카셋이 새로운 파드를 생성해야 할 경우, 명시된 파드 템플릿을
 사용한다.
 
-레플리카셋은 파드의 [metadata.ownerReferences](/ko/docs/concepts/workloads/controllers/garbage-collection/#소유자-owner-와-종속-dependent)
+레플리카셋은 파드의 [metadata.ownerReferences](/ko/docs/concepts/architecture/garbage-collection/#소유자-owner-와-종속-dependent)
 필드를 통해 파드에 연결되며, 이는 현재 오브젝트가 소유한 리소스를 명시한다.
 레플리카셋이 가지고 있는 모든 파드의 ownerReferences 필드는 해당 파드를 소유한 레플리카셋을 식별하기 위한 소유자 정보를 가진다.
 이 링크를 통해 레플리카셋은 자신이 유지하는 파드의 상태를 확인하고 이에 따라 관리 한다.
@@ -269,7 +269,7 @@ matchLabels:
 
 ### 레플리카셋과 해당 파드 삭제
 
-레플리카셋 및 모든 파드를 삭제하려면 [`kubectl delete`](/docs/reference/generated/kubectl/kubectl-commands#delete)를 사용한다. [가비지 수집기](/ko/docs/concepts/workloads/controllers/garbage-collection/)는 기본적으로 종속되어 있는 모든 파드를 자동으로 삭제한다.
+레플리카셋 및 모든 파드를 삭제하려면 [`kubectl delete`](/docs/reference/generated/kubectl/kubectl-commands#delete)를 사용한다. [가비지 수집기](/ko/docs/concepts/architecture/garbage-collection/)는 기본적으로 종속되어 있는 모든 파드를 자동으로 삭제한다.
 
 REST API또는 `client-go` 라이브러리를 이용할 때는 -d 옵션으로 `propagationPolicy`를 `Background`또는 `Foreground`로
 설정해야 한다.

content/ko/docs/reference/glossary/garbage-collection.md

@@ -0,0 +1,22 @@
+---
+title: 가비지(Garbage) 수집
+id: garbage-collection
+date: 2022-01-14
+full_link: /ko/docs/concepts/architecture/garbage-collection/
+short_description: >
+  쿠버네티스가 클러스터 자원을 정리하기 위해 사용하는 다양한 방법을 종합한 용어이다.
+
+aka: 
+tags:
+- fundamental
+- operation
+---
+ 쿠버네티스가 클러스터 자원을 정리하기 위해 사용하는 다양한 방법을 종합한 용어이다.
+
+<!--more-->
+
+쿠버네티스는 [사용되지 않는 컨테이너와 이미지](/ko/docs/concepts/architecture/garbage-collection/#containers-images),
+[실패한 파드](/ko/docs/concepts/workloads/pods/pod-lifecycle/#pod-garbage-collection),
+[타겟 리소스가 소유한 오브젝트](/docs/concepts/overview/working-with-objects/owners-dependents/),
+[종료된 잡](/ko/docs/concepts/workloads/controllers/ttlafterfinished/), 그리고
+만료되거나 실패한 리소스를 정리하기 위해 가비지 수집을 사용한다.

content/ko/docs/tasks/job/automated-tasks-with-cron-jobs.md

@@ -127,7 +127,7 @@ kubectl delete cronjob hello
 ```
 
 크론 잡을 삭제하면 생성된 모든 잡과 파드가 제거되고 추가 잡 생성이 중지된다.
-[가비지(garbage) 수집](/ko/docs/concepts/workloads/controllers/garbage-collection/)에서 잡 제거에 대해 상세한 내용을 읽을 수 있다.
+[가비지(garbage) 수집](/ko/docs/concepts/architecture/garbage-collection/)에서 잡 제거에 대해 상세한 내용을 읽을 수 있다.
 
 ## 크론 잡 명세 작성