微服务引擎 TSE
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 微服务引擎 TSE > 云原生 API 网关 > 迁移指南 > 从自建 Kong 网关迁移到腾讯云

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

最近更新时间：2023-07-10 10:36:11

我的收藏

本页目录：

操作场景

本文介绍利用 Kong 官方的 decK 工具来完成自建 Kong 网关到腾讯云云原生 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 工具导入配置到云原生 API 网关 Kong

1. 打开终端，运行如下命令查看Kong.yaml中的配置与云原生 Kong 网关的配置差异性。
# 注意将 kong-tencent 替换为腾讯云云原生 API 网关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 替换为腾讯云云原生 API 网关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 参考文档。
中国站