[k8s源码]1.client-go集群外部署

client-go是由k8s发布且维护的专门用于开发者和kubernetes交互的客户端库。它支持对k8s资源的CRUD操作（create、read、update、delete），事件监听和处理，访问kubernetes集群的上下文和配置。

client go是独立于kubernetes集群之外，但是又和集群交互的客户端机器。在这台机器上安装go环境以及和kubernetes建立连接。

Linux

安装go环境

在新的节点（在我这里是虚拟机）上安装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

配置client-go

如果您使用的 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文件会逐渐积累项目所需的所有依赖以及版本信息。

利用client-go抓取信息

编写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

windows

下载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中。

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

发现运行成功：