ansible-collections / amazon.cloud

Ansible Collection for Amazon AWS' Cloud Control API
GNU General Public License v3.0
12 stars 12 forks source link

How to create the contents of the config directory (modules.yaml and api_specification) #123

Open jamesfreeman959 opened 2 months ago

jamesfreeman959 commented 2 months ago

Summary

I would like to understand how the contents of the config/ directory are created - I understand that they come via CloudFormations, but I was wondering whether they are automatically generated, or whether they are human generated and then ingested at build time? I've tried rebuilding the collection using Content Builder without the api_specification directory, and it only created a very limited number of modules. Can more details on how this directory is created/updated be included in the documentation please?

Issue Type

Documentation Report

Component Name

Content Builder configuraiton

Ansible Version

$ ansible --version

Collection Versions

$ ansible-galaxy collection list

Configuration

$ ansible-config dump --only-changed

OS / Environment

No response

Additional Information

No response

Code of Conduct

gravesm commented 2 months ago

The modules.yaml file is created by hand. The schema files in api_specification are automatically generated by the content builder when plugin:action is either generate_schema or generate_all.