断网重启APIM Self Hosted Gateway Docker容器如何读取本地配置

前置检查 #

• 确认持久化Volume挂载配置正确：APIM自托管网关默认持久化配置存储路径为/app/configuration，容器启动时需将该路径挂载到本地宿主机的可靠目录，参考启动命令示例：

docker run -d -v /your/local/config/path:/app/configuration <其他原有启动参数> <SHG镜像名:标签>

• 确认挂载的本地目录内存在完整的有效配置：必须包含之前联网状态下网关生成的configuration.json，以及关联的策略文件、证书文件等资源，无损坏或缺失。

核心配置（环境变量设置） #

启动容器时添加以下两个环境变量即可实现离线场景下优先加载本地配置，无需依赖APIM服务端连接或内存缓存：

• config.service.endpoint=local：强制指定网关从本地持久化目录加载配置，跳过向APIM服务端发起的配置拉取请求
• config.service.persist.configuration=true：保障联网运行时拉取的最新配置会自动持久化到挂载的Volume目录，更新本地离线可用的配置版本

生效验证 #

容器启动后查看运行日志，出现Loaded configuration from local storage类日志即代表本地配置加载成功，无需再与APIM服务端建立网络连接即可正常转发API请求。 #

补充说明 #

如果需要更新离线使用的配置版本，只需临时恢复网络，添加上述两个环境变量启动容器，网关拉取到APIM侧最新配置后会自动同步到本地挂载目录，之后断网重启也会直接加载更新后的本地配置。

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