跳到主要内容
版本:3.20.0

构建自定义 Docker 镜像

你可以基于已发布的 Docker 源码构建 APISIX 镜像,并根据环境定制该源码。

前置条件​

  • 安装 Git 以下载 Docker 源码。
  • 安装 Docker 以构建并运行镜像。
  • 安装 Make 以运行镜像构建目标。

克隆仓库​

克隆与本版本文档对应的发布分支:

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,即使守护进程已经启动,容器仍会退出。