모두의 지식 저장고

[Podman] MariaDB Docker Compose 설치 방법

최근 리눅스 환경(특히 RHEL, Rocky, 최신 Ubuntu 등)에서 Docker 대신 Podman을 사용하여 컨테이너를 관리하는 경우가 많아졌습니다. Podman은 데몬 없이 작동하고 Rootless(관리자 권한 없이 실행) 모드를 지원하여 보안상 이점이 크지만, Docker와 미세하게 다른 설정 때문에 당황스러운 에러를 겪기도 합니다.

오늘은 docker-compose.yml을 이용해 MariaDB를 설치하는 과정에 대해 공유 합니다. 

1. docker-compose.yml 작성

먼저 MariaDB 11.3 버전을 설치하기 위해 구성 파일을 작성합니다. Podman 환경이라도 파일명은 docker-compose.yml을 그대로 사용하면 podman-compose 명령어가 자동으로 인식합니다.

파일명: docker-compose.yml

version: "3.8"

services:
  mariadb:
    image: docker.io/library/mariadb:11.3
    container_name: mariadb
    restart: always
    ports:
      - "3306:3306"
    environment:
      MARIADB_ROOT_PASSWORD: rootpassword
      MARIADB_DATABASE: mydb
      MARIADB_USER: myuser
      MARIADB_PASSWORD: mypassword
    volumes:
      - mariadb_data:/var/lib/mysql
    command:
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci

volumes:
  mariadb_data:

Mariadb 실행 

#설치 및 기동 
podman  compose up 

#background 실행 
podman  compose up -d 

#Mariadb 기동 상태 확인 
podman  compose ps 

#종료
podman  compose down​

Mariadb 접속 

podman exec -it mariadb mariadb -u root -p
# Password 입력 프롬프트가 뜨면 설정한 비밀번호(rootpassword) 입력
# docker-compose.yml 에 작성된 비밀번호를 입력한다.

실습

# 1.'mariadb'는 접속 :  docker-compose에서 정한 컨테이너 이름입니다.
podman exec -it mariadb mariadb -u root -p

# 2. docker-compose 설정 파일에서 만든 mydb 데이터베이스로 이동
USE mydb;

#3. 테이블 생성 
CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    email VARCHAR(100)
);

#4. 데이터 입력 (한글 테스트)
INSERT INTO users (username, email) VALUES ('홍길동', 'hong@test.com');
INSERT INTO users (username, email) VALUES ('Alice', 'alice@test.com');

#5. 데이터 조회
SELECT * FROM users;

DBeaver 연결 설정 방법 

문제발생 해결 방법

작성한 파일을 실행하기 위해 터미널에 podman-compose up -d를 입력했는데, 컨테이너가 뜨지 않고 아래와 같은 에러 로그가 출력이 됨.

[에러 메시지] Error: unable to start container ... : did not receive systemd slice as cgroup parent when using systemd to manage cgroups: invalid argument

원인 분석

이 에러는 Podman(Rootless 모드)이 시스템의 systemd와 상호작용할 때 Cgroup(리소스 관리) 설정이 충돌하여 발생하는 문제로 , 일반 사용자 권한으로 실행 중인데 시스템 관리 영역인 systemd cgroup에 접근하려다 거절당한 것입니다.

이때 sudo를 붙여서 실행하면 해결되긴 하지만, 그렇게 되면 생성되는 DB 파일들의 소유권이 root가 되어버립니다. 나중에 파일 이동이나 백업 시 Permission Denied로 고생할 수 있으므로 권장하지 않습니다.

해결 방법: containers.conf 설정 (권장)

• 가장 깔끔한 해결책은 Podman이 시스템의 systemd 대신 자체적인 cgroupfs를 사용하도록 설정을 변경하는 것입니다. 이 설정은 현재 로그인한 사용자 계정에만 적용된다. 

mkdir -p ~/.config/containers
vi ~/.config/containers/containers.conf

• ~/.config/containers/containers.conf 파일에 아래 내용 작성 

