Docker 컨테이너에 MariaDB 설치하기

서론

매번 새로운 DB 컨테이너를 생성할 때마다 검색하면서 찾아보기도 번거롭고, 그렇다고 세팅 주기도 그렇게 짧지 않아 기억도 잘 되지 않아서 이번 기회에 아예 문서화를 하고자 작성하게 되었습니다.

목차

1. Docker 설치
2. MariaDB Container 설치
3. MariaDB 사용자 추가 및 user 권한 설정
4. Dokcer의 다양한 명령어

 

Docker 설치

먼저 Docker가 설치되어 있지 않다면 Docker를 설치해야 합니다. Docker의 설치는 https://www.docker.com/에서 가능합니다.

Docker는 Docker Engine(Daemon)과 Docker CLI(Client)를 Docker라는 용어로 묶어서 사용하는데, 이들은 Docker에서 제공하는 서로 다른 두 가지 구성 요소입니다.

• Docker Engine: Docker의 런타임 부분으로, 데몬 형태로 실행하는 컨테이너 엔진 그 자체
• Docker CLI: 우리가 사용하는 docker 명령어 인터페이스

간단하게 말하면, Docker Engine은 컨테이너를 실행하고 관리하는 역할을 하고, Docker CLI는 사용자가 Docker Engine과 상호작용하는 데 사용하는 인터페이스입니다. 보통 Docker Engine을 설치할 때 Docker CLI도 같이 설치되기 때문에, 우리는 Docker CLI의 존재를 모르고 Docker를 설치했다고 통칭해서 이야기합니다.

 

MariaDB  Container 설치

1. Docker Image 가져오기

docker pull mariadb

위 명령어를 통해 Docker Hub에서 MariaDB Image를 다운로드합니다. 

Docker Image는 실행 가능한 소프트웨어 패키지로, 애플리케이션을 실행하는 데 필요한 코드, 런타임, 시스템 도구, 시스템 라이브러리, 설정 등을 포함한 모든 것을 포함한 파일의 형태입니다.

Docker Hub는 Docker Image를 저장하고 공유할 수 있는 공개 레지스트리 서비스입니다. 모든 사용자는 Docker Hub를 통해 자신이 만든 Docker Image를 업로드하고 공유할 수 있으며, 다른 사람들이 업로드한 Docker Image 또한 검색하고 다운로드할 수 있습니다.

docker images

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

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

docker run -p 3306:3306 --name {컨테이너 이름 작성} -e MARIADB_ROOT_PASSWORD={비밀번호} -d mariadb

ex) docker run -p 3306:3306 --name test -e MARIADB_ROOT_PASSWORD=1234 -d mariadb

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

• -p 3306:3306 : 호스트와 컨테이너 간의 포트를 연결 (host-port:container-port), 호스트에서 3306 포트 연결 시 컨테이너 3306 포트로 포워딩
• --name test : 생성하려는 컨테이너의 이름을 test로 지정
• -e MARIADB_ROOT_PASSWORD=1234 : 컨테이너 내 환경변수 설정. mariadb의 root 사용자의 암호 지정
• -d: 컨테이너를 백그라운드에서 실행

// 실행 중인 컨테이너만 조회
docker ps

// 모든 컨테이너 조회
docker ps -a

위 명령어를 통해 모든 컨테이너 혹은 실행 중인 컨테이너를 조회할 수 있습니다.

3. MariaDB에 접속하기

컨테이너가 성공적으로 실행되면, 이제 아래 명령어를 통해 MariaDB 서버에 접속할 수 있습니다. 

docker exec -it {컨테이너 이름} mariadb -uroot -p

ex) docker exec -it test mariadb -uroot -p

'mysql -uroot -p' 명령어를 통해 MariaDB의 root 사용자로 로그인하게 됩니다. 만약 암호를 입력하라는 메시지가 나타난다면, 이전 단계에서 설정한 root 사용자의 암호를 입력하면 됩니다.

그럼 여기까지 Docker에 MariaDB 설치가 끝났고, 이제 데이터베이스를 생성하고, 테이블을 만들고, 데이터를 추가하거나 조회할 수 있습니다.

 

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

