docs(*): clarify that auth SSH key for clusters cannot have a password

Author: carmstrong

README.md

@@ -126,7 +126,7 @@ The parameters to `deis clusters:create` are:
 * cluster name (`dev`) - the name used by Deis to reference the cluster
 * cluster hostname (`local.deisapp.com`) - the hostname under which apps are created, like `balancing-giraffe.local.deisapp.com`
 * cluster members (`--hosts`) - a comma-separated list of cluster members -- not necessarily all members, but at least one (for cloud providers, this is a list of the IPs like `--hosts=10.21.12.1,10.21.12.2,10.21.12.3`)
-* auth SSH key (`--auth`) - the SSH private key used to provision servers (for cloud providers, this key is likely `~/.ssh/deis`)
+* auth SSH key (`--auth`) - the SSH private key used to provision servers -- cannot have a password (for cloud providers, this key is likely `~/.ssh/deis`)
 
 The `dev` cluster will be used as the default cluster for future `deis` commands.
 

client/deis.py

@@ -885,8 +885,8 @@ def clusters_create(self, args):
           --hosts=<hosts>
             a comma-separated list of the cluster members' private IP addresses.
           --auth=<auth>
-            a local file path to a SSH private key. This is the key used to provision and
-            connect to the cluster members.
+            a local file path to an SSH private key. This is the key used to provision and
+            connect to the cluster members. This key must not have a password.
 
             NOTE: for EC2 and Rackspace, this key is likely `~/.ssh/deis`.
 
@@ -1013,9 +1013,10 @@ def clusters_update(self, args):
             a domain under which app hostnames will live. See `deis help clusters:create`
             for more information.
           --hosts=<hosts>
-            a comma-separated list of cluster members.
+            a comma-separated list of the cluster members' private IP addresses.
           --auth=<auth>
-            a local file path to a SSH private key used to connect to cluster members.
+            a local file path to an SSH private key. This is the key used to provision and
+            connect to the cluster members. This key must not have a password.
           --type=<type>
             cluster type (default: coreos).
           --id=<id>

docs/installing_deis/create-cluster.rst

@@ -14,7 +14,7 @@ The parameters to `deis clusters:create` are:
 * cluster name - the name used by Deis to reference the cluster
 * cluster hostname - the hostname for the cluster -- applications are accessible under this domain
 * cluster members (`--hosts`) - a comma-separated list of IP addresses of cluster members -- not necessarily all members, but at least one
-* auth SSH key (`--auth`) - the SSH private key used to provision servers (for cloud providers, this key is likely `~/.ssh/deis`)
+* auth SSH key (`--auth`) - the SSH private key used to provision servers -- cannot have a password (for cloud providers, this key is likely `~/.ssh/deis`)
 
 For example, to create a cluster on a local Deis installation: