mirror of
https://gitee.com/iresty/apisix.git
synced 2024-12-14 08:51:29 +08:00
3.7 KiB
3.7 KiB
Build Apache APISIX
1. Install dependencies
The runtime environment for Apache APISIX requires Nginx and etcd.
So before installation, please follow the different operating systems install Dependencies.
2. Install Apache APISIX
You can install Apache APISIX in a variety of ways, including source code packages, Docker, and Luarocks.
Installation via source release
You need to download the Apache source release first:
wget http://www.apache.org/dist/incubator/apisix/1.0/apache-apisix-1.0-incubating-src.tar.gz
tar zxvf apache-apisix-1.0-incubating-src.tar.gz
Install the Lua libraries that the runtime depends on:
cd apache-apisix-1.0-incubating
make deps
Installation via RPM package (CentOS 7)
sudo yum install -y https://github.com/apache/incubator-apisix/releases/download/1.0/apisix-1.0-0.el7.noarch.rpm
Installation via Luarocks (macOS not supported)
Execute the following command in the terminal to complete the installation of APISIX (only recommended for developers):
Install the code for the master branch via a script
sudo sh -c "$(curl -fsSL https://raw.githubusercontent.com/apache/incubator-apisix/master/utils/install-apisix.sh)"
Install the specified version via Luarocks:
# Install version 1.0
sudo luarocks install --lua-dir=/path/openresty/luajit apisix 1.0
# old luarocks not support the `lua-dir` parameter, you can remove this option
sudo luarocks install apisix 1.0
Manage (start/stop) APISIX Server
We can start the APISIX server by command make run
in APISIX home folder,
or we can stop APISIX server by command make stop
.
# init nginx config file and etcd
$ make init
# start APISIX server
$ make run
# stop APISIX server
$ make stop
# more actions find by `help`
$ make help
Makefile rules:
help: Show Makefile rules.
deps: Installation dependencies
utils: Installation tools
lint: Lint Lua source code
init: Initialize the runtime environment
run: Start the apisix server
stop: Stop the apisix server
clean: Remove generated files
reload: Reload the apisix server
install: Install the apisix
test: Run the test case
license-check: Check lua souce code for Apache License
Test
- Install perl's package manager
cpanminus
first - Then install
test-gninx
viacpanm
::sudo cpanm --notest Test::Nginx IPC::Run > build.log 2>&1 || (cat build.log && exit 1)
- Clone source code:
git clone https://github.com/openresty/test-nginx.git
; - Load the
test-nginx
library with perl'sprove
command and run the test cases in the/t
directory:- Run the test cases:
prove -Itest-nginx/lib -r t
- To set the path of nginx to run the test cases:
TEST_NGINX_BINARY=/usr/local/bin/openresty prove -Itest-nginx/lib -r t
- Run the test cases: