Skip to content

Latest commit

 

History

History
225 lines (176 loc) · 6.06 KB

README_CH.md

File metadata and controls

225 lines (176 loc) · 6.06 KB
Raw

介绍

meshregistry模块的角色大约为serviceregistry，它对接了多种服务注册中心，对不同的服务数据转换为统一的ServiceEntry数据（也即istio服务模型），然后以服务的方式通过指定协议提供给下游。

本模块可以认为是istio galley组件的延续，也有一些区别：

  • 出于单一职责的考虑，不再代理服务数据以外的资源（galley支持获取k8s中的各种配置资源，转发给下游）

  • 跟进istio的演进，支持的协议从MCP切换为MCP-over-xDS （这是通过 istio-mcp 来实现的，该库也支持HTTP协议等）

  • 根据落地实践的经验和需要，做了一些改进增强，其中部分可能需要下游（istio侧）对应改造，但不是必要

功能特性

对接的服务注册中心

目前支持的服务注册中心有：

  • zk（dubbo）

  • eureka

  • nacos

  • k8s

支持的协议

  • MCP-over-xDS

  • istio-mcp 支持的其他协议

增量推送

该特性由istio-mcp 支持，需要client-server双端支持。 目前因为还没进入社区istio，所以如果对接社区istio，需要关闭该特性。 如果期望使用，需要对istio进行修改用该库替换社区的Adsc。

后续有计划将istio-mcp增量推送改造为delta xDS实现然后推进社区adsc支持delta xDS。 可以关注该库的进展

dubbo支持

dubbo Sidecar生成

可选的可以开启dubbo Sidecar生成特性，开启后会根据zk中的dubbo consumers信息来分析出dubbo application的interface依赖关系，然后生成标准的istio Sidecar资源，可以极大的减少下发给数据面的配置量

使用

作为slime module，使用上的流程大体接近：

  1. 启用该模块、被slime纳管（slime-boot方式 or bundle方式）

  2. 准备好module config对模块行为进行必要的配置

bundle部署方式

  1. 在bundle中将本模块加入，打包、出镜像

  2. 本模块支持env方式设置少量行为，如有必要可以添加在bundle的部署材料（deployment）中 （可选）

  3. 在bundle的配置configmap中加入本模块部分，类似如下：

    apiVersion: v1
data:
  cfg: |
    bundle:
      modules:
      - name: meshregistry
        kind: meshregistry
    enable: true
  cfg_meshregistry: |
    name: meshregistry
    kind: meshregistry
    enable: true
    mode: BundleItem
    general:
      LEGACY:
        MeshConfigFile: ""
        RevCrds: ""
        Mcp:
          EnableIncPush: false
        K8SSource:
          Enabled: false
        EurekaSource:
          Enabled: true
          Address:
          - "http://eureka.myeureka.com/eureka"
          RefreshPeriod: 15s
          SvcPort: 80
        ZookeeperSource:
          Enabled: true
          RefreshPeriod: 30s
          WaitTime: 10s
          # EnableDubboSidecar: false
          Address:
          - zookeeper.myzk.cluster.local:2181

    其他配置内容见bundle部署模式介绍

    配置内容详见 pkg/bootstrap/args.go

单独部署样例

  1. 部署对接nacos的meshregistry子模块，也可参考 slimeboot

    apiVersion: config.netease.com/v1alpha1
kind: SlimeBoot
metadata:
  name: meshregistry
  namespace: mesh-operator
spec:
  image:
    pullPolicy: Always
    repository: docker.io/slimeio/slime-meshregistry
    tag: v0.9.0
  module:
  - name: meshregistry
    kind: meshregistry
    enable: true
    general:
      LEGACY:
        NacosSource:
          Enabled: true
          RefreshPeriod: 30s
          Address:
          - "http://nacos.test.com"
          Mode: polling

  2. istiod 配置configSources, 从meshregistry获取服务信息

    configSources:
- address: xds://meshregistry.mesh-operator.svc:16010

  3. 利用接口查询meshregistry已获取服务信息：xx:8081/meshregistry/xdsCache,

    {
  "networking.istio.io/v1alpha3/ServiceEntry": [
    {
      "type": "networking.istio.io/v1alpha3/ServiceEntry",
      "name": "nacos.naming.servicename",
      "namespace": "naming",
      "labels": {
        "registry": "nacos"
      },
      "annotations": {
        "ResourceVersion": "2023-04-07 09:14:37.971015359 +0000 UTC m=+246.064642097"
      },
      "creationTimestamp": "2023-04-07T09:14:37.970977169Z",
      "Spec": {
        "hosts": [
          "nacos.naming.servicename"
        ],
        "addresses": [],
        "ports": [
          {
            "number": 80,
            "protocol": "HTTP",
            "name": "http"
          }
        ],
        "resolution": "STATIC",
        "endpoints": [
          {
            "address": "20.18.7.10",
            "ports": {
              "http": 8080
            },
            "labels": {}
          }
        ]
      }
    }
  ]
}

  4. 利用接口查询istiod已获取服务信息 xx:15014/debug/configz 

[
  {
    "kind": "ServiceEntry",
    "apiVersion": "networking.istio.io/v1alpha3",
    "metadata": {
      "name": "nacos.naming.servicename",
      "namespace": "naming",
      "resourceVersion": "2023-04-07 09:27:15.69926204 +0000 UTC m=+0.090193089",
      "creationTimestamp": "2023-04-07T09:15:07Z",
      "labels": {
        "registry": "nacos"
      },
      "annotations": {
        "ResourceVersion": "2023-04-07 09:15:07.969794894 +0000 UTC m=+276.063421634"
      }
    },
    "spec": {
      "hosts": [
        "nacos.naming.servicename"
      ],
      "ports": [
        {
          "name": "http",
          "number": 80,
          "protocol": "HTTP"
        }
      ],
      "resolution": "STATIC"
    }
  }
]