Nacos是阿里开源的微服务架构组件,既可以用作服务注册中心,也可用作配置中心。
虽然Nacos的官方文档也有关于如何部署的说明,但是个人觉得不够详细和连续,故本文将阐述在单机环境实际搭建Nacos环境的详细步骤已经遇到的一些问题。
环境准备
由于安装的是单机环境,且需要使用MySQL数据库,所以需要在安装主机准备好Java8 运行时环境和MySQL数据库服务。
安装MySQL服务可以参考:yum方式安装mysql。
安装步骤
第一步:下载Nacos安装包
Nacos的最新发布版本可以从这里下载,有2中格式的压缩包文件(zip和tar.gz),分别为:nacos-server-{version}.tar.gz和nacos-server- {version}.zip。如本文示例中使用的安装包为:nacos-server-2.2.3.zip。
第二步:安装Nacos
由于Nacos只是一个简单的压缩包,所以所谓的安装就是解压到一个指定的目录即可,比如:~/opt
。
unzip nacos-server-2.2.3.zip -d ~/opt
从Nacos的配置文件中可以找到有关MySQL的连接配置,如下:
代码语言:javascript复制vim ~/opt/nacos/conf/application.properties
### If use MySQL as datasource:
### Deprecated configuration property, it is recommended to use `spring.sql.init.platform` replaced.
# spring.datasource.platform=mysql
# spring.sql.init.platform=mysql
### Count of DB:
# db.num=1
### Connect URL of DB:
# db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
# db.user.0=nacos
# db.password.0=nacos
显然,需要将如下几项配置参数的注释删除掉:
代码语言:javascript复制spring.sql.init.platform=mysql
db.num=1
db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user.0=nacos
db.password.0=nacos
由上述配置参数可知,默认连接的数据库名为nacos
,连接用户名为:nacos
,连接用户密码为:nacos
。
因此,需要登录MySQL数据库执行相应的初始化操作。
首先,需要创建一个名为nacos
的数据库(如下命令基于MySQL 8.0.34操作)。
# 创建数据库
mysql> create database nacos DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
其次,需要添加访问用户并为之授权。
代码语言:javascript复制# 添加用户
mysql> create user 'nacos'@'%' identified by 'nacos';
# 为用户授权
mysql> grant all privileges on *.* to 'nacos'@'%' with grant option;
# 刷新权限
mysql> flush privileges;
再者,在nacos的安装目录下还存在一个数据库表的初始化脚本,即:mysql-schema.sql
,需要将该脚本导入上面创建的nacos
数据库中。
## 登录到MySQL中并切换到nacos数据库后执行如下操作
mysql> source /root/opt/nacos/conf/mysql-schema.sql
至此,运行一个使用MySQL数据库的单实例nacos环境已经准备好了。
第三步:启动Nacos
执行如下命令启动nacos:
代码语言:javascript复制cd ~/opt/nacos/bin
sh startup.sh -m standalone
查看日志~/opt/nacos/logs/start.out
,当出现如下提示时说明nacos启动成功了。
,--.
,--.'|
,--,: : | Nacos 2.2.3
,`--.'`| ' : ,---. Running in stand alone mode, All function modules
| : : | | ' ,' .--.--. Port: 8848
: | | : ,--.--. ,---. / / | / / ' Pid: 7363
| : ' '; | / / . ; ,. :| : /`./ Console: http://192.168.2.24:8848/nacos/index.html ## 这里提示访问nacos控制台页面的地址
' ' ;. ;.--. .-. | / / '' | |: :| : ;_
| | | | __/: . .. ' / ' | .; : `. https://nacos.io
' : | ; .' ," .--.; |' ; :__| : | `----.
| | '`--' / / ,. |' | '.'| / / /`--' /
' : | ; : .' : : `----' '--'. /
; |.' | , .-./ / `--'---'
'---' `--`---' `----'
2023-07-22 10:15:07,812 INFO Tomcat initialized with port(s): 8848 (http) ## nacos服务运行端口
2023-07-22 10:15:07,949 INFO Root WebApplicationContext: initialization completed in 3036 ms
2023-07-22 10:15:11,699 INFO Adding welcome page: class path resource [static/index.html]
nacos启动后默认会打开4个端口:7848
,8848
,9848
,9849
。
各个端口的含义及作用描述如下:
端口 | 与主端口的偏移量 | 描述 |
---|---|---|
8848 | 0 | 主端口,客户端、控制台及OpenAPI所使用的HTTP端口 |
9848 | 1000 | 客户端gRPC请求服务端端口,用于客户端向服务端发起连接和请求 |
9849 | 1001 | 服务端gRPC请求服务端端口,用于服务间同步等 |
7848 | -1000 | Jraft请求服务端端口,用于处理服务端间的Raft相关请求 |
注:9849和7848端口为服务端之间的通信端口,请勿暴露到外部网络环境和客户端测。
第四步:停止Nacos
如果需要停止nacos,则执行如下操作:
代码语言:javascript复制cd ~/opt/nacos/bin
sh shutdown.sh
如何使用nacos作为注册中心
对于应用程序而言(不论是服务提供者还是服务消费者),通过如下2种方式集成nacos客户端即可接入nacos了。
方式1:引入nacos-client
组件。
<dependency>
<groupId>com.alibaba.nacos</groupId>
<artifactId>nacos-client</artifactId>
<version>${version}</version>
</dependency>
方式2:对于Dubbo应用而言,还可以直接引入dubbo-registry-nacos
组件。
<dependency>
<groupId>org.apache.dubbo</groupId>
<artifactId>dubbo-registry-nacos</artifactId>
<version>${version}</version>
</dependency>
如果是应用程序是基于Spring Boot框架开发,添加如下配置:
代码语言:javascript复制dubbo:
registry:
address: nacos://192.168.2.24:8848
如果项目并非基于Spring Boot框架开发,接入Nacos的详细步骤参考:Java SDK 。
至此,就完成了应用程序接入nacos的全部工作。
遇到的问题
Q1:主机未关闭防火墙,导致nacos无法连接MySQL数据库。
A1:我的安装环境为CentOS 8.5.2111
,默认是启动了防火墙的,即使MySQL服务和nacos安装在同一台主机也需要将防火墙关闭才能连接,否则nacos会启动失败,并且在日志中会看到报错信息:Caused by: java.lang.IllegalStateException: No DataSource set
。
当然,我看github上有人还遇到了同样的报错问题,参考:部署 Nacos:2.0.3 连接 MySQL 报错 Nacos Server did not start because dumpservice bean construction failure : No DataSource set。
关闭防火墙命令:systemctl stop firewalld.service
【参考】
Nacos 快速开始
Nacos部署环境