study.

이름으로 연결하는 컨테이너 네트워크 · Docker

호스트 포트를 공개하지 않고 두 컨테이너를 연결해봅니다.

← Docker

진도·퀴즈와 함께 학습하기

먼저, 개념을 잡아볼게요.

사용자 정의 bridge

같은 사용자 정의 bridge 네트워크의 컨테이너는 이름으로 서로를 찾을 수 있습니다. 기본 bridge와 이름 해석 동작이 다릅니다.

내부 연결과 포트 공개

같은 네트워크에서 서버의 컨테이너 포트로 접근할 때 -p는 필요하지 않습니다. -p는 호스트 쪽 접근 경로를 만드는 별도 설정입니다.

연결 실패 분리

이름이 해석되는지와 서버가 해당 포트에서 응답하는지를 따로 확인합니다. 네트워크가 다르거나 서버가 아직 준비되지 않았다면 요청이 실패할 수 있습니다.

왜 필요한가요?

같은 사용자 정의 bridge에 연결된 컨테이너는 이름으로 서로 찾을 수 있습니다. 컨테이너 안의 localhost는 기본적으로 그 컨테이너 자신이므로 다른 서버의 주소가 아닙니다.

차례대로 이해하기

내부 통신 경로

클라이언트와 서버가 같은 네트워크에 속하는지 inspect로 확인합니다. 요청은 서버 이름과 컨테이너 포트로 보냅니다. 호스트에 공개한 포트는 호스트 쪽 진입점입니다.

증상을 순서대로 좁히기

이름 해석 실패면 네트워크 소속과 이름을, 연결 거부면 대상 포트와 리스너를 확인합니다. HTTP 오류 응답이 오면 네트워크 연결 후 애플리케이션 단계까지 도달했을 가능성을 고려합니다.

직접 실행하며 익혀보세요.

Docker Engine 또는 Docker Desktop(Linux 컨테이너), Compose v2, POSIX 셸과 curl이 필요합니다. 개인 실습 호스트에서 실행하고 study- 접두사의 리소스만 정리하세요. 이미지 다운로드에 네트워크가 필요합니다.

study-net에 nginx 서버를 만들고 같은 네트워크의 BusyBox 클라이언트에서 서버 이름으로 요청하세요. 첫 요청이 너무 빠르면 잠시 후 다시 실행합니다.

docker network create study-net
docker run -d --name study-net-web --network study-net nginx:stable-alpine
docker run --rm --network study-net busybox:1.36 wget -qO- http://study-net-web:80
docker network inspect study-net

이렇게 확인하세요

HTML 응답이 보이면 이름 해석과 HTTP 연결이 모두 성공한 것입니다. inspect의 Containers 항목에서 서버가 이 네트워크에 연결됐는지 확인하세요. 호스트 -p 없이 성공한 이유를 메모합니다.

실습 리소스 정리

결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.

docker stop study-net-web
docker rm study-net-web
docker network rm study-net

응용해보기

서버는 컨테이너의 80 포트를 호스트 8080으로 공개했습니다. 같은 bridge의 클라이언트는 어느 포트로 서버에 요청할까요?

생각해본 뒤 풀이 보기

서버 컨테이너 이름의 80 포트를 사용합니다. 호스트 8080은 호스트 주소로 접근할 때의 매핑입니다. 두 접점을 섞으면 서버가 정상이어도 연결에 실패할 수 있습니다.

잠깐, 이해했는지 확인해볼까요?

같은 사용자 정의 bridge에서 서버로 요청할 때 보통 필요한 주소는?

  1. 서버 컨테이너 이름과 내부 포트
  2. 호스트의 공개 IP만
  3. 이미지 ID
  4. Dockerfile 파일명
생각해본 뒤 풀이 보기

서버 컨테이너 이름과 내부 포트

사용자 정의 bridge는 이름 기반 검색을 지원합니다. 같은 네트워크의 컨테이너끼리는 서버의 내부 포트에 접근합니다.

공식 문서 · 이름으로 연결하는 컨테이너 네트워크