Skip to main content
Version: v5.3

组件配置文件实践

本篇文章将会介绍如何在 Rainbond 中为组件挂载配置文件以及多组件之间配置文件共享,适用于有多个组件需要使用同一个配置文件的场景, 可以直接共享, 无需多次编辑设置;共享的配置文件只会解析当前组件的环境变量;以下将会以 MariaDB 为例, 演示配置文件的使用。

概述

Rainbond 结合了 Kubernetes 的 ConfigMap 实现的配置文件,是一种特殊的存储类型,此类型允许用户直接定义文件内容,通常是指配置文件;配置文件有两大特性:动态渲染环境变量和配置文件共享。

MariaDB 的官方镜像,给出了两种自定义配置文件的方法

  • 第一种

在宿主机需要有一个配置文件,并将这个配置文件在容器启动时挂载到容器的 /etc/mysql/conf.d 目录下,/etc/mysql/conf.d 下的配置文件即会覆盖容器内默认配置文件 /etc/mysql/my.cnf

这种方法不够灵活,无法在创建组件时确认 Pod 会被调度在哪个节点上(数据中心通常是集群),需要组件创建完成后才能挂载配置文件,然后重启组件使其生效。

  • 第二种

在容器启动时 docker run 命令中传入相关参数, 比如通过 character-set-servercollation-server 两个参数修改默认的编码和校对规则:

docker run --name some-mariadb -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mariadb:tag --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci

这种方法同样不够灵活,如果设置的参数非常多,那么这个 docker run 命令将会非常的长。

Rainbond 的配置方法

Rainbond 结合 k8s 的 ConfigMap 实现的配置文件,这种方法灵活性比较高, 可以 动态渲染环境变量,还可以共享给其它组件使用,以下演示 Rainbond 的配置文件挂载以及共享配置文件方法。

前提条件

  1. 可以连接外网,拉取 GitHub 代码,使用源码构建 MariaDB项目,子目录设置10.5;
  2. 拥有一份 MariaDB的配置文件。

配置文件示例

# MariaDB-specific config file.
# Read by /etc/mysql/my.cnf

[client]
# Default is Latin1, if you need UTF-8 set this (also in server section)
default-character-set = ${DEFAULT_CHARACTER_SET:utf8}

[mysqld]
#
# * Character sets
#
# Default is Latin1, if you need UTF-8 set all this (also in client section)
#
character-set-server = ${CHARACTER_SET_SERVER:utf8}
collation-server = ${COLLATION_SERVER:utf8_general_ci}
character_set_server = ${CHARACTER_SET_SERVER:utf8}
collation_server = ${COLLATION_SERVER:utf8_general_ci}

default_storage_engine = ${DEFAULT_STORAGE_ENGINE:innodb}

# Import all .cnf files from configuration directory
!includedir /etc/mysql/mariadb.conf.d/

配置文件解释

在这个配置文件中使用了 动态渲染配置文件解析环境变量,设置了 DEFAULT_CHARACTER_SETCHARACTER_SET_SERVERDEFAULT_STORAGE_ENGINE 等可以解析环境变量的变量,并给它们设置了默认值,如果组件中存在指定的环境变量,那么 Rainbond 会将该环境变量的值解析到配置文件中;如果组件中不存在该环境变量,那么 Rainbond 会将默认值解析到配置文件中;如果指定的环境变量不存在,且没有设置默认值,那么 Rainbond 不会进行解析。

动态渲染配置文件解析环境变量的语法:

${环境变量名}
${环境变量名:默认值}

操作步骤

  1. 从源码创建 MariaDB 组件,创建时不要勾选构建并启动

2.在组件管理页面 环境配置 --> 配置文件设置 中点击 添加配置文件 ,使用上述示例配置文件即可,挂载路径为 /etc/mysql/mariadb.cnf;如图所示:

3.添加环境变量

在组件管理页面 环境配置 --> 自定义环境变量 --> 添加变量 为组件添加环境变量 DEFAULT_STORAGE_ENGINE=myisamMYSQL_ROOT_PASSWORD=rainbond

效果展示

  1. 构建 MariaDB 组件,启动成功后进入容器检查 /etc/mysql/mariadb.cnf 的内容

可以发现,Rainbond 没有找到 DEFAULT_CHARACTER_SETCHARACTER_SET_SERVER 等没有对应环境变量的变量,则使用它们对应的默认值进行了解析;找到了 DEFAULT_STORAGE_ENGINE 对应的环境变量,则使用环境变量 DEFAULT_STORAGE_ENGINE 的值 myisam 进行解析.

2.登录 MySQL,查看配置是否生效:

# 登录 MySQL
root@gr52b3ee-0:/# mysql -uroot -prainbond

# 检查编码和校对规则
MariaDB [(none)]> show variables like "%character%";
+--------------------------+----------------------------+
| Variable_name | Value |
+--------------------------+----------------------------+
| character_set_client | utf8 |
| character_set_connection | utf8 |
| character_set_database | utf8 |
| character_set_filesystem | binary |
| character_set_results | utf8 |
| character_set_server | utf8 |
| character_set_system | utf8 |
| character_sets_dir | /usr/share/mysql/charsets/ |
+--------------------------+----------------------------+

# 查看存储引擎
MariaDB [(none)]> SHOW STORAGE ENGINES;
+--------------------+---------+----------------------------------------------------------------------------------+--------------+------+------------+
| Engine | Support | Comment | Transactions | XA | Savepoints |
+--------------------+---------+----------------------------------------------------------------------------------+--------------+------+------------+
| MRG_MyISAM | YES | Collection of identical MyISAM tables | NO | NO | NO |
| CSV | YES | Stores tables as CSV files | NO | NO | NO |
| MEMORY | YES | Hash based, stored in memory, useful for temporary tables | NO | NO | NO |
| MyISAM | DEFAULT | Non-transactional engine with good performance and small data footprint | NO | NO | NO |
| Aria | YES | Crash-safe tables with MyISAM heritage | NO | NO | NO |
| InnoDB | YES | Supports transactions, row-level locking, foreign keys and encryption for tables | YES | YES | YES |
| PERFORMANCE_SCHEMA | YES | Performance Schema | NO | NO | NO |
| SEQUENCE | YES | Generated tables filled with sequential values | YES | NO | YES |
+--------------------+---------+----------------------------------------------------------------------------------+--------------+------+------------+

可以看出,编码,校对规则,存储引擎 的设置都已经生效。

配置文件共享

前提条件

已通过上述步骤为 MariaDB 挂载配置文件

操作步骤

  1. 重新创建一个MariaDB组件,
  2. 在组件管理界面 环境配置 --> 共享配置文件 --> 挂载共享配置文件 找到上面的MariaDB 配置文件并填写挂载路径,更新组件,如图所示:

效果展示

创建完成后, 进入容器查看配置文件/etc/mysql/mariadb.cnf内容如下:

# MariaDB-specific config file.
# Read by /etc/mysql/my.cnf

[client]
# Default is Latin1, if you need UTF-8 set this (also in server section)
default-character-set = utf8

[mysqld]
#
# * Character sets
#
# Default is Latin1, if you need UTF-8 set all this (also in client section)
#
character-set-server = utf8
collation-server = utf8_general_ci
character_set_server = utf8
collation_server = utf8_general_ci

default_storage_engine = innodb

# Import all .cnf files from configuration directory

可以看到,由于当前组件没有设置 DEFAULT_STORAGE_ENGINE 变量, 所以 Rainbond 使用它的默认值 innodb 进行解析,其他配置已经生效。