MySQL 8.0에서 8.4 LTS로 업그레이드할 때 반드시 점검해야 하는 주요 항목과 설정 방법입니다.
1. 주요 변경사항 및 주의점
mysql_native_password플러그인 제거- MySQL 8.4부터는 이전 기본 인증 방식인
mysql_native_password플러그인이 기본적으로 비활성화/제거되었습니다 (caching_sha2_password가 기본). - 컨테이너 커맨드에
--default-authentication-plugin=mysql_native_password설정이 남아 있으면 컨테이너 실행(Start) 자체가 실패합니다.
- MySQL 8.4부터는 이전 기본 인증 방식인
- 삭제된 설정 옵션(
my.cnf/command)- 8.0에서 사용되던 일부 설정 매개변수가 8.4에서 완전히 제거되었습니다.
- 대표적으로
innodb_log_file_size,innodb_log_files_in_group등의 옵션이 설정 파일이나 실행 명령에 포함되어 있다면 시작 시 에러가 발생합니다.
- 자동 딕셔너리 업그레이드
- 별도의
mysql_upgrade명령을 실행할 필요 없이, 컨테이너 시작 시 데이터 디렉터리(var/lib/mysql)를 감지하여 자동으로 데이터 딕셔너리 업그레이드를 진행합니다.
- 별도의
- 다운그레이드 불가
- 메이저 버전 업그레이드 이후에는 8.4의 데이터 디렉터리로 8.0을 다시 실행(다운그레이드)할 수 없으므로 사전 백업이 필수입니다.
2. Compose 파일 수정 및 조치 예시
기존 docker-compose.yml에서 호환되지 않는 옵션을 제거해야 정상 작동합니다.
YAML
version: '3.8'
services:
mysql:
image: mysql:8.4
container_name: global-mysql
# command에서 --default-authentication-plugin=mysql_native_password 제거
command:
- --character-set-server=utf8mb4
- --collation-server=utf8mb4_unicode_ci
environment:
MYSQL_ROOT_PASSWORD: "your_password"
TZ: Asia/Seoul
volumes:
- global_db_data:/var/lib/mysql
volumes:
global_db_data:
external: true
3. 클라이언트 접속 문제 해결 (caching_sha2_password)
오래된 DB 클라이언트 라이브러리나 웹 애플리케이션(예: 구버전 PHP, Node.js 등)이 caching_sha2_password 인증을 지원하지 못해 접속 에러가 발생할 경우, DB에 접속하여 해당 계정의 인증 방식을 변경해 주어야 합니다.
SQL
-- 8.4 접속 후 인증 플러그인 변경 (필요 시)
ALTER USER 'user_name'@'%' IDENTIFIED WITH caching_sha2_password BY 'your_password';
FLUSH PRIVILEGES;
현재 상황 조회하려면
//전체사용자 조회
SELECT user, host, plugin FROM mysql.user;
//특정사용자만 조회
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';
구버전 방식 사용중인 계정이 있다면
ALTER USER 'dogak_user'@'%' IDENTIFIED WITH caching_sha2_password BY '기존비밀번호';
ALTER USER 'jisim_user'@'%' IDENTIFIED WITH caching_sha2_password BY '기존비밀번호';
ALTER USER 'test_user'@'%' IDENTIFIED WITH caching_sha2_password BY '기존비밀번호';
FLUSH PRIVILEGES;
답글 남기기