diff options
| author | Jeff Grafton <jgrafton@google.com> | 2016-03-03 15:21:14 -0800 |
|---|---|---|
| committer | Jeff Grafton <jgrafton@google.com> | 2016-03-03 15:28:33 -0800 |
| commit | e31ecd66fef340c7a00d0b0f2e1663fa52e18de7 (patch) | |
| tree | 010c267f0975bf6cd9a12736eca4d334b7424768 /e2e-tests.md | |
| parent | 1e01f1dfda7aa95f61d5e00ba2f23009ddb07ef1 (diff) | |
Remove log collection code in cluster/gce/util.sh.
Also update some docs to mention cluster/log-dump.sh.
Diffstat (limited to 'e2e-tests.md')
| -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: |