kuma 学习三组件说明

当前官方已经提供了两种可选的运行模式

通用模式
kubernetes 模式

kuma 组件说明

kuma-cp kuma 的控制面板
kuma-dp kuma 的数据面板
enovy 提供sidecar 服务的
kumactl 命令行与kuma-cp 通信的
kuma-injector 只有kubernetes 环境需要，用来自动处理容器的sidecar

通用模式

对于通用模式，需要依赖一个后端进行状态存储，官方当前建议的是pg

参考架构图

kubernetes 模式

需要依赖kuma-injector ，我们需要在运行的pod中添加注解

kuma.io/sidecar-injection: enabled

参考图

后端存储

kuma-cp 对于在通用模式依赖状态存储，默认是内存，实际上在安装包中的配置文件中我们也可以看到
对于pg 数据库的配置如下：

KUMA_STORE_TYPE=postgres \

KUMA_STORE_POSTGRES_HOST=localhost \

KUMA_STORE_POSTGRES_PORT=5432 \

KUMA_STORE_POSTGRES_USER=kuma-user \

KUMA_STORE_POSTGRES_PASSWORD=kuma-password \

KUMA_STORE_POSTGRES_DB_NAME=kuma \

kuma-cp run

kubernetes 模式

KUMA_STORE_TYPE=kubernetes kuma-cp run

数据面板以及数据模型

当kuma-cp 启动之后，需要等待数据面板进行连接以及注册，为了保障数据面板可以正常运行，需要准备两件事情

必须至少存在一个mesh,当控制面板启动的时候自动创建一个default 的
当通过数据面板连接的时候必须存在一个数据面板实体
参考模型图

说明：
在通用模式中，数据面板实体需要手工创建

数据面板实体

实际可以参考数据面板实体的规范https://kuma.io/docs/0.1.1/documentation/#dataplane-specification
当我们需要启动一个新的数据面板的时候，同样需要包含两件事情

数据面板，必须通知自己负责的服务，这个是通过数据面板实体定义的
数据面板进程需要处理输入以及输出请求
以上步骤通过两个不行的命令处理
数据面板的注册通过kumactl 或者http api
启动数据面板通过kuma-dp run
说明：
在kuberntes 中以上是自动处理的
以下是一个处理redis 服务的

echo "type: Dataplane

mesh: default

name: redis-1

networking:

  inbound:

  - interface: 127.0.0.1:9000:6379

    tags:

      service: redis" | kumactl apply -f -

KUMA_CONTROL_PLANE_BOOTSTRAP_SERVER_URL=http://control-plane:5682 \

KUMA_DATAPLANE_MESH=default \

KUMA_DATAPLANE_NAME=redis-1 \

kuma-dp run

以下是一个后端服务依赖redis的

echo "type: Dataplane

mesh: default

name: backend-1

networking:

  inbound:

  - interface: 127.0.0.1:8000:80

    tags:

      service: backend

  outbound:

  - interface: :10000

    service: redis" | kumactl apply -f -

KUMA_CONTROL_PLANE_BOOTSTRAP_SERVER_URL=http://control-plane:5682 \

KUMA_DATAPLANE_MESH=default \

KUMA_DATAPLANE_NAME=redis-1 \

kuma-dp run

说明：我们需要处理inbound 以及outbound

envoy

因为kuma 依赖envoy 通过9901 端口我们可以方便的调试常见问题

数据面板指南

参考格式

type: Dataplane

mesh: default

name: web-01

networking:

  inbound:

  - interface: 127.0.0.1:11011:11012

    tags:

      service: backend

  outbound:

  - interface: :33033

    service: redis

格式说明：
type：必须为Dataplane
mesh：我们需要关联的数据面板
name：数据面板实例的名字，必须唯一
networking：配置数据流量的inbound 以及outbound规则
inbound：一个数组定义通过数据面板可以暴露的访问地址
interface：决定请求格式 {address}:{dataplane-port}:{service-port}
tags：定义服务的角色，必须包含一个serevice 的tag
outbound：服务发出的每个传出请求也必须通过DP，此对象指定DP在接受服务的传出请求时必须侦听的端口
inerface：向外部服务访问暴露的端口
service：定义关联的服务

kuma 的几个端口

以下是kuma-cp 暴露的端口
5677： sds 服务的端口
5678： xds grpc 的端口
5680： http 服务，返回健康状态
5681: http 服务 kumactl 依赖次服务端口
5682：提供envoy bootstrap 配置，当数据面板启动的时候

kuma http api

kuma 通过5681提供管理配置
包含的请求url
/meshes
/meshes/{name}
/meshes/{name}/dataplanes
/meshes/{name}/dataplanes/{name}

参考资料

https://kuma.io/docs/0.1.1/documentation/#overview