构建自定义 Docker 镜像
你可以基于已发布的 Docker 源码构建 APISIX 镜像,并根据环境定制该源码。
前置条件
克隆仓库
克隆与本版本文档对应的发布分支:
git clone --branch release/apisix-3.20.0 --depth 1 https://github.com/apache/apisix-docker.git
cd apisix-docker
构建 Docker 镜像
使用 Make 构建 Ubuntu 镜像:
make build-on-ubuntu
若要构建其他受支持的镜像,请使用 make build-on-debian 或 make build-on-redhat。
检查 Docker 镜像
确认构建的镜像包含预期的 APISIX 版本:
docker run --rm --entrypoint apisix \
apache/apisix:3.20.0-ubuntu version
你应该看到 APISIX 版本:
3.20.0
保留容器入口点
扩展镜像时,请保留发布镜像的 /docker-entrypoint.sh 入口点和 docker-start 命令。入口点会初始化 APISIX,然后以 daemon off; 执行 OpenResty,使网关作为容器的最终进程保持在前台运行。
不要将容器命令替换为 apisix start。该命令在 OpenResty 以守护进程模式启动后返回。因此,如果容器的最终进程仅为 apisix start,即使守护进程已经启动,容器仍会退出。