Google Git
Sign in
apache / apisix-docker / f198360372dc73d65b408451082824457c58c48f
commitf198360372dc73d65b408451082824457c58c48f[log] [tgz]
authorJohn Bampton <jbampton@users.noreply.github.com>Sat Feb 27 22:20:39 2021 +1000
committerGitHub <noreply@github.com>Sat Feb 27 20:20:39 2021 +0800
treea4d3e9961af8e5c60a262e6e4ac00e1732bd143e
parent20e2a6a97c8a3c265232eafb5dc742d914f6306d [diff]
chore: fix spelling (#141)
2 files changed
tree: a4d3e9961af8e5c60a262e6e4ac00e1732bd143e
  1. .github/
  2. all-in-one/
  3. alpine/
  4. alpine-dev/
  5. alpine-local/
  6. centos/
  7. example/
  8. .asf.yaml
  9. .gitignore
  10. .markdownlint.yml
  11. build.md
  12. LICENSE
  13. Makefile
  14. manual.md
  15. README.md
README.md

Docker images are not official ASF releases but provided for convenience. Recommended usage is always to build the source.

How To Build Image

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.

Build an image from source

  1. Build from release version:
# Assign Apache release version number to variable `APISIX_VERSION`, for example: 2.2. The latest version can be find at `https://github.com/apache/apisix/releases`

export APISIX_VERSION=2.2
docker build -t apisix:${APISIX_VERSION}-alpine --build-arg APISIX_VERSION=${APISIX_VERSION} -f alpine/Dockerfile alpine
  1. Build from master branch version, which has latest code(ONLY for the developer's convenience):
export APISIX_VERSION=master
docker build -t apisix:${APISIX_VERSION}-alpine --build-arg APISIX_VERSION=${APISIX_VERSION} -f alpine/Dockerfile alpine
  1. Build from local code:
# To copy apisix into image, we need to include it in build context
cd <APISIX-PATH>
docker build -t apisix:alpine-local --build-arg APISIX_PATH=. -f <APISIX-DOCKER-PATH>/alpine-local/Dockerfile alpine
# 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.

$ docker build -t apisix:${APISIX_VERSION}-alpine --build-arg APISIX_VERSION=${APISIX_VERSION} --build-arg ENABLE_PROXY=true -f alpine/Dockerfile alpine

Manual deploy apisix via docker

Manual deploy

QuickStart via docker-compose

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.

Quick test with all dependencies in one Docker container

  • All in one Docker container for Apache APISIX
$ docker build -t apache/apisix:whole -f ./all-in-one/apisix/Dockerfile .
$ 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
  • All in one Docker container for Apache apisix-dashboard

The latest version of apisix-dashboard is 2.4 and should be used with APISIX 2.3.

$ docker build --build-arg APISIX_VERSION=2.2 --build-arg APISIX_DASHBOARD_VERSION=v2.3 -t apache/apisix-dashboard:whole -f ./all-in-one/apisix-dashboard/Dockerfile .
$ 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