Documentation needs instructions for adding a host using an SSH key

[mrog]

ISSUE TYPE

• Documentation Report

COMPONENT NAME

Adding a host

CLOUDSTACK VERSION

4.16
4.17

CONFIGURATION

N/A

OS / ENVIRONMENT

N/A

SUMMARY

A feature was added in version 4.16 that allows the use of an SSH key instead of a password when adding a host. See #5684. (Note that the SSH key path in the pull request description isn't quite correct.)

The instructions for adding a host don't explain how to use an SSH key.
https://docs.cloudstack.apache.org/en/latest/adminguide/hosts.html

STEPS TO REPRODUCE

N/A

EXPECTED RESULTS

Here's a summary of the process that should be explained in the instructions.

- Copy the system key from /var/cloudstack/management/.ssh/id_rsa.pub on the management server, and add it to the /root/.ssh/authorized_keys file on the host.  (You may use ssh-copy-id for this step, if desired.)
- If you're creating a new zone, you must fill in the password field when providing information about the host.  Enter any string in the password field.  It doesn't have to be a real password.
- If you're adding a new host to an existing zone, choose the "System SSH Key" option.

ACTUAL RESULTS

[boring-cyborg]

Thanks for opening your first issue here! Be sure to follow the issue template!

[mrog]

This is related to #6499.

[yadvr]

cc @weizhouapache was this added?

[weizhouapache]

cc @weizhouapache was this added?

@rohityadavcloud cloudstack doc is not updated.

I see @harikrishna-patnala has self-assigned this.
@harikrishna-patnala if you have any question, please let me know.

[harikrishna-patnala]

@weizhouapache "Add host" form is facilated to provide either using password or ssh keys but not the "Add Zone" Wizard.

@utchoang has already created PR for this #6525. I'll update the document accordingly.

[yadvr]

Fixed in apache/cloudstack-documentation#280