🚫 폐쇄망 환경을 위한 containerd 사용 가이드

I. 개요 및 필수 준비 사항

containerd는 컨테이너의 실행 엔진(Runtime) 그 자체입니다.
폐쇄망 환경에서는 외부 레지스트리(Docker Hub 등)에 접속할 수 없으므로, 사전에 필요한 이미지를 파일 형태로 확보하여 내부 로컬 저장소에 수동으로 주입(Load)해야 합니다.

핵심 제한: 인터넷 접속 불가.
작업 흐름: 모든 작업은 ① 인터넷 연결 환경에서 이미지 파일을 다운로드하고 ② 이 파일을 **물리적 매체(USB, 외장 하드)**를 통해 ③ 폐쇄망 내부로 옮겨서 실행해야 합니다.
도구: 로컬 파일 시스템과 containerd의 CLI 도구(ctr 또는 crictl)를 사용합니다.

구분	내용	사용 도구	비고
이미지 Pull	실행할 컨테이너의 이미지를 인터넷 환경에서 다운로드합니다.	`docker pull`	기본 작업
이미지 저장	다운로드한 이미지를 Portable Archive 파일 형태로 만듭니다.	`docker save` 또는 `skopeo`	이 파일이 물리적 전송 대상입니다.
이미지 전송	Archive 파일을 USB 등을 이용해 폐쇄망으로 옮깁니다.	USB Drive	전송 과정에서 파일 무결성을 확인해야 합니다.

(이 단계는 반드시 인터넷에 연결된 준비용 워크스테이션에서 진행합니다.)

가장 간편한 방법: docker save를 사용하여 이미지를 단일 .tar 파일로 만듭니다.
```
# 예시: nginx 이미지를 tar 파일로 저장
docker save -o nginx_image.tar nginx:latest
```
팁 (skopeo 사용): skopeo는 레지스트리나 로컬에서 이미지를 복사/검사하는 데 유용하며, 폐쇄망 전송 시 이미지 레이어의 무결성을 점검하는 데 사용될 수 있습니다.

(이 단계는 인터넷 연결이 완전히 차단된 폐쇄망 서버에서 진행합니다.)

containerd 설치 확인: 운영체제 레포지토리에서 containerd가 이미 설치되어 있는지 확인합니다. (설치가 안 되었다면, 이 서버가 어떤 경로로 패키지를 받았는지 명확히 기록해야 합니다.)
```
sudo dnf install containerd.io
```
서비스 시작: containerd 서비스를 실행합니다.
```
sudo systemctl start containerd
```

폐쇄망에서 containerd에게 “이 파일이 이미지다”라고 알려주어 로컬 스토리지를 채워야 합니다.

파일 이동: USB 드라이브에서 nginx_image.tar 파일을 서버 내부의 접근 가능한 디렉토리로 옮깁니다.
이미지 로드 (Import): ctr 도구를 사용하여 Tarball 파일을 컨테이너 내부 레지스트리로 가져옵니다.
```
# 형식: ctr image import <경로/이미지파일명.tar>
sudo ctr image import /mnt/usb/nginx_image.tar
```

컨테이너 생성 및 실행: 로컬에 로드된 이미지를 사용하여 컨테이너를 실행합니다.

# ctr run [이미지 식별자]
# 주의: 이미지 식별자(Image Digest)는 로딩 후 출력을 통해 확인해야 합니다.
sudo ctr run [로컬 이미지 Digest 또는 이름]

(Windows 환경에서는 반드시 WSL2 리눅스 가상 환경 내에서 Linux 명령을 사용합니다.)

이미지 로드: WSL2 내부의 터미널에서 Linux 명령어를 그대로 사용합니다.

# 이미지 로딩 명령어 (WSL 내부에서 실행)
sudo ctr image import /mnt/usb/nginx_image.tar

컨테이너 실행: 로컬로 주입된 이미지를 사용하여 컨테이너를 실행합니다.
```
# (WSL 내부) 컨테이너 실행
sudo ctr run [로컬 이미지 Digest 또는 이름]
```

⚠️ 중요 주의사항: 폐쇄망 환경에서는 docker나 containerd 같은 컨테이너 런타임 자체의 바이너리 및 종속 라이브러리(Runtime Dependencies)도 미리 확보하고 시스템에 배포해야 정상 작동합니다.