注意:说明:
注意:目前云原生网关仅对微服务场景支持开通白名单新购,其余场景不支持新接入。如有新购需求,请 提交工单 处理。
一、前置条件
·已购买并新建了网关实例可参见 操作文档,并 配置 admin-api。
·有自建的 Kong 网关,并配置了 services、routes、plugins。
·终端机安装了 decK 工具,请前往 Kong 下载 decK 并安装到你的终端。
二、步骤1:利用 decK 工具导出自建的 Kong 网关的配置
1. 打开终端,运行如下命令导出自建 Kong 网关的配置。
# 注意将 kong-zj 替换为自建kong网关的ip地址或域名deck –kong-addr http://kong-zj:8001/ dump
2. 检查生成的kong.yaml文件。
# 注意kong.yaml内容与实际情况会有所不同cat kong.yaml
_format_version: "1.1"plugins:- config: per_consumer: false enabled: true name: prometheus protocols: – grpc – grpcs – http – httpsservices:- connect_timeout: 60000 host: 127.0.0.1 name: admin-api path: / port: 8001 protocol: http read_timeout: 60000 retries: 5 routes: – https_redirect_status_code: 426 name: admin-api path_handling: v1 paths: – /admin-api preserve_host: false protocols: – http – https regex_priority: 0 request_buffering: true response_buffering: true strip_path: true write_timeout: 60000- connect_timeout: 60000 host: www.tencent.com name: tencent path: / port: 80 protocol: http read_timeout: 60000 retries: 5 routes: – https_redirect_status_code: 426 id: 040b0c62-4d31-4286-a595-1832e55bf568 path_handling: v1 paths: – / preserve_host: false protocols: – http – https regex_priority: 0 request_buffering: true response_buffering: true strip_path: true write_timeout: 60000
三、步骤2:利用 decK 工具导入配置到云原生网关 Kong
1. 打开终端,运行如下命令查看Kong.yaml中的配置与云原生 Kong 网关的配置差异。
# 注意将 kong-tencent 替换为腾讯云云原生网关Kong的代理地址deck –kong-addr http://kong-tencent/admin-api diffcreating service tencentcreating route 040b0c62-4d31-4286-a595-1832e55bf568creating plugin prometheus (global)Summary: Created: 3 Updated: 0 Deleted: 0
2. 运行如下命令将Kong.yaml中的配置导入腾讯云云原生 Kong 网关中。
# 注意 kong-tencent 替换为腾讯云云原生网关Kong的代理地址deck –kong-addr http://kong-tencent/admin-api synccreating service tencentcreating route 040b0c62-4d31-4286-a595-1832e55bf568creating plugin prometheus (global)Summary: Created: 3 Updated: 0 Deleted: 0
3. 打开腾讯云云原生 Kong 网关的控制台查看配置是否导入成功。
四、注意事项
为了操作方便 admin-api 并未开启安全认证插件,强烈建议在配置同步完成后为 admin-api 开启安全认证插件。
五、参考
更多相关说明请参见 decK 参考文档。