专栏首页我的小碗汤curl 命令操作 Kubernetes API

curl 命令操作 Kubernetes API

作者:潘猛_9f76 原文:https://www.jianshu.com/p/0a5976ce1ce4

导读

Kubernetes API是集群系统中的重要组成部分,Kubernetes中各种资源(对象)的数据通过该API接口被提交到后端的持久化存储(etcd)中,Kubernetes集群中的各部件之间通过该API接口实现解耦合,同时Kubernetes集群中一个重要且便捷的管理工具kubectl也是通过访问该API接口实现其强大的管理功能的。

本文将使用Linux curl命令演示操作Kubernetes API,让你有个初步的认识。

Kubernetes API 官方使用文档:

https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.15/

1、使用kubectl proxy访问
1.1.本地监听

启动kubectl proxy,不带任何参数只在本地监听,使用的是http协议,无需提供任何凭证就可以访问:

kubectl proxy
Starting to serve on 127.0.0.1:8001

验证api访问:

curl http://127.0.0.1:8001/api/
{
  "kind": "APIVersions",
  "versions": [
    "v1"
  ],
  "serverAddressByClientCIDRs": [
    {
      "clientCIDR": "0.0.0.0/0",
      "serverAddress": "192.168.3.101:6443"
    }
  ]
}
1.2.网络监听

启动kubectl proxy,使用网卡IP,从其他机器访问, --accept-hosts='^*$' 表示接受所有源IP,否则会显示不被授权:

kubectl proxy --address='192.168.3.101'  --accept-hosts='^*$' --port=8001
Starting to serve on 192.168.3.101:8001
curl  http://192.168.3.101:8001/api/
{
  "kind": "APIVersions",
  "versions": [
    "v1"
  ],
  "serverAddressByClientCIDRs": [
    {
      "clientCIDR": "0.0.0.0/0",
      "serverAddress": "192.168.3.101:6443"
    }
  ]
}
2、直接访问API
2.1.获取集群名称和api地址
kubectl config view -o jsonpath='{"Cluster name\tServer\n"}{range .clusters[*]}{.name}{"\t"}{.cluster.server}{"\n"}{end}'
export CLUSTER_NAME="kubernetes"
APISERVER=$(kubectl config view -o jsonpath="{.clusters[?(@.name==\"$CLUSTER_NAME\")].cluster.server}")
2.2.使用serviceaccount来访问

创建serviceaccount并绑定集群角色cluster-admin:

kubectl create seviceaccount  sa-panmeng
kubectl create clusterrolebinding   sa-panmeng-cluster-admin --clusterrole='cluster-admin' --serviceaccount=default:sa-panmeng

获取seviceaccount sa-panmeng 的secret token:

TOKEN=$(kubectl get secrets -o jsonpath="{.items[?(@.metadata.annotations['kubernetes\.io/service-account\.name']=='sa-panmeng')].data.token}"|base64 -d)

使用token访问api:

curl --header "Authorization: Bearer $TOKEN" --insecure  -X GET $APISERVER/api/v1/namespaces/test/pods?limit=1
curl --header "Authorization: Bearer $TOKEN" --insecure  -X GET $APISERVER/api/v1/namespaces/default/pods?limit=1
curl --header "Authorization: Bearer $TOKEN" --insecure  -X GET $APISERVER/api/v1/namespaces/kube-system/pods?limit=1

serviceaccount虽然是区分namespace的,但是不影响使用这个token访问所有namespace的资源。

2.3.使用useraccount来访问

创建user panmeng的证书:

openssl genrsa -out panmeng.key 2048
openssl req -new -key panmeng.key -out panmeng.csr -subj "/CN=panmeng"
openssl x509 -req -in panmeng.csr -out panmeng.crt -sha1 -CA ca.crt -CAkey ca.key  -CAcreateserial -days 3650

创建角色getpods,创建角色绑定user panmeng和role getpods:

