From 09e52fabe9f93d247451ea5ef2d244f877a564df Mon Sep 17 00:00:00 2001 From: jimin Date: Mon, 6 Nov 2023 11:59:50 +0800 Subject: [PATCH] optimize: change best recommend version to 2.2.3 (#409) --- .../current/quick-start.md | 192 ++++++++-------- .../current/v2/quickstart/quick-start.md | 206 ++++++++--------- .../version-1.X/quick-start.md | 192 ++++++++-------- .../version-1.X/v2/quickstart/quick-start.md | 206 ++++++++--------- .../version-2.X/quick-start.md | 192 ++++++++-------- .../version-2.X/v2/quickstart/quick-start.md | 206 ++++++++--------- .../current/quick-start.md | 200 ++++++++-------- .../current/v2/quickstart/quick-start.md | 214 +++++++++--------- .../version-1.X/quick-start.md | 200 ++++++++-------- .../version-1.X/v2/quickstart/quick-start.md | 214 +++++++++--------- .../version-2.X/quick-start.md | 200 ++++++++-------- .../version-2.X/v2/quickstart/quick-start.md | 214 +++++++++--------- versioned_docs/version-1.X/quick-start.md | 200 ++++++++-------- .../version-1.X/v2/quickstart/quick-start.md | 214 +++++++++--------- versioned_docs/version-2.X/quick-start.md | 200 ++++++++-------- .../version-2.X/v2/quickstart/quick-start.md | 214 +++++++++--------- 16 files changed, 1632 insertions(+), 1632 deletions(-) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/quick-start.md b/i18n/en/docusaurus-plugin-content-docs/current/quick-start.md index eee83b810c4..2c9bb039181 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/quick-start.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/quick-start.md @@ -1,96 +1,96 @@ ---- -title: Quick Start for Nacos -keywords: [Nacos,Quick start] -description: This topic is about how to set up and use Nacos. ---- - -# Quick Start for Nacos - -This topic is about how to set up and use Nacos. - -## 0.Choose Version - -Nacos 1.X is old version. Recommend you use 2.X version. Please move to [document](./v2/quickstart/quick-start.md). - -You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/zh-cn/blog/index.html), the current recommended version is 2.1.1. - -## 1.Prerequisites - -Before you begin, install the following: - -1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. -2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). -3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). - -## 2.Download & Build from Release - -There are two ways to get Nacos. - -### 1)Download source code from Github - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin -``` - -### 2)Download run package - -Select the latest stable version from https://github.com/alibaba/nacos/releases - -```bash - unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.Start Server - -### Linux/Unix/Mac - -Run the following command to start(standalone means non-cluster mode): - -`sh startup.sh -m standalone` - -If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: - -`bash startup.sh -m standalone` - -### Windows - -Run the following command to start(standalone means non-cluster mode): - -`cmd startup.cmd -m standalone` - -## 4.Service & 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'` - -### Service discovery - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### Publish config - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` - -### Get config - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` - -## 5.Shutdown Servers - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`cmd shutdown.cmd` - -Or click the `shutdown.cmd` file operation. +--- +title: Quick Start for Nacos +keywords: [Nacos,Quick start] +description: This topic is about how to set up and use Nacos. +--- + +# Quick Start for Nacos + +This topic is about how to set up and use Nacos. + +## 0.Choose Version + +Nacos 1.X is old version. Recommend you use 2.X version. Please move to [document](./v2/quickstart/quick-start.md). + +You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/zh-cn/blog/index.html), the current recommended version is 2.2.3. + +## 1.Prerequisites + +Before you begin, install the following: + +1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. +2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). +3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). + +## 2.Download & Build from Release + +There are two ways to get Nacos. + +### 1)Download source code from Github + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin +``` + +### 2)Download run package + +Select the latest stable version from https://github.com/alibaba/nacos/releases + +```bash + unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.Start Server + +### Linux/Unix/Mac + +Run the following command to start(standalone means non-cluster mode): + +`sh startup.sh -m standalone` + +If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: + +`bash startup.sh -m standalone` + +### Windows + +Run the following command to start(standalone means non-cluster mode): + +`cmd startup.cmd -m standalone` + +## 4.Service & 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'` + +### Service discovery + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### Publish config + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` + +### Get config + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` + +## 5.Shutdown Servers + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`cmd shutdown.cmd` + +Or click the `shutdown.cmd` file operation. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/v2/quickstart/quick-start.md b/i18n/en/docusaurus-plugin-content-docs/current/v2/quickstart/quick-start.md index d74518b3220..93dee01f0a9 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/v2/quickstart/quick-start.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/v2/quickstart/quick-start.md @@ -1,103 +1,103 @@ ---- -title: Quick Start for Nacos -keywords: [Nacos,Quick start] -description: This topic is about how to set up and use Nacos. ---- - -# Quick Start for Nacos - -This topic is about how to set up and use Nacos. - -## 0.Choose Version -You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/en-us/blog/index.html), the current recommended version is 2.1.1. - -## 1.Prerequisites - -Before you begin, install the following: - -1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. -2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). -3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). - -## 2.Download & Build from Release - -There are two ways to get Nacos. - -### 1)Download source code from Github - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin -``` - -### 2)Download run package - -Select the latest stable version from https://github.com/alibaba/nacos/releases - -```bash - unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.Setting Configuration - -> Must do this setting in 2.2.0.1 and 2.2.1, otherwise fail to start. - -Setting configuration file `application.properties` under `conf`. - -Setting `nacos.core.auth.plugin.nacos.token.secret.key` parameter，detail see [Authentication-Custom SecretKey](../plugin/auth-plugin.md). - -> 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.Start Server - -### Linux/Unix/Mac - -Run the following command to start(standalone means non-cluster mode): - -`sh startup.sh -m standalone` - -If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: - -`bash startup.sh -m standalone` - -### Windows - -Run the following command to start(standalone means non-cluster mode): - -`cmd startup.cmd -m standalone` - -## 5.Service & 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'` - -### Service discovery - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### Publish config - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` - -### Get config - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` - -## 6.Shutdown Servers - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`cmd shutdown.cmd` - -Or click the `shutdown.cmd` file operation. +--- +title: Quick Start for Nacos +keywords: [Nacos,Quick start] +description: This topic is about how to set up and use Nacos. +--- + +# Quick Start for Nacos + +This topic is about how to set up and use Nacos. + +## 0.Choose Version +You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/en-us/blog/index.html), the current recommended version is 2.2.3. + +## 1.Prerequisites + +Before you begin, install the following: + +1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. +2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). +3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). + +## 2.Download & Build from Release + +There are two ways to get Nacos. + +### 1)Download source code from Github + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin +``` + +### 2)Download run package + +Select the latest stable version from https://github.com/alibaba/nacos/releases + +```bash + unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.Setting Configuration + +> Must do this setting in 2.2.0.1 and 2.2.1, otherwise fail to start. + +Setting configuration file `application.properties` under `conf`. + +Setting `nacos.core.auth.plugin.nacos.token.secret.key` parameter，detail see [Authentication-Custom SecretKey](../plugin/auth-plugin.md). + +> 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.Start Server + +### Linux/Unix/Mac + +Run the following command to start(standalone means non-cluster mode): + +`sh startup.sh -m standalone` + +If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: + +`bash startup.sh -m standalone` + +### Windows + +Run the following command to start(standalone means non-cluster mode): + +`cmd startup.cmd -m standalone` + +## 5.Service & 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'` + +### Service discovery + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### Publish config + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` + +### Get config + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` + +## 6.Shutdown Servers + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`cmd shutdown.cmd` + +Or click the `shutdown.cmd` file operation. diff --git a/i18n/en/docusaurus-plugin-content-docs/version-1.X/quick-start.md b/i18n/en/docusaurus-plugin-content-docs/version-1.X/quick-start.md index eee83b810c4..2c9bb039181 100644 --- a/i18n/en/docusaurus-plugin-content-docs/version-1.X/quick-start.md +++ b/i18n/en/docusaurus-plugin-content-docs/version-1.X/quick-start.md @@ -1,96 +1,96 @@ ---- -title: Quick Start for Nacos -keywords: [Nacos,Quick start] -description: This topic is about how to set up and use Nacos. ---- - -# Quick Start for Nacos - -This topic is about how to set up and use Nacos. - -## 0.Choose Version - -Nacos 1.X is old version. Recommend you use 2.X version. Please move to [document](./v2/quickstart/quick-start.md). - -You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/zh-cn/blog/index.html), the current recommended version is 2.1.1. - -## 1.Prerequisites - -Before you begin, install the following: - -1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. -2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). -3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). - -## 2.Download & Build from Release - -There are two ways to get Nacos. - -### 1)Download source code from Github - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin -``` - -### 2)Download run package - -Select the latest stable version from https://github.com/alibaba/nacos/releases - -```bash - unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.Start Server - -### Linux/Unix/Mac - -Run the following command to start(standalone means non-cluster mode): - -`sh startup.sh -m standalone` - -If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: - -`bash startup.sh -m standalone` - -### Windows - -Run the following command to start(standalone means non-cluster mode): - -`cmd startup.cmd -m standalone` - -## 4.Service & 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'` - -### Service discovery - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### Publish config - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` - -### Get config - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` - -## 5.Shutdown Servers - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`cmd shutdown.cmd` - -Or click the `shutdown.cmd` file operation. +--- +title: Quick Start for Nacos +keywords: [Nacos,Quick start] +description: This topic is about how to set up and use Nacos. +--- + +# Quick Start for Nacos + +This topic is about how to set up and use Nacos. + +## 0.Choose Version + +Nacos 1.X is old version. Recommend you use 2.X version. Please move to [document](./v2/quickstart/quick-start.md). + +You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/zh-cn/blog/index.html), the current recommended version is 2.2.3. + +## 1.Prerequisites + +Before you begin, install the following: + +1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. +2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). +3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). + +## 2.Download & Build from Release + +There are two ways to get Nacos. + +### 1)Download source code from Github + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin +``` + +### 2)Download run package + +Select the latest stable version from https://github.com/alibaba/nacos/releases + +```bash + unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.Start Server + +### Linux/Unix/Mac + +Run the following command to start(standalone means non-cluster mode): + +`sh startup.sh -m standalone` + +If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: + +`bash startup.sh -m standalone` + +### Windows + +Run the following command to start(standalone means non-cluster mode): + +`cmd startup.cmd -m standalone` + +## 4.Service & 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'` + +### Service discovery + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### Publish config + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` + +### Get config + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` + +## 5.Shutdown Servers + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`cmd shutdown.cmd` + +Or click the `shutdown.cmd` file operation. diff --git a/i18n/en/docusaurus-plugin-content-docs/version-1.X/v2/quickstart/quick-start.md b/i18n/en/docusaurus-plugin-content-docs/version-1.X/v2/quickstart/quick-start.md index d74518b3220..93dee01f0a9 100644 --- a/i18n/en/docusaurus-plugin-content-docs/version-1.X/v2/quickstart/quick-start.md +++ b/i18n/en/docusaurus-plugin-content-docs/version-1.X/v2/quickstart/quick-start.md @@ -1,103 +1,103 @@ ---- -title: Quick Start for Nacos -keywords: [Nacos,Quick start] -description: This topic is about how to set up and use Nacos. ---- - -# Quick Start for Nacos - -This topic is about how to set up and use Nacos. - -## 0.Choose Version -You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/en-us/blog/index.html), the current recommended version is 2.1.1. - -## 1.Prerequisites - -Before you begin, install the following: - -1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. -2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). -3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). - -## 2.Download & Build from Release - -There are two ways to get Nacos. - -### 1)Download source code from Github - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin -``` - -### 2)Download run package - -Select the latest stable version from https://github.com/alibaba/nacos/releases - -```bash - unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.Setting Configuration - -> Must do this setting in 2.2.0.1 and 2.2.1, otherwise fail to start. - -Setting configuration file `application.properties` under `conf`. - -Setting `nacos.core.auth.plugin.nacos.token.secret.key` parameter，detail see [Authentication-Custom SecretKey](../plugin/auth-plugin.md). - -> 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.Start Server - -### Linux/Unix/Mac - -Run the following command to start(standalone means non-cluster mode): - -`sh startup.sh -m standalone` - -If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: - -`bash startup.sh -m standalone` - -### Windows - -Run the following command to start(standalone means non-cluster mode): - -`cmd startup.cmd -m standalone` - -## 5.Service & 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'` - -### Service discovery - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### Publish config - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` - -### Get config - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` - -## 6.Shutdown Servers - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`cmd shutdown.cmd` - -Or click the `shutdown.cmd` file operation. +--- +title: Quick Start for Nacos +keywords: [Nacos,Quick start] +description: This topic is about how to set up and use Nacos. +--- + +# Quick Start for Nacos + +This topic is about how to set up and use Nacos. + +## 0.Choose Version +You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/en-us/blog/index.html), the current recommended version is 2.2.3. + +## 1.Prerequisites + +Before you begin, install the following: + +1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. +2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). +3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). + +## 2.Download & Build from Release + +There are two ways to get Nacos. + +### 1)Download source code from Github + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin +``` + +### 2)Download run package + +Select the latest stable version from https://github.com/alibaba/nacos/releases + +```bash + unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.Setting Configuration + +> Must do this setting in 2.2.0.1 and 2.2.1, otherwise fail to start. + +Setting configuration file `application.properties` under `conf`. + +Setting `nacos.core.auth.plugin.nacos.token.secret.key` parameter，detail see [Authentication-Custom SecretKey](../plugin/auth-plugin.md). + +> 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.Start Server + +### Linux/Unix/Mac + +Run the following command to start(standalone means non-cluster mode): + +`sh startup.sh -m standalone` + +If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: + +`bash startup.sh -m standalone` + +### Windows + +Run the following command to start(standalone means non-cluster mode): + +`cmd startup.cmd -m standalone` + +## 5.Service & 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'` + +### Service discovery + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### Publish config + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` + +### Get config + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` + +## 6.Shutdown Servers + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`cmd shutdown.cmd` + +Or click the `shutdown.cmd` file operation. diff --git a/i18n/en/docusaurus-plugin-content-docs/version-2.X/quick-start.md b/i18n/en/docusaurus-plugin-content-docs/version-2.X/quick-start.md index eee83b810c4..2c9bb039181 100644 --- a/i18n/en/docusaurus-plugin-content-docs/version-2.X/quick-start.md +++ b/i18n/en/docusaurus-plugin-content-docs/version-2.X/quick-start.md @@ -1,96 +1,96 @@ ---- -title: Quick Start for Nacos -keywords: [Nacos,Quick start] -description: This topic is about how to set up and use Nacos. ---- - -# Quick Start for Nacos - -This topic is about how to set up and use Nacos. - -## 0.Choose Version - -Nacos 1.X is old version. Recommend you use 2.X version. Please move to [document](./v2/quickstart/quick-start.md). - -You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/zh-cn/blog/index.html), the current recommended version is 2.1.1. - -## 1.Prerequisites - -Before you begin, install the following: - -1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. -2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). -3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). - -## 2.Download & Build from Release - -There are two ways to get Nacos. - -### 1)Download source code from Github - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin -``` - -### 2)Download run package - -Select the latest stable version from https://github.com/alibaba/nacos/releases - -```bash - unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.Start Server - -### Linux/Unix/Mac - -Run the following command to start(standalone means non-cluster mode): - -`sh startup.sh -m standalone` - -If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: - -`bash startup.sh -m standalone` - -### Windows - -Run the following command to start(standalone means non-cluster mode): - -`cmd startup.cmd -m standalone` - -## 4.Service & 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'` - -### Service discovery - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### Publish config - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` - -### Get config - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` - -## 5.Shutdown Servers - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`cmd shutdown.cmd` - -Or click the `shutdown.cmd` file operation. +--- +title: Quick Start for Nacos +keywords: [Nacos,Quick start] +description: This topic is about how to set up and use Nacos. +--- + +# Quick Start for Nacos + +This topic is about how to set up and use Nacos. + +## 0.Choose Version + +Nacos 1.X is old version. Recommend you use 2.X version. Please move to [document](./v2/quickstart/quick-start.md). + +You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/zh-cn/blog/index.html), the current recommended version is 2.2.3. + +## 1.Prerequisites + +Before you begin, install the following: + +1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. +2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). +3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). + +## 2.Download & Build from Release + +There are two ways to get Nacos. + +### 1)Download source code from Github + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin +``` + +### 2)Download run package + +Select the latest stable version from https://github.com/alibaba/nacos/releases + +```bash + unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.Start Server + +### Linux/Unix/Mac + +Run the following command to start(standalone means non-cluster mode): + +`sh startup.sh -m standalone` + +If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: + +`bash startup.sh -m standalone` + +### Windows + +Run the following command to start(standalone means non-cluster mode): + +`cmd startup.cmd -m standalone` + +## 4.Service & 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'` + +### Service discovery + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### Publish config + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` + +### Get config + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` + +## 5.Shutdown Servers + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`cmd shutdown.cmd` + +Or click the `shutdown.cmd` file operation. diff --git a/i18n/en/docusaurus-plugin-content-docs/version-2.X/v2/quickstart/quick-start.md b/i18n/en/docusaurus-plugin-content-docs/version-2.X/v2/quickstart/quick-start.md index d74518b3220..93dee01f0a9 100644 --- a/i18n/en/docusaurus-plugin-content-docs/version-2.X/v2/quickstart/quick-start.md +++ b/i18n/en/docusaurus-plugin-content-docs/version-2.X/v2/quickstart/quick-start.md @@ -1,103 +1,103 @@ ---- -title: Quick Start for Nacos -keywords: [Nacos,Quick start] -description: This topic is about how to set up and use Nacos. ---- - -# Quick Start for Nacos - -This topic is about how to set up and use Nacos. - -## 0.Choose Version -You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/en-us/blog/index.html), the current recommended version is 2.1.1. - -## 1.Prerequisites - -Before you begin, install the following: - -1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. -2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). -3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). - -## 2.Download & Build from Release - -There are two ways to get Nacos. - -### 1)Download source code from Github - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin -``` - -### 2)Download run package - -Select the latest stable version from https://github.com/alibaba/nacos/releases - -```bash - unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.Setting Configuration - -> Must do this setting in 2.2.0.1 and 2.2.1, otherwise fail to start. - -Setting configuration file `application.properties` under `conf`. - -Setting `nacos.core.auth.plugin.nacos.token.secret.key` parameter，detail see [Authentication-Custom SecretKey](../plugin/auth-plugin.md). - -> 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.Start Server - -### Linux/Unix/Mac - -Run the following command to start(standalone means non-cluster mode): - -`sh startup.sh -m standalone` - -If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: - -`bash startup.sh -m standalone` - -### Windows - -Run the following command to start(standalone means non-cluster mode): - -`cmd startup.cmd -m standalone` - -## 5.Service & 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'` - -### Service discovery - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### Publish config - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` - -### Get config - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` - -## 6.Shutdown Servers - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`cmd shutdown.cmd` - -Or click the `shutdown.cmd` file operation. +--- +title: Quick Start for Nacos +keywords: [Nacos,Quick start] +description: This topic is about how to set up and use Nacos. +--- + +# Quick Start for Nacos + +This topic is about how to set up and use Nacos. + +## 0.Choose Version +You can see the introduction of each version at [release notes](https://github.com/alibaba/nacos/releases) or [blog](https://nacos.io/en-us/blog/index.html), the current recommended version is 2.2.3. + +## 1.Prerequisites + +Before you begin, install the following: + +1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended. +2. 64bit JDK 1.8+: [downloads](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), [JAVA_HOME settings](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/). +3. Maven 3.2.x+: [downloads](https://maven.apache.org/download.cgi), [settings](https://maven.apache.org/settings.html). + +## 2.Download & Build from Release + +There are two ways to get Nacos. + +### 1)Download source code from Github + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin +``` + +### 2)Download run package + +Select the latest stable version from https://github.com/alibaba/nacos/releases + +```bash + unzip nacos-server-$version.zip OR tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.Setting Configuration + +> Must do this setting in 2.2.0.1 and 2.2.1, otherwise fail to start. + +Setting configuration file `application.properties` under `conf`. + +Setting `nacos.core.auth.plugin.nacos.token.secret.key` parameter，detail see [Authentication-Custom SecretKey](../plugin/auth-plugin.md). + +> 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.Start Server + +### Linux/Unix/Mac + +Run the following command to start(standalone means non-cluster mode): + +`sh startup.sh -m standalone` + +If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows: + +`bash startup.sh -m standalone` + +### Windows + +Run the following command to start(standalone means non-cluster mode): + +`cmd startup.cmd -m standalone` + +## 5.Service & 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'` + +### Service discovery + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### Publish config + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"` + +### Get config + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test" ` + +## 6.Shutdown Servers + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`cmd shutdown.cmd` + +Or click the `shutdown.cmd` file operation. diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/current/quick-start.md b/i18n/zh-cn/docusaurus-plugin-content-docs/current/quick-start.md index 7dae3340c6d..c03b0dde4e0 100644 --- a/i18n/zh-cn/docusaurus-plugin-content-docs/current/quick-start.md +++ b/i18n/zh-cn/docusaurus-plugin-content-docs/current/quick-start.md @@ -1,100 +1,100 @@ ---- -title: Nacos 快速开始 -keywords: [Nacos,快速开始] -description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 ---- - -# Nacos 快速开始 - -这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 - -## 0.版本选择 - -Nacos 1.X 是老版本，将来会停止维护。 建议您使用2.X版本。 请移步到 [Nacos2.X相关文档](./v2/quickstart/quick-start.md). - -您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.1.1。 - -## 1.预备环境准备 - -Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: - -1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 -2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 -3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 - -## 2.下载源码或者安装包 - -你可以通过源码和发行包两种方式来获取 Nacos。 - -### 从 Github 上下载源码方式 - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin - -``` - -### 下载编译后压缩包方式 - -您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 - - -```bash - unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.启动服务器 - -* 注：Nacos的运行需要以至少2C4g60g*3的机器配置下运行。 - -### Linux/Unix/Mac - -启动命令(standalone代表着单机模式运行，非集群模式): - -`sh startup.sh -m standalone` - -如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： - -`bash startup.sh -m standalone` - -### Windows - -启动命令(standalone代表着单机模式运行，非集群模式): - -`startup.cmd -m standalone` - -## 4.服务注册&发现和配置管理 - -### 服务注册 - -`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` - -### 服务发现 - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### 发布配置 - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` - -### 获取配置 - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` - -## 5.关闭服务器 - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`shutdown.cmd` - -或者双击shutdown.cmd运行文件。 +--- +title: Nacos 快速开始 +keywords: [Nacos,快速开始] +description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 +--- + +# Nacos 快速开始 + +这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 + +## 0.版本选择 + +Nacos 1.X 是老版本，将来会停止维护。 建议您使用2.X版本。 请移步到 [Nacos2.X相关文档](./v2/quickstart/quick-start.md). + +您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.2.3。 + +## 1.预备环境准备 + +Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: + +1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 +2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 +3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 + +## 2.下载源码或者安装包 + +你可以通过源码和发行包两种方式来获取 Nacos。 + +### 从 Github 上下载源码方式 + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin + +``` + +### 下载编译后压缩包方式 + +您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 + + +```bash + unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.启动服务器 + +* 注：Nacos的运行需要以至少2C4g60g*3的机器配置下运行。 + +### Linux/Unix/Mac + +启动命令(standalone代表着单机模式运行，非集群模式): + +`sh startup.sh -m standalone` + +如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： + +`bash startup.sh -m standalone` + +### Windows + +启动命令(standalone代表着单机模式运行，非集群模式): + +`startup.cmd -m standalone` + +## 4.服务注册&发现和配置管理 + +### 服务注册 + +`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` + +### 服务发现 + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### 发布配置 + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` + +### 获取配置 + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` + +## 5.关闭服务器 + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`shutdown.cmd` + +或者双击shutdown.cmd运行文件。 diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/current/v2/quickstart/quick-start.md b/i18n/zh-cn/docusaurus-plugin-content-docs/current/v2/quickstart/quick-start.md index 894c3d4a193..b3f386f01e0 100644 --- a/i18n/zh-cn/docusaurus-plugin-content-docs/current/v2/quickstart/quick-start.md +++ b/i18n/zh-cn/docusaurus-plugin-content-docs/current/v2/quickstart/quick-start.md @@ -1,107 +1,107 @@ ---- -title: Nacos 快速开始 -keywords: [Nacos,快速开始] -description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 ---- - -# Nacos 快速开始 - -这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 - -## 0.版本选择 -您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.1.1。 - -## 1.预备环境准备 - -Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: - -1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 -2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 -3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 - -## 2.下载源码或者安装包 - -你可以通过源码和发行包两种方式来获取 Nacos。 - -### 从 Github 上下载源码方式 - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin - -``` - -### 下载编译后压缩包方式 - -您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 - - -```bash - unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.修改配置文件 - -> 在2.2.0.1和2.2.1版本时，必须执行此变更，否则无法启动；其他版本为建议设置。 - -修改`conf`目录下的`application.properties`文件。 - -设置其中的`nacos.core.auth.plugin.nacos.token.secret.key`值，详情可查看[鉴权-自定义密钥](../plugin/auth-plugin.md). - -> 注意，文档中的默认值`SecretKey012345678901234567890123456789012345678901234567890123456789`和`VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=`为公开默认值，可用于临时测试，实际使用时请**务必**更换为自定义的其他有效值。 - -## 4.启动服务器 - -* 注：Nacos的运行建议至少在2C4G 60G的机器配置下运行。 - -### Linux/Unix/Mac - -启动命令(standalone代表着单机模式运行，非集群模式): - -`sh startup.sh -m standalone` - -如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： - -`bash startup.sh -m standalone` - -### Windows - -启动命令(standalone代表着单机模式运行，非集群模式): - -`startup.cmd -m standalone` - -## 5.服务注册&发现和配置管理 - -### 服务注册 - -`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` - -### 服务发现 - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### 发布配置 - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` - -### 获取配置 - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` - -## 6.关闭服务器 - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`shutdown.cmd` - -或者双击shutdown.cmd运行文件。 +--- +title: Nacos 快速开始 +keywords: [Nacos,快速开始] +description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 +--- + +# Nacos 快速开始 + +这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 + +## 0.版本选择 +您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.2.3。 + +## 1.预备环境准备 + +Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: + +1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 +2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 +3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 + +## 2.下载源码或者安装包 + +你可以通过源码和发行包两种方式来获取 Nacos。 + +### 从 Github 上下载源码方式 + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin + +``` + +### 下载编译后压缩包方式 + +您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 + + +```bash + unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.修改配置文件 + +> 在2.2.0.1和2.2.1版本时，必须执行此变更，否则无法启动；其他版本为建议设置。 + +修改`conf`目录下的`application.properties`文件。 + +设置其中的`nacos.core.auth.plugin.nacos.token.secret.key`值，详情可查看[鉴权-自定义密钥](../plugin/auth-plugin.md). + +> 注意，文档中的默认值`SecretKey012345678901234567890123456789012345678901234567890123456789`和`VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=`为公开默认值，可用于临时测试，实际使用时请**务必**更换为自定义的其他有效值。 + +## 4.启动服务器 + +* 注：Nacos的运行建议至少在2C4G 60G的机器配置下运行。 + +### Linux/Unix/Mac + +启动命令(standalone代表着单机模式运行，非集群模式): + +`sh startup.sh -m standalone` + +如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： + +`bash startup.sh -m standalone` + +### Windows + +启动命令(standalone代表着单机模式运行，非集群模式): + +`startup.cmd -m standalone` + +## 5.服务注册&发现和配置管理 + +### 服务注册 + +`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` + +### 服务发现 + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### 发布配置 + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` + +### 获取配置 + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` + +## 6.关闭服务器 + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`shutdown.cmd` + +或者双击shutdown.cmd运行文件。 diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.X/quick-start.md b/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.X/quick-start.md index 7dae3340c6d..c03b0dde4e0 100644 --- a/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.X/quick-start.md +++ b/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.X/quick-start.md @@ -1,100 +1,100 @@ ---- -title: Nacos 快速开始 -keywords: [Nacos,快速开始] -description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 ---- - -# Nacos 快速开始 - -这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 - -## 0.版本选择 - -Nacos 1.X 是老版本，将来会停止维护。 建议您使用2.X版本。 请移步到 [Nacos2.X相关文档](./v2/quickstart/quick-start.md). - -您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.1.1。 - -## 1.预备环境准备 - -Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: - -1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 -2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 -3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 - -## 2.下载源码或者安装包 - -你可以通过源码和发行包两种方式来获取 Nacos。 - -### 从 Github 上下载源码方式 - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin - -``` - -### 下载编译后压缩包方式 - -您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 - - -```bash - unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.启动服务器 - -* 注：Nacos的运行需要以至少2C4g60g*3的机器配置下运行。 - -### Linux/Unix/Mac - -启动命令(standalone代表着单机模式运行，非集群模式): - -`sh startup.sh -m standalone` - -如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： - -`bash startup.sh -m standalone` - -### Windows - -启动命令(standalone代表着单机模式运行，非集群模式): - -`startup.cmd -m standalone` - -## 4.服务注册&发现和配置管理 - -### 服务注册 - -`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` - -### 服务发现 - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### 发布配置 - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` - -### 获取配置 - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` - -## 5.关闭服务器 - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`shutdown.cmd` - -或者双击shutdown.cmd运行文件。 +--- +title: Nacos 快速开始 +keywords: [Nacos,快速开始] +description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 +--- + +# Nacos 快速开始 + +这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 + +## 0.版本选择 + +Nacos 1.X 是老版本，将来会停止维护。 建议您使用2.X版本。 请移步到 [Nacos2.X相关文档](./v2/quickstart/quick-start.md). + +您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.2.3。 + +## 1.预备环境准备 + +Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: + +1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 +2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 +3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 + +## 2.下载源码或者安装包 + +你可以通过源码和发行包两种方式来获取 Nacos。 + +### 从 Github 上下载源码方式 + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin + +``` + +### 下载编译后压缩包方式 + +您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 + + +```bash + unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.启动服务器 + +* 注：Nacos的运行需要以至少2C4g60g*3的机器配置下运行。 + +### Linux/Unix/Mac + +启动命令(standalone代表着单机模式运行，非集群模式): + +`sh startup.sh -m standalone` + +如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： + +`bash startup.sh -m standalone` + +### Windows + +启动命令(standalone代表着单机模式运行，非集群模式): + +`startup.cmd -m standalone` + +## 4.服务注册&发现和配置管理 + +### 服务注册 + +`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` + +### 服务发现 + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### 发布配置 + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` + +### 获取配置 + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` + +## 5.关闭服务器 + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`shutdown.cmd` + +或者双击shutdown.cmd运行文件。 diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.X/v2/quickstart/quick-start.md b/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.X/v2/quickstart/quick-start.md index 894c3d4a193..b3f386f01e0 100644 --- a/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.X/v2/quickstart/quick-start.md +++ b/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.X/v2/quickstart/quick-start.md @@ -1,107 +1,107 @@ ---- -title: Nacos 快速开始 -keywords: [Nacos,快速开始] -description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 ---- - -# Nacos 快速开始 - -这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 - -## 0.版本选择 -您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.1.1。 - -## 1.预备环境准备 - -Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: - -1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 -2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 -3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 - -## 2.下载源码或者安装包 - -你可以通过源码和发行包两种方式来获取 Nacos。 - -### 从 Github 上下载源码方式 - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin - -``` - -### 下载编译后压缩包方式 - -您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 - - -```bash - unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.修改配置文件 - -> 在2.2.0.1和2.2.1版本时，必须执行此变更，否则无法启动；其他版本为建议设置。 - -修改`conf`目录下的`application.properties`文件。 - -设置其中的`nacos.core.auth.plugin.nacos.token.secret.key`值，详情可查看[鉴权-自定义密钥](../plugin/auth-plugin.md). - -> 注意，文档中的默认值`SecretKey012345678901234567890123456789012345678901234567890123456789`和`VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=`为公开默认值，可用于临时测试，实际使用时请**务必**更换为自定义的其他有效值。 - -## 4.启动服务器 - -* 注：Nacos的运行建议至少在2C4G 60G的机器配置下运行。 - -### Linux/Unix/Mac - -启动命令(standalone代表着单机模式运行，非集群模式): - -`sh startup.sh -m standalone` - -如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： - -`bash startup.sh -m standalone` - -### Windows - -启动命令(standalone代表着单机模式运行，非集群模式): - -`startup.cmd -m standalone` - -## 5.服务注册&发现和配置管理 - -### 服务注册 - -`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` - -### 服务发现 - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### 发布配置 - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` - -### 获取配置 - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` - -## 6.关闭服务器 - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`shutdown.cmd` - -或者双击shutdown.cmd运行文件。 +--- +title: Nacos 快速开始 +keywords: [Nacos,快速开始] +description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 +--- + +# Nacos 快速开始 + +这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 + +## 0.版本选择 +您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.2.3。 + +## 1.预备环境准备 + +Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: + +1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 +2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 +3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 + +## 2.下载源码或者安装包 + +你可以通过源码和发行包两种方式来获取 Nacos。 + +### 从 Github 上下载源码方式 + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin + +``` + +### 下载编译后压缩包方式 + +您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 + + +```bash + unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.修改配置文件 + +> 在2.2.0.1和2.2.1版本时，必须执行此变更，否则无法启动；其他版本为建议设置。 + +修改`conf`目录下的`application.properties`文件。 + +设置其中的`nacos.core.auth.plugin.nacos.token.secret.key`值，详情可查看[鉴权-自定义密钥](../plugin/auth-plugin.md). + +> 注意，文档中的默认值`SecretKey012345678901234567890123456789012345678901234567890123456789`和`VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=`为公开默认值，可用于临时测试，实际使用时请**务必**更换为自定义的其他有效值。 + +## 4.启动服务器 + +* 注：Nacos的运行建议至少在2C4G 60G的机器配置下运行。 + +### Linux/Unix/Mac + +启动命令(standalone代表着单机模式运行，非集群模式): + +`sh startup.sh -m standalone` + +如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： + +`bash startup.sh -m standalone` + +### Windows + +启动命令(standalone代表着单机模式运行，非集群模式): + +`startup.cmd -m standalone` + +## 5.服务注册&发现和配置管理 + +### 服务注册 + +`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` + +### 服务发现 + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### 发布配置 + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` + +### 获取配置 + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` + +## 6.关闭服务器 + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`shutdown.cmd` + +或者双击shutdown.cmd运行文件。 diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/version-2.X/quick-start.md b/i18n/zh-cn/docusaurus-plugin-content-docs/version-2.X/quick-start.md index 7dae3340c6d..c03b0dde4e0 100644 --- a/i18n/zh-cn/docusaurus-plugin-content-docs/version-2.X/quick-start.md +++ b/i18n/zh-cn/docusaurus-plugin-content-docs/version-2.X/quick-start.md @@ -1,100 +1,100 @@ ---- -title: Nacos 快速开始 -keywords: [Nacos,快速开始] -description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 ---- - -# Nacos 快速开始 - -这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 - -## 0.版本选择 - -Nacos 1.X 是老版本，将来会停止维护。 建议您使用2.X版本。 请移步到 [Nacos2.X相关文档](./v2/quickstart/quick-start.md). - -您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.1.1。 - -## 1.预备环境准备 - -Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: - -1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 -2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 -3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 - -## 2.下载源码或者安装包 - -你可以通过源码和发行包两种方式来获取 Nacos。 - -### 从 Github 上下载源码方式 - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin - -``` - -### 下载编译后压缩包方式 - -您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 - - -```bash - unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.启动服务器 - -* 注：Nacos的运行需要以至少2C4g60g*3的机器配置下运行。 - -### Linux/Unix/Mac - -启动命令(standalone代表着单机模式运行，非集群模式): - -`sh startup.sh -m standalone` - -如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： - -`bash startup.sh -m standalone` - -### Windows - -启动命令(standalone代表着单机模式运行，非集群模式): - -`startup.cmd -m standalone` - -## 4.服务注册&发现和配置管理 - -### 服务注册 - -`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` - -### 服务发现 - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### 发布配置 - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` - -### 获取配置 - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` - -## 5.关闭服务器 - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`shutdown.cmd` - -或者双击shutdown.cmd运行文件。 +--- +title: Nacos 快速开始 +keywords: [Nacos,快速开始] +description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 +--- + +# Nacos 快速开始 + +这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 + +## 0.版本选择 + +Nacos 1.X 是老版本，将来会停止维护。 建议您使用2.X版本。 请移步到 [Nacos2.X相关文档](./v2/quickstart/quick-start.md). + +您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.2.3。 + +## 1.预备环境准备 + +Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: + +1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 +2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 +3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 + +## 2.下载源码或者安装包 + +你可以通过源码和发行包两种方式来获取 Nacos。 + +### 从 Github 上下载源码方式 + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin + +``` + +### 下载编译后压缩包方式 + +您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 + + +```bash + unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.启动服务器 + +* 注：Nacos的运行需要以至少2C4g60g*3的机器配置下运行。 + +### Linux/Unix/Mac + +启动命令(standalone代表着单机模式运行，非集群模式): + +`sh startup.sh -m standalone` + +如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： + +`bash startup.sh -m standalone` + +### Windows + +启动命令(standalone代表着单机模式运行，非集群模式): + +`startup.cmd -m standalone` + +## 4.服务注册&发现和配置管理 + +### 服务注册 + +`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` + +### 服务发现 + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### 发布配置 + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` + +### 获取配置 + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` + +## 5.关闭服务器 + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`shutdown.cmd` + +或者双击shutdown.cmd运行文件。 diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/version-2.X/v2/quickstart/quick-start.md b/i18n/zh-cn/docusaurus-plugin-content-docs/version-2.X/v2/quickstart/quick-start.md index 894c3d4a193..b3f386f01e0 100644 --- a/i18n/zh-cn/docusaurus-plugin-content-docs/version-2.X/v2/quickstart/quick-start.md +++ b/i18n/zh-cn/docusaurus-plugin-content-docs/version-2.X/v2/quickstart/quick-start.md @@ -1,107 +1,107 @@ ---- -title: Nacos 快速开始 -keywords: [Nacos,快速开始] -description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 ---- - -# Nacos 快速开始 - -这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 - -## 0.版本选择 -您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.1.1。 - -## 1.预备环境准备 - -Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: - -1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 -2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 -3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 - -## 2.下载源码或者安装包 - -你可以通过源码和发行包两种方式来获取 Nacos。 - -### 从 Github 上下载源码方式 - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin - -``` - -### 下载编译后压缩包方式 - -您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 - - -```bash - unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.修改配置文件 - -> 在2.2.0.1和2.2.1版本时，必须执行此变更，否则无法启动；其他版本为建议设置。 - -修改`conf`目录下的`application.properties`文件。 - -设置其中的`nacos.core.auth.plugin.nacos.token.secret.key`值，详情可查看[鉴权-自定义密钥](../plugin/auth-plugin.md). - -> 注意，文档中的默认值`SecretKey012345678901234567890123456789012345678901234567890123456789`和`VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=`为公开默认值，可用于临时测试，实际使用时请**务必**更换为自定义的其他有效值。 - -## 4.启动服务器 - -* 注：Nacos的运行建议至少在2C4G 60G的机器配置下运行。 - -### Linux/Unix/Mac - -启动命令(standalone代表着单机模式运行，非集群模式): - -`sh startup.sh -m standalone` - -如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： - -`bash startup.sh -m standalone` - -### Windows - -启动命令(standalone代表着单机模式运行，非集群模式): - -`startup.cmd -m standalone` - -## 5.服务注册&发现和配置管理 - -### 服务注册 - -`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` - -### 服务发现 - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### 发布配置 - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` - -### 获取配置 - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` - -## 6.关闭服务器 - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`shutdown.cmd` - -或者双击shutdown.cmd运行文件。 +--- +title: Nacos 快速开始 +keywords: [Nacos,快速开始] +description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 +--- + +# Nacos 快速开始 + +这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 + +## 0.版本选择 +您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.2.3。 + +## 1.预备环境准备 + +Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: + +1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 +2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 +3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 + +## 2.下载源码或者安装包 + +你可以通过源码和发行包两种方式来获取 Nacos。 + +### 从 Github 上下载源码方式 + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin + +``` + +### 下载编译后压缩包方式 + +您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 + + +```bash + unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.修改配置文件 + +> 在2.2.0.1和2.2.1版本时，必须执行此变更，否则无法启动；其他版本为建议设置。 + +修改`conf`目录下的`application.properties`文件。 + +设置其中的`nacos.core.auth.plugin.nacos.token.secret.key`值，详情可查看[鉴权-自定义密钥](../plugin/auth-plugin.md). + +> 注意，文档中的默认值`SecretKey012345678901234567890123456789012345678901234567890123456789`和`VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=`为公开默认值，可用于临时测试，实际使用时请**务必**更换为自定义的其他有效值。 + +## 4.启动服务器 + +* 注：Nacos的运行建议至少在2C4G 60G的机器配置下运行。 + +### Linux/Unix/Mac + +启动命令(standalone代表着单机模式运行，非集群模式): + +`sh startup.sh -m standalone` + +如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： + +`bash startup.sh -m standalone` + +### Windows + +启动命令(standalone代表着单机模式运行，非集群模式): + +`startup.cmd -m standalone` + +## 5.服务注册&发现和配置管理 + +### 服务注册 + +`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` + +### 服务发现 + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### 发布配置 + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` + +### 获取配置 + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` + +## 6.关闭服务器 + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`shutdown.cmd` + +或者双击shutdown.cmd运行文件。 diff --git a/versioned_docs/version-1.X/quick-start.md b/versioned_docs/version-1.X/quick-start.md index 7dae3340c6d..c03b0dde4e0 100644 --- a/versioned_docs/version-1.X/quick-start.md +++ b/versioned_docs/version-1.X/quick-start.md @@ -1,100 +1,100 @@ ---- -title: Nacos 快速开始 -keywords: [Nacos,快速开始] -description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 ---- - -# Nacos 快速开始 - -这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 - -## 0.版本选择 - -Nacos 1.X 是老版本，将来会停止维护。 建议您使用2.X版本。 请移步到 [Nacos2.X相关文档](./v2/quickstart/quick-start.md). - -您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.1.1。 - -## 1.预备环境准备 - -Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: - -1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 -2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 -3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 - -## 2.下载源码或者安装包 - -你可以通过源码和发行包两种方式来获取 Nacos。 - -### 从 Github 上下载源码方式 - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin - -``` - -### 下载编译后压缩包方式 - -您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 - - -```bash - unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.启动服务器 - -* 注：Nacos的运行需要以至少2C4g60g*3的机器配置下运行。 - -### Linux/Unix/Mac - -启动命令(standalone代表着单机模式运行，非集群模式): - -`sh startup.sh -m standalone` - -如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： - -`bash startup.sh -m standalone` - -### Windows - -启动命令(standalone代表着单机模式运行，非集群模式): - -`startup.cmd -m standalone` - -## 4.服务注册&发现和配置管理 - -### 服务注册 - -`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` - -### 服务发现 - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### 发布配置 - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` - -### 获取配置 - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` - -## 5.关闭服务器 - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`shutdown.cmd` - -或者双击shutdown.cmd运行文件。 +--- +title: Nacos 快速开始 +keywords: [Nacos,快速开始] +description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 +--- + +# Nacos 快速开始 + +这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 + +## 0.版本选择 + +Nacos 1.X 是老版本，将来会停止维护。 建议您使用2.X版本。 请移步到 [Nacos2.X相关文档](./v2/quickstart/quick-start.md). + +您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.2.3。 + +## 1.预备环境准备 + +Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: + +1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 +2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 +3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 + +## 2.下载源码或者安装包 + +你可以通过源码和发行包两种方式来获取 Nacos。 + +### 从 Github 上下载源码方式 + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin + +``` + +### 下载编译后压缩包方式 + +您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 + + +```bash + unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.启动服务器 + +* 注：Nacos的运行需要以至少2C4g60g*3的机器配置下运行。 + +### Linux/Unix/Mac + +启动命令(standalone代表着单机模式运行，非集群模式): + +`sh startup.sh -m standalone` + +如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： + +`bash startup.sh -m standalone` + +### Windows + +启动命令(standalone代表着单机模式运行，非集群模式): + +`startup.cmd -m standalone` + +## 4.服务注册&发现和配置管理 + +### 服务注册 + +`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` + +### 服务发现 + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### 发布配置 + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` + +### 获取配置 + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` + +## 5.关闭服务器 + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`shutdown.cmd` + +或者双击shutdown.cmd运行文件。 diff --git a/versioned_docs/version-1.X/v2/quickstart/quick-start.md b/versioned_docs/version-1.X/v2/quickstart/quick-start.md index 894c3d4a193..b3f386f01e0 100644 --- a/versioned_docs/version-1.X/v2/quickstart/quick-start.md +++ b/versioned_docs/version-1.X/v2/quickstart/quick-start.md @@ -1,107 +1,107 @@ ---- -title: Nacos 快速开始 -keywords: [Nacos,快速开始] -description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 ---- - -# Nacos 快速开始 - -这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 - -## 0.版本选择 -您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.1.1。 - -## 1.预备环境准备 - -Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: - -1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 -2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 -3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 - -## 2.下载源码或者安装包 - -你可以通过源码和发行包两种方式来获取 Nacos。 - -### 从 Github 上下载源码方式 - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin - -``` - -### 下载编译后压缩包方式 - -您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 - - -```bash - unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.修改配置文件 - -> 在2.2.0.1和2.2.1版本时，必须执行此变更，否则无法启动；其他版本为建议设置。 - -修改`conf`目录下的`application.properties`文件。 - -设置其中的`nacos.core.auth.plugin.nacos.token.secret.key`值，详情可查看[鉴权-自定义密钥](../plugin/auth-plugin.md). - -> 注意，文档中的默认值`SecretKey012345678901234567890123456789012345678901234567890123456789`和`VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=`为公开默认值，可用于临时测试，实际使用时请**务必**更换为自定义的其他有效值。 - -## 4.启动服务器 - -* 注：Nacos的运行建议至少在2C4G 60G的机器配置下运行。 - -### Linux/Unix/Mac - -启动命令(standalone代表着单机模式运行，非集群模式): - -`sh startup.sh -m standalone` - -如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： - -`bash startup.sh -m standalone` - -### Windows - -启动命令(standalone代表着单机模式运行，非集群模式): - -`startup.cmd -m standalone` - -## 5.服务注册&发现和配置管理 - -### 服务注册 - -`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` - -### 服务发现 - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### 发布配置 - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` - -### 获取配置 - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` - -## 6.关闭服务器 - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`shutdown.cmd` - -或者双击shutdown.cmd运行文件。 +--- +title: Nacos 快速开始 +keywords: [Nacos,快速开始] +description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 +--- + +# Nacos 快速开始 + +这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 + +## 0.版本选择 +您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.2.3。 + +## 1.预备环境准备 + +Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: + +1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 +2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 +3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 + +## 2.下载源码或者安装包 + +你可以通过源码和发行包两种方式来获取 Nacos。 + +### 从 Github 上下载源码方式 + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin + +``` + +### 下载编译后压缩包方式 + +您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 + + +```bash + unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.修改配置文件 + +> 在2.2.0.1和2.2.1版本时，必须执行此变更，否则无法启动；其他版本为建议设置。 + +修改`conf`目录下的`application.properties`文件。 + +设置其中的`nacos.core.auth.plugin.nacos.token.secret.key`值，详情可查看[鉴权-自定义密钥](../plugin/auth-plugin.md). + +> 注意，文档中的默认值`SecretKey012345678901234567890123456789012345678901234567890123456789`和`VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=`为公开默认值，可用于临时测试，实际使用时请**务必**更换为自定义的其他有效值。 + +## 4.启动服务器 + +* 注：Nacos的运行建议至少在2C4G 60G的机器配置下运行。 + +### Linux/Unix/Mac + +启动命令(standalone代表着单机模式运行，非集群模式): + +`sh startup.sh -m standalone` + +如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： + +`bash startup.sh -m standalone` + +### Windows + +启动命令(standalone代表着单机模式运行，非集群模式): + +`startup.cmd -m standalone` + +## 5.服务注册&发现和配置管理 + +### 服务注册 + +`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` + +### 服务发现 + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### 发布配置 + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` + +### 获取配置 + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` + +## 6.关闭服务器 + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`shutdown.cmd` + +或者双击shutdown.cmd运行文件。 diff --git a/versioned_docs/version-2.X/quick-start.md b/versioned_docs/version-2.X/quick-start.md index 7dae3340c6d..c03b0dde4e0 100644 --- a/versioned_docs/version-2.X/quick-start.md +++ b/versioned_docs/version-2.X/quick-start.md @@ -1,100 +1,100 @@ ---- -title: Nacos 快速开始 -keywords: [Nacos,快速开始] -description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 ---- - -# Nacos 快速开始 - -这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 - -## 0.版本选择 - -Nacos 1.X 是老版本，将来会停止维护。 建议您使用2.X版本。 请移步到 [Nacos2.X相关文档](./v2/quickstart/quick-start.md). - -您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.1.1。 - -## 1.预备环境准备 - -Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: - -1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 -2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 -3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 - -## 2.下载源码或者安装包 - -你可以通过源码和发行包两种方式来获取 Nacos。 - -### 从 Github 上下载源码方式 - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin - -``` - -### 下载编译后压缩包方式 - -您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 - - -```bash - unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.启动服务器 - -* 注：Nacos的运行需要以至少2C4g60g*3的机器配置下运行。 - -### Linux/Unix/Mac - -启动命令(standalone代表着单机模式运行，非集群模式): - -`sh startup.sh -m standalone` - -如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： - -`bash startup.sh -m standalone` - -### Windows - -启动命令(standalone代表着单机模式运行，非集群模式): - -`startup.cmd -m standalone` - -## 4.服务注册&发现和配置管理 - -### 服务注册 - -`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` - -### 服务发现 - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### 发布配置 - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` - -### 获取配置 - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` - -## 5.关闭服务器 - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`shutdown.cmd` - -或者双击shutdown.cmd运行文件。 +--- +title: Nacos 快速开始 +keywords: [Nacos,快速开始] +description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 +--- + +# Nacos 快速开始 + +这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 + +## 0.版本选择 + +Nacos 1.X 是老版本，将来会停止维护。 建议您使用2.X版本。 请移步到 [Nacos2.X相关文档](./v2/quickstart/quick-start.md). + +您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.2.3。 + +## 1.预备环境准备 + +Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: + +1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 +2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 +3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 + +## 2.下载源码或者安装包 + +你可以通过源码和发行包两种方式来获取 Nacos。 + +### 从 Github 上下载源码方式 + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin + +``` + +### 下载编译后压缩包方式 + +您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 + + +```bash + unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.启动服务器 + +* 注：Nacos的运行需要以至少2C4g60g*3的机器配置下运行。 + +### Linux/Unix/Mac + +启动命令(standalone代表着单机模式运行，非集群模式): + +`sh startup.sh -m standalone` + +如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： + +`bash startup.sh -m standalone` + +### Windows + +启动命令(standalone代表着单机模式运行，非集群模式): + +`startup.cmd -m standalone` + +## 4.服务注册&发现和配置管理 + +### 服务注册 + +`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` + +### 服务发现 + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### 发布配置 + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` + +### 获取配置 + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` + +## 5.关闭服务器 + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`shutdown.cmd` + +或者双击shutdown.cmd运行文件。 diff --git a/versioned_docs/version-2.X/v2/quickstart/quick-start.md b/versioned_docs/version-2.X/v2/quickstart/quick-start.md index 894c3d4a193..b3f386f01e0 100644 --- a/versioned_docs/version-2.X/v2/quickstart/quick-start.md +++ b/versioned_docs/version-2.X/v2/quickstart/quick-start.md @@ -1,107 +1,107 @@ ---- -title: Nacos 快速开始 -keywords: [Nacos,快速开始] -description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 ---- - -# Nacos 快速开始 - -这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 - -## 0.版本选择 -您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.1.1。 - -## 1.预备环境准备 - -Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: - -1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 -2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 -3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 - -## 2.下载源码或者安装包 - -你可以通过源码和发行包两种方式来获取 Nacos。 - -### 从 Github 上下载源码方式 - -```bash -git clone https://github.com/alibaba/nacos.git -cd nacos/ -mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U -ls -al distribution/target/ - -// change the $version to your actual path -cd distribution/target/nacos-server-$version/nacos/bin - -``` - -### 下载编译后压缩包方式 - -您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 - - -```bash - unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz - cd nacos/bin -``` - -## 3.修改配置文件 - -> 在2.2.0.1和2.2.1版本时，必须执行此变更，否则无法启动；其他版本为建议设置。 - -修改`conf`目录下的`application.properties`文件。 - -设置其中的`nacos.core.auth.plugin.nacos.token.secret.key`值，详情可查看[鉴权-自定义密钥](../plugin/auth-plugin.md). - -> 注意，文档中的默认值`SecretKey012345678901234567890123456789012345678901234567890123456789`和`VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=`为公开默认值，可用于临时测试，实际使用时请**务必**更换为自定义的其他有效值。 - -## 4.启动服务器 - -* 注：Nacos的运行建议至少在2C4G 60G的机器配置下运行。 - -### Linux/Unix/Mac - -启动命令(standalone代表着单机模式运行，非集群模式): - -`sh startup.sh -m standalone` - -如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： - -`bash startup.sh -m standalone` - -### Windows - -启动命令(standalone代表着单机模式运行，非集群模式): - -`startup.cmd -m standalone` - -## 5.服务注册&发现和配置管理 - -### 服务注册 - -`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` - -### 服务发现 - -`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` - -### 发布配置 - -`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` - -### 获取配置 - -`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` - -## 6.关闭服务器 - -### Linux/Unix/Mac - -`sh shutdown.sh` - -### Windows - -`shutdown.cmd` - -或者双击shutdown.cmd运行文件。 +--- +title: Nacos 快速开始 +keywords: [Nacos,快速开始] +description: 这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 +--- + +# Nacos 快速开始 + +这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。 + +## 0.版本选择 +您可以在Nacos的[release notes](https://github.com/alibaba/nacos/releases)及[博客](https://nacos.io/zh-cn/blog/index.html)中找到每个版本支持的功能的介绍，当前推荐的稳定版本为2.2.3。 + +## 1.预备环境准备 + +Nacos 依赖 [Java](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/) 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 [Maven](https://maven.apache.org/index.html)环境，请确保是在以下版本环境中安装使用: + +1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 +2. 64 bit JDK 1.8+；[下载](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) & [配置](https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/)。 +3. Maven 3.2.x+；[下载](https://maven.apache.org/download.cgi) & [配置](https://maven.apache.org/settings.html)。 + +## 2.下载源码或者安装包 + +你可以通过源码和发行包两种方式来获取 Nacos。 + +### 从 Github 上下载源码方式 + +```bash +git clone https://github.com/alibaba/nacos.git +cd nacos/ +mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U +ls -al distribution/target/ + +// change the $version to your actual path +cd distribution/target/nacos-server-$version/nacos/bin + +``` + +### 下载编译后压缩包方式 + +您可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases) 下载 `nacos-server-$version.zip` 包。 + + +```bash + unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz + cd nacos/bin +``` + +## 3.修改配置文件 + +> 在2.2.0.1和2.2.1版本时，必须执行此变更，否则无法启动；其他版本为建议设置。 + +修改`conf`目录下的`application.properties`文件。 + +设置其中的`nacos.core.auth.plugin.nacos.token.secret.key`值，详情可查看[鉴权-自定义密钥](../plugin/auth-plugin.md). + +> 注意，文档中的默认值`SecretKey012345678901234567890123456789012345678901234567890123456789`和`VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg=`为公开默认值，可用于临时测试，实际使用时请**务必**更换为自定义的其他有效值。 + +## 4.启动服务器 + +* 注：Nacos的运行建议至少在2C4G 60G的机器配置下运行。 + +### Linux/Unix/Mac + +启动命令(standalone代表着单机模式运行，非集群模式): + +`sh startup.sh -m standalone` + +如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行： + +`bash startup.sh -m standalone` + +### Windows + +启动命令(standalone代表着单机模式运行，非集群模式): + +`startup.cmd -m standalone` + +## 5.服务注册&发现和配置管理 + +### 服务注册 + +`curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'` + +### 服务发现 + +`curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'` + +### 发布配置 + +`curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"` + +### 获取配置 + +`curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"` + +## 6.关闭服务器 + +### Linux/Unix/Mac + +`sh shutdown.sh` + +### Windows + +`shutdown.cmd` + +或者双击shutdown.cmd运行文件。