feat(source-installation): recommend installation via Ansible over manual installation

[yukkysaito]

Description

I see many people on social media doing manual installations instead of automated environment setups using Ansible.

Manual installation is difficult and many people fail.
Therefore, I have changed to recommend automatic environment setup using Ansible.

Pre-review checklist for the PR author

The PR author must check the checkboxes below when creating the PR.

• I've confirmed the contribution guidelines.
• The PR follows the pull request guidelines.

In-review checklist for the PR reviewers

The Reviewers must check the checkboxes below before approval.

• The PR follows the pull request guidelines.

Post-review checklist for the PR author

The PR author must check the checkboxes below before merging.

• There are no open discussions or they are tracked via tickets.

After all checkboxes are checked, anyone who has write access can merge the PR.

[github-actions]

Documentation URL: https://autowarefoundation.github.io/autoware-documentation/pr-369/
Modified URLs:

• https://autowarefoundation.github.io/autoware-documentation/pr-369/installation/autoware/source-installation/

[kenji-miyake]

I think it's okay, but since the current recommendation of manual installation was strongly pushed by @xmfcx and @esteve, I cannot judge it. I'll leave it to them.

[mitsudome-r]

If not using ansible is causing installation issue, then I don't mind making them a default installation step.
However, I believe one of the issue with ansible was that it might corrupt the users environment if they already have NVIDIA related libraries. I made some suggestions to make it obvious that users with NVIDIA libraries installed should be careful using the ansible script.

[yukkysaito]

@xmfcx @esteve Any opinions would be appreciated. 🙏

[xmfcx]

I'd still prefer to keep manual installation steps under a separate heading instead of a Note section.

But I leave the decision to you @yukkysaito . But I am sure some people will complain that Ansible method has made unwanted changes on their system, time will tell.

I've made some rephrasing of some sentences along the way. After you review them, I think we can merge this.

[yukkysaito]

@xmfcx
Thank you for your advice. 👍

I'd still prefer to keep manual installation steps under a separate heading instead of a Note section.

Do you mean to create a manual installation page in troubleshooting or somewhere else?
If you give us more details, I may be able to do ti.

But I leave the decision to you @yukkysaito . But I am sure some people will complain that Ansible method has made unwanted changes on their system, time will tell.

In japan, many people say installing Autoware is too difficult. also, installing Autoware is called "Autoware challenge".
I am afraid that if this situation continues, the number of people who use Autoware will decrease.
Therefore, I wanted to recommend ansible to simplify the procedure.
However, you are right that it may cause more trouble by using ansible.
Regarding that, I would like to improve troubleshooting, etc. in the future.

I've made some rephrasing of some sentences along the way. After you review them, I think we can merge this.

Thank you very much. I committed the fix.

[esteve]

@kenji-miyake @xmfcx @yukkysaito Sorry, didn't see this before. I still prefer the manual installation and I think it's not good for users to have their environment changed via a script without their control (see for example installing rocker via sudo pip vs sudo apt-get).

However the work done in autowarefoundation/autoware#3222 should largely make some of the Ansible steps obsolete, since users will be able to install Autoware directly from Debian packages (see https://github.com/esteve/autoware_packages/tree/jammy-humble for an APT repository that users can already use to install Autoware).

In any case, as long as the manual instructions are kept and that the Ansible scripts do not modify a user's environment without their consent, I'm fine.