ec2.py migration documentation

[danielmotaleite]

Summary

When trying to migrate from the old ec2.py to dynamic inventory aws_ec2, i of course found many different facts and groups. Migrating everything is a huge task in big projects, but the documentation do not help in any way.

Later on irc i was pointed to the page https://docs.ansible.com/automation-controller/latest/html/userguide/inventory_plugins_templates.html where we can find a example for most ec2.py compatibility (and easy to expand to other missing cases)

So aws_ec2 should give either a pointer to that page, or simply clone that info to their own documentation as a example for ec2.py migration helper, creating compatibility resources. This will help a LOT everyone migrating from ec2.py to aws_ec2

while there is a use_contrib_script_compatible_ec2_tag_keys config key, it do NOT work in ansible 2.9 nor have any help of info associated that could reach the above url compatibility page

Issue Type

Documentation Report

Component Name

aws_ec2

Ansible Version

ansible 2.9.6
  config file = /home/dleite/git/TechOps/provisioners/ansible/ansible.cfg
  configured module search path = ['/home/dleite/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python3/dist-packages/ansible
  executable location = /usr/bin/ansible
  python version = 3.8.10 (default, Nov 26 2021, 20:14:08) [GCC 9.3.0]

Collection Versions

$ ansible-galaxy collection list
usage: ansible-galaxy collection [-h] COLLECTION_ACTION ...
ansible-galaxy collection: error: argument COLLECTION_ACTION: invalid choice: 'list' (choose from 'init', 'build', 'publish', 'install')

this version do not support this command

Configuration

No response

OS / Environment

ubuntu 20.04

Additional Information

No response

Code of Conduct

• [X] I agree to follow the Ansible Code of Conduct

[ansibullbot]

Files identified in the description:

• [plugins/inventory/aws_ec2.py](https://github.com/['ansible-collections/amazon.aws', 'ansible-collections/community.aws', 'ansible-collections/community.vmware']/blob/main/plugins/inventory/aws_ec2.py)

If these files are inaccurate, please update the component name section of the description or use the !component bot command.

click here for bot help

[alinabuzachis]

@danielmotaleite thank you for raising this. We are going to work on this and update the documentation soon.

[alinabuzachis]

@danielmotaleite We have updated the aws_ec2 inventory plugin documentation. Please feel free to open a new issue if something is still unclear.