client-go是由k8s发布且维护的专门用于开发者和kubernetes交互的客户端库。它支持对k8s资源的CRUD操作(create、read、update、delete),事件监听和处理,访问kubernetes集群的上下文和配置。
client go是独立于kubernetes集群之外,但是又和集群交互的客户端机器。在这台机器上安装go环境以及和kubernetes建立连接。
在新的节点(在我这里是虚拟机)上安装go环境,首先下载go的安装包,在官网下载。All releases - The Go Programming Language
由于我安装的是server版的虚拟机,所以安装go环境的时候,使用curl命令来下载安装包。因为要确定go环境与k8s集群的兼容性,所以要查看集群的k8s版本。
[root@master ~]# kubectl version --short
Client Version: v1.23.1
Server Version: v1.23.1
查看kubernetes官方文档发现是与go的1.19.5版本相匹配
- [root@client ~]# curl -L -O https://go.dev/dl/go1.19.5.linux-amd64.tar.gz
- % Total % Received % Xferd Average Speed Time Time Time Current
- Dload Upload Total Spent Left Speed
- 100 75 100 75 0 0 131 0 --:--:-- --:--:-- --:--:-- 131
- 100 65.7M 100 65.7M 0 0 3446k 0 0:00:19 0:00:19 --:--:-- 3513k
- [root@client ~]# file go1.22.5.linux-amd64.tar.gz
- # 验证下载文件的类型是否为压缩包
- go1.22.5.linux-amd64.tar.gz: gzip compressed data, max compression, original size modulo 2^32 232839680 gzip compressed data, unknown method, has CRC, extra field, has comment, encrypted, from FAT filesystem (MS-DOS, OS/2, NT), original size modulo 2^32 232839680
- [root@client ~]# rm -rf /usr/local/go && tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz
将go加入环境变量,并查看go的版本,以确定go是否安装成功。
- [root@client ~]# export PATH=$PATH:/usr/local/go/bin
- [root@client ~]# go version
- go version go1.19.5 linux/amd64
将go持久化的加入环境变量,将上面的export PATH=...写入系统文件。
- [root@client ~]# vim ~/.bashrc
- [root@client ~]# source ~/.bashrc
如果您使用的 Kubernetes 版本 >= v1.17.0,请使用相应的 v0.x.y 标签。例如,k8s.io/client-go@v0.20.4 对应于 Kubernetes v1.20.4。我的版本为1.23.1,所以下载相应的client-go版本:
go get k8s.io/client-go@v0.23.1
go mod文件创建并启动go模式支持:
- go mod init <module-name>
- export GO111MODULE=on
随后会创建一个初始的go.mod文件,包含模块名称和go的版本信息等,随着项目部署或者添加依赖项,go会自动更新,go.mod文件会自动更新,记录所有依赖及其版本,同时生成go.sum文件,以确保依赖项的一致性和完整性。因此go.mod文件会逐渐积累项目所需的所有依赖以及版本信息。
编写main.go文件
- package main
-
- import (
- "flag"
- "fmt"
- metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
- "k8s.io/client-go/kubernetes"
- "k8s.io/client-go/tools/clientcmd"
- "context"
- )
-
- func main() {
- // 配置 k8s 集群外 kubeconfig 配置文件
- var kubeconfig *string
- kubeconfig = flag.String("kubeconfig", "/etc/k8scoonfig/config", "absolute path to the kubeconfig file")
- namespace := flag.String("namespace","default","the namespace to list the pod from")
- flag.Parse()
-
- // use the current context in kubeconfig
- config, err := clientcmd.BuildConfigFromFlags("", *kubeconfig)
- if err != nil {
- panic(err.Error())
- }
-
- // create the clientset
- clientset, err := kubernetes.NewForConfig(config)
- if err != nil {
- panic(err.Error())
- }
-
- // 获取集群中所有 Pod 列表
- pods, err := clientset.CoreV1().Pods("").List(context.TODO(), metav1.ListOptions{})
- if err != nil {
- panic(err.Error())
- }
- fmt.Printf("There are %d pods in the k8s cluster\n", len(pods.Items))
-
- // 获取指定 namespace 中的 Pod 列表
- pods, err = clientset.CoreV1().Pods(*namespace).List(context.TODO(), metav1.ListOptions{})
- if err != nil {
- panic(err)
- }
- fmt.Printf("There are %d pods in namespace %s\n", len(pods.Items), namespace)
- for _, pod := range pods.Items {
- fmt.Printf("Name: %s, Status: %s, CreateTime: %v\n", pod.Name, pod.Status.Phase, pod.CreationTimestamp)
- }
- }
当指定namespace为monitor-sa,可以看到client-go成功抓取了集群中该namespace的pod数量。
- [root@client client_go_examples]# ./app -kubeconfig=/etc/k8scoonfig/config -namespace="monitor-sa"
- There are 18 pods in the k8s cluster
- There are 3 pods in namespace monitor-sa
- Name: node-exporter-jb9jp, Status: Running, CreateTime: 2024-07-06 11:47:33 +0000 UTC
- Name: node-exporter-kpvxd, Status: Running, CreateTime: 2024-07-06 11:47:33 +0000 UTC
- Name: node-exporter-pwdw4, Status: Running, CreateTime: 2024-07-06 11:47:33 +0000 UTC
下载kubectl。注意这里下载保存的地方就是后面要引用的地方,所以最好记住保存路径,且不要保存在下载文件夹。https://storage.googleapis.com/kubernetes-release/release/v1.18.0/bin/windows/amd64/kubectl.exe
然后把他加入环境变量,这里的kube是存储kubectl.exe的文件夹。
打开windows命令行,测试kubectl是否正常工作。
配置kube-config,将复制到linux系统的config文件也同样复制到windows,我这里的目录是C:/user/.kube/config。随后配置到vscode中。
下载client-go到本地,然后在vscode中下载go的插件,以及code runner插件:
然后cstrl+shift+p,进入vscode的搜索行,安装go的插件依赖。搜索Go:install/update tools
如果出现这种情况,则需要设环境变量。设置如下四个环境变量,其中go_path是你要运行的go代码的存放目录,而go_root是你下载go存放的目录。
查看path,如果有以下这项则为正常:
此时再尝试下载GO:install/update tools,则成功。
安装成功后,在gopath目录下安装client-go
- go get k8s.io/client-go@v0.23.1
- go get k8s.io/apimachinery@v0.23.1
- #使用 go mod tidy 确保所有依赖项已被正确下载并添加到项目中:
- go mod tidy
- go run main.go
发现运行成功: