使用 Docker 安装 APISIX
APISIX Docker 镜像提供一致、可移植的运行方式,支持独立和解耦部署模式。以下示例均使用一台 Docker 主机,将配置持久化在 APISIX 容器外,并添加进程健康检查和重启策略。这台主机仍是单点故障。
unless-stopped 策略会在容器主进程退出或 Docker 守护进程重启时重新启动容器,除非操作员已停止该容器。仅有 unhealthy 状态不会触发重启。
前置条件
独立模式
以下步骤介绍了如何使用 Docker 在 文件驱动的独立模式 下安装 APISIX,同时使用 YAML 配置提供程序和 apisix.yaml 进行网关配置。
本节提供了一种使用 Docker 卷 实现数据持久化的方法。请相应调整该方法以与你的基础设施集成。
在主机上创建配置文件
为了实现数据持久化,创建一个用于配置文件的目录,并在其中创建 配置文件 config.yaml 和 apisix.yaml:
mkdir ~/conf
cat <<'EOF' > ~/conf/config.yaml
deployment:
role: data_plane
role_data_plane:
config_provider: yaml
#END
EOF
cat <<'EOF' > ~/conf/apisix.yaml
routes:
-
id: example-route-to-httpbin
uri: /anything/test
upstream:
nodes:
httpbin.org: 1
type: roundrobin
#END
EOF
❶ config.yaml:此文件将 APISIX 配置为以 文件驱动的独立模式运行,并使用 YAML 配置提供程序。
❷ apisix.yaml:此文件在启动时在容器中不存在。它是在主机上创建的,带有一个示例路由,以挂载到容器并避免可能出现的任何配置错误。
在主机上创建 apisix 用户
如果你使用的是基于 Debian 或 Ubuntu 的 APISIX Docker 镜像,为了以适当的权限卷挂载在上一步中创建的文件,你应该创建一个与容器中的 apisix 用户具有相同 gid 和 uid 的 apisix 用户,并将配置文件的所有者更改为 apisix。
创建一个 uid 和 gid 为 636 的用户 apisix:
groupadd --system --gid 636 apisix
useradd --system --gid apisix --no-create-home --shell /usr/sbin/nologin --uid 636 apisix
将包含配置文件的目录的所有权更改为 apisix:
chown -R apisix:apisix ~/conf
安装 APISIX
在环境变量中指定 Docker 镜像标签:
TAG=3.20.0-ubuntu
以独立模式启动 APISIX,并将 ~/conf 中的配置文件挂载到容器:
docker run -d \
--name apisix-standalone \
--restart unless-stopped \
--health-cmd 'test -s /usr/local/apisix/logs/nginx.pid && kill -0 "$(cat /usr/local/apisix/logs/nginx.pid)"' \
--health-interval 10s \
--health-timeout 5s \
--health-retries 5 \
--health-start-period 30s \
-p9080:9080 -p9443:9443 \
-e APISIX_STAND_ALONE=true \
--mount type=bind,source="$HOME"/conf/apisix.yaml,target=/usr/local/apisix/conf/apisix.yaml \
--mount type=bind,source="$HOME"/conf/config.yaml,target=/usr/local/apisix/conf/config.yaml \
apache/apisix:${TAG}