k8s环境kong网关1.0版本升级至2.4

最新推荐文章于 2024-08-28 05:00:00 发布
最新推荐文章于 2024-08-28 05:00:00 发布
阅读量1k 收藏 4
点赞数
分类专栏： 笔记 文章标签： postgresql docker 数据库
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/intheafk/article/details/120568721
版权

Konga网关管理后台升级操作手册

  1. 现状

    序号资源名称版本获取方式
    1Kong1.0.2kong version
    2PostgreSQL10.6psql --version

  2. 目标

    此次升级Kong，同时将数据迁移至自建数据库。

    序号资源名称版本
    1Kong2.4.1
    2PostgreSQL10.6

  3. 升级步骤

    官方指导文档

    1. 升级步骤:

      • 因Kong在每个大版本发布时数据库结构发生变更，因此不支持直接升级至最新版。

      • 升级期间不允许在中间版本进行Admin API更新请求

      • 升级版本过程

        kong:1.0.2 > kong:1.5.0 > kong:2.0 > kong:2.4

    2. 在各中间版本运行：kong migrations up，kong migrations finish

    3. 启动新版本服务前，确认流量切换完成后再执行：kong migrations finish

    4. 执行完finish指令后将多实例连接同一数据库，请停用旧集群服务、启动新集群服务。

  4. 实施步骤

    如kong安装有第三方(非konga列表展示)的组件请额外备份及升级

    1. 准备镜像

      分别准备目标版本及各中间版本Docker镜像文件，上传至私有仓库。

      • kong:1.5.0
      • kong:2.0
      • kong:2.4

    2. 备份

      1. 备份配置

        • 需备份配置文件

      2. 备份数据库

        升级Kong网关数据库，进入终端执行以下指令：

        # 备份
pg_dump  -h old_kong_dbhost -U kong -W -d kong > /tmp/kong.bak
# 备份完成后将文件传输至服务器本地

        如在升级过程出现问题，根据恢复时间决定是否回滚数据

        # 回滚
psql -h new_kong_dbhost -U kong -W -d kong < /tmp/kong.bak

    3. 基础环境

      请注意版本顺序及替换变量，本文示例Docker与K8S版本，请根据实际需要进行选择。

      1. 部署数据库

        1. 创建存储

          • 创建持久化存储卷

        2. 创建数据库

          1. 创建Postgres有状态工作负载

            1. 容器配置

              • 镜像名称：postgres
              • 镜像Tag：10.6
              • 环境变量：
                • POSTGRES_DB：kong
                • POSTGRES_USER：kong
                • POSTGRES_PASSWORD：保密字典/kong-postgresql/postgresql-password
                • PGDATA：/var/lib/postgresql/data/pgdata // 此处必须多一层目录，否则数据卷挂载后初始化文件将不可见
              • 数据卷：
                • 增加存储声明：
                  • 挂载源：选择对应存储声明名称
                  • 容器路径：/var/lib/postgresql/data
              • 访问设置：
                • 服务：
                  • 端口映射：postgresql/5432/5432/TCP

          2. 导入备份数据

            在新数据库容器中执行备份动作或上传备份文件至/tmp

            # 导入
psql -h new_kong_dbhost -U kong -W -d kong < /tmp/kong.bak

      2. 部署网关服务

        1. 创建Kong无状态工作负载

          1. 容器配置

            • 镜像名称：kong
            • 镜像Tag：1.5
            • 环境变量：
              • KONG_DATABASE：postgres
              • KONG_PG_HOST：kong-postgresql-svc
              • KONG_PG_USER：kong
              • KONG_PG_PASSWORD：kong
            • 生命周期：
              • 启动执行：
                • 命令：sleep 3600 # 防止kong启动失败后退出

          2. 高级配置

            中间状态应用不进行特殊配置

          以上确认无误后点击创建。

    4. 数据库升级

      1. 执行非破坏性升级

        进入Kong网关容器终端，执行升级指令：

        1. 应用数据库版本升级

          kong migrations up

        2. 确认无误后结束升级，关闭更新状态

          kong migrations finish

        • 如在升级过程出现问题，根据恢复时间决定是否回滚数据

          # 删除数据文件
