From 1c3e499e79dcc2ca6c665dc2bc19a9d1bb17abff Mon Sep 17 00:00:00 2001
From: Eric Tune <etune@google.com>
Date: Wed, 30 Mar 2016 09:41:26 -0700
Subject: [PATCH] Update images.md

---
 docs/user-guide/images.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/user-guide/images.md b/docs/user-guide/images.md
index 49f80a6500..26d65a7ab1 100644
--- a/docs/user-guide/images.md
+++ b/docs/user-guide/images.md
@@ -81,6 +81,21 @@ The kubelet will fetch and periodically refresh ECR credentials.  It needs the f
 - `ecr:ListImages`
 - `ecr:BatchGetImage`
 
+Requirements:
+
+- You must be using kubelet version `v1.2.0` or newer.  (e.g. run `/usr/bin/kubelet --version=true`).
+- Your nodes must be in the same region as the registry you are using
+- ECR must be offered in your region
+
+Troubleshooting:
+
+- Verify all requirements above.
+- Get $REGION (e.g. `us-west-2`) credentials on your workstation. SSH into the host and run Docker manually with those creds. Does it work?
+- Verify kubelet is running with `--cloud-provider=aws`.
+- Check kubelet logs (e.g. `journalctl -t kubelet`) for log lines like:
+  - `plugins.go:56] Registering credential provider: aws-ecr-key`
+  - `provider.go:91] Refreshing cache for provider: *aws_credentials.ecrProvider`
+
 ### Configuring Nodes to Authenticate to a Private Repository
 
 **Note:** if you are running on Google Container Engine (GKE), there will already be a `.dockercfg` on each node