KubeSphere API

架构

KubeSphere API 服务器为 API 对象验证和配置数据。API 服务器为 REST 操作提供服务，并为集群的共享状态提供前端，其他所有组件通过它进行交互。

其中 /kapi 和/kapis 是 KubeSphere 拓展聚合的 API，/api和 /apis开头的都属于 Kubernetes 原生的 API，KubeSphere 把用户对原生 Kubernetes 资源的请求通过 API Server 转发到 Kubernetes API Server 对原生资源进行操作和管理。

ks-apiserver

使用 KubeSphere API

KubeSphere 3.0 将 ks-apigateway 和 ks-account 功能移动至 ks-apiserver 中，使架构更加紧凑和清晰。要使用 KubeSphere API，您需要将 ks-apiserver 暴露给您的客户端。

步骤 1：暴露 KubeSphere API 服务

如果您要在集群内部访问 KubeSphere，可以跳过以下内容，使用 KubeSphere API 服务器 Endpoint http://ks-apiserver.kubesphere-system.svc 即可。

如果从集群外部访问，您需要先将 KubeSphere API 服务器 Endpoint 暴露给集群外部。

暴露 Kubernetes 服务的方式有很多。本示例使用 NodePort 来演示。使用以下命令将 ks-apiserver 的服务类型变更为 NodePort。

  1. $ kubectl -n kubesphere-system patch service ks-apiserver -p '{"spec":{"type":"NodePort"}}'
  2. $ kubectl -n kubesphere-system get svc
  3. NAME            TYPE           CLUSTER-IP      EXTERNAL-IP      PORT(S)              AGE
  4. etcd            ClusterIP      10.233.34.220   <none>           2379/TCP             44d
  5. ks-apiserver    NodePort       10.233.15.31    <none>           80:31407/TCP         49d
  6. ks-console      NodePort       10.233.3.45     <none>           80:30880/TCP         49d

现在，您可以从集群外部通过 URL（例如 http://[node ip]:31407）访问 ks-apiserver，其中 [node ip] 是您集群中任意节点的 IP 地址。

步骤 2：生成令牌

您需要先验证身份，然后才能向 API 服务器发起调用。下面的示例使用的密码是 P#$$w0rd。用户需要发起请求来生成令牌，如下所示：

  1. curl -X POST -H 'Content-Type: application/x-www-form-urlencoded' \
  2.  'http://[node ip]:31407/oauth/token' \
  3.   --data-urlencode 'grant_type=password' \
  4.   --data-urlencode 'username=admin' \
  5.   --data-urlencode 'password=P#$$w0rd' \
  6.   --data-urlencode 'client_id=kubesphere' \
  7.   --data-urlencode 'client_secret=kubesphere'

备注

将 [node ip] 替换为您的实际 IP 地址。你可以在 ClusterConfiguration 中配置客户端凭证, 存在一个默认的客户端凭证 client_id 和 client_secret 的值为 kubesphere。

如果身份正确，服务器将输出响应，如下所示。access_token 是访问 KubeSphere API 服务器的令牌。

  1. {
  2.  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIiwidWlkIjoiYTlhNjJmOTEtYWQ2Yi00MjRlLWIxNWEtZTFkOTcyNmUzNDFhIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImV4cCI6MTYwMDg1MjM5OCwiaWF0IjoxNjAwODQ1MTk4LCJpc3MiOiJrdWJlc3BoZXJlIiwibmJmIjoxNjAwODQ1MTk4fQ.Hcyf-CPMeq8XyQQLz5PO-oE1Rp1QVkOeV_5J2oX1hvU",
  3.  "token_type": "Bearer",
  4.  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIiwidWlkIjoiYTlhNjJmOTEtYWQ2Yi00MjRlLWIxNWEtZTFkOTcyNmUzNDFhIiwidG9rZW5fdHlwZSI6InJlZnJlc2hfdG9rZW4iLCJleHAiOjE2MDA4NTk1OTgsImlhdCI6MTYwMDg0NTE5OCwiaXNzIjoia3ViZXNwaGVyZSIsIm5iZiI6MTYwMDg0NTE5OH0.PerssCLVXJD7BuCF3Ow8QUNYLQxjwqC8m9iOkRRD6Tc",
  5.  "expires_in": 7200
  6. }

步骤 3：发起调用

如果您访问 KubeSphere API 服务器的准备工作都已做完，请使用上一步中获取的访问令牌来发起调用，以获取节点列表，如下所示：

  1. $ curl -X GET -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIiwidWlkIjoiYTlhNjJmOTEtYWQ2Yi00MjRlLWIxNWEtZTFkOTcyNmUzNDFhIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImV4cCI6MTYwMDg1MjM5OCwiaWF0IjoxNjAwODQ1MTk4LCJpc3MiOiJrdWJlc3BoZXJlIiwibmJmIjoxNjAwODQ1MTk4fQ.Hcyf-CPMeq8XyQQLz5PO-oE1Rp1QVkOeV_5J2oX1hvU" \
  2.   -H 'Content-Type: application/json' \
  3.   'http://[node ip]:31407/kapis/resources.kubesphere.io/v1alpha3/nodes'
  5. {
  6.  "items": [
  7.   {
  8.    "metadata": {
  9.     "name": "node3",
  10.     "selfLink": "/api/v1/nodes/node3",
  11.     "uid": "dd8c01f3-76e8-4695-9e54-45be90d9ec53",
  12.     "resourceVersion": "84170589",
  13.     "creationTimestamp": "2020-06-18T07:36:41Z",
  14.     "labels": {
  15.      "a": "a",
  16.      "beta.kubernetes.io/arch": "amd64",
  17.      "beta.kubernetes.io/os": "linux",
  18.      "gitpod.io/theia.v0.4.0": "available",
  19.      "gitpod.io/ws-sync": "available",
  20.      "kubernetes.io/arch": "amd64",
  21.      "kubernetes.io/hostname": "node3",
  22.      "kubernetes.io/os": "linux",
  23.      "kubernetes.io/role": "new",
  24.      "node-role.kubernetes.io/worker": "",
  25.      "topology.disk.csi.qingcloud.com/instance-type": "Standard",
  26.      "topology.disk.csi.qingcloud.com/zone": "ap2a"
  27.     },
  28.     "annotations": {
  29.      "csi.volume.kubernetes.io/nodeid": "{\"disk.csi.qingcloud.com\":\"i-icjxhi1e\"}",
  30.      "kubeadm.alpha.kubernetes.io/cri-socket": "/var/run/dockershim.sock",
  31.      "node.alpha.kubernetes.io/ttl": "0",
  32.      ....

备注

将 [node ip] 替换为您的实际 IP 地址。

API 参考

KubeSphere API Swagger JSON 文件可以在 https://github.com/kubesphere/kubesphere/tree/release-3.4/api 仓库中找到。

您也可以点击这里查看 KubeSphere API 文档。