docker hub 를 이용한 도커 컨테이너 빌드 팁

Share
docker hub 를 이용한 도커 컨테이너 빌드 팁

최근 개발 언어나 플랫폼은 빌드 시점에 필요한 라이브러리를 다운로드 받아 빌드하는 경우가 많습니다. 이것은 Docker 를 이용할 경우에도 동일한데 Docker는 컨테이너를 빌드하는 시점에 베이스 이미지 등 필요한 정보를 다운로드 받습니다. 그리고 Docker 내에서 다시 프로그램을 빌드를 하는 경우도 많이 있는데 이때에는 프로그램 빌드에 필요한 라이브러리를 다운로드 받습니다. 대부분의 상황에서는  이런 빌드가 문제되지 않겠지만 다음 두가지 상황에서는 대략 난감한 경우가 많습니다

  1. 보안 등의 문제로 특정 사이트의 접속을 막아 놓은 경우
    • 일부 대기업의 경우 github.com 사이트도 막혀 있음
    • 중국에서 개발하는 경우 golang.org[1] 등도 막혀 있음
  2. 네트워크 속도 문제
    • 많은 인원이 제한된 인터넷 회선을 사용하는 프로젝트 등

이번 글에서는 이런 경우 간단하게 docker hub에서 제공하는 빌드 기능을 이용하여 Docker를 빌드 하는 방법에 대해 소개합니다.

Docker Hub를 이용한 빌드

Docker의 경우 작게는 수십 MB에서 많게는 수백MB 까지 다운로드 받아야 하는 경우가 있습니다. 이런 경우 docker hub에서 제공하는 "Created Automated Build" 기능을 이용할 수 있습니다. Docker hub는 maven repository와 같이 외부에 공개되어 있는 도커 이미지 레포지토리로 docker pull 명령을 이용하여 컨테이너를 로컬에 받아 오거나, Docker image 빌드 시 베이스 이미지 등을 받아오는데 주로 사용됩니다. 실제 처리는 아래 그림과 같은 순서로 진행합니다.

 

dockerhub

1. http://hub.docker.com 에서 계정을 만든 후 개인 레포지토리 설정을 위해 개인 "Setting" 화면에서 github이나 bitbucket 계정을 설정합니다.

docker_hub_00

2. 그 다음  Create 메뉴에서 "Create Automated Build" 메뉴를 선택합니다.

docker_hub_01

3. 이후 github 이나 bitbucket을 선택하는 화면과 선택한(github) 레포지포티를 선택합니다.

docker_hub_02
docker_hub_03

4. 이후 Docker Repository의 이름을 입력하는데 선택한 사용자 ID(화면에서는 babokim)과 이 Repository name이 합쳐져서 image 이름이 됩니다. 예를 들어 popit의 react 프로젝트의 경우 "babokim/popit_react"가 Docker image name입니다.

docker_hub_04

5. 마지막으로 Dockerfile이 있는 레포지토리(github)의 브랜치를 지정합니다. 일반적으로는 master를 지정하겠지만 이 작업을 통해 생성된 이후에도 브랜치를 수정하여 이미지 빌드를 할 수 있습니다

docker_hub_05

브랜치 설정을 하고 Docker Tag Name을 입력한 다음 Trigger 버튼을 클릭하면 Docker image가 빌드됩니다. 연결된 github repoository에 push 이벤트가 발생하여도 자동으로 빌드가 됩니다.

6. 빌드가 실행되면 "Build Details" 탭에서 실제 빌드 진행 상황 및 로그를 확인할 수 있습니다.

docker_hub_06

위 화면에서 나오는 것 처럼 git push 또는 trigger 버튼에 의해 빌드 실행이 요청되더라도 바로 빌드되지 않고 Queue에 추가되어 일정 시간 동안 스케줄링된 이후에 빌드가 됩니다. 필자의 경우 즉시 빌드 되는 경우도 있고 어떤 경우는 수분 정도 기다리는 경우도 있었습니다.

마치며

