安装go client调用Kubernetes API

虽然Kubernetes是用go语言编写的,但是安装go client比安装python client复杂很多。python只需要在PyCharm中安装一个kubernetes包即可,而go则需要很复杂的一系列步骤。

主要按照https://github.com/kubernetes/client-go/blob/master/INSTALL.md的操作进行。默认已经正确安装了go并且正确配置了GOPATH。

最好保证电脑能顺畅地连接外网,否则有些包下载会特别慢。

一、下载go-client包

$ go get -u -v k8s.io/client-go/...

因为不能科学上网,这一步我足足等待了一个小时。为了确认下载的确在进行,加上了-u和-v,可以看见具体下载的过程。

下载完成后,对照官方GitHub中go-client和执行下面的操作:

$ cd $GOPATH/src/k8s.io/client-go
$ git checkout v9.0.0 #这里要根据版本对照表,找出和自己的Kubernetes集群对应的版本

注意:我测试时使用v7.0.0以下的版本时出现了依赖包不匹配的问题,导致编译错误。换成v8.0.0就正常了。所以:

尽量使用v8.0.0以上的版本!尽量使用v8.0.0以上的版本!尽量使用v8.0.0以上的版本!

二、安装godep

$ go get github.com/tools/godep

三、使用godep下载依赖包

godep是golang中管理依赖包的工具。在GOPATH/src/k8s.io/client-go目录下执行下面的命令后,godep会从Godeps/Godeps.json文件中下载依赖包并安装:

$ godep restore ./...

这一步同样等待了很长很长时间,耐心很重要。。。。。。

四、手动下载报错的包

执行godep restore时,会出现诸如:godep: error downloading dep (cloud.google.com/go/internal): unrecognized import path "cloud.google.com/go/internal"之类的错误,这是由于下载包的url路径与import的路径不一致,导致下载失败。这时只能手动下载报错的包。

网上搜索报错的包的url位置,用git clone命令下载。

cloud.google.com/go的位置在https://github.com/GoogleCloudPlatform/google-cloud-go。在$GOPATH/src下创建cloud.google.com目录后,在新目录下执行:

$ git clone https://github.com/GoogleCloudPlatform/google-cloud-go

之后,把google-cloud-go文件夹重命名为go。

golang.org/x/下的包都位于 https://github.com/golang/下。在$GOPATH/src下创建golang.org/x/目录后,针对所有golang.org/x/下报错的包,在新目录下依次执行:

$ git clone https://github.com/golang/xxx.git xxx   #xxx为报错的包

下载完所有的包后,可以用Goland尝试import一下报错的目录,看看是否能够正常导入。

五、运行测试代码

创建一个工程,编写main.go如下:

package main

import (
        "flag"
        "fmt"
        "os"
        "path/filepath"
        "time"

        "k8s.io/apimachinery/pkg/api/errors"
        metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
        "k8s.io/client-go/kubernetes"
        "k8s.io/client-go/tools/clientcmd"
)

func main() {
        var kubeconfig *string
        if home := homeDir(); home != "" {
                kubeconfig = flag.String("kubeconfig", filepath.Join(home, "src", "go-kubernetes", "config"), "(optional) absolute path to the kubeconfig file")
        } else {
                kubeconfig = flag.String("kubeconfig", "", "absolute path to the kubeconfig file")
        }
        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())
        }
        for {
                pods, err := clientset.CoreV1().Pods("default").List(metav1.ListOptions{})
                if err != nil {
                        panic(err.Error())
                }
                fmt.Printf("There are %d pods in the cluster\n", len(pods.Items))

                // Examples for error handling:
                // - Use helper functions like e.g. errors.IsNotFound()
                // - And/or cast to StatusError and use its properties like e.g. ErrStatus.Message
                namespace := ""
                pod := "example-xxxxx"
                _, err = clientset.CoreV1().Pods(namespace).Get(pod, metav1.GetOptions{})
                if errors.IsNotFound(err) {
                        fmt.Printf("Pod %s in namespace %s not found\n", pod, namespace)
                } else if statusError, isStatus := err.(*errors.StatusError); isStatus {
                        fmt.Printf("Error getting pod %s in namespace %s: %v\n",
                                pod, namespace, statusError.ErrStatus.Message)
                } else if err != nil {
                        panic(err.Error())
                } else {
                        fmt.Printf("Found pod %s in namespace %s\n", pod, namespace)
                }

                time.Sleep(10 * time.Second)
        }
}

func homeDir() string {
        if h := os.Getenv("GOPATH"); h != "" {
                return h
        }
        return os.Getenv("USERPROFILE")
}

首先在集群中任意节点的~/.kube目录下找到config文件,将config文件拷贝到go运行的机器上,具体目录可以通过自定义的homeDir函数和flag.String指定,我这里设置在工程的根目录下。

运行程序,如果能正确显示出pod的数量,说明配置成功!  

最后,个人感觉go的client真心不如python的client好用。且不说安装的复杂程度,client-go是没有官方文档的,对新手极不友好,而python client的文档非常详细,简单易用。

此外,python的yaml包支持用load方法将写好的yaml文件直接读入并解析,而go的yaml包则相对复杂,这导致在golang中通过yaml文件操作Kubernetes资源远比python中麻烦。一种可行的操作是将yaml文件的各个字段直接编码到代码中,通过dynamic、unstructure等包进行解析,比直接修改yaml文件更加灵活。