> 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/beginner/private.md).

# Private 이미지 사용하기

{% hint style="info" %}
본 문서에서는 liqpod에서 인증이 필요한 **비공개 이미지(Private Repository)**를 사용하는 방법을 안내합니다.
{% endhint %}

## 1. 이미지 저장소 토큰 등록하기

비공개 저장소 인증을 위해 사용자의 액세스 토큰을 등록해야 합니다.

### **① 사용하는 저장소에서 토큰을 발급합니다.**

**🔹 Docker Hub 기준:**\
<https://hub.docker.com> 접속 및 로그인

<div align="left"><figure><img src="https://1578221086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFoI87GDcuaRRviatFnc9%2Fuploads%2FZaDYn0KJuwjvPLvYKdKC%2Fimage.png?alt=media&amp;token=2ee96562-f3ae-4dd3-933a-2f9d6751094a" alt=""><figcaption></figcaption></figure></div>

1. Account Settings 이동

<div align="left"><figure><img src="https://1578221086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFoI87GDcuaRRviatFnc9%2Fuploads%2Fi2VfGFtXaCbVmBpAJIxh%2Fimage.png?alt=media&amp;token=0a823631-2ce9-4037-a029-f9c1108a4e56" alt=""><figcaption></figcaption></figure></div>

2. Settings → Personal Access Tokens 이동

<div align="left"><figure><img src="https://1578221086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFoI87GDcuaRRviatFnc9%2Fuploads%2FCbaMCxDOr3NTeSIQdlnH%2Fimage.png?alt=media&amp;token=2774400d-25b3-4b7d-8c2a-05e7e987c22f" alt=""><figcaption></figcaption></figure></div>

3. Generate New Token 클릭

<div align="left"><figure><img src="https://1578221086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFoI87GDcuaRRviatFnc9%2Fuploads%2FxHF2J6cXaMmzkjlFBdx9%2Fimage.png?alt=media&amp;token=43fb9ec0-d47c-461b-8e52-56231ebb4af0" alt=""><figcaption></figcaption></figure></div>

4. 토큰 이름 지정 및 Read-only 권한으로 생성하기

<div align="left"><figure><img src="https://1578221086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFoI87GDcuaRRviatFnc9%2Fuploads%2FaM18XbWbazFMlIvB84M7%2Fimage.png?alt=media&amp;token=2588ccc0-7594-47fc-9256-1cdc230a7b14" alt=""><figcaption></figcaption></figure></div>

5. 생성된 토큰을 복사하기

### **② liqpod에 토큰을 등록합니다.**

<figure><img src="https://1578221086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFoI87GDcuaRRviatFnc9%2Fuploads%2FR2XI9Y6Nzx9xbThsozdQ%2Fimage.png?alt=media&amp;token=b26118da-95dd-40e5-9f38-932f24bbc296" alt=""><figcaption></figcaption></figure>

* 계정 설정 → 계정 → \[새 레포지토리 연동 추가] 클릭

<div align="left"><figure><img src="https://1578221086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFoI87GDcuaRRviatFnc9%2Fuploads%2FuyuN2Qx0csXJkICCUv1w%2Fimage.png?alt=media&amp;token=b893610d-7572-486c-9ff6-6f37a5981cd0" alt=""><figcaption></figcaption></figure></div>

* 레포지토리 제공자: Docker Hub
* 레포지토리 ID: Docker Hub 계정 ID
* 토큰: 위에서 발급받은 토큰

{% hint style="info" %}
GitHub Container Registry (ghcr.io)의 경우도 동일한 방식으로 Personal Access Token 발급 및 등록이 가능합니다.\
필요한 권한은 `read:packages`입니다.
{% endhint %}

***

## 2. 비공개 템플릿 생성하기

비공개 이미지를 사용하려면 반드시 비공개 템플릿을 사용해야 합니다.

### ① 템플릿 생성하기

<div align="left"><figure><img src="https://1578221086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFoI87GDcuaRRviatFnc9%2Fuploads%2FFhJAJl8EY1ywAVaJVpDl%2Fimage.png?alt=media&amp;token=2f271dc4-1b6a-4c6d-b5d0-87eb3682400a" alt=""><figcaption></figcaption></figure></div>

1. 대여 → 템플릿 → \[템플릿 생성]을 클릭합니다.

<figure><img src="https://1578221086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFoI87GDcuaRRviatFnc9%2Fuploads%2FZtmVdYWBw5aqAEuGNdK0%2Fimage.png?alt=media&amp;token=9840f479-660b-4ffc-bcad-9db4276ab847" alt=""><figcaption></figcaption></figure>

2. 템플릿 작성 시 다음 설정 필수:

* 비공개 템플릿: 비공개
* 비공개 저장소 여부: 비공개
* 이미지 URL: docker.io/아이디/이미지명:태그 형식
* 환경변수, 포트, 시작 커맨드 등은 필요에 따라 설정

{% hint style="info" %}
비공개 템플릿 미설정 시 비공개 저장소를 사용할 수 없습니다.\
만약 토큰이 정상적이지 않거나 권한이 없을 경우 템플릿 생성 시 권한 에러가 발생할 수 있습니다.&#x20;
{% endhint %}

## 3. 컨테이너 대여

1. 대여 → 컨테이너 호스팅 메뉴로 이동
2. 사용하고자 하는 노드 선택
   * 스토리지를 연결하려는 경우, 스토리지와 같은 리전의 노드를 선택해야 합니다.
3. 방금 생성한 비공개 템플릿을 선택해 대여합니다.

## 4. 실행 상태 확인

1. 나의 머신 → 컨테이너 메뉴에서 현재 컨테이너의 상태를 확인할 수 있습니다.

* 이미지가 정상적으로 Pull되었다면 `사용중` 상태로 전환되며, 로그 및 엔드포인트 정보를 확인할 수 있습니다.
* 이미지에 문제가 있거나 커맨드 설정에 문제가 있어 기동에 실패했을 경우 `오류` 상태로 전환되며,\
  **\[최근 로그 확인하기]**&#xB97C; 통해 어떤 에러로 기동에 실패했는지 확인할 수 있습니다.