docs: update Debian Installation Guide (apache#9680)

qiming-007 · Jun 19, 2023 · e19a466 · e19a466
1 parent 488ace4
commit e19a466
Show file tree

Hide file tree

Showing 2 changed files with 100 additions and 50 deletions.
diff --git a/docs/en/latest/installation-guide.md b/docs/en/latest/installation-guide.md
@@ -43,6 +43,7 @@ APISIX can be installed by the different methods listed below:
     {label: 'Docker', value: 'docker'},
     {label: 'Helm', value: 'helm'},
     {label: 'RPM', value: 'rpm'},
+    {label: 'DEB', value: 'deb'},
     {label: 'Source Code', value: 'source code'},
   ]}>
 <TabItem value="docker">
@@ -130,31 +131,6 @@ sudo yum install apisix-2.13.1
 
 :::
 
-### Installation via DEB repository
-
-Currently the only DEB repository supported by APISIX is Debian 11 (Bullseye) and supports both amd64 and arm64 architectures.
-
-```shell
-# amd64
-sudo echo "deb http://openresty.org/package/debian bullseye openresty" | tee /etc/apt/sources.list.d/openresty.list
-wget -O - https://openresty.org/package/pubkey.gpg | apt-key add -
-wget -O - http://repos.apiseven.com/pubkey.gpg | apt-key add -
-echo "deb http://repos.apiseven.com/packages/debian bullseye main" | tee /etc/apt/sources.list.d/apisix.list
-
-# arm64
-sudo echo "deb http://openresty.org/package/debian bullseye openresty" | tee /etc/apt/sources.list.d/openresty.list
-wget -O - https://openresty.org/package/pubkey.gpg | apt-key add -
-wget -O - http://repos.apiseven.com/pubkey.gpg | apt-key add -
-echo "deb http://repos.apiseven.com/packages/arm64/debian bullseye main" | tee /etc/apt/sources.list.d/apisix.list
-```
-
-Then, to install APISIX, run:
-
-```shell
-sudo apt update
-sudo apt install -y apisix=3.0.0-0
-```
-
 ### Installation via RPM offline package
 
 First, download APISIX RPM offline package to an `apisix` folder:
@@ -194,6 +170,55 @@ Run `apisix help` to get a list of all available operations.
 
 </TabItem>
 
+<TabItem value="deb">
+
+### Installation via DEB repository
+
+Currently the only DEB repository supported by APISIX is Debian 11 (Bullseye) and supports both amd64 and arm64 architectures.
+
+```shell
+# amd64
+echo "deb http://openresty.org/package/debian bullseye openresty" | sudo tee /etc/apt/sources.list.d/openresty.list
+wget -O - https://openresty.org/package/pubkey.gpg | sudo apt-key add -
+wget -O - http://repos.apiseven.com/pubkey.gpg | sudo apt-key add -
+echo "deb http://repos.apiseven.com/packages/debian bullseye main" | sudo tee /etc/apt/sources.list.d/apisix.list
+
+# arm64
+echo "deb http://openresty.org/package/debian bullseye openresty" | sudo tee /etc/apt/sources.list.d/openresty.list
+wget -O - https://openresty.org/package/pubkey.gpg | sudo apt-key add -
+wget -O - http://repos.apiseven.com/pubkey.gpg | sudo apt-key add -
+echo "deb http://repos.apiseven.com/packages/arm64/debian bullseye main" | sudo tee /etc/apt/sources.list.d/apisix.list
+```
+
+Then, to install APISIX, run:
+
+```shell
+sudo apt update
+sudo apt install -y apisix=3.0.0-0
+```
+
+### Managing APISIX server
+
+Once APISIX is installed, you can initialize the configuration file and etcd by running:
+
+```shell
+sudo apisix init
+```
+
+To start APISIX server, run:
+
+```shell
+sudo apisix start
+```
+
+:::tip
+
+Run `apisix help` to get a list of all available operations.
+
+:::
+
+</TabItem>
+
 <TabItem value="source code">
 
 If you want to build APISIX from source, please refer to [Building APISIX from source](./building-apisix.md).