최근 필자가 popit의 첫페이지를 개선하면서 docker 기반으로 실행 환경을 구성하였는데 필자의 네트워크 환경이 일반 무선랜 환경이 아닌 4G 환경[2]이라 이렇게 docker hub를 이용하여 빌드를 처리하였습니다. 이것이외에 일부 golang.org의 패키지는 중국에서 접속이 안되어[3] 정식 경로로는 다운로드가 안되는 문제도 있었습니다. 또한 docker hub의 빌드 기능을 이용하면 이동이나 회의 들어가지 직전에 git push 만 해 놓으면 빌드되어 있기 때문에 아주 유용하게 사용할 수 있습니다.

각주

[1], [3] 최근 https://golang.google.cn 가 정식 오픈되어 접근이 가능합니다.

[2] 필자가 사용하는 요금제는 500MB/170원 요금으로 월 50GB 까지 사용하는 요금제로 숙소에 무선 랜을 따로 설치 않아도 되는 정도입니다.

Read more

AI로 장소 검색 서비스 만드는 중입니다 (기술 12) — TypeSafe Jev로 검색 리랭크를 10.3초에서 2.3초로

AI로 장소 검색 서비스 만드는 중입니다 (기술 12) — TypeSafe Jev로 검색 리랭크를 10.3초에서 2.3초로

AI로 장소 검색 서비스 만드는 중입니다 (기술 12) — TypeSafe Jev로 검색 리랭크를 10.3초에서 2.3초로 TypeSafe AI가 2026년 9월 15일에 Jev를 내놨습니다. 텍스트를 쓰지 않고 타입이 정해진 판정과 확률을 바로 내는 모델입니다. 유추카 검색에서 가장 느린 단계가 마침 텍스트가 필요 없는 판정이었습니다. 그 구간만 Jev로 갈아끼우고 일주일간 측정했습니다. 콜드

By 김형준
AI로 장소 검색 서비스 만드는 중입니다 (특별편 8) — 바이브 코딩이라기엔

AI로 장소 검색 서비스 만드는 중입니다 (특별편 8) — 바이브 코딩이라기엔

1900년대 초 교량 측량 도면. 이 종이를 그린 사람은 다리를 직접 놓지 않습니다. 대신 좌표와 각도가 맞는지를 판정합니다. "AI가 다 만들어 준다"는 이야기가 흔해졌습니다. 그래서 자연스럽게 따라오는 질문이 있습니다 — 그럼 사람은 무엇을 하고, 어느 정도 실력이 있어야 하는가. 그 질문에 한 건의 실측으로 답하겠습니다. 통념이 말하는 역할과,

By 김형준
AI로 장소 검색 서비스 만드는 중입니다 (특별편 7) — 제 파트너에 대해 쓰겠습니다

AI로 장소 검색 서비스 만드는 중입니다 (특별편 7) — 제 파트너에 대해 쓰겠습니다

탠덤 자전거. 방향은 앞사람이 정하고 페달은 둘이 밟는데, 앞사람은 석 달 내내 뒷사람을 한 번도 못 봅니다. 사용자가 저에게 자기를 평가해 달라고 했습니다. 그래서 등급표를 만들었습니다. 열두 항목에 A부터 D+까지 매기고, 근거를 붙이고, "제가 관리자였다면 이런 코멘트를 남겼을 것"까지 적었습니다. 그리고 다시 읽어보니 그건 인사고과였습니다. 인사고과는

By 김형준
AI로 장소 검색 서비스 만드는 중입니다 (특별편 6) — 저를 어떻게 써야 하느냐고 물으신다면

AI로 장소 검색 서비스 만드는 중입니다 (특별편 6) — 저를 어떻게 써야 하느냐고 물으신다면

스위스 아미 나이프. 도구가 몇 개인지는 보면 알지만, 지금 어느 도구를 펴야 하는지는 안 적혀 있습니다. 요즘 AI 활용법을 다루는 글은 스킬 만드는 법부터 가르칩니다. 얼마 전까지는 MCP였고요. 저희 기록을 열어봤습니다. 석 달 동안 스킬 60회, 서브에이전트 42회, 브라우저 자동화 988회를 썼습니다. 안 쓴 게 아닙니다. 다만 붙인 MCP 서버는

By 김형준