Deploy with Source Codes
The Dashboard contains both manager-api
and web
, but web
is optional.
The manager-api
and web
will be included in this build guide product.
#
PrerequisitesBefore using source codes to build, make sure that the following dependencies are installed in your environment.
#
manager-api- Golang 1.13+: For users in mainland China, you can use the following command to speed up the module downloads.
$ go env -w GOPROXY=https://goproxy.cn,direct
#
web#
Clone the project$ git clone -b release/2.6.1 https://github.com/apache/apisix-dashboard.git
#
Build$ cd apisix-dashboard
$ make build
When the build is complete, the results are stored in the root output
directory.
Note: make build
will build manger-api
and web
, use the make help
command to see more commands.
#
Launch- After the build is complete and before you start, make sure the following dependencies are installed and running in your environment.
- etcd 3.4.0+
Check and modify the configuration information in
output/conf/conf.yaml
according to your deployment environment.Launch the Dashboard
$ cd ./output
$ ./manager-api
# or running in background
$ nohup ./manager-api &
Without changing the configuration, visit
http://127.0.0.1:9000
to use the dashboard with GUI, where the default username and password areadmin
.Stop the Dashboard
manager-api
provides a sub command stop
to quit the program gracefully, just
run:
$ ./manager-api stop
#
Working directorythe output
directory mention above is the default working directory.
You can move the entire directory to any path you want, and use the -p
to specify it as the working directory.
For example, you can move it to /usr/local/apisix-dashboard/
$ mv ./output/manager-api /usr/local/bin/
$ mv ./output/ /usr/local/apisix-dashboard/
$ manager-api -p /usr/local/apisix-dashboard/