中文 | English

Debug CrashLoopBackOff

在k8s环境中服务因为一些预期之外的事情会进入CrashLoopBackOff状态，在这种状态下，单纯通过describe和log无法判定服务出问题的原因。当服务进入CrashLoopBackOff状态时，需要有一种机制允许部署服务的pod进入running状态方便用户通过exec进入容器内进行debug。 doris-operator提供了debug的运行模式。下面描述了当服务进入CrashLoopBackOff时如何进入debug模式进行人工debug，以及解决后如何恢复到正常启动状态。

Debug模式启动

当服务一个pod进入CrashLoopBackOff或者正常运行过程中无法再正常启动时，通过一下步骤让服务进入debug模式，进行手动启动服务查找问题。

  1. 通过一下命令给运行有问题的pod进行添加annnotation
    kubectl annotate pod ${pod_name} -n ${namespace} selectdb.com.doris/runmode=debug

当服务进行下一次重启时候，服务会检测到标识debug模式启动的annotation就会进入debug模式启动。
2. 当服务进入debug模式，此时服务的pod显示为正常状态，用户可以通过如下命令进入pod内部。

    kubectl -n ${namespace} exec -ti ${pod_name} bash
  1. debug下手动启动服务，当用户进入pod内部，通过修改对应配置文件有关http的端口进行手动执行start_xx.sh脚本，脚本目录为/opt/apache-doris/xx/bin下。

退出Debug模式

当服务定位到问题后需要退出debug运行，此时只需要按照如下命令删除对应的pod，服务就会按照正常的模式启动。

    kubectl delete pod ${pod_name} -n ${namespace}