Kubernetes的Group、Version、Resource学习小记

最新推荐文章于 2024-07-04 02:08:17 发布
最新推荐文章于 2024-07-04 02:08:17 发布
阅读量7k 收藏 21
点赞数 22
分类专栏： kubernetes实战 文章标签： kubernetes golang
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/boling_cavalry/article/details/113715847
版权

欢迎访问我的GitHub

这里分类和汇总了欣宸的全部原创(含配套源码)：https://github.com/zq2599/blog_demos

关于Group、Version、Resource

  • 开篇先提重点：Group、Version、Resource十分重要，它们会贯穿《client-go实战》、《kubebuilder实战》、《Kubernetes官方java客户端》等系列文章的始终；
  • Kubernetes是以资源为中心的系统，在学习client-go时，Group、Version、Resource等资源相关的数据结构就显得格外重要了，下图来自郑老师《Kubernetes源码剖析》一文，将三者关系做了简洁清晰的介绍：
    在这里插入图片描述

环境信息

  • 开始学习前先交待一下我这边的环境信息，以避免因为版本引起的误会：
  1. kubernetes源码：1.20.3-rc.0
  2. 实战环境的操作系统：CentOS Linux release 7.9.2009
  3. 实战环境的kubernetes：1.20.0
  • 接下来开始学习Group、Version、Resource吧

Group

  1. Group即资源组，在kubernetes对资源进行分组时，对应的数据结构就是Group，源码路径：k8s.io/apimachinery/pkg/apis/meta/v1/types.go ，如下，可见Group有自己的名称和版本：
type APIGroup struct {
	TypeMeta `json:",inline"`
	Name string `json:"name" protobuf:"bytes,1,opt,name=name"`
	Versions []GroupVersionForDiscovery `json:"versions" protobuf:"bytes,2,rep,name=versions"`
	PreferredVersion GroupVersionForDiscovery `json:"preferredVersion,omitempty" protobuf:"bytes,3,opt,name=preferredVersion"`
	ServerAddressByClientCIDRs []ServerAddressByClientCIDR `json:"serverAddressByClientCIDRs,omitempty" protobuf:"bytes,4,rep,name=serverAddressByClientCIDRs"`
}
  1. 在kubernetes中有两种资源组：有组名资源组和无组名资源组(也叫核心资源组Core Groups)，它们都很常见；
  2. deployment有组名，pod没有组名，咱们把它俩的OpenAPI放在一起对比就一目了然了：
    在这里插入图片描述

Version

  • Version即版本，这个好理解，kubernetes的版本分为三种：
  1. Alpha：内部测试版本，如v1alpha1
  2. Beta：经历了官方和社区测试的相对稳定版，如v1beta1
  3. Stable：正式发布版，如v1、v2
  • 如下图红框，资源组batch之下有v1和v2alpha1两个版本，每个版本下都有多个资源：
    在这里插入图片描述
  • 数据结构源码还是在types.go文件中，如下：
type APIVersions struct {
	TypeMeta `json:",inline"`
	Versions []string `json:"versions" protobuf:"bytes,1,rep,name=versions"`
	ServerAddressByClientCIDRs []ServerAddressByClientCIDR `json:"serverAddressByClientCIDRs" protobuf:"bytes,2,rep,name=serverAddressByClientCIDRs"`
}

Resource

  • Resource资源在kubernetes中的重要性是不言而喻的，常见的pod、service、deployment这些都是资源，下面是关于资源的一些小结：
  1. 在kubernetes环境被实例化的资源即资源对象(ResourceObject)；
  2. 资源被分为持久性（Persistent Entity）和非持久性（Ephemeral Entity），持久性如deployment，创建后会在etcd保存，非持久性如pod；
  • 资源的源码：
type APIResource struct {
	Name string `json:"name" protobuf:"bytes,1,opt,name=name"`
	SingularName string `json:"singularName" protobuf:"bytes,6,opt,name=singularName"`
	Namespaced bool `json:"namespaced" protobuf:"varint,2,opt,name=namespaced"`
	Group string `json:"group,omitempty" protobuf:"bytes,8,opt,name=group"`
	Version string `json:"version,omitempty" protobuf:"bytes,9,opt,name=version"`
	Kind string `json:"kind" protobuf:"bytes,3,opt,name=kind"`
	Verbs Verbs `json:"verbs" protobuf:"bytes,4,opt,name=verbs"`
	ShortNames []string `json:"shortNames,omitempty" protobuf:"bytes,5,rep,name=shortNames"`
	Categories []string `json:"categories,omitempty" protobuf:"bytes,7,rep,name=categories"`
	StorageVersionHash string `json:"storageVersionHash,omitempty" protobuf:"bytes,10,opt,name=storageVersionHash"`
}
  • kubernetes为资源准备了8种操作：create、delete、deletecollection、get、list、patch、update、watch，每一种资源都支持其中的一部分，这在每个资源的API文档中可以看到；
  • 资源支持以命名空间（namespace）进行隔离；
  • 资源对象描述文件在日常操作中频繁用到，一共由五部分组成：apiVersion、kind、metadata、spec、status，下图是官方的deployment描述文件，用于创建3个nginx pod，对着红框和文字就了解每个部分的作用了：
    在这里插入图片描述
  • 上图并没有status，该部分是用来反应当前资源对象状态的，体现在资源的数据结构中，如下所示：
