Bez popisu

nic-chen 088e5aefc3 fix: docker login před 3 roky
.github 088e5aefc3 fix: docker login před 3 roky
all-in-one 46b1a02bd7 chore: use the correct prometheus port for docker compose (#205) před 3 roky
alpine 619d26df77 fix: add pcre denpendency to all dockerfile (#206) před 3 roky
alpine-dev 619d26df77 fix: add pcre denpendency to all dockerfile (#206) před 3 roky
alpine-local 20a7f9def0 ci: Add PCRE package for dependency installation (#202) před 3 roky
centos 47a6cbb77d feat: release APISIX 2.8 (#199) před 3 roky
compose 46b1a02bd7 chore: use the correct prometheus port for docker compose (#205) před 3 roky
dashboard 611168f365 feat: release APISIX Dashboard 2.7.1 před 3 roky
docs 46b1a02bd7 chore: use the correct prometheus port for docker compose (#205) před 3 roky
example 46b1a02bd7 chore: use the correct prometheus port for docker compose (#205) před 3 roky
.asf.yaml f9705d9b61 chore: add .asf.yaml (#131) před 3 roky
.gitignore 4b9063bd2f CI: add apisix-docker test (#133) před 3 roky
.markdownlint.yml f5c17e0fa8 feat: add a GitHub Action to lint the Markdown (#105) před 4 roky
LICENSE 071007a851 Initial commit před 5 roky
MAINTAINING.md 9d2b2f8104 ci: change new release trigger from release to release branch (#178) před 3 roky
Makefile 611168f365 feat: release APISIX Dashboard 2.7.1 před 3 roky
README.md 46b1a02bd7 chore: use the correct prometheus port for docker compose (#205) před 3 roky

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

    export APISIX_VERSION=master
    # alpine
    $ make build-on-alpine
    
    # centos
    $ 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
    $ APISIX_PATH=./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

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
    $ docker run -v `pwd`/all-in-one/apisix/config.yaml:/usr/local/apisix/conf/config.yaml -p 9080:9080 -p 9091:9091 -p 2379:2379 -d apache/apisix:whole
    
  • All in one Docker container for Apache apisix-dashboard

The latest version of apisix-dashboard is 2.7 and should be used with APISIX 2.6.

$ 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 9091:9091 -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 19091:9091 -p 12379:2379 -p 19000:9000 -d apache/apisix-dashboard:whole

Note

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