k8s 对接zabbix

转载

mob64ca140ce312 2024-09-19 20:18:09

文章标签 k8s 对接zabbix kubernetes 容器 go 增删改查 文章分类 运维

资源的数据

1 | 资源的数据访问层

1.1 | etcd 访问

众所周知，kubernetes 所有资源都是存储在 etcd clsuter 中的，它是一个典型的分布式 kv 数据库，提供存储，查询，更新，监控对象变化的 watch 等操作。在数据访问层的设计上，也是秉承接口和实现的原则，定义接口功能，由相关的具体实现类(etcd3 实现)来实现功能。其相关的图解和源码如下：

k8s 对接zabbix_kubernetes

k8s.io/apiserver/pkg/storage/interfaces.go 中定义了资源数据访问层的接口，包括对资源的增删改查以及 watch 等操作。
etcd3.store 结构体实现了上述定义的接口功能，在该结构体中的实现中封装了对象 clientv3.Client 用来完成对 etcd3 集群的访问和对象操作。

// k8s.io/apiserver/pkg/storage/interfaces.go
type Interface interface {
  Versioner() Versioner
  Create(ctx context.Context, key string, obj, out runtime.Object, ttl uint64) error
  Delete(ctx context.Context, key string, out runtime.Object, preconditions *Preconditions,validateDeletion ValidateObjectFunc, cachedExistingObject runtime.Object) error
  Watch(ctx context.Context, key string, opts ListOptions) (watch.Interface, error)
  WatchList(ctx context.Context, key string, opts ListOptions) (watch.Interface, error)
  Get(ctx context.Context, key string, opts GetOptions, objPtr runtime.Object) error 
  GetToList(ctx context.Context, key string, opts ListOptions, listObj runtime.Object) error
  List(ctx context.Context, key string, opts ListOptions, listObj runtime.Object) error
  GuaranteedUpdate(ctx context.Context, key string, ptrToType runtime.Object, ignoreNotFound bool, precondtions *Preconditions, tryUpdate UpdateFunc, cachedExistingObject runtime.Object) error
  Count(key string) (int64, error)
}
// k8s.io/apiserver/pkg/storage/etcd3/store.go
type store struct {
  client        *clientv3.Client
  codec         runtime.Codec
  versioner     storage.Versioner
  transformer   value.Transformer
  pathPrefix    string
  watcher       *watcher
  pagingEnabled bool
  leaseManager  *leaseManager
}
func (s *store) Versioner() Versioner{...}
func (s *store) Create(ctx context.Context, key string, obj, out runtime.Object, ttl uint64) error{...}
func (s *store) Delete(ctx context.Context, key string, out runtime.Object, preconditions *Preconditions,validateDeletion ValidateObjectFunc, cachedExistingObject runtime.Object) error{...}
func (s *store) Watch(ctx context.Context, key string, opts ListOptions) (watch.Interface, error){...}
func (s *store) WatchList(ctx context.Context, key string, opts ListOptions) (watch.Interface, error){...}
func (s *store) Get(ctx context.Context, key string, opts GetOptions, objPtr runtime.Object) error{...}
func (s *store) GetToList(ctx context.Context, key string, opts ListOptions, listObj runtime.Object) error{...}
func (s *store) List(ctx context.Context, key string, opts ListOptions, listObj runtime.Object) error{...}
func (s *store) GuaranteedUpdate(ctx context.Context, key string, ptrToType runtime.Object, ignoreNotFound bool, precondtions *Preconditions, tryUpdate UpdateFunc, cachedExistingObject runtime.Object) error{...}
func (s *store) Count(key string) (int64, error){...}

1.2 | dry run 功能

另外 kubernetes 也支持 dry run 操作，即运行命令或者执行 API，但是不对资源存储造成影响，所以在以上的接口功能的基础上又定义了 DryRunnableStorage 结构体来实现此功能。其相关的图解和源码如下：

k8s 对接zabbix_go_02

该结构体包含上面介绍的数据访问接口类型的属性来完成基本数据访问操作。
该结构体包含 runtime.Codec 属性来完成必要的序列化和反序列化操作。
以创建操作的 dry run 做为例子，该操作判断资源是否存在，然后内部拷贝对象返回，并不会进行实际的创建操作。

// k8s.io/apiserver/pkg/registry/generic/registry/dryrun.go
type DryRunnableStorage struct {
  Storage storage.Interface  // 上面的 etcd 访问接口
  Codec   runtime.Codec // 序列化 反序列化
}
 
 
func (s *DryRunnableStorage) Create(ctx context.Context, key string, obj, out runtime.Object, ttl uint64, dryRun bool) error {
  if dryRun {
    if err := s.Storage.Get(ctx, key, storage.GetOptions{}, out); err == nil {
      return storage.NewKeyExistsError(key, 0)
    }
    return s.copyInto(obj, out)
  }
  return s.Storage.Create(ctx, key, obj, out, ttl)
}
 
 
func (s *DryRunnableStorage) copyInto(in, out runtime.Object) error {
  var data []byte
  data, err := runtime.Encode(s.Codec, in)
  if err != nil {
    return err
  }
  _, _, err = s.Codec.Decode(data, nil, out)
  if err != nil {
    return err
  }
  return nil
}
// ... other functions

1.3 | 数据访问对象

对于数据访问对象，或者 DAO 对象的创建过程的图解和源码如下：

k8s 对接zabbix_增删改查_03