kubectl create role getpods --verb=get --verb=list --resource=pods
kubectl create rolebinding panmeng-getpods --role=getpods --user=panmeng --namespace=default

验证访问是否正常:

curl --cert /etc/kubernetes/pki/panmeng.crt   -X GET $APISERVER/api/v1/namespaces/default/pods?limit=1 --key /etc/kubernetes/pki/panmeng.key  --insecure

验证用户panmeng不具备访问namespace kube-system的权限:

curl --cert /etc/kubernetes/pki/panmeng.crt   -X GET $APISERVER/api/v1/namespaces/kube-system/pods?limit=1 --key /etc/kubernetes/pki/panmeng.key  --insecure
{
  "kind": "Status",
  "apiVersion": "v1",
  "metadata": {
    
  },
  "status": "Failure",
  "message": "pods is forbidden: User \"panmeng\" cannot list resource \"pods\" in API group \"\" in the namespace \"kube-system\"",
  "reason": "Forbidden",
  "details": {
    "kind": "pods"
  },
  "code": 403
}
3、常用API资源

以下为常用资源的URL路径,将/apis/GROUP/VERSION/替换为/api/v1/,则表示基础API组:

/apis/GROUP/VERSION/RESOURCETYPE
/apis/GROUP/VERSION/RESOURCETYPE/NAME
/apis/GROUP/VERSION/namespaces/NAMESPACE/RESOURCETYPE
/apis/GROUP/VERSION/namespaces/NAMESPACE/RESOURCETYPE/NAME
/apis/GROUP/VERSION/RESOURCETYPE/NAME/SUBRESOURCE
/apis/GROUP/VERSION/namespaces/NAMESPACE/RESOURCETYPE/NAME/SUBRESOURCE

查看扩展api里的资源deployments::

curl  http://127.0.0.1:8001/apis/extensions/v1beta1/namespaces/kube-system/deployments

查看基础api里的资源pods:

curl  http://127.0.0.1:8001/api/v1/namespaces/kube-system/pods/
3.1.使用watch持续监控资源的变化
curl  http://127.0.0.1:8001/api/v1/namespaces/test/pods
"resourceVersion": "2563046"
curl  http://127.0.0.1:8001/api/v1/namespaces/test/pods?watch=1&resourceVersion=2563046
3.2.查看前n个资源
curl  http://127.0.0.1:8001/api/v1/namespaces/kube-system/pods?limit=1
"continue": "eyJ2IjoibWV0YS5rOHMuaW8vdjEiLCJydiI6MjU2NDk2Mywic3RhcnQiOiJjYWxpY28tbm9kZS1jejZrOVx1MDAwMCJ9"

使用continue token查看下n个资源:

curl  'http://127.0.0.1:8001/api/v1/namespaces/kube-system/pods?limit=1&continue=eyJ2IjoibWV0YS5rOHMuaW8vdjEiLCJydiI6MjU3MTYxMSwic3RhcnQiOiJjYWxpY28ta3ViZS1jb250cm9sbGVycy01Y2JjY2NjODg1LWt2bGRyXHUwMDAwIn0'
4、资源的类型

资源分类:Workloads,Discovery & LB ,Config & Storage,Cluster,Metadata 资源对象:Resource ObjectMeta,ResourceSpec,ResourceStatus 资源操作:create,update(replace&patch),read(get&list&watch),delete,rollback,read/write scale,read/write status

5、Workloads的操作

以pod为例,介绍workloads apis,以下为pod的yaml文件:

apiVersion: v1
kind: Pod
metadata:
  name: pod-example
spec:
  containers:
  - name: ubuntu
    image: ubuntu:trusty
    command: ["echo"]
    args: ["Hello World"]
5.1. 创建pod

POST /api/v1/namespaces/{namespace}/pods 查看当前pods:

# kubectl -n test get pods
NAME       READY   STATUS             RESTARTS   AGE

使用api创建pod:

