포스트

도커(Docker) 백엔드 서버와 MySQL 3306 포트 연결

게시 업데이트
By Chang-Seong Kim 15 분읽는 시간

Docker 개발 환경 이해 및 활용

  • Tool :
    Docker Git Bash PowerShell


🔔 Introduction

📌 Docker 소개

  • 도커는 애플리케이션을 컨테이너화하여 관리하는 플랫폼입니다.
  • 컨테이너에는 애플리케이션 실행에 필요한 코드, 라이브러리, 의존성 등이 포함됩니다.

📌 Docker 목적

  • 도커는 애플리케이션 실행 환경을 격리시켜 관리할 수 있습니다.
  • 도커를 구성하는 컨테이너들은 서로 분리되어 있습니다.
  • 그래서 애플리케이션 개발 환경끼리의 충돌을 방지하고 보안을 강화할 수 있습니다.
  • 게다가 도커 이미지를 사용하면 애플리케이션을 빠르게 구성하고 복제할 수 있습니다.


🔔 Docker 링크 모음

📌 Docker 다운로드 페이지

  • 도커 홈페이지에 접속해서 사용자 OS에 맞는 데스크톱 애플리케이션을 설치하시면 됩니다.
  • 설치가 완료되면 Git Bash 등에 docker -v를 입력하여 설치 상태를 확인해야 됩니다.
  • 도커 설치 페이지(링크)

📌 Docker 컴포즈 페이지

📌 Docker 허브 페이지


🔔 Docker 이미지 다운로드 과정

📌 Docker 초기 화면 구성

  • 도커를 다운로드 받으신 후 실행시키신 초기 Containers 화면 구성은 아래와 같습니다.
figure
초기 Docker Containers

📌 MySQL 이미지 다운로드

  • 도커 허브를 통해 알게 된 MySQL 이미지 다운로드 관련 명령문을 입력하면 됩니다.
  • 필자는 아래와 같은 코드 입력하고 MySQL 이미지를 다운로드 받았습니다.
1

docker pull mysql:latest
  • 이미지 다운로드 과정에서는 ‘Pull complete’ 등의 다양한 내용이 출력됩니다.
  • 이후 이미지 다운로드에 성공하면 아래와 같은 메시지가 출력됩니다.
1
2
3
4
5
6
7
8
9

$ docker pull mysql:latest

latest: Pulling from library/mysql
Digest: sha256:ff5ab9cdce0b4c59704b4e2a09deed5ab8467be795e0ea20228b8528f53fcf82
Status: Image is up to date for mysql:latest
docker.io/library/mysql:latest

What's Next?
  View a summary of image vulnerabilities and recommendations → docker scout quickview mysql:latest
  • 이미지 다운로드가 완료된 도커 Images 화면 구성 이미지 내용이 아래와 같이 변경됩니다.
figure
변경된 Docker Images


🔔 MySQL 컨테이너 생성 및 실행

📌 에러 발생

  • 이제 MySQL 관련 도커 컨테이너를 생성 및 실행하기 위해 아래 명령문을 입력하였습니다.
1

docker run --name mysql-hello-container -e MYSQL_ROOT_PASSWORD=0000 -d -p 3306:3306 mysql:latest
  • 그런데 아래와 같은 메시지가 출력되었습니다.
1
2
3
4

$ docker run --name mysql-hello-container -e MYSQL_ROOT_PASSWORD=0000 -d -p 3306:3306 mysql:latest

4f54bbf9519fce194faf7864fa8e02e519ab6cb3596c197e402e3003185c7f33
docker: Error response from daemon: Ports are not available: exposing port TCP 0.0.0.0:3306 -> 0.0.0.0:0: listen tcp 0.0.0.0:3306: bind: Only one usage of each socket address (protocol/network address/port) is normally permitted.
  • 해당 메시지의 내용은 TCP 포트 3306은 이미 다른 서비스가 사용중이라는 것을 의미합니다.
  • 그래서 포트 바인딩에 실패했다는 내용이 작성되어 있습니다.
  • 이를 해결하기 위해서는 현재 실행중인 도커 컨테이너 목록을 출력해 볼 필요가 있습니다.
  • 도커 컨테이너 목록 출력을 위한 아래 명령문을 입력하였습니다.
1

