Add Cloud Control API support

[meeuw]

SUMMARY

Add Cloud Control API support

ISSUE TYPE

• Feature Pull Request

COMPONENT NAME

Cloud Control API is an Uniform API to Access AWS & Third-Party Services.

This will give (what it seems) the same possibilities as CloudFormation to Ansible ❗

I'm actually pretty amazed how simple but powerful this module already is!

ADDITIONAL INFORMATION

This is still WIP, if you can please help me finish it by giving me some pointers. How can I run the test suite? I've tried running pytest in a Python 3.10 and 3.7 venv (various errors), tried running ansible-test (other errors).

https://github.com/ansible-collections/amazon.aws/blob/main/CONTRIBUTING.md isn't very helpful.

What documentation is required?

Does it make sense to add this module to this git repository? Please point me in the right direction if it isn't.

How do you think of the name of the module, would cloud_control (without _api) be better?

Please extend the below TODO list if I'm missing something.

TODO:

• Add tests
• Add documentation
• Agree about name of module
• Make waiter configurable
• Add module dependencies to project (jsonpatch)

EXAMPLE PLAYBOOK

- name: aws cloud control
  hosts: all
  tasks:
    - name: aws cloud control
      cloud_control_api:
        type_name: AWS::IAM::Role
        identifier: DmtestRole2
        properties:
          AssumeRolePolicyDocument:
            Statement:
            - Action: sts:AssumeRole
              Condition:
                Bool:
                  aws:MultiFactorAuthPresent: 'true'
              Effect: Allow
              Principal:
                AWS: arn:aws:iam::000000000000:root
            Version: '2012-10-17'
          ManagedPolicyArns:
          - arn:aws:iam::aws:policy/AdministratorAccess
          MaxSessionDuration: 3600
          Path: /
          RoleName: DmtestRole2
    - name: aws cloud control delete detach policies
      cloud_control_api:
        type_name: AWS::IAM::Role
        identifier: DmtestRole2
        state: absent
        properties:
          ManagedPolicyArns:
          - arn:aws:iam::aws:policy/AdministratorAccess
    - name: aws cloud control delete
      cloud_control_api:
        type_name: AWS::IAM::Role
        identifier: DmtestRole2
        state: absent

[ansibullbot]

cc @jillr @s-hertel @tremble
click here for bot help

[softwarefactory-project-zuul]

Build failed.

• ansible-galaxy-importer : FAILURE in 5m 14s
• build-ansible-collection : SUCCESS in 3m 21s
• ansible-test-sanity-aws-ansible-python38 : FAILURE in 10m 00s
• ansible-test-sanity-aws-ansible-2.9-python38 : FAILURE in 11m 19s
• ansible-test-sanity-aws-ansible-2.11-python38 : FAILURE in 10m 35s
• ansible-test-units-amazon-aws-python38 : SUCCESS in 8m 29s
• ansible-test-splitter : SUCCESS in 4m 12s
• integration-amazon.aws-1 : SKIPPED
• integration-amazon.aws-2 : SKIPPED
• integration-amazon.aws-3 : SKIPPED
• integration-amazon.aws-4 : SKIPPED
• integration-amazon.aws-5 : SKIPPED
• integration-amazon.aws-6 : SKIPPED
• integration-amazon.aws-7 : SKIPPED
• integration-amazon.aws-8 : SKIPPED
• integration-amazon.aws-9 : SKIPPED
• integration-amazon.aws-10 : SKIPPED
• integration-amazon.aws-11 : SKIPPED
• integration-amazon.aws-12 : SKIPPED
• integration-amazon.aws-13 : SKIPPED
• integration-community.aws-1 : SUCCESS in 31m 47s
• integration-community.aws-2 : SUCCESS in 47m 12s
• integration-community.aws-3 : SUCCESS in 35m 17s
• integration-community.aws-4 : SKIPPED
• integration-community.aws-5 : SKIPPED
• integration-community.aws-6 : SKIPPED
• integration-community.aws-7 : SKIPPED
• integration-community.aws-8 : SKIPPED
• integration-community.aws-9 : SKIPPED
• integration-community.aws-10 : SKIPPED
• integration-community.aws-11 : SKIPPED
• integration-community.aws-12 : SKIPPED
• integration-community.aws-13 : SKIPPED
• ansible-ee-tests-latest : FAILURE in 14m 12s (non-voting)
• ansible-ee-tests-stable-2.9 : FAILURE in 11m 39s
• ansible-ee-tests-stable-2.11 : FAILURE in 10m 45s
• ansible-ee-tests-stable-2.12 : FAILURE in 11m 18s (non-voting)

[jillr]

Hi @meeuw, thanks very much for your interest in extending the amazon.aws collection! This collection is maintained by the Red Hat Ansible team and contains modules that are officially supported by Red Hat. The Ansible community accepts PRs for new modules to the https://github.com/ansible-collections/community.aws collection. Could you please open a PR for this change in that repo?
https://docs.ansible.com/ansible/devel/community/contributing_maintained_collections.html

You can find more information about our development guidelines and how to get started with AWS modules, including information about module classes and module utilities used in both of these collections, in these links:
https://docs.ansible.com/ansible/devel/dev_guide/platforms/aws_guidelines.html
https://www.ansible.com/blog/getting-started-with-aws-ansible-module-development