调试StatefulSet

此任务展示如何调试StatefulSet。

准备开始

  • 你需要有一个Kubernetes集群,通过必要的配置使kubectl命令行工具与您的集群进行通信。
  • 你应该有一个运行中的StatefulSet,以便用于调试。

调试StatefulSet

由于StatefulSet在创建时设置了app=myapp标签,列出仅属于该StatefulSet的所有pod时,可以使用以下命令:

  1. kubectl get pods -l app=myapp

如果您发现列出的任何Pods长时间处于UnknownTerminating状态,关于如何处理它们的说明任务,请参阅删除 StatefulSet Pods。您可以参考调试 Pods指南来调试StatefulSet中的各个Pod。

StatefulSets提供调试机制,可以使用注解来暂停所有控制器在Pod上的操作。在任何StatefulSet Pod上设置pod.alpha.kubernetes.io/initialized注解为"false"暂停 StatefulSet的所有操作。暂停时,StatefulSet将不执行任何伸缩操作。一旦调试钩子设置完成后,就可以在StatefulSet pod的容器内执行命令,而不会造成伸缩操作的干扰。您可以通过执行以下命令将注解设置为"false"

  1. kubectl annotate pods <pod-name> pod.alpha.kubernetes.io/initialized="false" --overwrite

当注解设置为"false"时,StatefulSet在其Pods变得不健康或不可用时将不会响应。StatefulSet不会创建副本Pod直到每个Pod上删除注解或将注解设置为"true"

逐步初始化

创建StatefulSet之前,您可以通过使用和上文相同的注解,即将yaml文件中.spec.template.metadata.annotations里的pod.alpha.kubernetes.io/initialized字段设置为"false",对竞态条件的StatefulSet进行调试。

  1. apiVersion: apps/v1beta1
  2. kind: StatefulSet
  3. metadata:
  4. name: my-app
  5. spec:
  6. serviceName: "my-app"
  7. replicas: 3
  8. template:
  9. metadata:
  10. labels:
  11. app: my-app
  12. annotations:
  13. pod.alpha.kubernetes.io/initialized: "false"
  14. ...
  15. ...
  16. ...

设置注解后,如果创建了StatefulSet,您可以等待每个Pod来验证它是否正确初始化。StatefulSet将不会创建任何后续的Pods,直到在已经创建的每个Pod上将调试注解设置为"true" (或删除)。 您可以通过执行以下命令将注解设置为"true"

  1. kubectl annotate pods <pod-name> pod.alpha.kubernetes.io/initialized="true" --overwrite

接下来

点击链接调试init-container,了解更多信息。