docker ps -a
  • 출력문의 내용에서 STATUS=”Created” 우측의 PORTS 값이 공란인 것을 확인할 수 있습니다.
  • 따라서 해당 컨테이너의 포트 바인딩이 설정되지 않았거나 실패했음을 알 수 있습니다.
1
2
3
4

$ docker ps -a

CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS    PORTS     NAMES
4f54bbf9519f   mysql:latest   "docker-entrypoint.s…"   12 minutes ago   Created             mysql-hello-container


🔔 MySQL 컨테이너 생성 및 실행

📌 에러 해결 방법 1 : 포트 번호 변경 & 컨테이너 삭제

  • 에러를 직면하지 않고 회피하는 방법은 포트 번호를 변경하는 것입니다.
  • 이를 위한 명령문은 아래와 같습니다.
1

docker run --name mysql-hello-container -e MYSQL_ROOT_PASSWORD=0000 -d -p 3307:3306 mysql:latest
  • 에러 상황 회피의 예시로는 컨테이너를 삭제한 후 재생성하는 방법도 있습니다.
  • 이를 위한 명령문은 아래와 같습니다.
1

docker rm mysql-hello-container

📌 에러 해결 방법 2 : 동일 포트 사용중인 프로세스 종료

  • 하지만 위와 같이 에러 회피를 위한 명령문만 입력하면 개발자로서의 성장은 없다고 사료됩니다.
  • 그래서 에러를 정통적으로 해결하기 위한 방법을 말씀드리겠습니다.
  • 사용자의 운영체제에서 3306 포트를 사용하고 있는 프로세스의 ID를 추적하겠습니다.
  • Windows의 PowerShell에서 아래 명령문을 입력하겠습니다.
  • 참고로 아래 명령문을 복사하고 PowerShell에서 마우스 우클릭 한 번만 하시면 붙여넣기 됩니다.
1

netstat -ano | findstr :3306
  • 명령문으로 출력된 내용은 아래와 같습니다.
  • TCP 0.0.0.0:3306은 모든 IPv4 주소에서 3306 포트를 사용하고 있다는 것을 의미합니다.
  • LISTENING은 3306 포트에서 네트워크 요청을 대기중이라는 의미입니다.
  • 7196은 7196이라는 PID (Process ID)의 프로세스가 3306 포트를 사용중이라는 의미입니다.
1
2
3
4

TCP    0.0.0.0:3306           0.0.0.0:0              LISTENING       7196
TCP    0.0.0.0:33060          0.0.0.0:0              LISTENING       7196
TCP    [::]:3306              [::]:0                 LISTENING       7196
TCP    [::]:33060             [::]:0                 LISTENING       7196
  • 이제 3306 포트를 사용중인 7196 프로세스를 종료해보겠습니다.
  • ‘작업 관리자’의 ‘자세히’ 항목에서 실행중인 PID를 검색할 수 있습니다.
  • 키패드에서 Ctrl + Shift + Delete를 동시에 누르시면 ‘작업 관리자’를 찾으실 수 있습니다.
  • ‘작업 관리자’의 ‘자세히’ 항목에서 ‘PID’ 탭을 클릭하시면 오름차순으로 정렬됩니다.
  • 7196 프로세스의 주인공은 mysqld.exe였습니다.
  • 참고로 필자의 개발 운영체제는 Windows 11입니다.
figure
작업 관리자의 PID 탭
  • 7196 프로세스를 마우스 우측 버튼을 클릭하여 ‘작업 끝내기’하였습니다.
  • PowerShell에 입력했던 아래 명령문을 다시 입력하니 아무것도 출력되지 않았습니다.
1

netstat -ano | findstr :3306

📌 MySQL 컨테이너 생성 및 실행(재시도)

  • 다시 도커로 돌아와서, Git Bash에 아래 명령문을 입력하겠습니다.
1

docker run --name mysql-hello-container -e MYSQL_ROOT_PASSWORD=0000 -d -p 3306:3306 mysql:latest
  • 도커에 mysql-hello-container가 이미 생성되었다는 아래 명령문이 출력되었습니다.
1
2
3
4

$ docker run --name mysql-hello-container -e MYSQL_ROOT_PASSWORD=0000 -d -p 3306:3306 mysql:latest

docker: Error response from daemon: Conflict. The container name "/mysql-hello-container" is already in use by container "4f54bbf9519fce194faf7864fa8e02e519ab6cb3596c197e402e3003185c7f33". You have to remove (or rename) that container to be able to reuse that name.
See 'docker run --help'.
  • 도커 데시크톱 어플리케이션에서 이미 생성된 mysql-hello-container를 제거하겠습니다.