rm -rf /var/lib/postgresql/data/*
# 重启容器
# 回滚
psql -h new_kong_dbhost -U kong -W < /tmp/kong.bak

        以上执行指令均不应有错误输出，如有错误输出请回滚数据，检查配置后重新升级。

      2. 更新至下一版本

        1. 修改工作负载镜像Tag至下一版本，在操作栏点击【重新部署】；
        2. 启动成功后执行上述“执行非破坏性升级”操作；
        3. 循环执行上述动作，直至将数据库更新至最新稳定版。

    5. 配置Kong网关

      可修改基础环境中Kong网关工作负载配置，也可删除该工作负载后后重新创建，具体配置请根据实际情况进行修改，示例配置如下：

      1. 容器配置

        • 镜像名称：kong
        • 镜像Tag：2.4.1-centos
        • 端口：
          • admin：8001/TCP
          • proxy：8000/TCP
          • proxy-tls：8443/TCP
        • 环境变量：
          • KONG_DATABASE：postgres
          • KONG_PG_HOST：kong-postgresql-svc
          • KONG_PG_USER：kong
          • KONG_PG_PASSWORD：kong
          • KONG_ADMIN_LISTEN：0.0.0.0:8001
          • KONG_PROXY_LISTEN：0.0.0.0:8000,0.0.0.0:8443 ssl
          • KONG_NGINX_DAEMON：off
          • KONG_ADMIN_ACCESS_LOG：/dev/stdout
          • KONG_ADMIN_ERROR_LOG：/dev/stderr
          • KONG_ADMIN_GUI_ACCESS_LOG：/dev/stdout
          • KONG_ADMIN_GUI_ERROR_LOG：/dev/stderr
          • KONG_PORTAL_API_ACCESS_LOG：/dev/stdout
          • KONG_PORTAL_API_ERROR_LOG：/dev/stderr
          • KONG_PROXY_ACCESS_LOG：/dev/stdout
          • KONG_PROXY_ERROR_LOG：/dev/stderr
          • KONG_PG_PORT：5432
          • KONG_PG_DATABASE：kong
          • KONG_NGINX_HTTP_GZIP：on
          • KONG_NGINX_HTTP_GZIP_MIN_LENGTH：1k
          • KONG_NGINX_HTTP_GZIP_TYPES：text/html application/json text/plain

  5. 连接新实例

    通过Konga管理平台connections页面创建新连接

    Name: 新命名
Kong Admin URL: 新服务地址(http://admin-svc:8001)

    切换至新版本查看服务及路由等数据是否正常

  6. 迁移流量

    • 根据实际情况切换网关外部负载均衡标签

  7. 其他

    本次数据库版本升级输出如下：

    • 1.0-1.5

      / # kong migrations up
migrating core on database 'kong'...
core migrated up to: 005_120_to_130 (pending)
core migrated up to: 006_130_to_140 (executed)
core migrated up to: 007_140_to_150 (executed)
migrating hmac-auth on database 'kong'...
hmac-auth migrated up to: 002_130_to_140 (executed)
migrating oauth2 on database 'kong'...
oauth2 migrated up to: 003_130_to_140 (executed)
migrating jwt on database 'kong'...
jwt migrated up to: 002_130_to_140 (executed)
migrating basic-auth on database 'kong'...
basic-auth migrated up to: 002_130_to_140 (executed)
migrating key-auth on database 'kong'...
key-auth migrated up to: 002_130_to_140 (executed)
migrating acl on database 'kong'...
acl migrated up to: 002_130_to_140 (executed)
migrating session on database 'kong'...
session migrated up to: 000_base_session (executed)
10 migrations processed
9 executed
1 pending

Database has pending migrations; run 'kong migrations finish' when ready
/ # kong migrations finish
migrating core on database 'kong'...
core migrated up to: 005_120_to_130 (executed)
1 migration processed
1 executed
No pending migrations to finish
/ #

    • 1.5-2.0

      bash-5.0$ kong migrations up
migrating core on database 'kong'...
core migrated up to: 008_150_to_200 (pending)
migrating acme on database 'kong'...
acme migrated up to: 000_base_acme (executed)
2 migrations processed
1 executed
1 pending

Database has pending migrations; run 'kong migrations finish' when ready
bash-5.0$ kong migrations finish
migrating core on database 'kong'...
core migrated up to: 008_150_to_200 (executed)
1 migration processed
1 executed
No pending migrations to finish
bash-5.0$

    • 2.0-2.4

      bash-5.0$ kong migrations up
migrating core on database 'kong'...
core migrated up to: 009_200_to_210 (pending)
core migrated up to: 010_210_to_211 (executed)
core migrated up to: 011_212_to_213 (executed)
core migrated up to: 012_213_to_220 (pending)
core migrated up to: 013_220_to_230 (executed)
migrating acl on database 'kong'...
acl migrated up to: 003_200_to_210 (pending)
acl migrated up to: 004_212_to_213 (pending)
migrating basic-auth on database 'kong'...
basic-auth migrated up to: 003_200_to_210 (pending)
migrating bot-detection on database 'kong'...
bot-detection migrated up to: 001_200_to_210 (pending)
migrating hmac-auth on database 'kong'...
hmac-auth migrated up to: 003_200_to_210 (pending)
migrating ip-restriction on database 'kong'...
ip-restriction migrated up to: 001_200_to_210 (pending)
migrating jwt on database 'kong'...
jwt migrated up to: 003_200_to_210 (pending)
migrating key-auth on database 'kong'...
key-auth migrated up to: 003_200_to_210 (pending)
migrating oauth2 on database 'kong'...
oauth2 migrated up to: 004_200_to_210 (pending)
oauth2 migrated up to: 005_210_to_211 (executed)
migrating rate-limiting on database 'kong'...
rate-limiting migrated up to: 004_200_to_210 (executed)
migrating session on database 'kong'...
session migrated up to: 001_add_ttl_index (executed)
17 migrations processed
6 executed
11 pending

Database has pending migrations; run 'kong migrations finish' when ready
bash-5.0$ kong migrations finish
migrating core on database 'kong'...
core migrated up to: 009_200_to_210 (executed)
core migrated up to: 012_213_to_220 (executed)
migrating acl on database 'kong'...
acl migrated up to: 003_200_to_210 (executed)
acl migrated up to: 004_212_to_213 (executed)
migrating basic-auth on database 'kong'...
basic-auth migrated up to: 003_200_to_210 (executed)
migrating bot-detection on database 'kong'...
bot-detection migrated up to: 001_200_to_210 (executed)
migrating hmac-auth on database 'kong'...
hmac-auth migrated up to: 003_200_to_210 (executed)
migrating ip-restriction on database 'kong'...
ip-restriction migrated up to: 001_200_to_210 (executed)
migrating jwt on database 'kong'...
jwt migrated up to: 003_200_to_210 (executed)
migrating key-auth on database 'kong'...
key-auth migrated up to: 003_200_to_210 (executed)
migrating oauth2 on database 'kong'...
oauth2 migrated up to: 004_200_to_210 (executed)
11 migrations processed
11 executed
No pending migrations to finish
bash-5.0$
【云原生网关】Kong 使用详解
congge
05-02 5535
云原生网关kong使用详解
K8s（二十一）：在 Kubernetes 集群中部署 MySQL8.0 高可用集群（1主2从）
热门推荐
✨ 欢迎来到【Seal ^_^ 的CSDN博客】！这里是我记录技术心得、分享经验的地方。✨
04-16 1万+
🔴 K8s（二十一）：在 Kubernetes 集群中部署 MySQL8.0 高可用集群（1主2从）
centos7部署kong、升级kong - rpm安装
weixin_44418421的博客
06-26 305
启动时可能报错提示输入以下命令：kong migrations up && kong migrations finish。
kong升级版本，同时部署kong dashboard，并升级kong admin ui
weixin_44259356的博客
07-23 1920
kong升级版本，同时部署kong dashboard，并升级kong admin ui 今天查看了kong dashboard官方文档，发现最新版支持kong 1.x以上，然后重新安装kong dashboard如下 不支持此版本的kong，查了很多文档，没找到答案，后来想到可能是版本为rc版，于是去官网查看kong最新版，为1.2.1。从1.2.0.rc2到1.2.1更新日志如下： 大致为...
API网关之Kong
最新发布
youziguo的专栏
08-28 752
Kong 是一个高性能的开源 API 网关和微服务管理平台，用于管理、保护和扩展 API 和微服务。它最初由 Mashape 公司开发，并于 2015 年作为开源项目发布。Kong 能够处理 API 的路由、认证、负载均衡、缓存、监控、限流等多种功能，是微服务架构中不可或缺的一部分。
记录升级 KONG3.1 网关遇到的坑
weixin_43902314的博客
02-08 533
当你自定义插件后需要挂载到网关容器中，需要修改两个地方。
Centos7.x 安装Kong OSS版
叱咤少帅的博客
11-18 1766
Centos7.x 安装Kong OSS版
如何查看已安装Kong的版本
Dyeln的博客
12-03 1742
环境中Kong是通过K8s安装的，我们就来说说怎么查询容器中Kong的版本： 1.查询kong的POD名称 kubectl get pod|grep kong 2.进入kong容器 kubectl exec -it ${kong的POD名称} -- /bin/sh 3.查询kong版本 kong version ...
kong的安装版本
weixin_34346099的博客
03-27 734
2019独角兽企业重金招聘Python工程师标准>>> ...
K8s kubernetes 系统初始化脚本，一键安装部署基础环境，安装依赖包，针对k8s优化的内核参数，升级内核
08-06
2.1 设置主机名和hosts文件解析 2.2 安装依赖包 ...2.5 调整内核参数，对于 K8S 2.6 调整系统时区 2.7 关闭系统不需要服务 2.8 设置 rsyslogd 和 systemd journald 2.9 升级系统内核为 4.44 一键shell脚本
k8s的小版本升级与降级
qq_38419276的博客
10-04 1604
升级 先从负载均衡服务器上面禁用，防止调度到正在做升级相应服务器上 (记得，升级完后要把注释去掉，重新加载haproxy) [root@haproxy ~]# cat /etc/haproxy/haproxy.cfg listen k8s-m44-6443 bind 172.18.8.168:6443 mode tcp #server 172.18.8.109 172.18.8.109:6443 check inter 2s fall 3 rise 5 server 172.18.8.119
k8s版本升级
weixin_44946147的博客
05-25 3031
k8s版本升级 背景： kubernetes版本从v1.21.1 升级到v1.21.10 一. 预先下载需要的镜像（所有节点都需要下载） kubeadm config images list --kubernetes-version=v1.21.10 #查看所需版本镜像 images=( kube-apiserver:v1.21.10 kube-controller-manager:v1.21.10 kube-scheduler:v1.21.10 kube-proxy:v1.21.10 pause
Kong 1.0通用（GA）版本正式发布！
Docker的专栏
12-22 275
今天，我们很高兴地公布Kong 1.0[1]的通用版本——这是一款可扩展、快速且开源的微服务API网关，可用于对混合及云原生架构进行管理、保护与连接。Kong运行有全部服...
api kong简单应用（0.10版本之前和0.10版本之后）-kong服务安装
qq_22094297的博客
07-30 835
Cassandra 3.x.x）,推荐postgresql数据库 kong服务官网 https://getkong.org/install/centos/#packages。 kong服务启动
kong ingress-controller 更新nginx的配置
小草的博客
03-25 2367
一个k8s 集群采用的是kong作为ingress controller，查日志的时候发现kong有一个warning a client request body is buffered to a temporary file 问题分析 通过kong的admin api可以看到，与之相关的是nginx的一个配置 client_body_buffer_size: 8k 这个配置的意思是：如果请求的b...
kong网关源代码研究及调试
u012821124的博客
12-17 1369
前段时间一直研究kong网关，发现kong源码的整体结构还是比较清晰的。核心的目录结构如下： Api目录-----kong对外发布的管理API，通过8001端口发布。 Cmd目录----kong的命令行，如start、stop等 cluster_events目录------集群事件的策略配置文件，如数据库集群。 Db目录------数据库的操作，如数据操作、结构定义、数据库迁移等 Log目录------日志存储，平台分三类日志，access/admin_access/error Pdk目录------设计工
Kong Docker 镜像使用教程
gitblog_00795的博客
08-09 904
Kong Docker 镜像使用教程 docker-kong:monkey: Docker distribution for Kong项目地址:https://gitcode.com/gh_mirrors/do/docker-kong 项目介绍 Kong 是一个开源的 API 网关和微服务管理层，旨在为现代架构提供高性能、可扩展的 API 管理。Kong 通过插件机制提供了丰富的功能，如认证、监...
/usr/local/share/lua/5.1/kong/cmd/start.lua:34: [postgres错误]当前的数据库模式与这个版本的版本不匹配。请运行“kong migrations
CGD_ProgramLife的博客
05-30 5150
/usr/local/share/lua/5.1/kong/cmd/start.lua:34: [postgres error] the current database schema does not match this version of Kong. Please run `kong migrations up` to update/initialize the database sche...
centos7安装kong网关
努力升级中的凡人
11-17 1159
下载安装包： https://bintray.com/kong/kong-community-edition-rpm/download_file?file_path=centos/7/kong-community-edition-1.0.2.el7.noarch.rpm 运行下面的两个命令进行安装 $ sudo yum install epel-release $ sudo yum install kong-community-edition-1.0.2.el7.noarch.rpm --nogpgche
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值