diff --git a/docs/zh/latest/installation-guide.md b/docs/zh/latest/installation-guide.md
@@ -44,6 +44,7 @@ import TabItem from '@theme/TabItem';
     {label: 'Docker', value: 'docker'},
     {label: 'Helm', value: 'helm'},
     {label: 'RPM', value: 'rpm'},
+    {label: 'DEB', value: 'deb'},
     {label: 'Source Code', value: 'source code'},
   ]}>
 <TabItem value="docker">
@@ -133,31 +134,6 @@ sudo yum install apisix-2.13.1
 
 :::
 
-### 通过 DEB 仓库安装
-
-目前 APISIX 支持的 DEB 仓库仅支持 Debian 11（Bullseye），并且支持 amd64 和 arm64 架构。
-
-```shell
-# amd64
-sudo echo "deb http://openresty.org/package/debian bullseye openresty" | tee /etc/apt/sources.list.d/openresty.list
-wget -O - https://openresty.org/package/pubkey.gpg | apt-key add -
-wget -O - http://repos.apiseven.com/pubkey.gpg | apt-key add -
-echo "deb http://repos.apiseven.com/packages/debian bullseye main" | tee /etc/apt/sources.list.d/apisix.list
-
-# arm64
-sudo echo "deb http://openresty.org/package/debian bullseye openresty" | tee /etc/apt/sources.list.d/openresty.list
-wget -O - https://openresty.org/package/pubkey.gpg | apt-key add -
-wget -O - http://repos.apiseven.com/pubkey.gpg | apt-key add -
-echo "deb http://repos.apiseven.com/packages/arm64/debian bullseye main" | tee /etc/apt/sources.list.d/apisix.list
-```
-
-完成上述操作后使用以下命令安装 APISIX：
-
-```shell
-sudo apt update
-sudo apt install -y apisix=3.0.0-0
-```
-
 ### 通过 RPM 包离线安装：
 
 将 APISIX 离线 RPM 包下载到 `apisix` 文件夹：
@@ -197,6 +173,55 @@ apisix start
 
 </TabItem>
 
+<TabItem value="deb">
+
+### 通过 DEB 仓库安装
+
+目前 APISIX 支持的 DEB 仓库仅支持 Debian 11（Bullseye），并且支持 amd64 和 arm64 架构。
+
+```shell
+# amd64
+echo "deb http://openresty.org/package/debian bullseye openresty" | sudo tee /etc/apt/sources.list.d/openresty.list
+wget -O - https://openresty.org/package/pubkey.gpg | sudo apt-key add -
+wget -O - http://repos.apiseven.com/pubkey.gpg | sudo apt-key add -
+echo "deb http://repos.apiseven.com/packages/debian bullseye main" | sudo tee /etc/apt/sources.list.d/apisix.list
+
+# arm64
+echo "deb http://openresty.org/package/debian bullseye openresty" | sudo tee /etc/apt/sources.list.d/openresty.list
+wget -O - https://openresty.org/package/pubkey.gpg | sudo apt-key add -
+wget -O - http://repos.apiseven.com/pubkey.gpg | sudo apt-key add -
+echo "deb http://repos.apiseven.com/packages/arm64/debian bullseye main" | sudo tee /etc/apt/sources.list.d/apisix.list
+```
+
+完成上述操作后使用以下命令安装 APISIX：
+
+```shell
+sudo apt update
+sudo apt install -y apisix=3.0.0-0
+```
+
+### 管理 APISIX 服务
+
+APISIX 安装完成后，你可以运行以下命令初始化 NGINX 配置文件和 etcd：
+
+```shell
+sudo apisix init
+```
+
+使用以下命令启动 APISIX：
+
+```shell
+sudo apisix start
+```
+
+:::tip
+
+你可以运行 `apisix help` 命令，通过查看返回结果，获取其他操作的命令及描述。
+
+:::
+
+</TabItem>
+
 <TabItem value="source code">
 
 如果你想要使用源码构建 APISIX，请参考 [源码安装 APISIX](./building-apisix.md)。