commit | 47122bf141cc08cf22a44fbafab15b67d45c0c77 | [log] [tgz] |
---|---|---|
author | Ayush das <ayush24das@gmail.com> | Mon Apr 19 08:37:41 2021 +0530 |
committer | GitHub <noreply@github.com> | Mon Apr 19 11:07:41 2021 +0800 |
tree | 329f8b9f683d2328e08e9f6d04cfce2026ec15c2 | |
parent | 155cd24fb9fd8cb28b7bd643b5dd4fd740cc4511 [diff] |
docs: Replace `docker build` command with `make` (#161)
Docker images are not official ASF releases but provided for convenience. Recommended usage is always to build the source.
The master branch is for the version of Apache APISIX 2.x. If you need a previous version, please build from the v1.x tag.
# Assign Apache release version number to variable `APISIX_VERSION`, for example: 2.4. The latest version can be find at `https://github.com/apache/apisix/releases` export APISIX_VERSION=2.4 # alpine $ make build-on-alpine # centos $ make build-on-centos
export APISIX_VERSION=master # alpine $ make build-on-alpine # centos $ make build-on-centos
# To copy apisix into image, we need to include it in build context $ cd <APISIX-PATH> # alpine $ APISIX_PATH=/path/to/apisix make build-on-alpine-local # Might need root privilege if encounter "error checking context: 'can't stat'"
Note: For Chinese, the following command is always recommended. The additional build argument ENABLE_PROXY=true
will enable proxy to definitely accelerate the progress.
$ make build-on-alpine-cn
start all modules with docker-compose
$ cd example $ docker-compose -p docker-apisix up -d
You can refer to the docker-compose example for more try.
$ make build-all-in-one $ docker run -v `pwd`/all-in-one/apisix/config.yaml:/usr/local/apisix/conf/config.yaml -p 9080:9080 -p 2379:2379 -d apache/apisix:whole
The latest version of apisix-dashboard
is 2.4 and should be used with APISIX 2.3.
$ make build-dashboard $ docker run -v `pwd`/all-in-one/apisix/config.yaml:/usr/local/apisix/conf/config.yaml -v `pwd`/all-in-one/apisix-dashboard/conf.yaml:/usr/local/apisix-dashboard/conf/conf.yaml -p 9080:9080 -p 2379:2379 -p 9000:9000 -d apache/apisix-dashboard:whole
Tips: If there is a port conflict, please modify the host port through docker run -p
, e.g.
$ docker run -v `pwd`/all-in-one/apisix/config.yaml:/usr/local/apisix/conf/config.yaml -v `pwd`/all-in-one/apisix-dashboard/conf.yaml:/usr/local/apisix-dashboard/conf/conf.yaml -p 19080:9080 -p 12379:2379 -p 19000:9000 -d apache/apisix-dashboard:whole