API概述

官网文档：https://kubernetes.io/zh-cn/docs/reference/using-api/

REST API 是 Kubernetes 系统的重要部分，组件之间的所有操作和通信均由 API Server 处理的 REST AP I调用，大多数情况下， API
定义和实现都符合标准的 HTTP REST 格式，可以通过 kubectl 命令管理工具或其他命令行工具来执行。

类型

  1. Alpha
    • 包含 alpha 名称的版本（例如v1alpha1）。
    • 该软件可能包含错误。启用一个功能可能会导致 bug。默认情况下，功能可能会被禁用。
    • 随时可能会丢弃对该功能的支持，恕不另行通知。
    • API 可能在以后的软件版本中以不兼容的方式更改，恕不另行通知。
    • 该软件建议仅在短期测试集群中使用，因为错误的风险增加和缺乏长期支持。
  2. Beta
    • 包含 beta 名称的版本（例如 v2beta3）。
    • 该软件经过很好的测试。启用功能被认为是安全的。默认情况下功能是开启的。
    • 细节可能会改变，但功能在后续版本不会被删除
    • 对象的模式或语义在随后的 beta 版本或 Stable 版本中可能以不兼容的方式发生变化。如果这种情况发生时，官方会提供迁移操作指南。这可能需要删除、编辑和重新创建API对象。
    • 该版本在后续可能会更改一些不兼容地方，所以建议用于非关键业务，如果你有多个可以独立升级的集群，你也可以放宽此限制。
    • 大家使用过的 Beta 版本后，可以多给社区反馈，如果此版本在后续更新后将不会有太大变化。
  3. Stable
    • 该版本名称命名方式：vX 这里 X 是一个整数。
    • Stable 版本的功能特性，将出现在后续发布的软件版本中。

访问控制

  • 认证
  • 授权

废弃 api 说明

https://kubernetes.io/zh-cn/docs/reference/using-api/deprecation-guide/