Docker 고수가 되는 지름길! 커스텀 이미지 올리고 쓰는 전과정 A to Z

Last updated on 2025년 4월 9일

"같은 걸 반복하지 마라." – 프로그래밍 원칙 (DRY)

혹시 이런 생각 해본 적 있지 않으세요?

“내가 직접 만든 커스텀 이미지를 어디서든 써먹고 싶다구요! 어떻게 하면 되죠? 😭”

고블로가 도와줄게요~!
바로 도커허브(Docker Hub)에 나만의 이미지를 올려서, 어디서든 ‘슝~’ 하고 불러와서 쓰는 방법을 알려드릴게요!

이건 마치,
‘나만의 비빔밥 소스’를 만들어서 도서관, 회사, 캠핑장 어디서든 꺼내 먹는 비법 같다고 할까요? 😋

1️⃣ 도커허브 레포지토리, 내 소스 담을 반찬통!

먼저, 내 도커 이미지를 담을 반찬통 하나 만들어야겠죠?

도커허브에 로그인
오른쪽 위 프로필 클릭 → Repositories 선택
Create Repository 클릭!
이름은 n8n-python이라고 해볼까요?
Public(공개)이나 Private(비공개) 선택도 잊지 마세요~
그리고 ‘Create’ 버튼 꾹!

🔗 그러면 이런 주소가 생겨요:
https://hub.docker.com/repository/docker/gobloimgs/n8n-python
이제부터 여기에 우리의 소중한 이미지가 쏙 들어갈 거예요.

2️⃣ 로컬에서 내 요리(?) 시작! 이미지 빌드하기

자, 주방(?)으로 가볼까요?
Dockerfile이 있는 폴더로 이동해서 아래 명령어를 딱!

cd ~/your-custom-n8n-directory
docker build -t n8n-python:20.1 .

🎯 여기서 20.1은 버전 이름이에요.
‘내가 만든 20번째 버전, 1번 리파인’ 이런 느낌이죠 😎

3️⃣ 도커허브용 태그는 이름표 붙이기!

이미지에 ‘어디로 보낼지’ 딱! 알려줘야 해요.

docker tag n8n-python:20.1 gobloimgs/n8n-python:20.1

📝 여기서 gobloimgs는 내 도커허브 아이디!
자기 계정명으로 바꿔야 해요! 실수하지 마세요 🙈

4️⃣ 도커허브 로그인! 택배 붙이기 전 신분 확인 😆

docker login

아이디, 비밀번호 입력!
2FA (이중 인증 옵션) 켜놓은 분은 여기서 토큰 생성해서 로그인하셔야 해요.

5️⃣ 이제 푸시~! 도커허브로 이미지 보내기 🚀

docker push gobloimgs/n8n-python:20.1

와아~ 택배 출발했어요!
도커허브에서 올라갔는지 확인해보세요 😍

6️⃣ (선택) latest라는 라벨도 같이 보내볼까요?

docker tag n8n-python:20.1 gobloimgs/n8n-python:latest
docker push gobloimgs/n8n-python:latest

이건 마치, "지금 가장 최신 거예요~" 라고 스티커 붙이는 느낌!
나중에 latest만 불러도 가장 최신 버전이 쓩~ 옵니다.

7️⃣ 다른 데서 쓰기! ✨ 내 이미지 이제 어디서든 사용 가능!

🔸 이미지 불러오기 (pull)

docker pull gobloimgs/n8n-python:20.1

비공개 레포면 docker login 한 번 더 해주세요!

🔸 실행하기

docker run -d -p 5678:5678 gobloimgs/n8n-python:20.1

포트는 n8n 기본값인 5678, 이건 거의 공식이에요 😁

🔸 Docker Compose에서도 찰떡같이 사용하기

version: "3.8"

services:
  n8n:
    image: gobloimgs/n8n-python:20.1
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=secret
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

이렇게 쓰면, 완전 자동으로 쓱~ 실행!
환경변수나 볼륨도 자유롭게 조정 가능해요.

🎁 고블로 팁박스 – 알아두면 유용한 도커 명령어들

상황	명령어
이미지 목록 보기	`docker images`
컨테이너 상태 확인	`docker ps -a`
이미지 삭제	`docker rmi gobloimgs/n8n-python:20.1`
캐시 삭제	`docker builder prune`
볼륨 보기	`docker volume ls`

🧩 정리하면 이렇게 됩니다!

이미지 빌드
태그 붙이기
로그인 후 푸시!
다른 데서 pull & run!

이제 여러분도!
🍱 도시락처럼 싸서 다닐 수 있는 나만의 도커 이미지 마스터!
어디서든 딱 꺼내 쓰는 그 쾌감… 한 번 맛보면 헤어날 수 없어요 😍