Explanation
kubernetes be estimated as the presence of linux, Client-Go is its SDK Go, Client-Go / examples / gives some use cases, but a relatively small number.
api
Resource definition is not client-go, but in a called api project, this project directory synchronization from kubernetes project staging / src / k8s.io / api , can be obtained in the following way:
go get k8s.io/api
api directory structure as follows:
▾ api/
▸ admission/
▸ admissionregistration/
▸ apps/
▸ authentication/
▸ authorization/
▸ autoscaling/
▸ batch/
▸ certificates/
▸ core/
▸ extensions/
▸ Godeps/
▸ imagepolicy/
▸ networking/
▸ policy/
▸ rbac/
▸ scheduling/
▸ settings/
▸ storage/
▸ vendor/
LICENSE
OWNERS
README.md
client-go
client-go is kubernetes official project, go language, use the sample source code located: Go-code-Example / k8sclient .
Obtain client-go:
go get k8s.io/client-go
go get k8s.io/apimachinery
go get k8s.io/api
go get k8s.io/kube-openapi
Creating Clientset
Operating handle Clientset contains kubernetes of all resources, through "k8s.io/client-go/kubernetes" in NewForConfig()
creation.
Creating Clientset need to provide a rest.Config, tools Config can be mentioned later / clientcmd generation, you can also fill yourself:
config := rest.Config{ Host: "https://10.39.0.105:6443", APIPath: "/", Prefix: "", BearerToken: "af8cbdf725efadf8c4", TLSClientConfig: rest.TLSClientConfig{Insecure: true}, }
Creating simple:
clientset, err := kubernetes.NewForConfig(&config)
Use Clientset
Clientset, intended as the name suggests, it is a collection of client, / clientset.go defined in the client-go / kubernetes.
type Clientset struct { *discovery.DiscoveryClient admissionregistrationV1alpha1 *admissionregistrationv1alpha1.AdmissionregistrationV1alpha1Client appsV1beta1 *appsv1beta1.AppsV1beta1Client appsV1beta2 *appsv1beta2.AppsV1beta2Client appsV1 *appsv1.AppsV1Client authenticationV1 *authenticationv1.AuthenticationV1Client authenticationV1beta1 *authenticationv1beta1.AuthenticationV1beta1Client authorizationV1 *authorizationv1.AuthorizationV1Client authorizationV1beta1 *authorizationv1beta1.AuthorizationV1beta1Client autoscalingV1 *autoscalingv1.AutoscalingV1Client autoscalingV2beta1 *autoscalingv2beta1.AutoscalingV2beta1Client batchV1 *batchv1.BatchV1Client batchV1beta1 *batchv1beta1.BatchV1beta1Client batchV2alpha1 *batchv2alpha1.BatchV2alpha1Client certificatesV1beta1 *certificatesv1beta1.CertificatesV1beta1Client coreV1 *corev1.CoreV1Client extensionsV1beta1 *extensionsv1beta1.ExtensionsV1beta1Client networkingV1 *networkingv1.NetworkingV1Client policyV1beta1 *policyv1beta1.PolicyV1beta1Client rbacV1 *rbacv1.RbacV1Client rbacV1beta1 *rbacv1beta1.RbacV1beta1Client rbacV1alpha1 *rbacv1alpha1.RbacV1alpha1Client schedulingV1alpha1 *schedulingv1alpha1.SchedulingV1alpha1Client settingsV1alpha1 *settingsv1alpha1.SettingsV1alpha1Client storageV1beta1 *storagev1beta1.StorageV1beta1Client storageV1 *storagev1.StorageV1Client }
Get different resources Clientset method of operating handle, Clientset following methods are available:
+Admissionregistration() : admissionregistrationv1alpha1.AdmissionregistrationV1alpha1Interface
+AdmissionregistrationV1alpha1() : admissionregistrationv1alpha1.AdmissionregistrationV1alpha1Interface +Apps() : appsv1.AppsV1Interface +AppsV1() : appsv1.AppsV1Interface +AppsV1beta1() : appsv1beta1.AppsV1beta1Interface +AppsV1beta2() : appsv1beta2.AppsV1beta2Interface +Authentication() : authenticationv1.AuthenticationV1Interface +AuthenticationV1() : authenticationv1.AuthenticationV1Interface +AuthenticationV1beta1() : authenticationv1beta1.AuthenticationV1beta1Interface +Authorization() : authorizationv1.AuthorizationV1Interface +AuthorizationV1() : authorizationv1.AuthorizationV1Interface +AuthorizationV1beta1() : authorizationv1beta1.AuthorizationV1beta1Interface +Autoscaling() : autoscalingv1.AutoscalingV1Interface +AutoscalingV1() : autoscalingv1.AutoscalingV1Interface +AutoscalingV2beta1() : autoscalingv2beta1.AutoscalingV2beta1Interface +Batch() : batchv1.BatchV1Interface +BatchV1() : batchv1.BatchV1Interface +BatchV1beta1() : batchv1beta1.BatchV1beta1Interface +BatchV2alpha1() : batchv2alpha1.BatchV2alpha1Interface +Certificates() : certificatesv1beta1.CertificatesV1beta1Interface +CertificatesV1beta1() : certificatesv1beta1.CertificatesV1beta1Interface +Core() : corev1.CoreV1Interface +CoreV1() : corev1.CoreV1Interface +Discovery() : discovery.DiscoveryInterface +Extensions() : extensionsv1beta1.ExtensionsV1beta1Interface +ExtensionsV1beta1() : extensionsv1beta1.ExtensionsV1beta1Interface +Networking() : networkingv1.NetworkingV1Interface +NetworkingV1() : networkingv1.NetworkingV1Interface +Policy() : policyv1beta1.PolicyV1beta1Interface +PolicyV1beta1() : policyv1beta1.PolicyV1beta1Interface +Rbac() : rbacv1.RbacV1Interface +RbacV1() : rbacv1.RbacV1Interface +RbacV1alpha1() : rbacv1alpha1.RbacV1alpha1Interface +RbacV1beta1() : rbacv1beta1.RbacV1beta1Interface +Scheduling() : schedulingv1alpha1.SchedulingV1alpha1Interface +SchedulingV1alpha1() : schedulingv1alpha1.SchedulingV1alpha1Interface +Settings() : settingsv1alpha1.SettingsV1alpha1Interface +SettingsV1alpha1() : settingsv1alpha1.SettingsV1alpha1Interface +Storage() : storagev1.StorageV1Interface +StorageV1() : storagev1.StorageV1Interface +StorageV1beta1() : storagev1beta1.StorageV1beta1Interface
Wherein the Core () and CoreV1 () acquired corev1.CoreV1Interface, for operation of the most basic kubernetes Resrouce.
type CoreV1Interface interface { RESTClient() rest.Interface ComponentStatusesGetter ConfigMapsGetter EndpointsGetter EventsGetter LimitRangesGetter NamespacesGetter NodesGetter PersistentVolumesGetter PersistentVolumeClaimsGetter PodsGetter PodTemplatesGetter ReplicationControllersGetter ResourceQuotasGetter SecretsGetter ServicesGetter ServiceAccountsGetter }
Pod example, to find all of the specified namespace:
pods, err := clientset.CoreV1().Pods("lijiaocn").List(v1.ListOptions{})
Creating RESTClient
client-go / rest achieved RESTClient, create RESTClient There are two methods.
The first way is directly through the config created in this way need to fill GroupVersion information in the config:
// create restClient from config
func CreateCoreRestClient(config *rest.Config) (*rest.RESTClient, error) { config.ContentConfig.GroupVersion = &core_v1.SchemeGroupVersion config.ContentConfig.NegotiatedSerializer = serializer.DirectCodecFactory{CodecFactory: scheme.Codecs} config.APIPath = "/api" restClient, err := rest.RESTClientFor(config) if err != nil { return nil, err } if restClient == nil { return nil, errors.New("restclient1 is nil") } return restClient, nil }
The second embodiment is obtained from Clientset, this method does not require manual fill GroupVersion, Clientset call interface corresponding to:
// get restClient from clientset
func GetCoreRestClient(config *rest.Config) (rest.Interface, error) { clientset, err := kubernetes.NewForConfig(config) if err != nil { return nil, err } if clientset == nil { return nil, errors.New("clientset is nil") } restClient := clientset.CoreV1().RESTClient() if restClient == nil { return nil, errors.New("restclient is nil") } return restClient, nil }
Use RESTClient
RESTClient are chained call, use the following, Do () method final call:
// /<namespace>/<resource>/<name>
// GET https://10.10.173.203/api/v1/namespaces/default/pods?limit=500
// GET https://10.10.173.203/api/v1/namespaces/kube-system/pods?limit=500 // GET https://10.10.173.203/api/v1/namespaces/kube-system/pods/kube-dns-5b54cf547c-jl4r9 result := restClient.Get(). Namespace("kube-system"). Resource("pods"). Name("kube-dns-5b54cf547c-jl4r9"). Do() bytes, err := result.Raw() if err != nil { fmt.Printf("%s: %s\n", err.Error(), bytes) } else { fmt.Printf("%s\n", bytes) }
client-go/tools
client-go provides a set of Tools , provides a configuration file to load, and other methods to achieve the local cache.
tools / clientcmd: load configuration
tools / clientcmd provides a number of aids, such as loading kubeconfig create client file generation is necessary Config:
home, err := os.UserHomeDir() if err != nil { glog.Fatal(err.Error()) } file, err := filepath.Abs(home + "/.kube/config") if err != nil { glog.Fatal(err.Error()) } config, err := clientcmd.BuildConfigFromFlags("", file) if err != nil { glog.Fatal(err.Error()) return } clientset, err := kubernetes.NewForConfig(config) if err != nil { glog.Fatal(err.Error()) return }
tools / cache: local cache
tools / cache provides local caching functions, in particular to provide the informer.
Creating listwatcher and handler informer need to provide are created or defined in the cache using the method cache:
labels := make(map[string]string) selector := fields.SelectorFromSet(labels) listwatch := cache.NewListWatchFromClient(restClient, "endpoints", "", selector)
handler definition:
handler := cache.ResourceEventHandlerFuncs{ AddFunc: func(obj interface{}) { fmt.Printf("Add endpoint:\n") if ep, ok := obj.(*core_v1.Endpoints); !ok { fmt.Printf("not endpoints\n") } else { printEndpoint(ep) } }, UpdateFunc: func(oldObj, newObj interface{}) { fmt.Printf("Update endpoint:\n") if epOld, ok := oldObj.(*core_v1.Endpoints); !ok { fmt.Printf("not endpoints\n") } else { printEndpoint(epOld) } if epNew, ok := newObj.(*core_v1.Endpoints); !ok { fmt.Printf("not endpoints\n") } else { printEndpoint(epNew) } }, DeleteFunc: func(obj interface{}) { fmt.Printf("Delete endpoint:\n") if ep, ok := obj.(*core_v1.Endpoints); !ok { fmt.Printf("not endpoint") }