[engine]
cgroup_manager = "cgroupfs"
events_logger = "file"

잠깐! 상식

MariaDB는 MySQL의 소스 코드를 기반으로 만들어진(Fork된) 파생 버전입니다. 그래서 명령어, 포트, 파일 구조가 거의 똑같습니다.

사용자 입장에서 중요한 3가지 핵심 관계를 정리해 드릴게요.

왜 갈라졌나요? (탄생 비화)

• MySQL의 창시자: 몬티 와이드니어스(Monty Widenius)라는 개발자가 만들었습니다. (딸 이름이 'My'라서 MySQL입니다.)
• 오라클 인수: MySQL이 썬 마이크로시스템즈를 거쳐 거대 기업인 오라클(Oracle) 로 넘어가게 되었습니다.
• MariaDB 탄생: 몬티는 오라클이 MySQL을 상업적으로 폐쇄할까 봐 걱정하여, "영원히 무료인 오픈소스"를 지키기 위해 MySQL 소스 코드를 들고 나와서 MariaDB를 새로 만들었습니다. (둘째 딸 이름이 'Maria'라서 MariaDB입니다.)

MySQL 로그 설정 정보 확인 

Mysql에 접속 되어 실행 되는 SQL 들을 확인 할수 있는 방법에 대해 공유 하겠습니다. 

Mysql DB 에 먼저 접속 한후 로그깅 설정 정보를 확인 합니다. 

• SHOW VARIABLES 명령을 통해 Mysql 에 현재 적용된 로그레벨과 로그 파일 위치를 확인 합니다. 

SHOW VARIABLES LIKE '%general%';

• 실행 결과

• 로그확인(tail -f general_log_file ) 
•  mysql db에 수행된 sql 에 대해서 조회가 가능 합니다. 

MySQL 로그 설정 변경

• set global general_log 명령을 통해 로그를 on/off 시킬수도 있습니다. 
• 해당 명령을 수행한 이후에는 flush logs 명령을 수행 해주세요 

 SET GLOBAL general_log = 'OFF';
 FLUSH LOGS ;

 SET GLOBAL general_log = 'ON';

Mysql 사용자 생성 및 권한을 부여하는 방법에 대해 간단하게 정리합니다. 

Mysql8 기준으로 작성되어  있습니다. 

Mysql 기본 정보 확인

유저를 생성하기에 앞서 우선 Mysql 기본 정보를 확인 합니다. 

제가 테스트하는 Mysql 은 도커로 설치되었습니다. 

설치 방법은 Mysql 도커 설치 글을 참고 하세요 

root 접속 (mysql -u root  -p --host 127.0.0.1)

Database 생성 삭제 및 변경 

#database 생성 
create database book_db;

#utf8 로 database 생성 
create database book_db character set utf8mb4 collate utf8mb4_general_ci;

#database 삭제
drop database book_db ;


SET character_set_client = utf8mb4 ;
SET character_set_results = utf8mb4 ;
SET character_set_connection = utf8mb4 ;
ALTER DATABASE [DB명] DEFAULT CHARACTER SET utf8mb4 ;

mysql database 선택(use mysql)

유저정보 확인 (select user, host from user;)

• 현재 생성되어 있는 유저 정보를 확인합니다. 

데이터베이스 정보 확인(show databases;)

• Mysql에 생성된 database 정보를 확인합니다. 

유저 생성 및 권한 추가 삭제

• 유저를 생성하기 위한 기본 정보가 확인 되었으므로 이제 유저를 생성해 보겠습니다. 

유저 생성 및 권한 부여 

• 'localhost' 대신 '%' 을 사용할 경우 외부에서도 접속 가능합니다.

# create user '[유저명]'@'[접속허용IP]' identified by '[비밀번호]';
create user 'manager'@'localhost' identified by 'test123';

grant all privileges on [권한 허용 database].* to manager@'[접속허용IP]';
grant all privileges on mysql8.* to manager@'localhost';

유저 정보 변경 

