지난 강의에서는 OpenMediaVault(OMV)에 도커(Docker)와 포테이너(Portainer)를 설치하는 방법까지 알아보았습니다. 이번에는 도커를 활용하여 다양한 서비스를 운영하기 위한 기초 작업으로, 데이터베이스인 MariaDB와 이를 웹에서 관리할 수 있는 도구인 phpMyAdmin을 설치해 보려고 합니다. 이 과정을 통해 데이터를 한데 모아 효율적으로 관리할 수 있습니다.
오늘 포스팅에서는 Portainer의 기본적인 활용 방법과 데이터베이스 설치 과정을 자세히 설명해 드리겠습니다. 향후 Nextcloud나 WordPress와 같은 서비스를 구축하기 위해 반드시 필요한 과정이므로, 이번 내용을 꼭 숙지하시기 바랍니다.
분량이 많은 관계로 오늘은 MariaDB 설치 과정까지 다루고, phpMyAdmin 설치는 다음 포스팅에서 이어가도록 하겠습니다.
혹시 아직 도커와 Portainer가 설치되지 않은 분들은 아래의 이전 가이드를 먼저 참고해 주세요.
1. 도커에서 사용할 가상 네트워크 만들어 주기
가장 먼저 도커에서 사용할 가상 네트워크를 생성해야 합니다. 이는 각 컨테이너에 고정 IP를 수동으로 할당하기 위함이며, 이를 통해 나중에 컨테이너 재시작 시 IP가 변경되어 연결이 끊기는 문제를 방지할 수 있습니다.
Portainer에 접속한 후 ‘Local’ 환경을 클릭하여 관리 화면으로 진입합니다.
좌측 사이드바에서 “Networks” 탭을 선택한 뒤, 상단의 “Add network” 버튼을 눌러 새로운 네트워크 설정을 시작합니다.
이름은 자유롭게 정하시고(예: my_bridge), 아래 IPv4 설정 섹션에 서브넷(Subnet)과 게이트웨이(Gateway)를 입력합니다. 설정이 완료되면 아래의 파란색 버튼을 눌러 저장합니다.
2. MariaDB 설치하기
이제 MariaDB를 설치해 보겠습니다. “Images” 탭으로 이동하여 “Pull Image” 입력란에 ‘mariadb’를 입력하고 버튼을 클릭해 이미지를 다운로드합니다.
이미지 리스트에서 방금 받은 MariaDB를 클릭하면 상세 정보를 볼 수 있습니다. 이곳에서 컨테이너 생성 시 필요한 포트 정보나 볼륨 경로 등을 미리 확인할 수 있습니다.
컨테이너가 삭제되어도 데이터가 유지되도록 볼륨을 생성해야 합니다. “Volumes” 탭에서 “Create Volume”을 누르고 이름(예: mariadb_config)을 입력하여 생성합니다.
“Containers” 탭에서 “Add container”를 클릭합니다. 이름은 ‘mariadb’로 정하고, Image 항목에 “mariadb:latest”를 입력합니다.
하단 “Advanced container settings”의 “Volumes” 탭에서 매핑을 추가합니다. 컨테이너 내부 경로인 “/var/lib/mysql”을 방금 생성한 “mariadb_config” 볼륨에 연결합니다.
“Network” 탭에서 앞서 만든 가상 네트워크를 선택하고, IPv4 Address 항목에 원하는 고정 IP(예: 172.20.0.10)를 입력합니다.
“Env” 탭에서 환경 변수를 추가합니다. MYSQL_ROOT_PASSWORD 변수에는 관리자 비밀번호를, TZ 변수에는 시간대(Asia/Seoul)를 입력합니다. 비밀번호는 보안을 위해 복잡하게 설정해 주세요.
“Restart policy” 탭에서 “Always”를 선택합니다. 이렇게 하면 서버가 재부팅되거나 비정상적으로 종료되었을 때 자동으로 데이터베이스가 다시 실행됩니다. 모든 설정이 끝났다면 “Deploy the container” 버튼을 클릭합니다.
3. MariaDB 제대로 작동하는지 확인하기
설치가 완료되면 컨테이너 리스트에서 MariaDB가 ‘Running’ 상태인 것을 확인할 수 있습니다. 이제 제대로 동작하는지 콘솔을 통해 확인해 보겠습니다.
컨테이너 이름 옆의 콘솔 아이콘을 누르고 “Connect”를 클릭하여 터미널 창으로 진입합니다.
아래 명령어를 입력하여 데이터베이스에 접속합니다.
mysql -u root -p
비밀번호를 입력한 뒤 접속이 되면 아래 명령어로 데이터베이스 목록을 확인해 봅니다.
show databases;
명령어가 정상적으로 수행되고 목록이 나타난다면 모든 설치 과정이 완벽하게 완료된 것입니다.
오늘은 Portainer의 기본 사용법과 MariaDB 설치 방법을 알아보았습니다. 다음 시간에는 오늘 설치한 데이터베이스를 웹에서 마우스 클릭만으로 간편하게 관리할 수 있게 해주는 phpMyAdmin 설치 방법을 설명해 드리겠습니다.
콘솔 환경이 낯선 초보자분들에게는 phpMyAdmin이 훨씬 직관적이고 편리한 도구가 될 것입니다. 긴 글 읽어주셔서 감사합니다.
다른 글 읽기
이 글의 저작권은 전적으로 작성자인 P_Emblem에게 있으며 허락 없는 사용을 금합니다.