Azure container registry tags

[l3ender]

SUMMARY

This PR:

• updates container registry management dependency to the latest.
• adds support for working with container registry tags (importing or deleting).
• fixes an existing issue where idempotency is not handled correctly when deleting a container registry.

ISSUE TYPE

• New Module Pull Request

COMPONENT NAME

azure_rm_containerregistrytag
azure_rm_containerregistrytag_info

ADDITIONAL INFORMATION

Example usage:

- name: Import a tag to a different name
  azure_rm_containerregistrytag:
    registry: myRegistry
    repository_name: app1
    name: v1
    source_image:
      registry_uri: docker.io
      repository: library/hello-world
      name: latest

- name: Delete a tag
  azure_rm_containerregistrytag:
    registry: myRegistry
    repository_name: app1
    name: v1
    state: absent

The test suite can be run with the following playbook:

---
- name: "Playbook for testing."
  hosts: "localhost"
  connection: "local"
  gather_facts: false
  collections:
    - azure.azcollection

  tasks:
    - name: "Include tests"
      include_tasks: "tests/integration/targets/azure_rm_containerregistrytag/tasks/main.yml"

[l3ender]

@Fred-sun Please take a look. Thank you!

[Fred-sun]

@l3ender Please change the module name to azure_rm_containerregistrytag. Be consistent with other module development. Thank you very much!

ERROR: plugins/modules/azure_rm_containerregistry_tag.py:0:0: undocumented-parameter: Argument 'source_image' is listed in the argument_spec, but not documented in the module documentation
ERROR: plugins/modules/azure_rm_containerregistry_tag.py:0:0: undocumented-parameter: Argument 'username' found in source_image -> credentials is listed in the argument_spec, but not documented in the module documentation
ERROR: plugins/modules/azure_rm_containerregistry_tag_info.py:0:0: nonexistent-parameter-documented: Argument 'append_tags' is listed in DOCUMENTATION.options, but not accepted by the module argument_spec
ERROR: plugins/modules/azure_rm_containerregistry_tag_info.py:0:0: nonexistent-parameter-documented: Argument 'tags' is listed in DOCUMENTATION.options, but not accepted by the module argument_spec
ERROR: plugins/modules/azure_rm_containerregistry_tag_info.py:0:0: return-syntax-error: RETURN.repositories.contains.tags.suboptions: extra keys not allowed @ data['repositories']['contains']['tags']['suboptions']. Got {'name': {'description': ['Name of the tag.'], 'type': 'str', 'sample': 'my-tag'}, 'digest': {'description': ['Digest of the tag.'], 'type': 'str', 'sample': 'sha256:7bd8fcb425afc34a7865f85868126e9c4fef5b2d6291986524687d289ab3a64a'}, 'created_on': {'description': ['Datetime of when the tag was created.'], 'type': 'datetime', 'sample': datetime.datetime(2022, 2, 2, 18, 18, 57, 145778, tzinfo=datetime.timezone.utc)}, 'last_updated_on': {'description': ['Datetime of when the tag was last updated...
See documentation for help: https://docs.ansible.com/ansible-core/devel/dev_guide/testing/sanity/validate-modules.html

[l3ender]

@Fred-sun PR is updated with review suggestions and sanity fixes. Please take another look...thank you!

[Fred-sun]

tests/integration/targets/azure_rm_containerregistry_tag/tasks/main.yml ---> tests/integration/targets/azure_rm_containerregistrytag/tasks/main.yml

[Fred-sun]

@l3ender If you upgrade azure-mgmt-containerregistry, please change the relevant modules that depend on this module as track1 and Track2 are incompatible. The modules that synchronize changes are as follows:

azure_rm_containerregistrywebhook.py
azure_rm_containerregistrywebhook_info.py
azure_rm_containerregistryreplication.py
azure_rm_containerregistryreplication_info.py

[l3ender]

@Fred-sun I have updated the other modules you mentioned (any that use azure.mgmt.containerregistry). I am not sure how I missed it...thank you!

[Fred-sun]

@l3ender n addition, can you authorize me to make some changes to this PR? Since some of the changes are not easy to describe, I will move forward with this PR merger as soon as possible. Thank you very much!

[l3ender]

Thanks for the review, @Fred-sun! I apologize for missing the updates to use begin_xxx variants; I am working on multiple features in this repo and when I switched to this branch I neglected to install the correct dependencies...so I didn't see those methods!

You should have access to push changes to this PR/branch. Please let me know if you face any issue.

Thank you!

[l3ender]

Hello @Fred-sun, anything else I can provide for this PR? Thank you!

[xuzhang3]

LGTM