부여된 권한 정보 확인( SHOW GRANTS FOR manager@localhost;)

생성된 계정에 접속 

테이블 생성

databasee 와 유저 생성에 대해 알아보았습니다. 

이제 해당 databse 에 table 생성해 보겠습니다. 

• book_db database 에 book 테이블 을 만들고 bookadmin 유저에 권한을 부여하는 명령입니다. 

CREATE TABLE `book` (
 `book_id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
 `title` VARCHAR(200) NOT NULL,
 `category` VARCHAR(200) NOT NULL DEFAULT '',
 `price` INT NULL,
 `insert_date` DATETIME NOT NULL DEFAULT NOW(),
 PRIMARY KEY (`book_id`)
);

GRANT EXECUTE, SELECT, SHOW VIEW, ALTER, ALTER ROUTINE, CREATE, CREATE ROUTINE, CREATE TEMPORARY TABLES, CREATE VIEW, DELETE, DROP, EVENT, INDEX, INSERT, REFERENCES, TRIGGER, UPDATE, LOCK TABLES  ON `book_db`.* TO 'bookadmin'@'%' WITH GRANT OPTION;
FLUSH PRIVILEGES;

이전 포스트팅 했던 자료에서 Docker 환경으로 Mysql 을 설치했습니다. 

설치 이후에 외부에서 MySQL 접속이 되지 않는 문제가 있어 해결 방법을 정리했습니다. 

Mysql 접속을 위한 DBeaver 다운로드 

아래 링크에서 DBeaver  다운로드를 받습니다. 

DBeaver  는 여러종류의 DBMS 에서 제공하는 jdbc 라이브러리를 통해 DB에 접속 할수 있는 유용한 데이터베이스 관리 툴입니다. Oracle,Tibero ,PostgreSQL,MySQL 등 여러 DB에 접속 설정을 통해 편리하게 데이터를 조작 하고 관리할수 있습니다. 

https://dbeaver.io/download/

• Enterprise Edition 이 있지만 유료 이므로 무료 버전인 Communition 버전을 다운로드 해서 사용 하도록 하겠습니다. 

Mysql  접속 정보 확인 하기 

이전에 작성했던  Docker 환경으로 Mysql 설치 글에서 아래의 설정으로 Mysql8 버전을 설정을 했습니다. 

설치된 서버 데이터 베이스 확인 하기

• mysql -u testuser  -p --host 127.0.0.1
• 접속 후 show databases; 명령을 통해 database 목록을 확인합니다. 
• Docker 설치시 mysql8 이라는 이름으로 database 설정 했습니다. 

데이터 베이스 Table 목록 확인하기 

• testuser  이름으로 mysql8 database 에 t_board 와 book 라는 테이블을 만들었습니다. 
• 테이블 목록 확인 명령은 show tables; 명령으로 확인 할수 있습니다. 
•  

윈도우10 데스크탑 에서 리눅스 MySQAL 데이터 베이스 접속 

이제 다운로드 받은 DBeaver 로 리눅스에 설치된 MySQL 에 접속 테스트를 진행해 보겠습니다. 

DBeaver 실행 & Connect 설정 

플러그버튼을 누르거나 Datbase Navigator 창에서 우클릭해서 create -> Connect 버튼을 눌러서 Mysql 접속 설정을 합니다. 

수많은 Database 가 있지만 MySQL 접속할 예정이므로 Mysql 창을 선택합니다.

접속 설정 마친후 TesteConnect 버튼을 눌러 정상적으로 테스트가 이루어 지는지 확인합니다. 

예상치 못한 에러가 발생하였습니다. 

• 에러 :Public Key Retrieval is not allowed

우측 DBbeaver Driver Properties 탭으로 설정 위치를 변경하여 

allowPublicKeyRetrieval 값을 변경합니다. 

• allowPublicKeyRetrieval : false ->TRUE

프로퍼티값 변경 후 접속하면 아래와 같이 정상적으로 생성했던 테이블 목록이 보입니다.