curl --request POST http://127.0.0.1:8001/api/v1/namespaces/test/pods -s -w "状态码是:%{http_code}\n" -o /dev/null -H 'Content-Type: application/yaml' --data 'apiVersion: v1
kind: Pod
metadata:
  name: pod-example
spec:
  containers:
  - name: ubuntu
    image: ubuntu:trusty
    command: ["echo"]
    args: ["Hello World"]'
状态码是:201

查看当前pods:

#kubectl -n test get pods
NAME          READY   STATUS              RESTARTS   AGE
pod-example   0/1     ContainerCreating   0          4s

状态码: 200 Ok 201 Created 202 Accepted

5.2.删除pod

DELETE /api/v1/namespaces/{namespace}/pods/{name} 查看当前pods:

kubectl get pods -n test --show-labels
NAME          READY   STATUS             RESTARTS   AGE     LABELS
pod-example   0/1     CrashLoopBackOff   1          15s     <none>

删除pod pod-example:

curl --request DELETE http://127.0.0.1:8001/api/v1/namespaces/test/pods/pod-example -o /dev/null  -s -w "状态码是:%{http_code}\n"
状态码是:200

查看当前pods:

kubectl get pods -n test --show-labels
NAME          READY   STATUS             RESTARTS   AGE     LABELS
pod-example   0/1     Terminating        2          28s     <none>

状态码: 200 Ok 202 Accepted

本文分享自微信公众号 - 我的小碗汤(mysmallsoup),作者:DevOps技术栈

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2019-10-14

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 19 个很有用的 ElasticSearch 查询语句 篇一

    为了演示不同类型的 ElasticSearch 的查询,我们将使用书文档信息的集合(有以下字段:title(标题), authors(作者), summary(...

    我的小碗汤
  • Go语言可能会遇到的坑

    最近在用go开发项目的过程中突然发现一个坑,尤其是对于其它传统语言转来的人来说一不注意就掉坑里了,话不多说,咱看代码:

    我的小碗汤
  • ElasticSearch学习笔记之原理介绍

    ElasticSearch是一个基于Lucene的搜索服务器。它提供了一个分布式多用户能力的全文搜索引擎,基于RESTful web接口。Elasticsear...

    我的小碗汤
  • 直播系统开发中服务端处理工作以及交互系统分析

    一个完整直播系统开发应该包含以下环节:推流端(采集、前处理、编码、推流)、服务端处理(转码、录制、截图、鉴黄)、播放器(拉流、解码、渲染)、交互系统(聊天室、礼...

    布谷安妮
  • 12-11【kibana 7.5 中的地图更好用】

    Kibana Maps 已经在6.7版本中引入。从6.7版本开始,之后的每个版本都对之前的一些问题进行了修复,同时也新增了许多新功能和对现有功能的一些改进。

    有暗香盈袖
  • C#用GDI画任意形状的form

    Point[] points = list.ToArray();//将点集合赋给点数组

    Dabelv
  • 诺亦腾CTO戴若犁:VR会长期存在于B端商用,Noitom当前致力于将To B做精

    VRPinea
  • [踩坑记]jquery点击事件多次执行解决方法

    上一篇文章介绍中使用a的弹窗方式测试孔href属性,但是最近在一个项目中发现click事件执行后会多次触发.应该是点击事件进行叠加了,jquery的unbind...

    十月梦想
  • Java 注解 学习笔记

    我们平常写Java代码,对其中的注解并不是很陌生,比如说写继承关系的时候经常用到@Override来修饰方法。但是@Override是用来做什么的,为什么写继承...

    yuxiaofei93
  • 从零开始开发和搭建直播平台-教程汇总篇

    之前也分享过不少零散的技术文章,包括音视频、图像处理和流媒体服务相关的技术都略有涉猎。但是,都写得比较偏具体功能的实现,不够系统。因此也让很多读者产生迷惑和不解...

    eguid

扫码关注云+社区

领取腾讯云代金券