Development/DevOps

docker container에서 localhost 접속하기 host.docker.internal

📝 작성 : 2021.08.21  ⏱ 수정 : 
반응형

docker에서 컨테이너들이 실행 중인 서버를 바라 봐야 할 경우가 있습니다.

Docker Compose를 이용해 여러개의 도커 컨테이너를 실행해서 하나의 어플리케이션을 담당한다고 했을때, 하나의 네트워크로 연결해 사용하게 되는데요. 정작 컨테이너에서 로컬 서버에는 어떻게 접근해야 할까요?

image-20210821144823960

제 맥북에서 사용중인 Docker에는 컨테이너가 아직 PostgreSQL 하나밖에 없어서, 이 컨테이너를 이용해서 시도 해 보겠습니다.

제 컨테이너 같이 DB 서버라면 사실 필요할 일은 없지만, Apache나 NginX 같은 웹 서버의 경우는 흔하게 필요한 상황이 발생 할 수 있겠습니다.

일단 해당 Container로 접속 해 보겠습니다.

GUI환경이라면

image-20210821145005719

위에 보이는 CLI 버튼으로 쉽게 접속 해 터미널을 띄울 수 있습니다.

image-20210821145031263

간단하죠. 그렇다면 이번에는 CLI 환경에서 한번 차근차근 띄워보겠습니다.

1. 터미널을 켭니다

image-20210821145111588

2. 실행중인 Docker 컨테이너 목록

docker ps

명령어로 가동중인 컨테이너들을 볼 수 있습니다. -a 옵션을 붙이면 멈춰있는 컨테이너도 다 표시해줍니다.

image-20210821145225043

그럼 제일 왼쪽에 79..로 시작하는게 해당 컨테이너의 ID 입니다.

그럼 이제 docker exec 명령어를 통해 해당 컨테이너의 STDIN 표준 입출력을 열어 가상 TTY를 통해 접속합니다.

 docker exec -it 79edaba9d6cb /bin/bash

image-20210821145747468

그러면 이제 해당 컨테이너에 접속이 완료 된 상태입니다.

3. cURL 설치

image-20210821145813776

curl 을 이용해 테스트 해 보려 했는데 curl이 없습니다.

apt update

로 업데이트를 한번 해주고

image-20210821145843706

apt install curl

curl을 설치 해 줍니다.

당연히 Y 를 입력해야 설치가 됩니다.

이제 localhost로 curl 명령을 보내 보겠습니다.

curl localhost:8080

image-20210821150042104

Failed to connect to localhost port 8080: Connection refused 가 나오네요..

하지만

image-20210821150118245

저는 분명 localhost에 서버를 하나 띄워 두었습니다.

로컬에서 같은 명령어를 입력 하면

image-20210821150150657

잘 받아오는 것을 확인할 수 있습니다. Docker에서 localhost는 컨테이너 그 자신의 주소기 때문에 이런 문제가 발생 한 것 입니다.

그렇다면 docker container에서 localhost를 어떻게 접근할까?

1. 첫번째로 아주 단순하지만 좋지 않은 방법이 있습니다.

바로 내부 아이피를 이용하는 것 입니다. Windows에서는 ipconfig를, Mac에서는

ipconfig getifaddr en0

를 입력해 간단히 내부아이피 주소를 찾을 수 있습니다.

image-20210821150703240

그 다음 해당 내부아이피 주소를 이용하면 됩니다.

curl 192.168.0.19:8080

image-20210821150740984

물론, 접속이 잘 되지만 이건 좋은 방법이 아닙니다. 내부아이피야 인터넷 사용하는 환경에 따라 매번 달라질 수 있는데 그럴때마다 수정을 할 수도 없고 번거롭습니다.

2. host.docker.internal를 이용합니다.

curl host.docker.internal:8080

image-20210821150858573

아주 간단하죠. 환경에 따라 변할 걱정도 할 필요가 없습니다.

그럼 docker-compose 에서는 ?

docker로 localhost를 바라 볼 상황이야 여러경우 있겠지만 저는 웹서버를 docker에서 띄우고, 나머지 개발중인 여러개의 어플리케이션들은 로컬에서 띄운 상황입니다. docker-compose 에서는 웹 서버인 nginx를 비롯해 데이터베이스나 검색엔진, 세션db, FTP 서버 등 여러가지를 한번에 관리 하고 있는데요.

docker-compose.yml 과 같은 폴더에 있는 conf/nginx.conf 파일의 일부 입니다.

  server {
      listen 80 default;
    server_name localhost;

    # 인증 어플리케이션
    location /auth/ {
      proxy_pass http://host.docker.internal:8081/auth/;
    }

    # 메인 어플리케이션
    location /main/ {
      proxy_pass http://host.docker.internal:8082/main/;
    }
}

이처럼 proxy_pass 에서 로컬에 띄워 둔 어플리케이션을 바라 보기 위해 host.docker.internal:포트번호 를 사용했습니다. Windows 에서 docker를 띄울 때는 상관 없지만 Linux 환경의 docker에서는 docker-compose.yml 에서

nginx:
    extra_hosts:
      - "host.docker.internal:host-gateway"

이런식으로 해당 컨테이너에게 extra_hosts 에 대해 알려 주어야 합니다.

그렇지 않으면 아래의 에러를 뿜어냅니다.

nginx: [emerg] host not found in upstream "host.docker.internal" in /etc/nginx/nginx.conf:77

이상입니다.

반응형