作者:Stepan Stipl,DoiT International高级云架构师。客座文章最后在DoiT International博客上发表。

随着Kubernetes 1.16可用一段时间,并开始在许多托管Kubernetes平台上迟缓推出,你可能据说过API弃用(deprecation)。尽管解决起来相当简略,然而如果无人参加,这种更改可能会重大地中断你的服务。

API弃用是什么?

随着Kubernetes的个性集的倒退,API也必须倒退以反对这种变动。有一些规定旨在保障兼容性和稳定性。这种状况不会在每个版本中都产生,但最终,你将不得不应用新的API版本和格局,因为旧的API将不再受反对。

为什么这对于1.16版本如此重要?

在最近几个K8s版本中保留了一些弃用的API,最终在Kubernetes 1.16版本中被齐全删除。即以下API组和版本:

  • Deployment — extensions/v1beta1, apps/v1beta1 and apps/v1beta2
  • NetworkPolicy — extensions/v1beta1
  • PodSecurityPolicy — extensions/v1beta1
  • DaemonSet — extensions/v1beta1 and apps/v1beta2
  • StatefulSet — apps/v1beta1 and apps/v1beta2
  • ReplicaSet — extensions/v1beta1, apps/v1beta1 and apps/v1beta2

如果尝试在1.16中应用其中之一创立资源,操作将会失败。

如何查看我是否受到影响?

你能够手动遍历所有清单,但这可能相当耗时。如果有多个团队部署到集群中,或者在一个中央没有以后的所有清单,那么很容易失落一些清单,并且可能十分不理论。这就是kubent(Kube-No-Trouble)来帮忙的中央。

问题是什么?

用于创立给定资源的API版本的信息通常是不容易找到,因为资源总是在外部转换为首选存储版本并存储在首选存储版本中。然而。如果你应用kubectl或Helm来部署资源,原始清单也存储在集群中,咱们能够利用它。如果是kubectl,则模式为kubectl.kubernetes.io/last-applied-configuration正文;如果是Helm,则模式为ConfigMap或Secret。

如何解决弃用产生的问题

最简略的办法是装置:

sh -c "$(curl -sSL 'https://git.io/install-kubent')"

这将把kubent的最新版本装置到/usr/local/bin中。

(如果你和我一样,不置信他人在博客文章中公布的随机脚本,请下载针对你的平台的最新版本,而后解压缩到你喜爱的任何中央。)

配置kubectl的以后上下文,以指向你想要检查和运行kubent工具的集群:

图1:kubent运行的示例输入

Kubent将连贯到你的集群,检索所有可能受到影响的资源,扫描并打印那些受到影响的资源的摘要。

你还能够应用-f json标记来取得JSON格局的输入,这更适宜让你将其集成到你的CI/CD流水线中或进一步处理结果。对于可用配置选项的更多细节在doitintl/kube-no-trouble仓库的README文件中形容。

我应该如何解决检测到的资源?

在某些状况下,这就像扭转manifest中的apiVersion一样简略,但在其余状况下,构造可能曾经扭转,须要调整。另外,要留神,版本之间有很多默认值会发生变化(对于这方面的好文章是David Schweikert的Kubernetes 1.16 API deprecations and changed defaults),因而,仅更改apiVersion并利用雷同的清单,就会失去不同的后果。例如,StatefulSet的updateStrategy.type从OnDelete更改为RollingUpdate,导致了十分不同的行为。

以前应用的kubectl convert命令现已弃用,可能不能依据后面提到的默认值正确地转换资源。

最好的办法可能是简略地利用资源(如果你应用kubent检测到它们,那么你曾经有了这些资源)并从API检索新版本。这将确保资源被正确地转换为新版本。你可能曾经留神到,kubectl在某种程度上不确定地返回的版本。要申请一个特定的API版本,应用残缺的模式:

kubectl get ingress.v1beta1.extensions -o yaml

欢送反馈!

心愿这将帮忙你检测和解决Kubernetes集群中弃用的API,免得这些API给你带来任何麻烦。

当初kubent工具还为时过早,如果你感觉它有用,我很乐意听到任何评论和倡议。平安的航行!⛵⛵⛵

额定参考:

  • Kube-No-Trouble - kubent GitHub仓库 - https://github.com/doitintl/k...
  • 1.16中删除了弃用API:Vallery Lancey博客文章通知你须要晓得的 - https://kubernetes.io/blog/2019/07/18/api-deprecations-in-1-16/

在DoiT International与Stepan工作!在咱们的职业网站上申请工程职位。

点击浏览网站原文。


CNCF (Cloud Native Computing Foundation)成立于2015年12月,隶属于Linux  Foundation,是非营利性组织。
CNCF(云原生计算基金会)致力于培养和保护一个厂商中立的开源生态系统,来推广云原生技术。咱们通过将最前沿的模式民主化,让这些翻新为公众所用。扫描二维码关注CNCF微信公众号。