1. 데이터 베이스 생성

create database {db_name};

ex) create database test;

2. 사용자 추가

create user 'user_name'@'ip_address' identified by 'user_password';

ex) create user 'tester'@'%' identified by 'tester1234';
ex) create user 'tester'@'localhost' identified by 'tester1234';

위 명령어에서  뜻하는 각각의 의미는 다음과 같습니다.

• user_name: 새로 생성할 사용자의 이름
• ip_address: 해당 사용자가 접근할 수 있는 호스트, %로 지정하면 모든 호스트에서 데이터베이스에 접근 가능
• user_password: 사용자의 패스워드

3. 사용자에게 권한 부여

grant all privileges on db_name.* to 'user_name'@'ip_address';

ex) grant all privileges on test.* to 'tester'@'%';

위의 명령어는 모든 데이터베이스와 테이블에 대한 모든 권한을 부여합니다.

4. 변경사항 적용

마지막으로 아래 명령어를 통해 사용자의 권한 변경 사항을 즉시 적용하도록 합니다.

flush privileges;

MariaDB와 MySQL은 사용자 권한을 메모리에 캐시 하기에 grant, revoke, set password 등의 명령을 통해 사용자 권한이 변경되더라도 변경사항이 즉시 적용되지 않으며, 변경사항이 적용되려면 권한 캐시가 다시 로드되어야 합니다.

flush privileges; 명령은 권한 캐시를 다시 로드하도록 서버에 지시하므로, 사용자 권한의 변경 사항을 즉시 적용할 수 있습니다. 따라서 사용자 권한을 변경한 후에는 항상 flush privileges; 명령을 실행해야 합니다.

단, 사용자를 추가하는 create user 같은 경우는 자동으로 권한 캐시를 로드하기 때문에 flush privileges;를 실행할 필요가 없습니다.

 

Docker의 다양한 명령어들

docker --help 명령어를 통해 사용 가능한 모든 Docker 명령어를 확인할 수 있으며, 주로 사용되는 명령어들은 다음과 같습니다.

• docker run: Docker 이미지를 기반으로 새로운 컨테이너를 생성하고 실행합니다. 예를 들어, `docker run ubuntu` 명령은 ubuntu 이미지를 기반으로 새로운 컨테이너를 실행합니다.
• docker ps: 현재 실행 중인 모든 Docker 컨테이너를 나열합니다. `-a` 옵션을 추가하면 (`docker ps -a`), 실행 중이지 않은 컨테이너도 포함하여 모든 컨테이너를 나열합니다.
• docker stop [container_id]: 실행 중인 Docker 컨테이너를 중지합니다. `container_id`는 중지하려는 컨테이너의 ID를 지정합니다. 이 ID는 `docker ps` 명령의 출력에서 확인할 수 있습니다.
• docker start [container_id]: 중지된 Docker 컨테이너를 다시 시작합니다. 이 명령에는 컨테이너 ID가 필요합니다.
• docker restart [container_id]: Docker 컨테이너를 재시작합니다. 이 명령에는 컨테이너 ID가 필요합니다.
• docker rm [container_id]: Docker 컨테이너를 제거합니다. 이 명령에는 컨테이너 ID가 필요하며, 해당 컨테이너는 더 이상 실행 중이지 않아야 합니다.
• docker pull [image_name]: Docker 이미지를 Docker Hub 또는 다른 Docker 레지스트리에서 로컬 시스템으로 다운로드합니다.
• docker rmi [image_id]: 로컬 Docker 시스템에서 Docker 이미지를 제거합니다.
• docker logs [container_id]: Docker 컨테이너의 로그를 출력합니다.
• docker exec: 실행 중인 컨테이너에서 명령을 실행합니다. 예를 들어, `docker exec -it [container_id] bash` 명령은 실행 중인 컨테이너에서 bash 쉘을 시작합니다.

 

같이 보면 좋은 글

[MySQL] 사용자 생성 및 권한 부여 방법