> For the complete documentation index, see [llms.txt](https://liqpod.gitbook.io/liqpod/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://liqpod.gitbook.io/liqpod/mymachine/container.md).

# 컨테이너 관리하기

{% hint style="info" %}
liqpod의 컨테이너 관리 페이지는 현재 실행 중이거나 일시정지된 컨테이너의 상세 정보를 확인하고 다양한 작업을 수행할 수 있는 대시보드 화면입니다.\
사용자는 이 페이지에서 컨테이너의 실행 상태, 연결된 리소스, 접근 방법, 비용 현황 등을 확인하고, 직접 컨테이너를 조작할 수 있습니다.
{% endhint %}

<figure><img src="https://1578221086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFoI87GDcuaRRviatFnc9%2Fuploads%2F5WMBO7nAZB28AnFiYPVU%2Fimage.png?alt=media&amp;token=de53b37a-1158-43b2-b836-23d7431b516c" alt=""><figcaption></figcaption></figure>

## 마운트 스토리지

현재 컨테이너에 연결된 스토리지 목록을 확인할 수 있습니다.

* **표시 항목**:
  * 스토리지 이름
  * 마운트 경로
  * 용량 정보
* 다중 스토리지를 연결한 경우 모두 표시됩니다.
* 스토리지는 컨테이너 종료 또는 일시정지 이후에도 데이터가 유지됩니다.

***

## 컨테이너 정보

컨테이너의 기본 메타 정보가 표시됩니다.

<table><thead><tr><th width="195">항목</th><th>설명</th></tr></thead><tbody><tr><td>이름</td><td>컨테이너 고유 이름입니다.</td></tr><tr><td>상태</td><td><code>실행 중</code>, <code>일시정지</code>, <code>종료됨</code> 상태 중 하나가 표시됩니다.</td></tr><tr><td>지역 (리전)</td><td>컨테이너가 실행 중인 데이터센터 위치입니다.</td></tr><tr><td>Docker 이미지 주소</td><td>사용 중인 Docker 이미지의 풀 URL입니다.</td></tr><tr><td>시작일시</td><td>현재 세션의 컨테이너 기동 시간입니다. (일시정지 후 재개 시점 기준으로 갱신됨)</td></tr><tr><td>업타임</td><td>컨테이너가 현재 상태로 실행된 시간입니다. (초 단위로 지속 증가)</td></tr></tbody></table>

***

## 실행 환경

### 엔드포인트

컨테이너가 외부에서 접근 가능한 주소 정보를 제공합니다.

* **SSH 주소, 포트, 사용자명**
* **SSH 접속 명령어** (예: `ssh liquser@node.liqpod.ai -p 49123`)
* **웹 주소**: Web UI, API 서버 등 컨테이너에 연결된 포트가 웹에 노출된 경우 표시됨

{% hint style="info" %}
포트를 생성 시 `SSH`, `WEB`으로 명시한 경우에만 해당 항목들이 표시됩니다.
{% endhint %}

### 환경 변수

컨테이너 실행 시 전달된 환경 변수 목록이 key-value 형태로 나열됩니다.

* 예:
  * `MODEL_NAME = llama2`
  * `HF_TOKEN = [REDACTED]`

### 포트

내부 컨테이너 포트와 외부 접근을 위한 바인딩 포트 정보가 표시됩니다.

* 예:
  * 컨테이너 포트: `7860`
  * 호스트 포트: `49123`

### 커맨드

해당 컨테이너를 실행할 때 사용된 **시작 커맨드**가 표시됩니다.

* 예: `python app.py --port 7860`

***

## 비용

컨테이너에 대한 실시간 비용 정보가 표시됩니다.

* **시간당 비용**: GPU 종류, 스펙에 따라 자동 계산된 시간 단위 요금
* **총 비용**: 컨테이너 실행 이후 현재까지 누적된 과금액 (크레딧 단위)

***

## 액션

### 웹 터미널 접속하기 (베타)

* WebSocket 기반 터미널 인터페이스를 제공합니다.
* 이미지가 bash쉘을 지원하지 않을 경우 정상 동작하지 않을 수 있습니다.

### 웹 스토리지 접속하기 (예정)

* GUI 파일 탐색기와 같이 파일을 확인하거나 업로드, 다운로드가 가능합니다.
* 추후 지원 예정

### 최근 로그 확인

* **POD 로그**: Kubernetes에서 생성된 컨테이너 콘솔 로그
* **POD 이벤트**: Kubernetes에서 해당 pod에 발생한 이벤트 로그 (스케줄링, 재시작 등)
* **서비스 로그**: 사용자가 설정한 포트로 외부에 노출된 Web 서비스의 접속/에러 로그

### 컨테이너 일시정지하기

컨테이너를 종료하지 않고 일시적으로 정지시킬 수 있습니다.

* **데이터 주의**: 연동된 스토리지 외 컨테이너 내 모든 데이터는 소멸됩니다.
* 일시정지 상태에서는 다음 항목들을 수정할 수 있습니다:
  * 환경변수
  * 포트 설정
  * 시작 커맨드
* 정지 후 \[다시 시작하기] 버튼을 통해 재개 가능합니다.

### 컨테이너 종료하기

컨테이너를 **정상적으로 종료**합니다.

* 스토리지는 유지되며, 재시작은 불가능합니다.
* 실행 시간은 여기서 종료되어 과금도 멈춥니다.

### 컨테이너 삭제하기

* 컨테이너를 삭제하고 리스트 상에서 볼 수 없게 됩니다.
* 종료된 컨테이너만 삭제할 수 있습니다.