help text for juju import-ssh-key needs improving

[Nick Veitch]

e.g:

Usage: juju import-ssh-key [options] <lp|gh>:<user identity> ...

Summary:
Adds a public SSH key from a trusted identity source to a model.

Options:

-m, --model (= "")
  Model to operate in

Details:
Juju can add SSH keys to its cache from reliable public sources (currently Launchpad and GitHub), allowing those users SSH access to Juju machines. The user identity supplied is the username on the respective service given by 'lp:' or 'gh:'.
If the user has multiple keys on the service, all the keys will be added.
Once the keys are imported, they can be viewed with the `juju list-ssh-keys` command, where comments will indicate which ones were imported in this way.
An alternative to this command is the more manual `juju add-ssh-key`.

Examples:

Import all public keys associated with user account 'phamilton' on the GitHub service:

    juju import-ssh-key gh:phamilton

Multiple identities may be specified in a space delimited list:

    juju import-ssh-key rheinlein lp:iasmiov gh:hharrison

See also: add-ssh-key
          list-ssh-keys

[Cheryl Jennings (cherylj)]

PR: https://github.com/juju/juju/pull/4970

[Tim Penhey (thumper)]

I seriously think we should not allow a name without a prefix.

That way lies absolute crazy and security issues.

[Cheryl Jennings (cherylj)]

We can open a bug against the command to fix not requiring a prefix. In the meantime, should we update the doc to indicate that a prefix should always be used?

[Reed O'Brien (reedobrien)]

Output:

Usage: juju import-ssh-key [options] <lp|gh>:<user identity> ...

Summary:
Adds a public SSH key from a trusted identity source to a model.

Options:
-m, --model (= "")
    Model to operate in

Details:
Juju can add SSH keys to its cache from reliable public sources (currently
Launchpad and GitHub), allowing those users SSH access to Juju machines.
The user identity supplied is the username on the respective service given
by 'lp:' or 'gh:'.
If the user has multiple keys on the service, all the keys will be added.
Once the keys are imported, they can be viewed with the `juju list-ssh-
keys` command, where comments will indicate which ones were imported in
this way.
An alternative to this command is the more manual `juju add-ssh-key`.

Examples:
Import all public keys associated with user account 'phamilton' on the
GitHub service:

    juju import-ssh-key gh:phamilton

Multiple identities may be specified in a space delimited list:

    juju import-ssh-key rheinlein lp:iasmiov gh:hharrison

See also:
    add-ssh-key
    list-ssh-keys

Aliases: import-ssh-keys

[Reed O'Brien (reedobrien)]

Bug created for comment 2 and 3 https://bugs.launchpad.net/juju-core/+bug/1570977

[Horacio Durán (hduran-8)]

I proposed https://github.com/juju/juju/pull/6344