# 🐳 [macOS / Linux] 2. 시스템 & 컨테이너 DevOps

[⬅️ 메인 README로 돌아가기](../README.md) | [💻 Windows 가이드 보기](./WIN-02-SYSTEM-DEVOPS.md)

---

## ⚡ 빠른 원클릭 설치 (Bash)

```bash
# 2.1. bottom (CPU/메모리/네트워크 실시간 모니터링 TUI)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-bottom.sh?ref_type=heads" | bash

# 2.2. all-smi (이종 GPU/NPU 가속기 통합 모니터링 TUI)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-all-smi.sh?ref_type=heads" | bash

# 2.3. Docker (Linux 전용 자동 설치)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-docker.sh?ref_type=heads" | bash

# 2.4. ctop (실시간 컨테이너 메트릭 모니터링 TUI)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ctop.sh?ref_type=heads" | bash

# 2.5. lazydocker (도커 컨테이너·이미지·볼륨 통합 제어 TUI)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazydocker.sh?ref_type=heads" | bash
```

---

## 📖 도구별 상세 사용법 및 단축키

### 2.1. [bottom (btm)](https://github.com/ClementTsang/bottom)
기존의 `top`이나 `htop`을 완벽하게 대체하는 화려하고 가벼운 호스트 시스템 리소스 모니터링 TUI 도구입니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-bottom.sh?ref_type=heads" | bash
  ```
* **주요 특징:**
  * **풀 그래픽 차트** — CPU 코어별 사용률, RAM/Swap, 네트워크 흐름, 디스크 I/O 실시간 그래프화
  * **정교한 프로세스 제어** — 프로세스를 정렬하고 직접 제어 및 강제 종료 가능

```bash
btm # 실행 명령어
```

| 단축키 | 동작 |
| :--- | :--- |
| `q` / `Esc` | 프로그램 종료 |
| `F1` ~ `F5` | 메트릭 모니터링 탭 이동 |
| `↑` `↓` | 프로세스 목록 선택 이동 |
| `k` / `dd` | 선택한 대상 프로세스 강제 종료 (Kill) |
| `/` | 실시간 프로세스명 검색 필터링 |

---

### 2.2. [all-smi](https://github.com/lablup/all-smi)
Lablup에서 개발한 이종(Heterogeneous) 가속기 및 GPU/NPU 자원 통합 모니터링 CLI/TUI 도구입니다. `nvidia-smi`를 대체/확장하여 다양한 AI 가속기 및 클러스터 노드 관제를 지원합니다.

* **설치 명령:**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-all-smi.sh?ref_type=heads" | bash
  ```
* **주요 특징:**
  * **이종 가속기 지원** — NVIDIA GPU, Apple Silicon, Intel Gaudi, Google TPU, Rebellions NPU, Furiosa NPU, Tenstorrent NPU 등 모니터링 지원
  * **실시간 인터랙티브 TUI** — GPU/NPU 사용률, 메모리, 온도, 전력 소모량 실시간 그래프 시각화
  * **클러스터 메트릭 관제** — 원격 시스템 관제 및 프로메테우스(Prometheus) 메트릭 추출 기능 연동 지원

```bash
all-smi             # 인터랙티브 모니터링 TUI 세션 시작
all-smi --help      # 도움말 및 사용 가능 옵션 확인
```

---

### 2.3. [Docker](https://www.docker.com/)
컨테이너 기반 애플리케이션 가상화 플랫폼입니다.

* **설치 명령 (Linux 전용):**
  ```bash
  curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-docker.sh?ref_type=heads" | bash
  ```

```bash
docker run hello-world     # 동작 유효성 테스트
docker ps                   # 가동 중인 컨테이너 목록
docker compose up -d        # 멀티 컨테이너 환경 백그라운드 구동
docker build -t <name> .    # 로컬 Dockerfile 빌드
```

> 💡 **운영체제별 사용 가이드:**
> * **macOS:** [Docker Desktop for Mac](https://www.docker.com/products/docker-desktop/) 또는 초경량 대안인 [OrbStack](https://orbstack.dev/) 설치를 권장합니다.
> * **Linux:** 설치 완료 후 스크립트가 로그인된 유저를 자동으로 `docker` 권한 그룹에 할당합니다. 터미널 세션을 재로그인하시면 `sudo` 없이 편하게 제어하실 수 있습니다.

---

### 2.4. [ctop](https://github.com/bcicen/ctop) & 2.5. [lazydocker](https://github.com/jesseduffield/lazydocker)
가동 중인 컨테이너들을 효율적으로 모니터링하고 관리할 수 있도록 지원하는 특화 TUI 듀오입니다.

| 도구명 | 특징 및 주요 권장 환경 |
| :--- | :--- |
| **ctop** | 실시간 리소스 메트릭(CPU, RAM, 네트워크 트래픽 등) 모니터링에 고도로 특화됨 |
| **lazydocker** | 컨테이너 상태 조회는 물론이고 시작, 정지, 재시작, 로그 보기, 내부 셸 진입 등 전반적인 컨테이너 수명 주기 관리에 적합함 |

#### [ctop 설치 및 사용법]
```bash
# 설치
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ctop.sh?ref_type=heads" | bash

# 실행
ctop
```

| 단축키 | 동작 |
| :--- | :--- |
| `q` / `Esc` | 프로그램 종료 |
| `↑` `↓` | 컨테이너 리스트 이동 |
| `l` | 선택된 컨테이너의 실시간 로그 화면 로드 |
| `a` | 숨겨진 비활성 컨테이너까지 전부 표시 |
| `f` | 특정 컨테이너 이름 검색 필터링 |
| `S` / `R` | 선택된 컨테이너 정지 / 즉시 재시작 |

#### [lazydocker 설치 및 사용법]
```bash
# 설치
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-lazydocker.sh?ref_type=heads" | bash

# 실행
lazydocker
```

| 단축키 | 동작 |
| :--- | :--- |
| `q` | 프로그램 종료 |
| `↑` `↓` | 목록 패널 탐색 |
| `Enter` | 컨테이너 상세 로그 및 자원 소비 통계 보기 |
| `s` / `r` | 컨테이너 인스턴스 정지 (Stop) / 재시작 (Restart) |
| `e` | 컨테이너 내부 터미널 즉시 실행 진입 (Exec) |
| `x` | 컨테이너 강제 파괴 및 제거 (Remove) |
| `[` `]` | 탭 및 패널 간 수평 포커스 이동 |

---

[⬅️ 이전: 1. 터미널 관리 & 파일 유틸리티](./UNIX-01-TERMINAL-FILE.md) | [🏠 메인 README](../README.md) | [다음: 3. 개발 유틸리티 ➡️](./UNIX-03-DEV-UTILS.md)