tencent cloud

注册配置治理

文档注册配置治理云原生网关迁移指南从自建 Kong 网关迁移到腾讯云

从自建 Kong 网关迁移到腾讯云

PDF
聚焦模式
字号
最后更新时间： 2026-05-07 17:55:07
说明：
目前云原生网关仅对微服务场景支持开通白名单新购，其余场景不支持新接入。如有新购需求，请 提交工单处理。

操作场景

本文介绍利用 Kong 官方的 decK 工具来完成自建 Kong 网关到腾讯云云原生 Kong 网关的配置迁移。

前置条件

已购买并新建了网关实例可参见操作文档，并 配置 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
  - https
services:
- 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 diff
creating service tencent
creating route 040b0c62-4d31-4286-a595-1832e55bf568
creating 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 sync
creating service tencent
creating route 040b0c62-4d31-4286-a595-1832e55bf568
creating plugin prometheus (global)
Summary:
  Created: 3
  Updated: 0
  Deleted: 0
3. 打开腾讯云云原生 Kong 网关的控制台查看配置是否导入成功。







注意事项

为了操作方便 admin-api 并未开启安全认证插件，强烈建议在配置同步完成后为 admin-api 开启安全认证插件。

参考

更多相关说明请参见 decK 参考文档。
上一篇: 事件中心下一篇: 使用 IP 访问控制

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