type Deployment struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`
	Spec DeploymentSpec `json:"spec,omitempty" protobuf:"bytes,2,opt,name=spec"`
	Status DeploymentStatus `json:"status,omitempty" protobuf:"bytes,3,opt,name=status"`
}

官方文档速查

  • 在实际学习和开发中，对指定资源做增删改查操作时，官方文档是我们最可靠的依赖，地址：https://kubernetes.io/docs/reference/kubernetes-api/
  • 打开deployment的文档，如下图：
    在这里插入图片描述
  • 另外还有API文档也是必不可少的，遗憾的是目前没有找到1.20的API在线文档，最新的是1.19版本，地址：https://v1-19.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.19/
  • 下图是deployment的api接口文档，可见示例、path、请求响应参数都有详细的说明，对咱们的学习和开发提供了强有力的支持：
    在这里插入图片描述

APIResources数据结构

  • APIResource是个常用的数据结构了，可以用来描述资源，例如resource_quota_controller_test.go中有对其的使用：
func TestDiscoverySync(t *testing.T) {
	serverResources := []*metav1.APIResourceList{
		{
			GroupVersion: "v1",
			APIResources: []metav1.APIResource{
				{Name: "pods", Namespaced: true, Kind: "Pod", Verbs: metav1.Verbs{"create", "delete", "list", "watch"}},
			},
		},
	}
	unsyncableServerResources := []*metav1.APIResourceList{
		{
			GroupVersion: "v1",
			APIResources: []metav1.APIResource{
				{Name: "pods", Namespaced: true, Kind: "Pod", Verbs: metav1.Verbs{"create", "delete", "list", "watch"}},
				{Name: "secrets", Namespaced: true, Kind: "Secret", Verbs: metav1.Verbs{"create", "delete", "list", "watch"}},
			},
		},
	}

实际操作

  • 聊了这么久理论，接下来咱们在kubernetes环境执行一些和资源有关的操作；
  • 查看所有资源kubectl api-resources -o wide，可见当前环境的所有资源，及其相关属性：
[root@kubebuilder 07]# kubectl api-resources -o wide
NAME                              SHORTNAMES   APIVERSION                             NAMESPACED   KIND                             VERBS
bindings                                       v1                                     true         Binding                          [create]
componentstatuses                 cs           v1                                     false        ComponentStatus                  [get list]
configmaps                        cm           v1                                     true         ConfigMap                        [create delete deletecollection get list patch update watch]
endpoints                         ep           v1                                     true         Endpoints                        [create delete deletecollection get list patch update watch]
events                            ev           v1                                     true         Event                            [create delete deletecollection get list patch update watch]
limitranges                       limits       v1                                     true         LimitRange                       [create delete deletecollection get list patch update watch]
namespaces                        ns           v1                                     false        Namespace                        [create delete get list patch update watch]
...
  • 只看apps这个group下面的资源kubectl api-resources --api-group apps -o wide：
[root@kubebuilder 07]# kubectl api-resources --api-group apps -o wide
NAME                  SHORTNAMES   APIVERSION   NAMESPACED   KIND                 VERBS
controllerrevisions                apps/v1      true         ControllerRevision   [create delete deletecollection get list patch update watch]
daemonsets            ds           apps/v1      true         DaemonSet            [create delete deletecollection get list patch update watch]
deployments           deploy       apps/v1      true         Deployment           [create delete deletecollection get list patch update watch]
replicasets           rs           apps/v1      true         ReplicaSet           [create delete deletecollection get list patch update watch]
statefulsets          sts          apps/v1      true         StatefulSet          [create delete deletecollection get list patch update watch]
  • 查看指定资源的详情kubectl explain configmap：
[root@kubebuilder 07]# kubectl explain configmap
KIND:     ConfigMap
VERSION:  v1

DESCRIPTION:
     ConfigMap holds configuration data for pods to consume.

FIELDS:
   apiVersion	<string>
     APIVersion defines the versioned schema of this representation of an
     object. Servers should convert recognized schemas to the latest internal
     value, and may reject unrecognized values. More info:
     https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

   binaryData	<map[string]string>
   ...
  • 查看所有Group和Version的命令kubectl api-versions
[root@kubebuilder 07]# kubectl api-versions
admissionregistration.k8s.io/v1
admissionregistration.k8s.io/v1beta1
apiextensions.k8s.io/v1
apiextensions.k8s.io/v1beta1
apiregistration.k8s.io/v1
apiregistration.k8s.io/v1beta1
apps/v1
authentication.k8s.io/v1
authentication.k8s.io/v1beta1
authorization.k8s.io/v1
authorization.k8s.io/v1beta1
autoscaling/v1
autoscaling/v2beta1
autoscaling/v2beta2
batch/v1
batch/v1beta1
certificates.k8s.io/v1
certificates.k8s.io/v1beta1
coordination.k8s.io/v1
coordination.k8s.io/v1beta1
discovery.k8s.io/v1beta1
events.k8s.io/v1
events.k8s.io/v1beta1
extensions/v1beta1
flowcontrol.apiserver.k8s.io/v1beta1
networking.k8s.io/v1
networking.k8s.io/v1beta1
node.k8s.io/v1
node.k8s.io/v1beta1
policy/v1beta1
rbac.authorization.k8s.io/v1
rbac.authorization.k8s.io/v1beta1
scheduling.k8s.io/v1
scheduling.k8s.io/v1beta1
storage.k8s.io/v1
storage.k8s.io/v1beta1
v1
webapp.com.bolingcavalry/v1
  • 以上就是个人对Group、Version、Resource的理解和整理，在后面的client-go和kubebuilder学习过程中也会频繁用到这些基础知识，希望能给您带来一些参考；

你不孤单，欣宸原创一路相伴

  1. Java系列
  2. Spring系列
  3. Docker系列
  4. kubernetes系列
  5. 数据库+中间件系列
  6. DevOps系列

欢迎关注公众号：程序员欣宸

微信搜索「程序员欣宸」，我是欣宸，期待与您一同畅游Java世界…

程序员欣宸
关注
专栏目录
Kubernetes（K8s）入门文档.pdf
08-13
K8s入门文档
K8sAPI接口文档
xisheng_lx的博客
04-28 5315
#sjjd #K8sAPI API 操作方式 描述 CustomObjectsApi 使用 CustomObjectsApi apiInstance = new CustomObjectsApi(); CRD（CustomResourceDefinition，自定义资源）资源增删改查 CoreV1Api 使用 CoreV1Api apiInstance = new CoreV1Api(); Namespaces增删改查 SchedulingV1Api 使用 SchedulingV1
记一次configmap报错
最新发布
weixin_31998371的博客
07-04 78
登录后复制 [root@VM-0-14-kylin yaml]# kubectl apply -f config/aep-aep-nacos.yaml Error from server (Conflict): error when applying patch: {"metadata":{"creationTimest...
k8s的接口文档——swagger-ui服务
运维玄德公
11-16 1174
1. 获取配置文件 2. 启动swagger-ui 2.1 用docker部署 2.2 用docker-compose部署 2.3 在k8s平台部署
kubernetes部署文档-超详细
weixin_45093078的博客
03-08 2418
kuberbets 1.23.5版本，含dashboard,详细部署流程,包成功。
kubernetes 官方文档整理，k8s入门教程笔记整理---6、Pod
qq_43610489的博客
02-19 1017
kubelet将挑选Pod所映射的主机UID/GID，pod.spec的runAsUser、runAsGroup、fsGroup总是指的是容器内的用户，UID/GID在0~65535内。创建Pod时，默认会使用几个新的命名空间进行隔离：一个网络命名空间来隔离容器网络，一个PID命名空间来隔离进程视图，一个用户命名空间隔离容器中的用户和节点的用户。仅针对于kubelet的容器重启动作，当pod中的容器退出时，kubelet会按指数回退方式计算重启的延迟(10s、20s、40s)，最长为5分钟。
MongoDB学习笔记之分组（group）使用示例
12-15
在MongoDB的学习过程中，理解并熟练运用`group`命令对于数据处理和分析至关重要。 最后，如果您对MongoDB有更多的兴趣，可以参考相关学习笔记，包括MongoDB的配置、索引使用、文件存取、环境搭建以及各种操作方法，...
kubernetes常用命令表
02-19
$ kubectl create clusterrole NAME --verb=VERB --resource=RESOURCE [--resource-name=RESOURCE_NAME] [--api-group=API_GROUP] [--dry-run=bool] ... ``` #### 八、kubectl create clusterrolebinding 为特定的 ...
Kubernetes 实践指南
12-24
《Kubernetes实践指南》是一本由专业人士编写的关于Kubernetes实战经验的电子书，旨在帮助读者深入了解并掌握Kubernetes...通过这本书，读者可以学习到如何高效地管理Kubernetes集群，从而更好地适应云原生环境的需求。
SQL学习小记
04-17
标题 "SQL学习小记" 暗示了这篇博客文章主要关注的是SQL语言的学习和实践。SQL（Structured Query Language）是用于管理和处理关系数据库的标准编程语言。以下是对这个主题的详细探讨： SQL基础： 1. 数据类型：SQL...
kubernetes 官方文档整理，k8s入门教程笔记整理---4、kubernetes架构
qq_43610489的博客
08-18 700
容器是在节点上的pod中运行的，节点可以是一个虚拟机或者物理机器。每个节点上必有kubelet、容器运行时、kube-proxy。
学习k8s的接口（Api）使用，并试着调用KubeEdge中（计数器demo）设备的信息
m0_46440313的博客
04-21 3958
学习k8s的接口（Api）使用，并试着调用KubeEdge中（计数器demo）设备的信息
K8S api接口详解
热门推荐
Shallow的博客
02-28 1万+
一、创建管理员用户，授权，获取token值 1. 创建用户 编写CreateServiceAccount.yaml文件 apiVersion: v1 kind: ServiceAccount metadata: name: admin-user namespace: kube-system 创建用户命令： kubectl create -f CreateServiceAccount.ya...
k8s之API接口访问
xingdiango的博客
03-29 6888
API（Application Programming Interface，应用程序接口）： 是一些预先定义的接口（如函数、HTTP接口），或指软件系统不同组成部分衔接的约定。K8s也提供API接口，提供这个接口的是管理节点的apiserver组件，apiserver服务负责提供HTTP API，以便用户、其他组件相互通信。所以这个的错误的信息代表的意思是，pod用namespace默认的serviceaccout是没有权限访问K8s的 API group的。这步如果没有做就会报错。
Kubernetes(K8S)中文文档
ixiaoyang的专栏
06-13 4878
前言 Kubernetes是什么? 互动教程展开子菜单 Minikube介绍展开子菜单 设计文档展开子菜单 概念展开子菜单 Kubectl CLI展开子菜单 Kubectl 命令表展开子菜单 安装设置展开子菜单 API使用展开子菜单 集群管理展开子菜单 TASKS ...
K8S入门培训文档
qq_41583951的博客
05-25 1997
文章目录Kubernets入门1.什么是K8S2.Container技术与Docker2.1 技术演进2.2 什么是容器2.3 从系统角度看容器2.4 从容器内部看容器2.5 容器化技术2.5.1 Namespace 机制2.5.2 Linux Cgroups技术2.5.3 总结2.6 容器与镜像2.7 Docker2.7.1 Docker组成3.K8S组件与架构3.1 组件说明3.1.1 控制平面组件3.1.2 Worker组件3.1.3 应用部署在K8S内部的隐藏过程4.Pod4.1 如何实现资源共享？
Kubernetes API 文档 （v1.12 - - v1.23）
yunis
04-29 416
k8s各个版本的RestFul API 文档
​K8s中yaml文件详解（超详细）​
Java后端技术栈
09-20 6620
上述例子中，使用两个空格作为缩进，但空格的数据量并不重要，只是至少要求一个空格并且所有缩进保持一致的空格数。除了上述的基本属性外，还能够指定复杂的属性，包括容器启动运行的命令、使用的参数、工作目录以及每次实例化是否拉取新的副本。注：上述的YAML文件中，metadata这个KEY对应的值为一个Maps，而嵌套的labels这个KEY的值又是一个Map。上述例子只是一个简单的最小定义：一个名字（front-end）、基于nginx的镜像，以及容器将会监听的指定端口号（80）。YAML对用户更加友好。
Kubernetes（k8s）入门及集群部署文档
秃了也弱了
07-10 3225
Kubernetes 简称 k8s。是用于自动部署，扩展和管理容器化应用程序的开源系统。 中文官网：https://kubernetes.io/zh/ （推荐！中文官方文档，查阅起来很详细方便） 中文社区：https://www.kubernetes.org.cn/ 官方文档：https://kubernetes.io/zh/docs/home/ 社区文档：http://docs.kubernetes.org.cn/ 传统部署时代 --> 虚拟化部署时代 --> 容器部署时代服务发现和负载均衡Kuberne
评论 5
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

程序员欣宸

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值