[on Nacos] get started quickly

If you want to know more Nacos course , welcome star 《On Nacos》 Open source project . be based on Nacos 2.x To get started 、 principle 、 Source code 、 Introduction to actual combat , Help developers get started quickly Nacos.

Installation package

install

Step one ： Can pass https://github.com/alibaba/nacos/releases Find the corresponding version , Download packaged Nacos. You can use the following command to download the corresponding Nacos edition . What we're downloading right now is 2.1.0 edition , You can use the following command ：

wget https://github.com/alibaba/nacos/releases/download/2.1.0/nacos-server-2.1.0.tar.gz

Step two ： After downloading the compressed package, you need to decompress it with a command ：

tar -xzf nacos-server-2.1.0.tar.gz

Step three ：cd To nacos Under the table of contents , First, let's introduce the directory structure

.
|____LICENSE
|____bin                                 // nacos  Start of 、 Stop script 
| |____startup.sh
| |____startup.cmd
| |____shutdown.sh
| |____shutdown.cmd
|____target                              // nacos  Server side  jar  package 
| |____nacos-server.jar
|____NOTICE
|____conf                                // naocs  The configuration file 、sql Script 、 Cluster configuration, etc 
| |____1.4.0-ipv6_support-update.sql
| |____schema.sql
| |____nacos-mysql.sql
| |____application.properties.example
| |____nacos-logback.xml
| |____cluster.conf.example
| |____application.properties

Step four ： Stand alone mode starts Nacos

Linux/Unix/Mac

Start command ( -m standalone Stand alone mode start ):

sh startup.sh -m standalone

If you are using ubuntu System , Or run the script to report an error [[ Symbol not found , Try the following operation ：

bash startup.sh -m standalone

Windows

Start command ( -m standalone Stand alone mode start ):

startup.cmd -m standalone

The following log shows that it has been started naocs 了 , Detailed log nacos/logs/start.out.

nacos is starting with standalone
nacos is starting,you can check the /Users/lixiaoshuang/nacos-related/nacos/logs/start.out

Step five ： Access... Through a browser ：http://127.0.0.1:8848/nacos Sign in nacos Console , The default account name and password are ：nacos、nacos.

https://tva1.sinaimg.cn/large/e6c9d24ely1h3jghe1b57j215u0u0div.jpg

remarks ： By default, it is unnecessary to start in stand-alone mode MySQL Of , If you want to use it MySQL You can modify the data source information in the configuration

Configuration Management

adopt curl Command invocation Nacos Of Open API Let's have a quick experience of Nacos Configuration management capabilities .

Release configuration ：

curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=Hello Nacos"

adopt curl After the command is issued and configured , You can configure management through the console - View the configuration information in the configuration list .

https://tva1.sinaimg.cn/large/e6c9d24ely1h3jh75hwdhj22300tgtcu.jpg

Get configuration ：

curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"

https://tva1.sinaimg.cn/large/e6c9d24ely1h3jh8xya7ej21fa0eq761.jpg

Service registration & Find out

adopt curl Command invocation Nacos Of Open API Let's have a quick experience of Nacos Service discovery capabilities for .

Service registration ：

curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'

After execution curl After the command , You can manage services on the console - View the registered service information in the service list .

https://tva1.sinaimg.cn/large/e6c9d24ely1h3jhexgudnj223i0quwie.jpg

Service discovery ：

curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'

https://tva1.sinaimg.cn/large/e6c9d24ely1h3jhi77yujj21no0ki0y3.jpg

Use MySQL

If you want to Nacos Use MySQL To do the underlying storage , First we need to find out nacos/conf In the catalog nacos-mysql.sql . perform sql Script creation nacos Related library tables .

Then you just need to modify application.properties file , First cd To nacos/conf Under the table of contents , use vim Command to change application.properties file , Find the following comment ：

#*************** Config Module Related Configurations ***************#
### If use MySQL as datasource:
# spring.datasource.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

Release comment , modify db.url.0 The database link of is the actual database address to be connected , Modify corresponding user、password.

#*************** Config Module Related Configurations ***************#
### If use MySQL as datasource:
spring.datasource.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=root
db.password.0=12345678

After modifying the above configuration , Through nacos/bin The startup script under the directory starts nacos that will do ：

sh startup.sh -m standalone

Debugging the source code

Step one ： adopt git The order will nacos Warehouse clone To local

git clone https://github.com/alibaba/nacos.git

Step two ： Use idea open nacos Source code

https://tva1.sinaimg.cn/large/e6c9d24ely1h3jl16bygzj21bg0u0got.jpg

Step three ： Use mvn clean compile -U -Dmaven.test.skip=true Command to compile the project

https://tva1.sinaimg.cn/large/e6c9d24ely1h3jlbydm93j20yi0u0dn0.jpg

Step four ： find com.alibaba.nacos.Nacos Start class , stay idea Add... At startup VM Parameters -Dnacos.standalone=true, And then it starts , You can debug nacos Source code .

https://tva1.sinaimg.cn/large/e6c9d24ely1h3jllyxo7sj219c0u0tbp.jpg