Нет описания

leslie e398cb6ac7 feat: upgrade APISIX to 2.13.0 (#295) 2 лет назад
.github e398cb6ac7 feat: upgrade APISIX to 2.13.0 (#295) 2 лет назад
all-in-one e398cb6ac7 feat: upgrade APISIX to 2.13.0 (#295) 2 лет назад
alpine e398cb6ac7 feat: upgrade APISIX to 2.13.0 (#295) 2 лет назад
alpine-dev 407610575b feat: upgrade dependency to 1.19.9.1.4 (#294) 2 лет назад
alpine-local 3dc527ccff fix(alpine): missing openldap (#278) 2 лет назад
centos e398cb6ac7 feat: upgrade APISIX to 2.13.0 (#295) 2 лет назад
compose 07e45fc003 docs: add the ASF header (#266) 3 лет назад
dashboard 10a8c99d2d chore: solve build error (type *big.Int has no field or method FillBy… (#281) 2 лет назад
docs 3ecee9b38b docs: optimize the reading experience (#226) 3 лет назад
example e398cb6ac7 feat: upgrade APISIX to 2.13.0 (#295) 2 лет назад
.asf.yaml f9705d9b61 chore: add .asf.yaml (#131) 3 лет назад
.gitignore 4b9063bd2f CI: add apisix-docker test (#133) 3 лет назад
.markdownlint.yml 07e45fc003 docs: add the ASF header (#266) 3 лет назад
LICENSE 071007a851 Initial commit 5 лет назад
MAINTAINING.md 9d2b2f8104 ci: change new release trigger from release to release branch (#178) 3 лет назад
Makefile e398cb6ac7 feat: upgrade APISIX to 2.13.0 (#295) 2 лет назад
README.md f19cfe2e1b ci(apisix-dev): timed sync apisix-dev image (#291) 2 лет назад

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 to variable `APISIX_VERSION`, for example: 2.9.
    # The latest release version can be find at `https://github.com/apache/apisix/releases`
    
    export APISIX_VERSION=2.9
    
    # build alpine based image
    make build-on-alpine
    
    # build centos based image
    make build-on-centos
    
  2. Build from master branch version, which has latest code(ONLY for the developer's convenience):

    export APISIX_VERSION=master
    
    # build alpine based image
    make build-on-alpine
    
    # build centos based image
    make build-on-centos
    
  3. Build from local code:

    # To copy apisix into image, we need to include it in build context
    cp -r <APISIX-PATH> ./apisix
    
    export APISIX_PATH=./apisix
    make build-on-alpine-local
    
    # Might need root privilege if encounter "error checking context: 'can't start'"
    

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
  1. Build apisix-dashboard from release version:

    # Assign the release version of Apache APISIX Dashboard to variable `APISIX_DASHBOARD_VERSION`, for example: 2.10.
    # The latest release version can be found at `https://github.com/apache/apisix-dashboard/releases`
    
    export APISIX_DASHBOARD_VERSION=2.10
    
    # build alpine based image
    make build-dashboard-alpine
    
    # build centos based image
    make build-dashboard-centos
    

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

    make build-all-in-one
    
    # launch APISIX container
    docker run -d \
    -p 9080:9080 -p 9091:9091 -p 2379:2379 \
    -v `pwd`/all-in-one/apisix/config.yaml:/usr/local/apisix/conf/config.yaml \
    apache/apisix:whole
    
  • All in one Docker container for Apache apisix-dashboard

The latest version of apisix-dashboard is 2.10 and can be used with APISIX 2.11.

make build-dashboard-all-in-one

# launch APISIX-dashboard container
docker run -d \
-p 9080:9080 -p 9091:9091 -p 2379:2379 -p 9000:9000 \
-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 \
apache/apisix-dashboard:whole

Tips: If there is a port conflict, please modify the host port through docker run -p, e.g.

# launch APISIX-AIO container
docker run -d \
-p 19080:9080 -p 19091:9091 -p 12379:2379 -p 19000:9000 \
-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 \
apache/apisix-dashboard:whole

Note

Prometheus

Apache APISIX expose prometheus metrics port on 9091, and you need to expose it to 0.0.0.0 instead of the default 127.0.0.1 to make it accessible outside docker. You could achieve it with adding the following to your config.yaml.

plugin_attr:
  prometheus:
    export_addr:
      ip: "0.0.0.0"
      port: 9091

APISIX-Dev Image

At 0:00 UTC every day, the APISIX master code will be automatically built and synchronized to the Docker Hub repository. You can pull the latest master branch image in the following ways.

docker pull apache/apisix:dev