开发者

通过client-go来操作K8S集群的操作方法

开发者 https://www.devze.com 2024-11-08 10:44 出处:网络 作者: 景天科技苑
目录client-go一、client-go介绍1. 什么是client-go?2. client-go版本的演变3. client-go客户端分类4. client-go客户端工具依赖关系5. 安装client-go二、使用client-go进行基本操作2.1 in-cluster配置2.2 out-of-clu
目录
  • client-go
  • 一、client-go介绍
    • 1. 什么是client-go?
    • 2. client-go版本的演变
    • 3. client-go客户端分类
    • 4. client-go客户端工具依赖关系
    • 5. 安装client-go
  • 二、使用client-go进行基本操作
    • 2.1 in-cluster配置
    • 2.2 out-of-cluster配置
    • 2.3 client-go 查询列表功能使用
    • 2.4 client-go查询资源详情
    • 2.5 client-go更新资源功能
    • 2.6 client-go删除资源
    • 2.7 client-go创建资源
    • 2.8 client-go使用json串创建资源
  • 三、总结

    client-go

    一、client-go介绍

    1. 什么是client-go?

    client-go是Kubernetes官方提供的,用于操作kubernetes资源的Go语言客户端库,通过它,开发者可以非常方便地在Go项目中与Kubernetes集群进行交互,实现对编程客栈Kubernetes资源以及自定义CRD的增删改查和事件监听等操作。

    同时,可以通过client-go实现kubernetes的二次开发。自定义资源开发。

    源码:

    github下载地址:https://github.com/kubernetes/client-go

    通过client-go来操作K8S集群的操作方法

    如果是其他语言的客户端工具,可以通过https://github.com/kubernetes-client 来查看

    通过client-go来操作K8S集群的操作方法

    我们看下client-go几个比较重要的目录

    通过client-go来操作K8S集群的操作方法

    2. client-go版本的演变

    左边是client-go的版本。右边是k8s的版本

    在client-go 1.17版本之前,client-go的版本与k8s版本保持一致,1.17之后,client-go的版本多了一个v的tag。是由于go语言的包是带v的版本

    通过client-go来操作K8S集群的操作方法

    通过client-go来操作K8S集群的操作方法

    建议:client-go我们直接用最新版本

    3. client-go客户端分类

    通过client-go来操作K8S集群的操作方法

    restclient: 一般我们不会使用restclient,因为它需要把整个资源的yaml文件或json数据都传过去,显得比较臃肿,一般我们不用这个

    discoverclient: 比如我们创建deployment时的apiversion: apps/v1    apps就是资源组Group   v1就是资源版本Version   资源信息 就是kind 。我们一般也不会用这个客户端工具

    ClientSet: 只能针对K8S内置的资源进行操作,不能操作自定义的资源

    DyanmicClient: 我们经常使用这个客户端,但是对于内置资源,我们还是习惯使用ClientSet,因为它更好用,自定义资源我们使用DyanmicClient。

    我们可以通过命令 kubectl api-resources 查看每种资源的资源组

    通过client-go来操作K8S集群的操作方法

    4. client-go客户端工具依赖关系

    通过client-go来操作K8S集群的操作方法

    5. 安装client-go

    client-go是一个Go模块,可以通过Go Module的方式进行安装。在你的Go项目中,执行以下命令:

    go get k8s.io/client-go@latest

    通过client-go来操作K8S集群的操作方法

    这将安装最新版本的client-go。此外,你还需要安装一些相关的依赖库,例如apiMAChinery,用于处理Kubernetes API对象。

    go get k8s.io/apimachinery@latest

    通过client-go来操作K8S集群的操作方法

    安装完还需要运行go mod tidy 加载依赖包

    通过client-go来操作K8S集群的操作方法

    二、使用client-go进行基本操作

    创建Kubernetes客户端

    在使用client-go之前,首先需要创建一个Kubernetes客户端。client-go提供了两种创建客户端的方式:in-cluster配置和out-of-cluster配置。

    我们根据我们之前写好的脚手架,改个名字,在此基础编程客栈上开发我们的项目

    通过client-go来操作K8S集群的操作方法

    并不是说在此改了就可以了,因为很多包用的还是原来的名字,

    我们可以批量替换

    在Goland IDE中想要替换某一段特定的字符串,可以使用Find and Replace 功能来实现。这是一种全局性的操作,将会在你的整个项目或指定的文件/文件夹中进行。

    使用Ctrl + Shift + R 打开Find and Repalce对话框

    通过client-go来操作K8S集群的操作方法

    我们测试client-go,要用到k8s集群,得有~/.kube/config 这个文件

    里面是加载集群的配置信息

    通过client-go来操作K8S集群的操作方法

    通过client-go来操作K8S集群的操作方法

    将这个文件复制到我们的项目中

    通过client-go来操作K8S集群的操作方法

    2.1 in-cluster配置

    在Kubernetes 集群内部运行时,可以使用in-cluster配置。这种方式不需要手动指定kubeconfig文件路径,client-go会自动使用集群中的服务账户进行身份验证。

    2.2 out-of-cluster配置

    测试client-go,我们使用out-of-cluster方式来测试,发布项目的时候,我们使用in-cluster方式配置

    在本地电脑开发环境或其他非Kubernetes集群中运行时,可以使用out-of-cluster配置。这需要指定kubeconfig文件的路径。kubeconfig文件通常位于$HOME/.kube/config,它包含了访问Kubernetes集群所需的配置信息。

    这是github上面看用法举例

    通过client-go来操作K8S集群的操作方法

    package main
    import (
        "context"
        "fmt"
        metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
        "k8s.io/client-go/kubernetes"
        "k8s.io/client-go/tools/clientcmd"
    )
    func main() {
        //1. 初始化config实例
        //var kubeconfig *string
        // 通过家目录找到kubeconfig文件。我们的路径是已知的,所以不用此项配置
        //if home := homedir.HomeDir(); home != "" {
        //    kubeconfig = flag.String("meta.kubeconfig", filepath.Join(home, ".kube", "config"), "(optional) absolute path to the kubeconfig file")
        //} else {
        //    kubeconfig = flag.String("kubeconfig", "", "absolute path to the kubeconfig file")
        //}
        //flag.Parse()
        // 1. 初始化config实例
        // 因为我们的路径是已知的,所以不用上面的配置。use the current context in kubeconfig
        // masterUrl就是离我们主节点的ip地址和端口号,我们在kubeconfig文件中有了,所以可以省略
        config, err := clientcmd.BuildConfigFromFlags("", "meta.kubeconfig")
        //要想正常应用我们的服务,必须能够实例化成功kubeconfig,要不然后面所有的功能都无法使用,所以这里直接报panic即可
        if err != nil {
            panic(err.Error())
        }
        // 2. 创建客户端工具 create the clientset
        clientset, err := kubernetes.NewForConfig(config)
        //这个客户端工具如果生成失败的话,后面的操作也无法完成,所以这里也报panic即可
        if err != nil {
            panic(err.Error())
        }
        //3. 操作集群
        pods, err := clientset.CoreV1().Pods("").List(context.TODO(), metav1.ListOptions{})
        //此时报错的话,不应该是panic了,但是这里官方用的还是panic。后期需要优化,我么可以返回个错误信息
        if err != nil {
            panic(err.Error())
        }
        //打印pod的数量
        fmt.Printf("There are %d pods in the cluster\n", len(pods.Items))
        // 获取指定名称空间下的pod数量,如果namespace不传值,默认查的是所有命名空间下的pod
        namespace := "h5-web"
        pods, err = clientset.CoreV1().Pods(namespace).List(context.TODO(), metav1.ListOptions{})
        if err != nil {
            panic(err.Error())
        }
        //打印pod的数量
        fmt.Printf("%s namespce has %d pods in the cluster\n", namespace, len(pods.Items))
        //看下返回的pod是什么
        fmt.Println("pods是什么:", pods)
    }

    通过client-go来操作K8S集群的操作方法

    2.3 client-go 查询列表功能使用

    我们看下List方法的参数,包含两个,一个context,一个是ListOptions。

    通过client-go来操作K8S集群的操作方法

    这个ListOptions就可以在里面做些筛选条件,比如传json串,标签等

    通过client-go来操作K8S集群的操作方法

    我们看下List的返回值

    通过client-go来操作K8S集群的操作方法

    通过client-go来操作K8S集群的操作方法

    所以我们要查询具体的pod里面的信息,可以在Items字段中获取到所有的pod

    跟我们通过在k8s集群中通过kubectl … -ojson的得到的信息是一样的

    通过client-go来操作K8S集群的操作方法

    如果要取其中某个pod,可以通过下标来获取

    通过client-go来操作K8S集群的操作方法

    如果忘记pod的层级关系,可以使用k8s命令的-ojson 查看一下

    完整代码:

    package main
    import (
        "context"
        "fmt"
        metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
        "k8s.io/client-go/kubernetes"
        "k8s.io/client-go/tools/clientcmd"
    )
    func main() {
        // 1. 初始化config实例
        // masterUrl就是离我们主节点的ip地址和端口号,我们在kubeconfig文件中有了,所以可以省略
        config, err := clientcmd.BuildConfigFromFlags("", "meta.kubeconfig")
        //要想正常应用我们的服务,必须能够实例化成功kubeconfig,要不然后面所有的功能都无法使用,所以这里直接报panic即可
        if err != nil {
            panic(err.Error())
        }
        // 2. 创建客户端工具 create the clientset
        clientset, err := kubernetes.NewForConfig(config)
        //这个客户端工具如果生成失败的话,后面的操作也无法完成,所以这里也报panic即可
        if err != nil {
            panic(err.Error())
        }
        //3. 操作集群
        pods, err := clientset.CoreV1().Pods("").List(context.TODO(), metav1.ListOptions{})
        //此时报错的话,不应该是panic了,但是这里官方用的还是panic。后期需要优化,我么可以返回个错误信息
        if err != nil {
            panic(err.Error())
        }
        //打印pod的数量
        fmt.Printf("There are %d pods in the cluster\n", len(pods.Items))
        // 获取指定名称空间下的pod数量,如果namespace不传值,默认查的是所有命名空间下的pod
        namespace := "h5-web"
        pods, err = clientset.CoreV1().Pods(namespace).List(context.TODO(), metav1.ListOptions{})
        if err != nil {
            panic(err.Error())
        }
        //打印pod的数量
        fmt.Printf("%s namespce has %d pods in the cluster\n", namespace, len(pods.Items))
        //看下返回的pod是什么
        fmt.Println("pods是什么:", pods)
        //获取到某个pod
        fmt.Println(pods.Items[0].Spec.NodeName)
        //获取到某个容器的镜像
        fmt.Println(pods.Items[0].Spec.Containers[0].Image)
    }

    下面,我们探讨下,我们怎么知道我们要操作的资源是属于CoreV1()或者是其他什么组呢?

    之前,我们说过,在K8S集群中,可以通过命令 kubectl api-resources查看

    通过client-go来操作K8S集群的操作方法

    通过client-go来操作K8S集群的操作方法

    deployment 的apiversion是 apps/v1 对应的client-go里面的方法就是 clientset.AppsV1()

    crontabs 的apiversion是BATch/v1 对应的client-go里面的方法就是clientset.BatchV1()

    ingresses的apiversion是networking.k8s.io/v1 对应client-go里面的方法就是clientset.NetworkingV1()

    以此类推,由此我们就知道了个汇总资源对应的操作方法

    这种V1的apiversion的资源,对应的就是clientset.CoreV1()

    通过client-go来操作K8S集群的操作方法

    如果不想通过K8S命令来查,也可以在代码中查看

    点进来

    通过client-go来操作K8S集群的操作方法

    通过client-go来操作K8S集群的操作方法

    这里可看看到个各种方法,不过我们用的时候要把首字母大写

    通过client-go来操作K8S集群的操作方法

    比如查询deployment

    //查询deployment列表,用法与pod类似
    deploy, _ := clientset.AppsV1().Deployments("").List(context.TODO(), metav1.ListOptions{})
    //查看所有名称空间下deploy的数量
    fmt.Println("deployment的数量", len(deploy.Items))
    //打印deploy名称,由于是多个,我们循环打印
    for _, i := range deploy.Items {
        fmt.Printf("当前资源的名称空间: %s, deployment名称是: %s\n", i.Namespace, i.Name)
    }
    //查询没有名称空间限制的资源,比如名称空间,工作节点,clusterrole,clusterrolebinding等
    //查的都是集群的资源
    //比如我们查询集群有多少个名称空间
    ns, _ := clientset.CoreV1().Namespaces().List(context.TODO(), metav1.ListOptions{})
    fmt.Printf("There are %d namespaces in the cluster\n", len(ns.Items))

    通过client-go来操作K8S集群的操作方法

    完整代码:

    package main
    import (
        "context"
        "fmt"
        metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
        "k8s.io/client-go/kubernetes"
        "k8s.io/client-go/tools/clientcmd"
    )
    func main() {
        // 1. 初始化config实例
        // masterUrl就是离我们主节点的ip地址和端口号,我们在kubeconfig文件中有了,所以可以省略
        config, err := clientcmd.BuildConfigFromFlags("", "meta.kubeconfig")
        //要想正常应用我们的服务,必须能够实例化成功kubeconfig,要不然后面所有的功能都无法使用,所以这里直接报panic即可
        if err != nil {
            panic(err.Error())
        }
        // 2. 创建客户端工具 create the clientset
        clientset, err := kubernetes.NewForConfig(config)
        //这个客户端工具如果生成失败的话,后面的操作也无法完成,所以这里也报panic即可
        if err != nil {
            panic(err.Error())
        }
        //3. 操作集群
        pods, err := clientset.CoreV1().Pods("").List(context.TODO(), metav1.ListOptions{})
        //此时报错的话,不应该是panic了,但是这里官方用的还是panic。后期需要优化,我么可以返回个错误信息
        if err != nil {
            panic(err.Error())
        }
        //打印pod的数量
        fmt.Printf("There are %d pods in the cluster\n", len(pods.Items))
        // 获取指定名称空间下的pod数量,如果namespace不传值,默认查的是所有命名空间下的pod
        //namespace := "h5-web"
        //pods, err = clientset.CoreV1().Pods(namespace).List(context.TODO(), metav1.ListOptions{})
        //if err != nil {
        //    panic(err.Error())
        //}
        打印pod的数量
        //fmt.Printf("%s namespce has %d pods in the cluster\n", namespace, len(pods.Items))
        看下返回的pod是什么
        //fmt.Println("pods是什么:", pods)
        //
        获取到某个pod
        //fmt.Println(pods.Items[0].Spec.NodeName)
        获取到某个容器的镜像
        //fmt.Println(pods.Items[0].Spec.Containers[0].Image)
        //查询deployment列表,用法与pod类似
        deploy, _ := clientset.AppsV1().Deployments("").List(context.TODO(), metav1.ListOptions{})
        //查看所有名称空间下deploy的数量
        fmt.Println("deployment的数量", len(deploy.Items))
        //打印deploy名称,由于是多个,我们循环打印
        for _, i := range deploy.Items {
            fmt.Printf("当前资源的名称空间: %s, deployment名称是: %s\n", i.Namespace, i.Name)
        }
        //查询没有名称空间限制的资源,比如名称空间,工作节点,clusterrole,clusterrolebinding等
        //查的都是集群的资源
        //比如我们查询集群有多少个名称空间
        ns, _ := clientset.CoreV1().Namespaces().List(context.TODO(), metav1.ListOptions{})
        fmt.Printf("There are %d namespaces in the cluster\n", len(ns.Items))
    }

    2.4 client-go查询资源详情

    Get()方法,可以获取单个资源的详情,获取详情之后,我们可以传给前端展示,或者根据查询出来的数据进行更改

    比如说,我们对K8S集群中h5-web名称空间下的 pods 查询详情

    通过client-go来操作K8S集群的操作方法

    // 查询资源详情 Get()方法
    // Get(ctx context.Context, name string, opts metav1.GetOptions) (*v1.Pod, error)
    poddetail, _ := clientset.CoreV1().Pods("h5-web").Get(context.TODO(), "web-864f4c6988-95sw4", metav1.GetOptions{})
    //fmt.Println("pod详情:", poddetail)
    //打印pod的镜像名称
    fmt.Println("pod第一个容器的镜像名称", poddetail.Spec.Containers[0].Image)
    //获取名称空间的详情
    namespace, _ := clientset.CoreV1().Namespaces().Get(context.TODO(), "h5-web", metav1.GetOptions{})
    fmt.Println("名称空间详情:", namespace)

    通过client-go来操作K8S集群的操作方法

    完整代码

    package main
    import (
        "context"
        "fmt"
        metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
        "k8s.io/client-go/kubernetes"
        "k8s.io/client-go/tools/clientcmd"
    )
    func main() {
        // 1. 初始化config实例
        // masterUrl就是离我们主节点的ip地址和端口号,我们在kubeconfig文件中有了,所以可以省略
        config, err := clientcmd.BuildConfigFromFlags("", "meta.kubeconfig")
        //要想正常应用我们的服务,必须能够实例化成功kubeconfig,要不然后面所有的功能都无法使用,所以这里直接报panic即可
        if err != nil {
            panic(err.Error())
        }
        // 2. 创建客户端工具 create the clientset
        clientset, err := kubernetes.NewForConfig(config)
        //这个客户端工具如果生成失败的话,后面的操作也无法完成,所以这里也报panic即可
        if err != nil {
            panic(err.Error())
        }
        //3. 操作集群
        // 查询资源详情 Get()方法
        // Get(ctx context.Context, name string, opts metav1.GetOptions) (*v1.Pod, error)
        poddetail, _ := clientset.CoreV1().Pods("h5-web").Get(context.TODO(), "web-864f4c6988-95sw4", metav1.GetOptions{})
        //fmt.Println("pod详情:", poddetail)
        //打印pod的镜像名称
        fmt.Println("pod第一个容器的镜像名称", poddetail.Spec.Containers[0].Image)
        //获取名称空间的详情
        namespace, _ := clientset.CoreV1().Namespaces().Get(context.TODO(), "h5-web", metav1.GetOptions{})
        fmt.Println("名称空间详情:", namespace)
    }

    其他资源查询方式类似,感兴趣的朋友可以尝试下

    2.5 client-go更新资源功能

    更新的前提是该字段是可更改的

    比如这种can’t be updated的字段,就不能被修改

    通过client-go来操作K8S集群的操作方法

    注意:如果修改的字段在资源中不存在,比如labels 。修改时会报空指针错误,此时就要初始化下才能修改

    //更新资源操作  Update()
    //先获取资源详情,再修改
    //比如,我们修改service的暴露的端口号
    service, _ := clientset.CoreV1().Services("h5-web").Get(context.TODO(), "web", metav1.GetOptions{})
    fmt.Printf("service对外的端口号是 %d\n", service.Spec.Ports[0].NodePort)
    // 修改端口号
    // service-node-port-range 默认可以设置的范围 30000-32767
    service.Spec.Ports[0].NodePort = 32050
    // 修改暴露的端口号
    // Update(ctx context.Context, service *v1.Service, opts metav1.UpdateOptions) (*v1.Service, error)
    _, err = clientset.CoreV1().Services("h5-web").Update(context.TODO(), service, metav1.UpdateOptions{})
    if err != nil {
        panic(err.Error())
    }
    fmt.Printf("修改后service对外的端口号是 %d\n", service.Spec.Ports[0].NodePort)
    //修改deploy的副本数
    deploy, _ := clientset.AppsV1().Deployments("h5-web").Get(context.TODO(), "web", metav1.GetOptions{})
    //查看当前deploy的副本数
    fmt.Println("当前deploy的副本数是:", *deploy.Spec.Replicas)
    //修改副本数
    replacs := int32(3)
    //注意Replicas 是int32的指针类型
    deploy.Spec.Replicas = &replacs
    _, err = clientset.AppsV1().Deployments("h5-web").Update(context.TODO(), deploy, metav1.UpdateOptions{})
    //查看修改后deploy的副本数
    fmt.Println("修改后deploy的副本数是:", *deploy.Spec.Replicas)

    通过client-go来操作K8S集群的操作方法

    完整代码:

    package main
    import (
        "context"
        "fmt"
        metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
        "k8s.io/client-go/kubernetes"
        "k8s.io/client-go/tools/clientcmd"
    )
    func main() {
        // 1. 初始化config实例
        // masterUrl就是离我们主节点的ip地址和端口号,我们在kubeconfig文件中有了,所以可以省略
        config, err := clientcmd.BuildConfigFromFlags("", "meta.kubeconfig")
        //要想正常应用我们的服务,必须能够实例化成功kubeconfig,要不然后面所有的功能都无法使用,所以这里直接报panic即可
        if err != nil {
            panic(err.Error())
        }
        // 2. 创建客户端工具 create the clientset
        clientset, err := kubernetes.NewForConfig(config)
        //这个客户端工具如果生成失败的话,后面的操作也无法完成,所以这里也报panic即可
        if err != nil {
            panic(err.Error())
        }
        //3. 操作集群
        //更新资源操作  Update()
        //先获取资源详情,再修改
        //比如,我们修改service的暴露的端口号
        service, _ := clientset.CoreV1().Services("h5-web").Get(context.TODO(), "web", metav1.GetOptions{})
        fmt.Printf("service对外的端口号是 %d\n", service.Spec.Ports[0].NodePort)
        // 修改端口号
        // service-node-port-range 默认可以设置的范围 30000-32767
        service.Spec.Ports[0].NodePort = 32050
        // 修改暴露的端口号
        // Update(ctx context.Context, service *v1.Service, opts metav1.UpdateOptions) (*v1.Service, error)
        _, err = clientset.CoreV1().Services("h5-web").Update(context.TODO(), service, metav1.UpdateOptions{})
        if err != nil {
            panic(err.Error())
        }
        fmt.Printf("修改后service对外的端口号是 %d\n", service.Spec.Ports[0].NodePort)
        //修改deploy的副本数
        deploy, _ := clientset.AppsV1().Deployments("h5-web").Get(context.TODO(), "web", metav1.GetOptions{})
        //查看当前deploy的副本数
        fmt.Println("当前deploy的副本数是:", *deploy.Spec.Replicas)
        //修改副本数
        replacs := int32(3)
        //注意Replicas 是int32的指针类型
        deploy.Spec.Replicas = &replacs
        _, err = clientset.AppsV1().Deployments("h5-web").Update(context.TODO(), deploy, metav1.UpdateOptions{})
        //查看修改后deploy的副本数
        fmt.Println("修改后deploy的副本数是:", *deploy.Spec.Replicas)
    }

    2.6 client-go删除资源

    删除pod,比如我们将下列的pod删除

    通过client-go来操作K8S集群的操作方法

    //删除资源 Delete()
    //删除pod
    err = clientset.CoreV1().Pods("h5-web").Delete(context.TODO(), "web-864f4c6988-r456g", metav1.DeleteOptions{})
    if err != nil {
        panic(err.Error())

    可见pod已被删除

    通过client-go来操作K8S集群的操作方法

    2.7 client-go创建资源

    创建namespace

    //创建名称空间
    var namespace corev1.Namespace
    //创建namespace只需要传个名字就可以了
    namespace.Name = "test1"
    // Create(ctx context.Context, namespace *v1.Namespace, opts metav1.CreateOptions) (*v1.Namespace, error)
    //传的是指针
    _, err = clientset.CoreV1().Namespaces().Create(context.TODO(), &namespace, metav1.CreateOptions{})
    if err != nil {
        panic(err.Error())
    }

    注意,这个corev1的导包,我们要根据Create()这个方法里面的导包,导过来,不要导错了,因为很多v1的包

    通过client-go来操作K8S集群的操作方法

    通过client-go来操作K8S集群的操作方法

    创建deployment

    注意,这个deployment的v1,

    通过client-go来操作K8S集群的操作方法

    导包的时候,不要导错

    通过client-go来操作K8S集群的操作方法

    传参时,要把必须得参数都传进去

    通过client-go来操作K8S集群的操作方法

    通过client-go来操作K8S集群的操作方法

    可以通过这个命令来查看哪些是必须传的参数

    kubectl create deployment mynginx --image="nginx" --dry-run=client -oyaml

    它会导出一份yaml文件

    通过client-go来操作K8S集群的操作方法

    package main
    import (
        "context"
        "fmt"
        deployv1 "k8s.io/api/apps/v1"
        corev1 "k8s.io/api/core/v1"
        metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
        "k8s.io/client-go/kubernetes"
        "k8s.io/client-go/tools/clientcmd"
    )
    func main() {
        // 1. 初始化config实例
        // masterUrl就是离我们主节点的ip地址和端口号,我们在kubeconfig文件中有了,所以可以省略
        config, err := clientcmd.BuildConfigFromFlags("", "meta.kubeconfig")
        //要想正常应用我们的服务,必须能够实例化成功kubeconfig,要不然后面所有的功能都无法使用,所以这里直接报panic即可
        if err != nil {
            panic(err.Error())
        }
        // 2. 创建客户端工具 create the clientset
        clientset, err := kubernetes.NewForConfig(config)
        //这个客户端工具如果生成失败的话,后面的操作也无法完成,所以这里也报panic即可
        if err != nil {
            panic(err.Error())
        }
        //3. 操作集群
        //创建deployment
        var deploy deployv1.Deployment
        //给deployment传参,要把必须传的参数都传进去,不然创建会报错
        deploy.Name = "mydeploy"
        deploy.Namespace = "test1"
        //副本数
        replicas := int32(1)
        deploy.Spec.Replicas = &replicas
        //mathlabels
        labels := make(map[string]string)
        labels["app"] = "nginx"
        //Selector 是个指针类型,需要先初始化
        //Selector *metav1.LabelSelector `json:"selector" protobuf:"bytes,2,opt,name=selector"`
        deploy.Spec.Selector = &metav1.LabelSelector{}
        deploy.Spec.Selector.MatchLabels = labels
        //deployment label   metadata会将里面的资源发布出去,metadata可以省略掉
        deploy.Labels = labels
        // 创建template 这个template模版就是pod的模板
        // Template v1.PodTemplateSpec `json:"template" protobuf:"bytes,3,opt,name=template"`
        // 此时的labels要和selector的labels一样,否则deployment就无法管理到pod
        deploy.Spec.Template.ObjectMeta.Labels = labels
        //创建容器,容器是个切片,可以创建多个容器
        var containers []corev1.Container
        var container corev1.Container
        container.Name = "nginx"
        container.Image = "nginx:1.7.9"
        containers = append(containers, container)
        container.Name = "Redis"
        container.Image = "redis:6-alpine"
        containers = append(containers, container)
        deploy.Spec.Template.Spec.Containers = containers
        _, err = clientset.AppsV1().Deployments("test1").Create(context.TODO(), &deploy, metav1.CreateOptions{})
    }

    查看创建的deploy

    通过client-go来操作K8S集群的操作方法

    查看yaml文件,两个容器都创建成功

    [root@master01 svc ]#kubectl get deploy -n test1 -oyaml
    apiVersion: v1
    items:
    - apiVersion: apps/v1
      kind: Deployment
      metadata:
        annotations:
          deployment.kubernetes.io/revision: "1"
        creationTimestamp: "2024-11-05T09:58:43Z"
        generation: 1
        labels:
          app: nginx
        name: mydeploy
        namespace: test1
        resourceVersion: "1079640"
        uid: 8df3654a-71c6-45d5-888d-6329ed81dad7
      spec:
        progressDeadlineSeconds: 600
        replicas: 1
        revisionHistoryLimit: 10
        selector:
          matchLabels:
            app: nginx
        strategy:
          rollingUpdate:
            maxSurge: 25%
            maxUnavailable: 25%
          type: RollingUpdate
        template:
          metadata:
            creationTimestamp: null
            labels:
              app: nginx
          spec:
            containers:
            - image: nginx:1.7.9
              imagePullPolicy: IfNotPresent
              name: nginx
              resources: {}
              terminationMessagePath: /dev/termination-log
              terminationMessagePolicy: File
            - image: redis:6-alpine
              imagePullPolicy: IfNotPresent
              name: redis
              resources: {}
              terminationMessagePath: /dev/termination-log
              terminationMessagePolicy: File
            dnsPolicy: ClusterFirst
            restartPolicy: Always
            schedulerName: default-scheduler
            securityContext: {}
            terminationGracePeriodSeconds: 30
      status:
        conditions:
        - lastTransitionTime: "2024-11-05T09:58:43Z"
          lastUpdateTime: "2024-11-05T09:58:43Z"
          message: Deployment does not have minimum availability.
          reason: MinimumReplicasUnavailable
          status: "False"
          type: Available
        - lastTransitionTime: "2024-11-05T09:58:43Z"
          lastUpdateTime: "2024-11-05T09:58:43Z"
          message: ReplicaSet "mydeploy-68dcc7d46d" is progressing.
          reason: ReplicaSetUpdated
          status: "True"
          type: Progressing
        observedGeneration: 1
        replicas: 1
        unavailableReplicas: 1
        updatedReplicas: 1
    kind: List
    metadata:
      resourceVersion: ""

    2.8 client-go使用json串创建资源

    上面使用手动填值的方式创建,还是比较麻烦的,稍微有不注意的地方还容易犯错,因此,在前后端分离的项目中,在web页面,一般我们不悔通过手动填值进行创建资源。

    一般我们会根据json串来创建资源

    首先我们通过先通过kubectl命令导出json串

    通过client-go来操作K8S集群的操作方法

    通过client-go来操作K8S集群的操作方法

    –dry-run 选项只能为 “none”、“server”、"client"三者中的一个,默认是none;当不加该参数,或者为none的时候,该操作后资源会生效 ,请求会被发送到kube-apiserver并做实际更改;

    当该参数为client的时候,只打印该对象并不会发送请求且并不会实际创建该对象;

    当该参数为server的时候,会发送请求到服务端,但是并不会实际创建该python对象。

    比如我们拿到一个创建deploy的json串

    kubectl create deployment myredis --image="redis" --dry-run=client -ojson

    通过client-go来操作K8S集群的操作方法

    我们将json串拿出来

    {
        "kind": "Deployment",
        "apiVersion": "apps/v1",
        "metadata": {
            "name": "myredis",
            "creationTimestamp": null,
            "labels": {
                "app": "myredis"
            }
        },
        "spec": {
            "replicas": 1,
            "selector": {
                "matchLabels": {
                    "app": "myredis"
                }
            },
            "template": {
                "metadata": {
                    "creationTimestamp": null,
                    "labels": {
                        "app": "myredis"
                    }
                },
                "spec": {
                    "containers": [
                        {
                            "name": "redis",
                            "image": "redis",
                            "resources": {}
                        }
                    ]
                }
            },
            "strategy": {}
        },
        "status": {}
    }

    使用json创建deploy完整代码:

    package main
    import (
        "context"
        "encoding/json"
        "fmt"
        deployv1 "k8s.io/api/apps/v1"
        metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
        "k8s.io/client-go/kuandroidbernetes"
        "k8s.io/client-go/tools/clientcmd"
    )
    func main() {
        // 1. 初始化config实例
        // masterUrl就是离我们主节点的ip地址和端口号,我们在kubeconfig文件中有了,所以可以省略
        config, err := clientcmd.BuildConfigFromFlags("", "meta.kubeconfig")
        //要想正常应用我们的服务,必须能够实例化成功kubeconfig,要不然后面所有的功能都无法使用,所以这里直接报panic即可
        if err != nil {
            panic(err.Error())
        }
        // 2. 创建客户端工具 create the clientset
        clientset, err := kubernetes.NewForConfig(config)
        //这个客户端工具如果生成失败的话,后面的操作也无法完成,所以这里也报panic即可
        if err != nil {
            panic(err.Error())
        }
        //3. 操作集群
        //通过json串创建k8s资源,注意多行字符串用反引号包裹
        deployJson := `{
        "kind": "Deployment",
        "apiVersion": "apps/v1",
        "metadata": {
            "name": "myredis",
            "creationTimestamp": null,
            "labels": {
                "app": "myredis"
            }
        },
        "spec": {
            "replicas": 1,
            "selector": {
                "matchLabels": {
                    "app": "myredis"
                }
            },
            "template": {
                "metadata": {
                    "creationTimestamp": null,
                    "labels": {
                        "app": "myredis"
                    }
                },
                "spec": {
                    "containers": [
                        {
                            "name": "redis",
                            "image": "redis",
                            "resources": {}
                        }
                    ]
                }
            },
            "strategy": {}
        },
        "status": {}
    }`
        //我们需要将json串转换成deployv1类型的资源
        var redisdeploy deployv1.Deployment
        //将json转换成struct
        // func Unmarshal(data []byte, v any) error
        err = json.Unmarshal([]byte(deployJson), &redisdeploy)
        if err != nil {
            panic(err.Error())
        }
        fmt.Println("将json转换成的struct:", redisdeplhttp://www.devze.comoy)
        //创建deploy
        _, err = clientset.AppsV1().Deployments("default").Create(context.TODO(), &redisdeploy, metav1.CreateOptions{})
        if err != nil {
            panic(err.Error())
        }
    }

    在K8S集群查看下,创建成功

    通过client-go来操作K8S集群的操作方法

    三、总结

    client-go是Kubernetes官方提供的Go客户端库,它封装了与Kubernetes API服务器的交互,提供了便捷的方式进行各种资源的管理。通过创建客户端并使用相应的API客户端进行操作,你可以轻松地进行Pod、Deployment、Service等资源的增删改查。

    本文详细介绍了client-go的安装、配置和使用方法,并通过示例代码展示了如何进行常见的Kubernetes操作。希望这些内容能帮助大家更好地理解和使用client-go,从而提高你的Kubernetes开发效率。

    到此这篇关于通过client-go来操作K8S集群的文章就介绍到这了,更多相关client-go操作K8S集群内容请搜索编程客栈(www.devze.com)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程客栈(www.devze.com)!

    0

    精彩评论

    暂无评论...
    验证码 换一张
    取 消

    关注公众号