Private 이미지 사용하기

본 문서에서는 liqpod에서 인증이 필요한 비공개 이미지(Private Repository)를 사용하는 방법을 안내합니다.

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

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

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

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

  1. Account Settings 이동

  1. Settings → Personal Access Tokens 이동

  1. Generate New Token 클릭

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

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

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

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

  • 레포지토리 제공자: Docker Hub

  • 레포지토리 ID: Docker Hub 계정 ID

  • 토큰: 위에서 발급받은 토큰

GitHub Container Registry (ghcr.io)의 경우도 동일한 방식으로 Personal Access Token 발급 및 등록이 가능합니다. 필요한 권한은 read:packages입니다.


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

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

① 템플릿 생성하기

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

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

  • 비공개 템플릿: 비공개

  • 비공개 저장소 여부: 비공개

  • 이미지 URL: docker.io/아이디/이미지명:태그 형식

  • 환경변수, 포트, 시작 커맨드 등은 필요에 따라 설정

비공개 템플릿 미설정 시 비공개 저장소를 사용할 수 없습니다. 만약 토큰이 정상적이지 않거나 권한이 없을 경우 템플릿 생성 시 권한 에러가 발생할 수 있습니다.

3. 컨테이너 대여

  1. 대여 → 컨테이너 호스팅 메뉴로 이동

  2. 사용하고자 하는 노드 선택

    • 스토리지를 연결하려는 경우, 스토리지와 같은 리전의 노드를 선택해야 합니다.

  3. 방금 생성한 비공개 템플릿을 선택해 대여합니다.

4. 실행 상태 확인

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

  • 이미지가 정상적으로 Pull되었다면 사용중 상태로 전환되며, 로그 및 엔드포인트 정보를 확인할 수 있습니다.

  • 이미지에 문제가 있거나 커맨드 설정에 문제가 있어 기동에 실패했을 경우 오류 상태로 전환되며, [최근 로그 확인하기]를 통해 어떤 에러로 기동에 실패했는지 확인할 수 있습니다.

Last updated