Skip to main content
Version: User Docs

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

deployDnsVipMode.jpg

1. Preparing for the Environment​

Make sure that it is installed and used in the environment:

  1. 64 bit OS Linux/Unix/Mac, recommended Linux system.
  2. 64 bit JDK 1.8+; Download. Configuration.
  3. Maven 3.2.x+; Download. Configuration.
  4. 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 and VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg= 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​

sql statement source file

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