Skip to main content
Version: v5.2

服务间通信,端口别名的使用

今天给大家介绍一下 Rainbond 的一个小技巧——端口别名。

端口别名,顾名思义,是给组件端口定义一个别名。

端口别名的设置

当进入到端口管理页面,点击使用别名,即可设置端口的别名,如下图所示:

端口别名设置

端口别名的作用

定义好端口别名后,Rainbond 会为该别名生成两个对外环境变量:端口别名_HOST端口别名_PORT。比如,端口别名是 MYSQL,则对应的环境变量就是 MYSQL_HOSTMYSQL_HOST

端口别名对外环境变量

不知道大家发现没有,这两个环境变量,其实就是该端口的访问方式,访问方式=端口别名_HOST:端口别名_PORT。 比如:端口别名是 MYSQL,对应的访问方式就是 MYSQL_HOST:MYSQL_PORT,即 127.0.0.1:3306

还有一个很重要的点就是,不管组件所属应用的治理模式怎么变,端口别名_HOST 都可以感知到。

也就是说,只要需要访问该端口的组件依赖上该组件,则可以很方便地知道其访问方式;不管应用的治理模式怎么变化,这个访问的方式会作出相应的变化,一直保持是正确的。

Spring 组件连接 MySQL

为了做更进一步的说明,我们以 Spring 组件连接 MySQL 为例,看看 Spring 是如何方便地获取 MySQL 的访问方式。

熟悉 Spring 的同学可能知道,其配置文件可以是这样子的:

spring.jpa.hibernate.ddl-auto=update
spring.datasource.url=jdbc:mysql://${MYSQL_HOST:localhost}:${MYSQL_PORT:localhost}/db_example
spring.datasource.username=springuser
spring.datasource.password=ThePassword

可能有些同学不熟悉 Spring,不过没有关系。我们只需要知道,Spring 会用环境变量去渲染配置文件里的变量。

只要 Spring 组件依赖了 MySQL 组件,Rainbond 则会把 MySQL 组件的对外环境变量注入到 Spring 组件里。

换句话说,Spring 组件依赖了 MySQL 之后,就会自动地得到环境变量 MYSQL_HOSTMYSQL_HOST。如果 MYSQL_HOST=127.0.0.1, MYSQL_PORT=3306, 经 Spring 渲染后,数据库的链接地址则变成了 spring.datasource.url=jdbc:mysql://127.0.0。1:3306/db_example,从而可以正确的访问 MySQL 组件。

总结

端口别名 是 Rainbond 组件间的通信里的一个非常方便的功能,通过为端口设置别名,可以很方便地获取到该端口的访问方式。