본 문서에서는 liqpod에서 인증이 필요한 비공개 이미지(Private Repository)를 사용하는 방법을 안내합니다.
비공개 저장소 인증을 위해 사용자의 액세스 토큰을 등록해야 합니다.
🔹 Docker Hub 기준: https://hub.docker.com 접속 및 로그인
Account Settings 이동
Settings → Personal Access Tokens 이동
Generate New Token 클릭
토큰 이름 지정 및 Read-only 권한으로 생성하기
생성된 토큰을 복사하기
계정 설정 → 계정 → [새 레포지토리 연동 추가] 클릭
레포지토리 제공자: Docker Hub
레포지토리 ID: Docker Hub 계정 ID
토큰: 위에서 발급받은 토큰
GitHub Container Registry (ghcr.io)의 경우도 동일한 방식으로 Personal Access Token 발급 및 등록이 가능합니다.
필요한 권한은 read:packages입니다.
비공개 이미지를 사용하려면 반드시 비공개 템플릿을 사용해야 합니다.
대여 → 템플릿 → [템플릿 생성]을 클릭합니다.
템플릿 작성 시 다음 설정 필수:
비공개 템플릿: 비공개
비공개 저장소 여부: 비공개
이미지 URL: docker.io/아이디/이미지명:태그 형식
환경변수, 포트, 시작 커맨드 등은 필요에 따라 설정
비공개 템플릿 미설정 시 비공개 저장소를 사용할 수 없습니다. 만약 토큰이 정상적이지 않거나 권한이 없을 경우 템플릿 생성 시 권한 에러가 발생할 수 있습니다.
대여 → 컨테이너 호스팅 메뉴로 이동
사용하고자 하는 노드 선택
스토리지를 연결하려는 경우, 스토리지와 같은 리전의 노드를 선택해야 합니다.
방금 생성한 비공개 템플릿을 선택해 대여합니다.
나의 머신 → 컨테이너 메뉴에서 현재 컨테이너의 상태를 확인할 수 있습니다.
이미지가 정상적으로 Pull되었다면 사용중 상태로 전환되며, 로그 및 엔드포인트 정보를 확인할 수 있습니다.
이미지에 문제가 있거나 커맨드 설정에 문제가 있어 기동에 실패했을 경우 오류 상태로 전환되며,
[최근 로그 확인하기]를 통해 어떤 에러로 기동에 실패했는지 확인할 수 있습니다.
Last updated