keycloak 9.0 迁移数据库到MySQL 8.0.19

1.官方文档

• 下载地址

https://www.keycloak.org/downloads.html

• 数据库配置

https://www.keycloak.org/docs/latest/server_installation/index.html#database-configuration

2.驱动准备

• Oracle官网下载下载mysql-connector-java-8.0.19.zip，略。
• 解压~/Downloads/mysql-connector-java-8.0.19.zip.
• 解压mysql-connector-java-8.0.19.jar，进入目录查找

find . -name "MysqlXADataSource.class"

记下路径

./com/mysql/cj/jdbc/MysqlXADataSource.class

3.下载并配置keycloak 9.0

• 下载地址

https://downloads.jboss.org/keycloak/9.0.0/keycloak-9.0.0.zip

• 解压~/Downloads/keycloak-9.0.0.zip

cd ~/Downloads    
unzip keycloak-9.0.0.zip
cd keycloak-9.0.0

• 拷贝MySQL驱动

mkdir -p ./modules/system/layers/base/com/mysql/main/
cp ../mysql-connector-java-8.0.19/mysql-connector-java-8.0.19.jar ./modules/system/layers/base/com/mysql/main/

• 建立module.xml文件，与mysql-connector-java-8.0.19.jar同一目录

• 修改驱动及数据源配置

cd ~/Downloads/keycloak-9.0.0
vim standalone/configuration/standalone.xml

修改三处。
a.增加MySQL驱动

                
                    
                        org.h2.jdbcx.JdbcDataSource
                    

                    
                    
                        com.mysql.cj.jdbc.MysqlXADataSource
                    
                

b.注释原数据源，增加MySQL数据源

                
                
                
                    jdbc:mysql://127.0.0.1:3306/keycloak?useSSL=false&connectionCollation=utf8_general_ci&characterSetResults=utf8&characterEncoding=utf8
                    mysql
                    
                        root
                        password
                    
                
                

c.修改jpa配置

4.准备数据库

• 建立数据库

CREATE DATABASE IF NOT EXISTS keycloak  DEFAULT CHARSET utf8mb4;

*导入数据脚本，若keycloak-database-update.sql不存在，先执行第5步，运行./bin/standalone.sh，报错后就有了。

use keycloak;
source ~/Downloads/keycloak-9.0.0/keycloak-database-update.sql;

• 确认结果

mysql> show tables;
+-------------------------------+
| Tables_in_keycloak            |
+-------------------------------+
...
...
| WEB_ORIGINS                   |
+-------------------------------+
93 rows in set (0.00 sec)

5.启动

cd ~/Downloads/keycloak-9.0.0
./bin/standalone.sh

打开浏览器访问

http://localhost:8080/auth