figure
Delete Container

📌 MySQL 컨테이너 생성 및 실행(성공)

  • 다시, Git Bash에 아래 명령문을 입력하겠습니다.
1

docker run --name mysql-hello-container -e MYSQL_ROOT_PASSWORD=0000 -d -p 3306:3306 mysql:latest
  • 드디어, 성공적으로 MySQL 도커 컨테이너를 생성하였다는 내용이 출력되었습니다.
1
2
3

$ docker run --name mysql-hello-container -e MYSQL_ROOT_PASSWORD=0000 -d -p 3306:3306 mysql:latest

1cf6103fa964839f0b8a15c2a817ab13e524fa012cf7c5e5ee436147b1b09dd7
  • 정상적인 도커 컨테이너 아이콘의 색상은 주황색이 아니라 아래와 같은 녹색입니다.
  • 그리고 정상적인 도커 컨테이너는 CPU 용량을 차지합니다.
  • 상기 정상적이지 않은 도커 컨테이너 이미지를 확인하시면 CPU란이 N/A로 표기되어 있습니다.
figure
Complete Created Container
  • 마지막으로, 도커 컨테이너 목록을 출력하겠습니다.
1

docker ps -a
  • 성공적인 도커 컨테이너 생성 및 실행 결과는 아래와 같습니다.
1
2
3
4

$ docker ps -a

CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS         PORTS                               NAMES
1cf6103fa964   mysql:latest   "docker-entrypoint.s…"   6 minutes ago   Up 6 minutes   0.0.0.0:3306->3306/tcp, 33060/tcp   mysql-hello-container


🔔 Docker 백엔드 서버 활용

📌 MySQL 컨테이너 접속

  • 이제 도커 컨테이너에 접속해보겠습니다.
1

docker exec -it mysql-hello-container bash
  • 그런데 접속해 실패하였고 아래와 같은 내용이 출력되었습니다.
1
2
3

$ docker exec -it mysql-hello-container bash

the input device is not a TTY.  If you are using mintty, try prefixing the command with 'winpty'
  • 이 내용은 Git Bash가 TTY (텔레타이프)를 지원하지 않는다는 내용입니다.
  • 해결 방법은 간단하며 아래와 같이 명령문 앞에 winpty를 추가 입력하면 됩니다.
1

winpty docker exec -it mysql-hello-container bash
  • 도커 컨테이너에 잘 접속되면 아래와 같은 내용이 출력됩니다.
1
2
3

$ winpty docker exec -it mysql-hello-container bash

bash-4.4#

📌 MySQL 연동

  • 다음으로 MySQL에 접속하여 연동해보겠습니다.
  • 접속 방법은 출력된 bash-4.4# 우측에 명령문을 입력하시면 됩니다.
1

bash-4.4# mysql -u root -p
  • 명령문 중 ‘-p’는 패스워드를 입력한다는 내용입니다.
  • 출력된 Enter password:에 방금 생성한 컨테이너의 비밀번호를 입력해주시면 됩니다.
  • 이때 비밀번호를 타이핑해도 아무런 글자가 보이지 않지만 실제로는 잘 입력됩니다.
  • 비밀번호를 잘 입력하면 아래 이미지 내용과 같은 출력문을 확인하실 수 있습니다.
figure
Connected MySQL Container

📌 3306 포트 사용 현황

  • 마지막으로, 에러 해결을 위해 필요했던 PowerShell에 동일 명령문을 재차 입력해보겠습니다.
  • 말씀드렸듯이 PowerShell 사용 목적은 3306 포트 현황을 조회하는 것입니다.
1

netstat -ano | findstr :3306
  • 명령문 입력 결과, 아래와 같은 내용이 출력되었습니다. TCP 0.0.0.0:3306 0.0.0.0:0 LISTENING 11028 TCP [::]:3306 [::]:0 LISTENING 11028 TCP [::1]:3306 [::]:0 LISTENING 30576
  • 작업 관리자에서 PID를 조회한 결과, 도커 백엔드에 잘 연결된 것을 확인할 수 있었습니다.
  • 아래 이미지는 3306 포트 현황에 대한 것입니다.
figure
Port 3306 Status




4. Hobby Project, Development Tool
Fundamental Docker Backend Port Server MySQL
이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.
<>