diff options
| author | k8s-merge-robot <k8s.production.user@gmail.com> | 2016-03-05 23:06:29 -0800 |
|---|---|---|
| committer | k8s-merge-robot <k8s.production.user@gmail.com> | 2016-03-05 23:06:29 -0800 |
| commit | d687119c6a514ca30b903fbbb76d4781764634fb (patch) | |
| tree | 8a776b30a936c9dec05b7c7f7163b63a27c341ad | |
| parent | 8a122bd8cef246a3f5173e7b2d4a2b9da6e0b774 (diff) | |
| parent | e31ecd66fef340c7a00d0b0f2e1663fa52e18de7 (diff) | |
Merge pull request #22476 from ixdy/cluster-logs
Auto commit by PR queue bot
| -rw-r--r-- | e2e-tests.md | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/e2e-tests.md b/e2e-tests.md index 1978af18..d88be47c 100644 --- a/e2e-tests.md +++ b/e2e-tests.md @@ -148,6 +148,26 @@ As mentioned earlier there are a host of other options that are available, but t - `rm -rf /var/run/kubernetes`, clear kube generated credentials, sometimes stale permissions can cause problems. - `sudo iptables -F`, clear ip tables rules left by the kube-proxy. +### Debugging clusters + +If a cluster fails to initialize, or you'd like to better understand cluster +state to debug a failed e2e test, you can use the `cluster/log-dump.sh` script +to gather logs. + +This script requires that the cluster provider supports ssh. Assuming it does, +running + +``` +cluster/log-dump.sh <directory> +```` + +will ssh to the master and all nodes +and download a variety of useful logs to the provided directory (which should +already exist). + +The Google-run Jenkins builds automatically collected these logs for every +build, saving them in the `artifacts` directory uploaded to GCS. + ### Local clusters It can be much faster to iterate on a local cluster instead of a cloud-based one. To start a local cluster, you can run: |