Debugging FAQ

Under construction.

Tips that may help you debug why Kubernetes isn't working.

General

Check logs

TODO: log location by distribution: /var/log, /tmp, journalctl

TODO: turning on verbose logging: https://github.com/golang/glog

Check Docker state directly

sudo docker ps -a

By symptom

• Pod is in state Waiting forever
• kubecfg cannot reach apiserver
  • Ensure KUBERNETES_MASTER or KUBE_MASTER_IP is set, or use -h
  • Ensure apiserver is running
    • Check that the process is running on the master
    • Check its logs
• kubecfg hangs forever
  • Ensure all components running: apiserver, controller, scheduler, etcd, kubelets
  • Ensure all k8s components have --etcd_servers set correctly on the command line (if it isn't, you should see error messages in their logs)
    • If it's not set, your networking setup may be broken, since it is usually initialized from the IP address of kubernetes-master, in cluster/saltbase/salt/apiserver/default

Networking problems

TODO

Other provider-specific issues

TODO