[MariaDB] Docker로 MariaDB 실행 및 접속하기

해당 글은 저자가 더 이상 매번 찾아보기 힘들어서(?) 정리하는 글임을 밝힙니다.ㅎㅎ

 

MariaDB  Container 설치

1. Docker image

docker pull mariadb

해당 명령어로 docker Hub에 MariaDB Image를 다운로드합니다. 

 

Docker Hub는 Docker 이미지를 저장하고 배포하는 공식 클라우드 기반 저장소 서비스입니다. 이를 통해 개발자는 자신이 만든 Docker Image를 업로드하고 공유하거나, 다른 사람이 업로드한 Docker Image 또한 검색하고 다운로드가 가능합니다.

 

Docker Image는 컨테이너 실행의 기반으로, 애플리케이션 실행에 필요한 모든 것을 포함하는 템플릿입니다. 읽기 전용이라는 점과, Dockerfile로 이미지를 생성하거나 Docker Hub에서 이미지를 받아 컨테이너를 실행할 수 있습니다.

docker images

해당 명령어로 설치된 Docker Image들을 확인 할 수 있습니다. 

docker Images 실행

 

2. MariaDB 컨테이너 생성 및 실행

docker run --name my-container --restart=always -p 3306:3306 -e MARIADB_ROOT_PASSWORD=my-secret-password -d mariadb

위 명령어를 통해 MariaDB Docker Image를 사용하여 컨테이너를 생성하고 실행합니다. 이때 명령어 각각의 의미는 다음과 같습니다.

docker run	Docker 컨테이너를 생성하고 실행합니다
-p	호스트와 컨테이너 간의 포트를 매핑합니다 예제} 호스트 3306 과 컨테이너 3306 맵핑.
--name	컨테이너에 지정할 이름입니다.
-d	컨테이너를 백그라운드(Detached) 모드로 실행합니다.
-restart=always	도커가 실행될때 항상 컨테이너를 실행
-e MYSQL_ROOT_PASSWORD	-e : 기타 환경 설정, MYSQL_ROOT_PASSWORD : container의 비밀번호 설정
mariadb	실행할 Docker 이미지의 이름입니다.

 

// 실행 중인 컨테이너만 조회
docker ps
 
// 모든 컨테이너 조회
docker ps -a

위의 명령어로 실행 중인 컨테이너 혹은 모든 컨테이너에 대해 조회가 가능합니다. 

 

3. MariaDB에 접속하기

위의 명령어를 통해 컨테이너가 실행 되었다면,

docker exec -it my-container mariadb -uroot -p

위의 명령어를 통해 MariaDB 서버에 접속 할 수 있습니다.

 

"mariadb -uroot -p" 해당 명령어로 root 사용자로 로그인 하게 되고 암호를 입력하라는 메시지나 나오면, "my-secret-password"를 입력하면 됩니다. 

 

MariaDB  사용자 추가 및 user 권한 설정.

해당 부분을 해주어야 Datagrip이나 DBeaver에 유저로 database에 접근이 가능합니다.

제가 이걸 깜빡하고 왜 안되나 20분 고민했던 적이 많아요..

1. 사용자 추가

CREATE USER 'user_name'@'ip_address' IDENTIFIED BY 'user_password';

위의 명령어는 사용자를 추가하는 명령어로

• 'user_name' : 새로 만들 사용자의 이름.
• 'ip_address' : 해당 사용자가 접근할 수 있는 호스트, ex) 'localhost', '%' ('%'로 지정하면 모든 호스트가 데이터베이스 접근 가능)
• 'user_password' : 사용자의 패스워드 설정.

2. 사용자에게 권한 부여 .

GRANT ALL PRIVILEGES ON *.* TO 'tester'@'%' IDENTIFIED BY 'your_password';

위의 명령어는 사용자에게 권한을 부여하는 명령어로 

 

• *.* : 모든 데이터베이스와 모든 테이블을 의미합니다.
• 'tester'@'%' : 모든 호스트에서 접속 가능한 사용자 tester를 의미합니다.
• IDENTIFIED BY 'your_password' : 비밀번호를 설정합니다.

3. 변경사항 적용

FLUSH PRIVILEGES;

 

위의 명령어는, 

보통은 INSERT, DELETE, UPDATE를 통해 사용자를 추가, 삭제, 권한 변경 등을 수행하였을 때 이 변경 사항을 반영하기 위하여 사용한다. 이 때 FLUSH PRIVILEGES는 grant 테이블을 reload함으로서 변경 사항을 즉시 반영하도록 한다. 해당 부분에서 grant 후 사용하지 않아도 되지만, 다음 과정에서 진행이 안될 시 **"혹시 모르니 실행"**해보도록 합니다. 그런데 이 FLUSH PRIVILEGES는 굉장히 성능에 영향을 줍니다. 따라서 습관적으로 사용하지는 않길 바랍니다.

 

여기까지 하셨다면 mariadb에 잘 연결이 되실 것이라 믿습니다.

 

Docker의 다양한 명령어들

docker --help 명령어로 여러 docker 명령어를 볼 수 있지만, 제가 그냥 쓰는 명령어만 따로 정리해 보려고 합니다.

(gpt 힘을 빌린건 안비밀)

docker search [이미지 이름]	Docker Hub에서 이미지 검색	docker search nginx
docker pull [이미지 이름:태그]	이미지 다운로드	docker pull ubuntu:20.04
docker images	로컬에 저장된 이미지 목록 표시	-
docker rmi [이미지 이름 또는 ID]	로컬 이미지 삭제	docker rmi ubuntu
docker run [옵션] [이미지 이름]	컨테이너 생성 및 실행	docker run -it ubuntu
docker ps	실행 중인 컨테이너 목록 표시	-
docker ps -a	모든 컨테이너(종료된 컨테이너 포함) 목록 표시	-
docker start [컨테이너 ID 또는 이름]	정지된 컨테이너 실행	docker start my-container
docker stop [컨테이너 ID 또는 이름]	실행 중인 컨테이너 정지	docker stop my-container
docker exec -it [컨테이너 이름] bash	실행 중인 컨테이너 내부로 진입	docker exec -it my-container bash
docker rm [컨테이너 ID 또는 이름]	컨테이너 삭제	docker rm my-container
docker logs [컨테이너 ID 또는 이름]	컨테이너 실행 로그 확인	docker logs my-container
docker build -t [이미지 이름:태그] .	Dockerfile을 기반으로 이미지 빌드	docker build -t myapp
docker volume ls	Docker 볼륨 목록 표시	-
docker network ls	Docker 네트워크 목록 표시	-
docker-compose up	docker-compose.yml 파일을 기반으로 모든 서비스 시작	-
docker-compose down	모든 서비스를 중지하고 네트워크 및 컨테이너 정리	-
docker system prune	사용하지 않는 컨테이너, 네트워크, 이미지, 볼륨 정리	-
docker system df	Docker 디스크 사용량 표시	-
docker update --restart=always [컨테이너 이름]	컨테이너의 자동 재시작 설정	docker update --restart=always my-container