Kubernetes 客户端库 Client-Go 教程-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00850/article/details/141009473

Kubernetes 客户端库 Client-Go 教程

client-goGo client for Kubernetes.项目地址:https://gitcode.com/gh_mirrors/cl/client-go

1. 项目介绍

Kubernetes Client-Go 是一个用于开发 Kubernetes 应用程序的官方 Go 语言客户端库。它提供了与 Kubernetes 集群通信所需的接口和工具，允许开发者轻松地在 Go 代码中集成 Kubernetes 的功能。

版本与兼容性

Client-Go 遵循语义版本规范。主要版本号变更表示可能有不向后兼容的API更改，次要版本更新通常添加新功能，而补丁版本则修复bug，不改变已有功能。推荐根据你的项目需求指定特定版本以保持代码与库之间的兼容性。

兼容性矩阵

Client-Go 可以与多个 Kubernetes 集群版本配合使用，但不是所有的功能都是完全向后兼容的。请参考项目中的兼容性矩阵来选择适合的版本。

2. 项目快速启动

要在你的项目中引入 kubernetes/client-go，确保你使用的是 Go 1.16 或更高版本，然后通过 go get 命令获取库：

go get k8s.io/client-go@latest

如果你需要特定版本，可以这样操作：

go get k8s.io/client-go@v0.23.0

接下来，在你的代码中导入并初始化客户端配置：

package main

import (
	"k8s.io/client-go/kubernetes"
	"k8s.io/client-go/rest"
)

func main() {
	// 创建配置对象
	config, err := rest.InClusterConfig()
	if err != nil {
		panic(err)
	}

	// 使用配置创建客户端
	clientset, err := kubernetes.NewForConfig(config)
	if err != nil {
		panic(err)
	}

	// 现在你可以使用 clientset 来访问集群资源
	// ...
}

这段示例代码展示了如何在集群内部应用程序中获取客户端配置。如果你的应用不在集群内，请参阅官方文档来了解如何手动设置配置。

3. 应用案例和最佳实践

示例：列出所有命名空间的 pod

package main

import (
	"context"
	"fmt"

	corev1 "k8s.io/api/core/v1"
	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
)

func main() {
	// 初始化客户端实例（假设已创建了 config 对象）
	clientset, _ := kubernetes.NewForConfig(config)

	// 列出所有命名空间的 pod
	pods, err := clientset.CoreV1().Pods(metav1.NamespaceAll).List(context.TODO(), metav1.ListOptions{})
	if err != nil {
		panic(err)
	}

	fmt.Printf("发现 %d 个 pod:\n", len(pods.Items))
	for _, pod := range pods.Items {
		fmt.Printf("- %s/%s\n", pod.ObjectMeta.Namespace, pod.ObjectMeta.Name)
	}
}