数据访问对象的创建是基于配置的，由 storagebackend.Config 决定。
对于目前的 kubernetes 版本来说，只支持 etcd3 的数据访问层。
对于 etcd2 或者其它类型存储的数据访问层是不支持的。

// k8s.io/apiserver/pkg/storage/storagebackend/factory/factory.go
func Create(c storagebackend.Config, newFunc func() runtime.Object) (storage.Interface, DestroyFunc, error) {
  switch c.Type {
  case "etcd2":
    return nil, nil, fmt.Errorf("%v is no longer a supported storage backend", c.Type)
  case storagebackend.StorageTypeUnset, storagebackend.StorageTypeETCD3:
    return newETCD3Storage(c, newFunc)
  default:
    return nil, nil, fmt.Errorf("unknown storage type: %s", c.Type)
  }
}

2 | 资源的服务层接口定义

在数据服务层的设计上，也是秉承接口和实现的原则，定义接口功能，由相关的具体实现类来实现功能。kubernetes 在服务层上定义分为两大类:

一类是增删改查类接口，定义增删改查 watch 等操作
另一类是操作的策略类型接口，用来定义资源在增删改查等不同操作中的逻辑。

2.1 | 增删改查接口

对于增删改查类接口定义，图解和源码如下：

k8s 对接zabbix_kubernetes_04

对于不同的增删改查以及 watch 操作均有不同类型的独立接口与之对应定义，例如 Storage， Getter， Lister， Creater， Updater， Watcher 等等。
有聚合类型接口 StandardStorage 封装了一些独立接口功能。

// staging/src/k8s.io/apiserver/pkg/registry/rest/rest.go
type Storage interface {
    New() runtime.Object
}
type Scoper interface {
  NamespaceScoped() bool
}
type Getter interface {
  Get(ctx context.Context, name string, options *metav1.GetOptions) (runtime.Object, error)
}
type Lister interface {
  NewList() runtime.Object
  List(ctx context.Context, options *metainternalversion.ListOptions) (runtime.Object, error)
  TableConvertor
}
type Watcher interface {
  Watch(ctx context.Context, options *metainternalversion.ListOptions) (watch.Interface, error)
}
type Creater interface {
  New() runtime.Object
  Create(ctx context.Context, obj runtime.Object, createValidation ValidateObjectFunc, options *metav1.CreateOptions) (runtime.Object, error)
}
type Updater interface {
  New() runtime.Object
  Update(ctx context.Context, name string, objInfo UpdatedObjectInfo, createValidation ValidateObjectFunc, updateValidation ValidateObjectUpdateFunc, forceAllowCreate bool, options *metav1.UpdateOptions) (runtime.Object, bool, error)
}
type CreaterUpdater interface {
  Creater
  Update(ctx context.Context, name string, objInfo UpdatedObjectInfo, createValidation ValidateObjectFunc, updateValidation ValidateObjectUpdateFunc, forceAllowCreate bool, options *metav1.UpdateOptions) (runtime.Object, bool, error)
}
type GracefulDeleter interface {
  Delete(ctx context.Context, name string, deleteValidation ValidateObjectFunc, options *metav1.DeleteOptions) (runtime.Object, bool, error)
}
type CollectionDeleter interface {
  DeleteCollection(ctx context.Context, deleteValidation ValidateObjectFunc, options *metav1.DeleteOptions, listOptions *metainternalversion.ListOptions) (runtime.Object, error)
}
type StandardStorage interface {
  Getter
  Lister
  CreaterUpdater
  GracefulDeleter
  CollectionDeleter
  Watcher
}

2.2 | 操作策略接口

对于操作类策略接口定义，图解和源码如下：

k8s 对接zabbix_增删改查_05

操作策略类会定义创建操作策略，更新操作策略，创建或更新操作策略，删除操作策略等独立接口，这些定义都涉及到了资源的持久化操作。
策略类接口被定义在不同文件中，例如 create.go/update.go/create_update.go/delete.go 等等。

// k8s.io/apiserver/pkg/registry/rest/create.go
type RESTCreateStrategy interface {
  runtime.ObjectTyper
  names.NameGenerator
  NamespaceScoped() bool
  PrepareForCreate(ctx context.Context, obj runtime.Object)
  Validate(ctx context.Context, obj runtime.Object) field.ErrorList
  Canonicalize(obj runtime.Object)
}
// k8s.io/apiserver/pkg/registry/rest/update.go
type RESTUpdateStrategy interface {
  runtime.ObjectTyper
  NamespaceScoped() bool
  AllowCreateOnUpdate() bool
  PrepareForUpdate(ctx context.Context, obj, old runtime.Object)
  ValidateUpdate(ctx context.Context, obj, old runtime.Object) field.ErrorList
  Canonicalize(obj runtime.Object)
  AllowUnconditionalUpdate() bool
}
// k8s.io/apiserver/pkg/registry/rest/create_update.go
type RESTCreateUpdateStrategy interface {
  RESTCreateStrategy
  AllowCreateOnUpdate() bool
  PrepareForUpdate(ctx context.Context, obj, old runtime.Object)
  ValidateUpdate(ctx context.Context, obj, old runtime.Object) field.ErrorList
  AllowUnconditionalUpdate() bool
}
// k8s.io/apiserver/pkg/registry/rest/delete.go
type RESTDeleteStrategy interface {
  runtime.ObjectTyper
}

本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。