# 컨테이너 런타임 인터페이스 (CRI)

LLMS index: [llms.txt](/llms.txt)

---

<!-- overview -->

컨테이너 런타임 인터페이스 (CRI)는 클러스터 컴포넌트를 다시 컴파일하지 않아도 Kubelet이 다양한 
컨테이너 런타임을 사용할 수 있도록 하는 플러그인 인터페이스다.

<a class='glossary-tooltip' title='클러스터의 각 노드에서 실행되는 에이전트. Kubelet은 파드에서 컨테이너가 확실하게 동작하도록 관리한다.' data-bs-toggle='tooltip' data-bs-placement='top' href='/ko/docs/reference/generated/kubelet' target='_blank' aria-label='Kubelet'>Kubelet</a>이
<a class='glossary-tooltip' title='파드는 클러스터에서 실행 중인 컨테이너의 집합을 나타낸다.' data-bs-toggle='tooltip' data-bs-placement='top' href='/ko/docs/concepts/workloads/pods/' target='_blank' aria-label='파드'>파드</a>와 컨테이너를 
실행할 수 있도록, 
클러스터의 각 노드에는 동작 중인 
<a class='glossary-tooltip' title='컨테이너 런타임은 컨테이너 실행을 담당하는 소프트웨어이다.' data-bs-toggle='tooltip' data-bs-placement='top' href='/ko/docs/setup/production-environment/container-runtimes/' target='_blank' aria-label='컨테이너 런타임'>컨테이너 런타임</a>이 필요하다.

<p><p>컨테이너 런타임 인터페이스(CRI)는 컨테이너 런타임 인터페이스(CRI)는 노드의 Kubelet과 컨테이너
런타임을 통합시키기 위한 API이다.</p></p>
<p>API와 스펙에 대한 정보는 <a href="https://github.com/kubernetes/community/blob/master/contributors/devel/sig-node/container-runtime-interface.md">CRI</a>를 참고한다.</p>

<!-- body -->

## API {#api}








  <div class="feature-state-notice feature-stable">
      <span class="feature-state-name">기능 상태:</span>
      <code>Kubernetes v1.23 [stable]</code>
    </div>
  



Kubelet은 gRPC를 통해 컨테이너 런타임과 연결할 때 클라이언트의 역할을 수행한다.
런타임과 이미지 서비스 엔드포인트는 컨테이너 런타임 내에서 사용 가능해야 하며, 
이는 각각 Kubelet 내에서 `--container-runtime-endpoint` 
[커맨드라인 플래그](/docs/reference/command-line-tools-reference/kubelet/)
를 통해 설정할 수 있다.

쿠버네티스 v1.26 및 이후 버전에서, Kubelet은 컨테이너 런타임이 CRI `v1` API를 지원할 것을 요구한다. 
컨테이너 런타임이 `v1` API를 지원하지 않으면, 
Kubelet은 해당 노드를 등록하지 않는다.

## 업그레이드

노드에서 쿠버네티스 버전을 업그레이드하면 Kubelet이 재시작된다. 만약 
컨테이너 런타임이 CRI `v1` API를 지원하지 않는 경우, Kubelet은 등록에 실패하고 
에러를 보고한다. 컨테이너 런타임 업그레이드로 인해 gRPC 재연결이 필요한 경우, 
연결이 성공하려면 런타임이 CRI `v1` API를 지원해야 한다. 
이 경우 컨테이너 런타임이 올바르게 설정된 후 
Kubelet을 재시작해야 할 수 있다.

## 다음 내용

- CRI [프로토콜 정의](https://github.com/kubernetes/cri-api/blob/v0.33.1/pkg/apis/runtime/v1/api.proto)에 대해 자세히 알아본다.