Rancher + K8S RestApi使用

Posted TiestoRay

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Rancher + K8S RestApi使用相关的知识,希望对你有一定的参考价值。

 

1前言

1.1使用的软件及版本

软件

版本号

Rancher

1.6stable

Kubernetes

1.8.3

Docker

1.12.6

 

 

 

 

 

 

1.2 RancherK8SRESTAPI差异

因为目前使用Rancher作为K8S的部署工具,Rancher封装了K8SREST API(仅仅是做了一层代理),且K8S apiserver是作为内部服务(没有开放对外端口),因此无法直接访问K8Sapi。不过可以通过Rancher开放的端口访问,其他内容还是没有变化的。

K8SREST API访问链接

https://k8s_apiserver_ip:6443/api/v1/namespaces/default/

Rancher提供的RESTAPI链接

http://rancher_server_ip:8080/r/projects/1a7/kubernetes:6443/v1/namespaces/default/

 

2 REST API授权

要访问K8SRESTAPI需要提供认证信息API Key

API Key使用Bearer认证,包含集群所有者的两部分内容:Access KeySecret Key。这两个信息都可以通过在RancherUI中获得。

具体获取方式如下:

①使用该集群所有者信息登录RancherUI,点击【API> 【密钥】

 

 

②点击【添加账号API Key

这里Api Key的名称和描述仅仅作为辅助作用,点创建会弹出真正需要记录的内容。

 

 

③点击【创建】

图片中的警告信息说明的已经很清晰了,不再解释。

 

 

④根据Access KeySecret Key计算认证信息。

先获取 <AccessKey>:<SecretKey> Base64编码,长度84,记做KeyCode84

再获取 Basic <KeyCode84> Base64编码,长度120,记做KeyCode120

 

⑤使用

发起REST API请求的时候,在请求头里加上以下认证信息即可:

Authorization:Bearer <KeyCode120>

例如:

Authorization:Bearer

QmFzaWMgTXpjNVFVSkRRalJCT1RRMFJUQTFPRVF5UlVZNldXbFJNbmM1UVcxUVIzaEZlbHBrTlc1NU56VnZRbmhCY1RreFIxRjBObU55ZVRsRVFuVnRhdz09

QmFzaWMgTUVNME0wWXpPVU0wTmtNek5USXhNRVV4TWpRNmVHMDFhRlY2WkRnelMxazBjM2xTT0ZKa2MyTnJTRFJUYm1seGFXTktOelI2Tm5ONmFYUkJXQT09

 

3 REST API使用

3.1 api功能分类

官方api的使用文档,https://kubernetes.io/docs/api-reference/v1.9

 

访问http://rancher_server_ip:8080/r/projects/1a7/kubernetes:6443可以获取到所有支持的接口:

{

    "paths": [

        "/api",

        "/api/v1", //蓝色部分是核心API Group

        "/apis",

        "/apis/",

        "/apis/apiextensions.k8s.io",

        "/apis/apiextensions.k8s.io/v1beta1",

        "/apis/apiregistration.k8s.io",

        "/apis/apiregistration.k8s.io/v1beta1",

        "/apis/apps",

        "/apis/apps/v1beta1",

        "/apis/apps/v1beta2",

        "/apis/authentication.k8s.io",

        "/apis/authentication.k8s.io/v1",

        "/apis/authentication.k8s.io/v1beta1",

        "/apis/authorization.k8s.io",

        "/apis/authorization.k8s.io/v1",

        "/apis/authorization.k8s.io/v1beta1",

        "/apis/autoscaling",

        "/apis/autoscaling/v1",

        "/apis/autoscaling/v2beta1",

        "/apis/batch",

        "/apis/batch/v1",

        "/apis/batch/v1beta1",

        "/apis/batch/v2alpha1",

        "/apis/certificates.k8s.io",

        "/apis/certificates.k8s.io/v1beta1",

        "/apis/extensions",

        "/apis/extensions/v1beta1", //扩展组

        "/apis/networking.k8s.io",

        "/apis/networking.k8s.io/v1",

        "/apis/policy",

        "/apis/policy/v1beta1",

        "/apis/rbac.authorization.k8s.io",

        "/apis/rbac.authorization.k8s.io/v1",

        "/apis/rbac.authorization.k8s.io/v1beta1",

        "/apis/storage.k8s.io",

        "/apis/storage.k8s.io/v1",

        "/apis/storage.k8s.io/v1beta1",//其他APIGroup

        "/healthz",

        "/healthz/autoregister-completion",

        "/healthz/etcd",

        "/healthz/ping",

        "/healthz/poststarthook/apiservice-openapi-controller",

        "/healthz/poststarthook/apiservice-registration-controller",

        "/healthz/poststarthook/apiservice-status-available-controller",

        "/healthz/poststarthook/bootstrap-controller",

        "/healthz/poststarthook/ca-registration",

        "/healthz/poststarthook/generic-apiserver-start-informers",

        "/healthz/poststarthook/kube-apiserver-autoregistration",

        "/healthz/poststarthook/start-apiextensions-controllers",

        "/healthz/poststarthook/start-apiextensions-informers",

        "/healthz/poststarthook/start-kube-aggregator-informers",

        "/healthz/poststarthook/start-kube-apiserver-informers",

        "/logs",

        "/metrics",

        "/swagger-2.0.0.json",

        "/swagger-2.0.0.pb-v1",

        "/swagger-2.0.0.pb-v1.gz",

        "/swagger.json",

        "/swaggerapi",

        "/ui",

        "/ui/",

        "/version"

    ]

}

 

Kubernetes主要管理三种资源:PodreplicationControllerservice

这里有一篇针对这三个资源的RESTAPI文档:

http://cdn.rawgit.com/GoogleCloudPlatform/kubernetes/31a0daae3627c91bc96e1f02a6344cd76e294791/api/kubernetes.html

 

至于其他API,暂未找到好的较好的,如果想获取某操作的API url,可以通过kubectl执行操作的时候添加-v=8来获得。例如删除pod

kubectl delete pods ubuntu1 -v=8

 

得到

 

 

 4. JavaClient 的使用

 

KubernetesAPIJavaClient

 

 

 

 

 

 

 

 

 

 

 

 

 

 

以上是关于Rancher + K8S RestApi使用的主要内容,如果未能解决你的问题,请参考以下文章

秒搭Kubernetes之使用Rancher

64 k8s + rancher + karmada容器化部署

rancher部署k8s遇到的问题总结

强力优化Rancher k8s中国区的使用体验

使用Rancher搭建K8S测试环境

K8s 通过 Rancher 管理 k8s 集群