feat: Introduce public_ip module

[acelebanski]

Description

This PR introduces a public_ip module for more advanced creation of Public IP Addresses and Prefixes.
It modifies other modules to accept passing PIPs created that way.
It also adds the capability to use PIPs created with the module to the examples.

These modules are adapted to work with public_ip module:

• vmseries
• panorama
• loadbalancer
• appgw
• natgw
• virtual_network_gateway
• test_infrastructure

Additional enhancements introduced by this PR:

• Capability to source Public IP Addresses from a different RG within the virtual_network_gateway module
• Capability to create LB Frontends with Public IP Prefix within the loadbalancer module
• Capability to create Public IP Addresses within the vmss module with the same properties as offered by the public_ip module

Motivation and Context

All other modules that may require a Public IP Address resource support simple creation of it. This module allows more advanced
creation of Public IP Addresses and Prefixes, including:

• Sourcing Public IPs from different Resource Groups than the main resource
• Specifying Availability Zones for Public IPs separately from the main resource
• Specifying Domain Name Label and Idle Timeout for Public IPs
• Allocating Public IP Addresses from an existing Public IP Prefix (e.g. Custom non-Microsoft IP Prefix)

How Has This Been Tested?

In progress

Types of changes

• New feature (non-breaking change which adds functionality)

Checklist

• I have updated the documentation accordingly.
• I have read the CONTRIBUTING document.
• I have added tests to cover my changes if appropriate.
• All new and existing tests passed.

[acelebanski]

/idempotence paths="examples/common_vmseries examples/common_vmseries_and_autoscale examples/dedicated_vmseries examples/dedicated_vmseries_and_autoscale examples/gwlb_with_vmseries examples/standalone_panorama examples/standalone_vmseries"

Testing job ID: 10142143499
Job result: SUCCESS

[sebastianczech]

Great work 👍