Create an example for L2 resources

[displague]

SUMMARY

Create an example in https://github.com/equinix-labs/ansible-collection-equinix/tree/main/examples, like the existing examples, that demonstrates how to connect the following resources:

• metal_interconnection
• metal_virtual_circuit (depends on #141)
• metal_vrf
• metal_gateway
• metal_vlan
• metal_device (with port configuration to connect to vlan and userdata that connects to vlan and assigns IPs from the VRF)

ISSUE TYPE

• Documentation Report

COMPONENT NAME

ANSIBLE VERSION

[t0mk]

Hi @displague, would you have a particular usecase of what to do? I checked guides in TF provider docs and there's nothing on this topic. Maybe some text guide from equnix labs site?

[displague]

@t0mk https://github.com/equinix-labs/terraform-equinix-metal-vrf/blob/main/main.tf would be a similar example. The purpose of this example would be to demonstrate how all of the resources come together to create a logical network that an OS has access to (VLAN + VRF derived IP address is configured in the OS). We don't have to get into what services are run in the OS for the purposes of this.

https://github.com/equinix-labs/terraform-equinix-metal-vrf/tree/main?tab=readme-ov-file#vrf-deployment-on-equinix-platform

[displague]

Metal-billed interconnection could be used in the example without redundant VCs and VLANs if that helps to simplify what we are demonstrating here. In that case, the VC resource would be generated and managed by the Interconnection service rather than Ansible. The Ansible example could then refer to the VC through an info module as a secondary step (Use X to create this architecture, use Y to access the Metal-billed interconnection immutable VC).

[displague]

Since Metal-Billed Interconnection deploys Virtual Circuits on its own, this example should be possible with the existing v0.4.0 capabilities.

Any VC improvements to the example could be created in a second example focused on dedicated interconnection.

[ctreatma]

As I understand it, we need to resolve #61 in order to put a device in L2 mode