diff --git a/README_CN.md b/README_CN.md index 6228b194b8dd..2b85609e6f7a 100644 --- a/README_CN.md +++ b/README_CN.md @@ -121,7 +121,7 @@ APISIX 在以下操作系统中可顺利安装并做过运行测试,需要注 CentOS 7, Ubuntu 16.04, Ubuntu 18.04, Debian 9, Debian 10, macOS, **[ARM64](https://zhuanlan.zhihu.com/p/84467919)** Ubuntu 18.04 安装 APISIX 的步骤: -1. 安装运行时依赖:OpenResty 和 etcd,参考[依赖安装文档](doc/install-dependencies.md) +1. 安装运行时依赖:OpenResty 和 etcd,参考[依赖安装文档](doc/install-dependencies-cn.md) 2. 有以下几种方式来安装 Apache APISIX: - 通过[源码包安装](doc/how-to-build-cn.md#通过源码包安装); - 如果你在使用 CentOS 7,可以使用 [RPM 包安装](doc/how-to-build-cn.md#通过-rpm-包安装centos-7); diff --git a/doc/how-to-build-cn.md b/doc/how-to-build-cn.md index 3f54eb034620..d2d5dbcc1928 100644 --- a/doc/how-to-build-cn.md +++ b/doc/how-to-build-cn.md @@ -23,7 +23,7 @@ Apache APISIX 的运行环境需要 Nginx 和 etcd, -所以在安装前,请根据不同的操作系统来[安装依赖](install-dependencies.md)。 +所以在安装前,请根据不同的操作系统来[安装依赖](install-dependencies-cn.md)。 ## 2. 安装 Apache APISIX diff --git a/doc/install-dependencies-cn.md b/doc/install-dependencies-cn.md new file mode 100644 index 000000000000..1ada388b756e --- /dev/null +++ b/doc/install-dependencies-cn.md @@ -0,0 +1,137 @@ + + +# 安装依赖 +- [CentOS 6](#centos-6) +- [CentOS 7](#centos-7) +- [Ubuntu 16.04 & 18.04](#ubuntu-1604--1804) +- [Debian 9 & 10](#debian-9--10) +- [Mac OSX](#mac-osx) +- [如何编译 Openresty](#如何编译-Openresty) +- [注意](#注意) + +CentOS 6 +======== + +```shell +# 添加 OpenResty 源 +sudo yum install yum-utils +sudo yum-config-manager --add-repo https://openresty.org/package/centos/openresty.repo + +# 安装 OpenResty, etcd 和 编译工具 +sudo yum install -y openresty curl git gcc luarocks lua-devel make + +wget https://github.com/etcd-io/etcd/releases/download/v3.3.13/etcd-v3.3.13-linux-amd64.tar.gz +tar -xvf etcd-v3.3.13-linux-amd64.tar.gz && \ + cd etcd-v3.3.13-linux-amd64 && \ + sudo cp -a etcd etcdctl /usr/bin/ + +# 开启 etcd server +nohup etcd & +``` + +CentOS 7 +======== + +```shell +# 安装 epel, `luarocks` 需要它 +wget http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm +sudo rpm -ivh epel-release-latest-7.noarch.rpm + +# 添加 OpenResty 源 +sudo yum install yum-utils +sudo yum-config-manager --add-repo https://openresty.org/package/centos/openresty.repo + +# 安装 OpenResty, etcd 和 编译工具 +sudo yum install -y etcd openresty curl git gcc luarocks lua-devel + +# 开启 etcd server +sudo service etcd start +``` + +Ubuntu 16.04 & 18.04 +==================== + +```shell +# 添加 OpenResty 源 +wget -qO - https://openresty.org/package/pubkey.gpg | sudo apt-key add - +sudo apt-get update +sudo apt-get -y install software-properties-common +sudo add-apt-repository -y "deb http://openresty.org/package/ubuntu $(lsb_release -sc) main" +sudo apt-get update + +# 安装 OpenResty, etcd 和 编译工具 +sudo apt-get install -y git etcd openresty curl luarocks + +# 开启 etcd server +sudo service etcd start +``` + +Debian 9 & 10 +============= + +```shell +# 可选 +sed -i 's|^deb http://deb.debian.org/debian|deb http://mirrors.huaweicloud.com/debian|g' /etc/apt/sources.list +sed -i 's|^deb http://security.debian.org/debian-security|deb http://mirrors.huaweicloud.com/debian-security|g' /etc/apt/sources.list +apt update +apt install wget gnupg -y + +# 添加 OpenResty 源 +wget -qO - https://openresty.org/package/pubkey.gpg | sudo apt-key add - +sudo apt-get -y install software-properties-common +sudo add-apt-repository -y "deb http://openresty.org/package/debian $(lsb_release -sc) openresty" +sudo apt-get update + +# 安装 etcd +wget https://github.com/etcd-io/etcd/releases/download/v3.3.13/etcd-v3.3.13-linux-amd64.tar.gz +tar -xvf etcd-v3.3.13-linux-amd64.tar.gz && \ + cd etcd-v3.3.13-linux-amd64 && \ + sudo cp -a etcd etcdctl /usr/bin/ + +# 安装 OpenResty, etcd 和 编译工具 +sudo apt-get install -y git openresty curl luarocks make + +# 开启 etcd server +nohup etcd & +``` + +Mac OSX +======= + +```shell +# 安装 OpenResty, etcd 和 编译工具 +brew install openresty/brew/openresty etcd luarocks curl git + +# 开启 etcd server 并启用 v2 的功能 +etcd --enable-v2=true & +``` + +如何编译 Openresty +============================ + +编译 Openresty 是一件比较复杂的事情,没办法简单地说明白。所以我们推荐你直接参考官方的安装文档。 + +http://openresty.org/en/linux-packages.html + +注意 +==== +- Apache APISIX 目前只支持 `v2` 版本的 etcd,但是最新版的 etcd (从 3.4 起)已经默认关闭了 `v2` 版本的功能。所以你需要添加启动参数 `--enable-v2=true` 来开启 `v2` 的功能,目前对 `v3` etcd 的开发工作已经启动,不久后便可投入使用。 + +- 如果你要想使用 Tengine 替代 OpenResty,请参考 [Install Tengine at Ubuntu](../.travis/linux_tengine_runner.sh)。