Cluster deployment instructions
Document optimizing...
Cluster Mode Deployment
This Quick Start Manual is to help you quickly download, install and use Nacos on your computer to deploy the cluster mode for production use.
Cluster Deployment Architecture
Therefore, when it is open source, it is recommended that users put all server lists under a vip and then hang under a domain name.
Http://ip1:port/openAPI Directly connected to ip mode, the machine needs to be modified to use ip.
Http://SLB:port/openAPI Mount the SLB mode(Intranet, do not expose internet to avoid security risks), directly connect to SLB, the following server ip real ip, readability is not good.
Http://nacos.com:port/openAPI Domain name + SLB mode(Intranet, do not expose internet to avoid security risks), good readability, and easy to change ip, recommended mode
1. Preparing for the Environment
Make sure that it is installed and used in the environment:
- 64 bit OS Linux/Unix/Mac, recommended Linux system.
- 64 bit JDK 1.8+; Download. Configuration.
- Maven 3.2.x+; Download. Configuration.
- 3 or more Nacos Nodes;
2. Download source code or installation package
You can get Nacos in two ways.
Download source code from Github
unzip nacos-source.zip
cd nacos/
mvn -Prelease-nacos clean install -U
cd nacos/distribution/target/nacos-server-1.3.0/nacos/bin
Download Compressed Packet after Compilation
Download address
Select the latest stable version from releases and download nacos-server-$version.zip
or nacos-server-$version.tar.gz
unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz
cd nacos/bin
3. Configuration Cluster Profile
In the Nacos decompression directory Nacos / conf directory, there is a configuration file cluster. conf, please configure each line as ip: port.
# ip:port
200.8.9.16:8848
200.8.9.17:8848
200.8.9.18:8848
3.1 Open Default auth plugin (Optional)
Then Setting configuration file application.properties
under conf
.
Setting
nacos.core.auth.enabled=true
nacos.core.auth.system.type=nacos
nacos.core.auth.plugin.nacos.token.secret.key=${custom, make sure same in all nodes}
nacos.core.auth.server.identity.key=${custom, make sure same in all nodes}
nacos.core.auth.server.identity.value=${custom, make sure same in all nodes}
Detail see Authentication.
Attention,Default value in Document
SecretKey012345678901234567890123456789012345678901234567890123456789
andVGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=
is a public default, only should use in test temporary. Please make sure to replace it with another valid value when you actually deploy.
4. Determine The DataSource
Using built-in data sources
No configuration is required
Use an external data source
production and use recommendations at least backup mode, or high availability database.
Initializes the MySQL database
application. properties configuration
application.properties configuration file
5. start server
Linux/Unix/Mac
Standalone mode
sh startup.sh -m standalone
Cluster mode
Using built-in data sources
sh startup.sh -p embedded
Use an external data source
sh startup.sh
6. Service Registration & Discovery and Configuration Management
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'
Attention: If open default auth plugin, please call with username and password in header.
Service discovery
curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'
Attention: If open default auth plugin, please call with username and password in header.
Publish configuration
curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"
Attention: If open default auth plugin, please call with username and password in header.
get configuration
curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"
Attention: If open default auth plugin, please call with username and password in header.
7. shut down server
Linux/Unix/Mac
sh shutdown.sh