关于Apache APISIX启动时通过配置文件加载资源的咨询

当然可以，Apache APISIX 支持在启动阶段通过配置文件批量加载 routes、upstreams、consumers 等资源，无需每次部署后手动调用 API 创建。以下是具体实现方式：

1. 通过本地 YAML 配置文件加载 #

你可以将所有需要预置的资源定义在单独的 YAML 文件中，然后在 APISIX 的主配置文件 config.yaml 中指定加载路径。

步骤1：创建资源配置文件 #

新建一个如 initial_resources.yaml 的文件，按以下格式定义资源：

# 定义路由
routes:
  - id: "demo_route"
    uri: "/demo/*"
    upstream_id: "demo_upstream"
    plugins:
      rewrite:
        uri: "/api$uri"

# 定义上游服务
upstreams:
  - id: "demo_upstream"
    nodes:
      "192.168.1.100:80": 1
      "192.168.1.101:80": 1
    type: "roundrobin"

# 定义消费者
consumers:
  - id: "demo_consumer"
    username: "dev_user"
    plugins:
      key-auth:
        key: "dev_secret_key"

步骤2：修改主配置文件加载资源 #

编辑 APISIX 的 config.yaml，在 deployment.admin.conf 下配置使用 YAML 作为配置中心，并指定资源文件路径：

deployment:
  admin:
    conf:
      config_center: yaml
      yaml:
        prefix: "/usr/local/apisix/conf/initial_resources.yaml"  # 替换为你的实际文件路径

启动 APISIX 后，这些资源会自动加载并生效，无需手动调用 API。

2. 关键注意事项 #

• YAML 语法规范：确保资源配置文件的 YAML 格式正确，缩进、冒号等符号使用规范，否则会导致 APISIX 启动失败。
• 配置中心兼容性：如果使用 etcd 作为默认配置中心，预置资源会被同步到 etcd 中，后续通过 API 修改资源会覆盖初始配置。
• 内存模式可选：若不需要持久化资源，可将 config_center 设置为 memory，但重启 APISIX 后资源会丢失，仅适合测试场景。
• 版本适配：不同版本的 APISIX 可能在配置项细节上略有差异，需对应版本调整配置。

内容的提问来源于stack exchange，提问作者Jost