From 9fdf100ed64730c421acd86ad25e5030b8e6425a Mon Sep 17 00:00:00 2001 From: Allen Robel Date: Fri, 12 Jul 2024 07:00:33 -1000 Subject: [PATCH] Fix markdown levels Most of the README.md files in the roles directory contained skips from level 1 (#) to level 3 (###). Fixed these. --- roles/ndfc_device_config_get/README.md | 8 +- roles/ndfc_device_deleted/README.md | 8 +- roles/ndfc_device_deleted_all/README.md | 8 +- .../README.md | 8 +- .../README.md | 8 +- roles/ndfc_device_info_get/README.md | 256 +++++++++--------- .../README.md | 8 +- .../README.md | 8 +- .../README.md | 8 +- roles/ndfc_device_list_get/README.md | 12 +- roles/ndfc_device_list_merged/README.md | 10 +- roles/ndfc_device_merged/README.md | 10 +- roles/ndfc_device_merged_all/README.md | 10 +- roles/ndfc_device_model_number_get/README.md | 8 +- roles/ndfc_device_names_get/README.md | 8 +- roles/ndfc_device_serial_number_get/README.md | 8 +- roles/ndfc_fabric_config_get/README.md | 8 +- roles/ndfc_network_config_get/README.md | 8 +- roles/ndfc_network_deleted/README.md | 12 +- roles/ndfc_network_deleted_all/README.md | 10 +- roles/ndfc_network_info_get/README.md | 12 +- roles/ndfc_network_replaced/README.md | 8 +- roles/ndfc_network_replaced_all/README.md | 8 +- .../ndfc_policy_vrf_rt_import_evpn/README.md | 8 +- .../README.md | 8 +- roles/ndfc_rest_config_deploy/README.md | 8 +- roles/ndfc_rest_config_deploy_all/README.md | 8 +- .../README.md | 8 +- .../ndfc_rest_device_list_by_fabric/README.md | 8 +- roles/ndfc_rest_device_rediscover/README.md | 12 +- roles/ndfc_rest_device_set_role/README.md | 10 +- .../README.md | 8 +- .../README.md | 6 +- .../README.md | 8 +- roles/ndfc_rest_fabric_asn_get/README.md | 10 +- .../README.md | 8 +- .../README.md | 8 +- .../README.md | 8 +- .../README.md | 8 +- roles/ndfc_rest_fabric_create_msd/README.md | 8 +- roles/ndfc_rest_fabric_delete/README.md | 8 +- roles/ndfc_rest_fabric_info_get/README.md | 10 +- .../ndfc_rest_fabric_msd_child_add/README.md | 8 +- .../README.md | 8 +- .../ndfc_rest_interface_no_shutdown/README.md | 10 +- roles/ndfc_rest_interface_shutdown/README.md | 10 +- roles/ndfc_rest_service_node_add/README.md | 10 +- roles/ndfc_rest_vpc_create/README.md | 8 +- roles/ndfc_rest_vpc_delete/README.md | 8 +- roles/ndfc_rest_vrf_list_by_fabric/README.md | 8 +- roles/ndfc_service_node_config_get/README.md | 8 +- roles/ndfc_service_node_deleted/README.md | 8 +- roles/ndfc_service_node_merged/README.md | 8 +- .../README.md | 8 +- .../README.md | 8 +- roles/ndfc_vpc_config_get/README.md | 8 +- roles/ndfc_vpc_interface_merged_all/README.md | 8 +- roles/ndfc_vrf_all/README.md | 14 +- roles/ndfc_vrf_config_get/README.md | 13 +- roles/ndfc_vrf_query/README.md | 10 +- roles/ndfc_vrf_replaced/README.md | 10 +- 61 files changed, 397 insertions(+), 388 deletions(-) diff --git a/roles/ndfc_device_config_get/README.md b/roles/ndfc_device_config_get/README.md index a1bc7d6..99166f5 100644 --- a/roles/ndfc_device_config_get/README.md +++ b/roles/ndfc_device_config_get/README.md @@ -2,7 +2,7 @@ Retrieve local configuration for ``device_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -17,7 +17,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -34,12 +34,12 @@ See the following for details: var: device_config ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_deleted/README.md b/roles/ndfc_device_deleted/README.md index b74c3cd..91cf462 100644 --- a/roles/ndfc_device_deleted/README.md +++ b/roles/ndfc_device_deleted/README.md @@ -2,7 +2,7 @@ Delete device ``device_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -17,7 +17,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -29,12 +29,12 @@ See the following for details: device_name: spine_1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_deleted_all/README.md b/roles/ndfc_device_deleted_all/README.md index b10bf7c..52dc9e3 100644 --- a/roles/ndfc_device_deleted_all/README.md +++ b/roles/ndfc_device_deleted_all/README.md @@ -2,7 +2,7 @@ Delete all devices from fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -17,7 +17,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -29,12 +29,12 @@ See the following for details: fabric_name: f1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_generated_configs_all_get/README.md b/roles/ndfc_device_generated_configs_all_get/README.md index 9936413..bad5c9e 100644 --- a/roles/ndfc_device_generated_configs_all_get/README.md +++ b/roles/ndfc_device_generated_configs_all_get/README.md @@ -2,7 +2,7 @@ Query populated generated_config from all devices in fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -18,7 +18,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -30,12 +30,12 @@ See the following for details: fabric_name: f1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_generated_configs_get/README.md b/roles/ndfc_device_generated_configs_get/README.md index 370d10f..6379ecf 100644 --- a/roles/ndfc_device_generated_configs_get/README.md +++ b/roles/ndfc_device_generated_configs_get/README.md @@ -4,7 +4,7 @@ Retrieve populated generated configs from ``device_name`` in fabric ``fabric_nam Store in variable ``device_generated_configs`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -20,7 +20,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -37,12 +37,12 @@ See the following for details: when: "device_generated_configs != ''" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_info_get/README.md b/roles/ndfc_device_info_get/README.md index 18ffe64..30c2e38 100644 --- a/roles/ndfc_device_info_get/README.md +++ b/roles/ndfc_device_info_get/README.md @@ -4,7 +4,7 @@ Query device ``device_name`` on the NDFC controller A ``device_info`` dictionary is returned, as described below. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -19,7 +19,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml # Query NX-OS switch associated with fabric_name + device_name @@ -45,140 +45,142 @@ See the following for details: msg: "switchDbId: {{ device_info.switchDbID }}" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) -### Example returned object device_info (as of NDFC version 12.0.1) +## Example returned object device_info + +As of NDFC version 12.0.1 ```json -{ - "device_info": { - "activeSupSlot": 0, - "availPorts": 0, - "colDBId": 0, - "connUnitStatus": 0, - "consistencyState": true, - "contact": "", - "cpuUsage": 25, - "deviceType": "Switch_Fabric", - "displayHdrs": [ - "Name", - "IP Address", - "Fabric", - "WWN", - "FC Ports", - "Vendor", - "Model", - "Release", - "UpTime" - ], - "displayValues": [ - "cvd_leaf_2311", - "172.XX.XX.XX", - "fabric_2", - "FDOXXXXXXXX", - "54", - "Cisco", - "N9K-C93180YC-EX", - "10.2(3)", - "18 days, 23:02:23" - ], - "domain": null, - "domainID": 0, - "elementType": null, - "fabricId": 3, - "fabricName": "fabric_2", - "fabricTechnology": "VXLANFabric", - "fcoeEnabled": false, - "fex": false, - "fexMap": {}, - "fid": 3, - "health": -1, - "hostName": "cvd_leaf_2311", - "index": 3, - "interfaces": null, - "ipAddress": "172.XX.XX.XX", - "ipDomain": "", - "isEchSupport": false, - "isLan": false, - "isNonNexus": false, - "isPmCollect": false, - "isTrapDelayed": false, - "isVpcConfigured": true, - "is_smlic_enabled": false, - "keepAliveState": "Peer is not alive", - "lastScanTime": 1649700732019, - "licenseDetail": null, - "licenseViolation": false, - "linkName": null, - "location": "", - "logicalName": "cvd_leaf_2311", - "managable": true, - "mds": false, - "membership": null, - "memoryUsage": 35, - "mgmtAddress": null, - "mode": "Normal", - "model": "N9K-C93180YC-EX", - "modelType": 0, - "moduleIndexOffset": 9999, - "modules": null, - "name": null, - "network": "LAN", - "nonMdsModel": "N9K-C93180YC-EX", - "npvEnabled": false, - "numberOfPorts": 54, - "peer": "cvd_leaf_2312", - "peerSerialNumber": "FDOXXXXXXXX", - "peerSwitchDbId": 576650, - "peerlinkState": "Peer link is down", - "ports": 0, - "present": true, - "primaryIP": null, - "primarySwitchDbID": 0, - "principal": null, - "recvIntf": "mgmt0", - "release": "10.2(3)", - "role": "None established", - "sanAnalyticsCapable": false, - "scope": null, - "secondaryIP": "", - "secondarySwitchDbID": 0, - "sendIntf": "mgmt0", - "serialNumber": "FDOXXXXXXXX", - "standbySupState": 0, - "status": "ok", - "swWwn": null, - "swWwnName": "FDOXXXXXXXX", - "switchDbID": 575610, - "switchRole": "leaf", - "switchRoleEnum": "Leaf", - "sysDescr": "", - "systemMode": null, - "uid": 0, - "unmanagableCause": "", - "upTime": 163814317, - "upTimeNumber": 0, - "upTimeStr": "18 days, 23:02:23", - "usedPorts": 0, - "username": null, - "vdcId": -1, - "vdcMac": null, - "vdcName": "", - "vendor": "Cisco", - "version": null, - "vpcDomain": 1, - "vrf": "management", - "vsanWwn": null, - "vsanWwnName": null, - "wwn": null + { + "device_info": { + "activeSupSlot": 0, + "availPorts": 0, + "colDBId": 0, + "connUnitStatus": 0, + "consistencyState": true, + "contact": "", + "cpuUsage": 25, + "deviceType": "Switch_Fabric", + "displayHdrs": [ + "Name", + "IP Address", + "Fabric", + "WWN", + "FC Ports", + "Vendor", + "Model", + "Release", + "UpTime" + ], + "displayValues": [ + "cvd_leaf_2311", + "172.XX.XX.XX", + "fabric_2", + "FDOXXXXXXXX", + "54", + "Cisco", + "N9K-C93180YC-EX", + "10.2(3)", + "18 days, 23:02:23" + ], + "domain": null, + "domainID": 0, + "elementType": null, + "fabricId": 3, + "fabricName": "fabric_2", + "fabricTechnology": "VXLANFabric", + "fcoeEnabled": false, + "fex": false, + "fexMap": {}, + "fid": 3, + "health": -1, + "hostName": "cvd_leaf_2311", + "index": 3, + "interfaces": null, + "ipAddress": "172.XX.XX.XX", + "ipDomain": "", + "isEchSupport": false, + "isLan": false, + "isNonNexus": false, + "isPmCollect": false, + "isTrapDelayed": false, + "isVpcConfigured": true, + "is_smlic_enabled": false, + "keepAliveState": "Peer is not alive", + "lastScanTime": 1649700732019, + "licenseDetail": null, + "licenseViolation": false, + "linkName": null, + "location": "", + "logicalName": "cvd_leaf_2311", + "managable": true, + "mds": false, + "membership": null, + "memoryUsage": 35, + "mgmtAddress": null, + "mode": "Normal", + "model": "N9K-C93180YC-EX", + "modelType": 0, + "moduleIndexOffset": 9999, + "modules": null, + "name": null, + "network": "LAN", + "nonMdsModel": "N9K-C93180YC-EX", + "npvEnabled": false, + "numberOfPorts": 54, + "peer": "cvd_leaf_2312", + "peerSerialNumber": "FDOXXXXXXXX", + "peerSwitchDbId": 576650, + "peerlinkState": "Peer link is down", + "ports": 0, + "present": true, + "primaryIP": null, + "primarySwitchDbID": 0, + "principal": null, + "recvIntf": "mgmt0", + "release": "10.2(3)", + "role": "None established", + "sanAnalyticsCapable": false, + "scope": null, + "secondaryIP": "", + "secondarySwitchDbID": 0, + "sendIntf": "mgmt0", + "serialNumber": "FDOXXXXXXXX", + "standbySupState": 0, + "status": "ok", + "swWwn": null, + "swWwnName": "FDOXXXXXXXX", + "switchDbID": 575610, + "switchRole": "leaf", + "switchRoleEnum": "Leaf", + "sysDescr": "", + "systemMode": null, + "uid": 0, + "unmanagableCause": "", + "upTime": 163814317, + "upTimeNumber": 0, + "upTimeStr": "18 days, 23:02:23", + "usedPorts": 0, + "username": null, + "vdcId": -1, + "vdcMac": null, + "vdcName": "", + "vendor": "Cisco", + "version": null, + "vpcDomain": 1, + "vrf": "management", + "vsanWwn": null, + "vsanWwnName": null, + "wwn": null + } } -} ``` \ No newline at end of file diff --git a/roles/ndfc_device_interface_config_all_get/README.md b/roles/ndfc_device_interface_config_all_get/README.md index 8fa0db6..403091a 100644 --- a/roles/ndfc_device_interface_config_all_get/README.md +++ b/roles/ndfc_device_interface_config_all_get/README.md @@ -2,7 +2,7 @@ Query the config for a specific interface across all devices in fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -19,7 +19,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -32,12 +32,12 @@ See the following for details: interface_name: Ethernet1/11 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_ipv4_address_local_get/README.md b/roles/ndfc_device_ipv4_address_local_get/README.md index de547d2..e1775f0 100644 --- a/roles/ndfc_device_ipv4_address_local_get/README.md +++ b/roles/ndfc_device_ipv4_address_local_get/README.md @@ -10,7 +10,7 @@ Since this operation is local, the result is returned faster than ``ndfc_device_ SEE ALSO: ``ndfc_device_ipv4_address_remote_get`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -25,7 +25,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml # Query ./inventory/group_vars/ndfc/02_devices.yml for fabric_name + device_name @@ -44,12 +44,12 @@ See the following for details: when: "device_ipv4_address != ''" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) \ No newline at end of file diff --git a/roles/ndfc_device_ipv4_address_remote_get/README.md b/roles/ndfc_device_ipv4_address_remote_get/README.md index 066ea37..631fc26 100644 --- a/roles/ndfc_device_ipv4_address_remote_get/README.md +++ b/roles/ndfc_device_ipv4_address_remote_get/README.md @@ -10,7 +10,7 @@ Since this operation involves a query of the NDFC controller, the result is retu SEE ALSO: ``ndfc_device_ipv4_address_local_get`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -25,7 +25,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml # Query NX-OS switch associated with fabric_name + device_name @@ -44,12 +44,12 @@ See the following for details: when: "device_ipv4_address != ''" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) \ No newline at end of file diff --git a/roles/ndfc_device_list_get/README.md b/roles/ndfc_device_list_get/README.md index f856ca3..ce27ca6 100644 --- a/roles/ndfc_device_list_get/README.md +++ b/roles/ndfc_device_list_get/README.md @@ -2,11 +2,11 @@ Retrieve device configuration from the local inventory for all devices in fabric ``fabric_name`` -### Returns +## Returns A JSON list of objects containing device configurations, including seed_ip, role, password, username. -#### Example structure of returned information: +### Example structure of returned information: ```json [ @@ -25,7 +25,7 @@ A JSON list of objects containing device configurations, including seed_ip, role ] ``` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -39,7 +39,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -56,12 +56,12 @@ See the following for details: when: "device_list != ''" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_list_merged/README.md b/roles/ndfc_device_list_merged/README.md index 67b366c..99fcef6 100644 --- a/roles/ndfc_device_list_merged/README.md +++ b/roles/ndfc_device_list_merged/README.md @@ -2,7 +2,7 @@ Merge a list of devices into a fabric. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -36,9 +36,9 @@ Variable | Type | Description device_password | string | The password used to login to the device device_username | string | The username used to login to the device -### Dependencies +## Dependencies -### Example Playbooks +## Example Playbooks Merge all devices in the local inventory for ``fabric_name`` f1 into the topology. @@ -59,12 +59,12 @@ Merge all devices in the local inventory for ``fabric_name`` f1 into the topolog devices: "{{ device_list }}" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_merged/README.md b/roles/ndfc_device_merged/README.md index 3ef43c8..7f003d3 100644 --- a/roles/ndfc_device_merged/README.md +++ b/roles/ndfc_device_merged/README.md @@ -2,7 +2,7 @@ Merge device ``device_name`` into the topology. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -36,9 +36,9 @@ Variable | Type | Description device_password | string | The password used to login to the device device_username | string | The username used to login to the device -### Dependencies +## Dependencies -### Example Playbooks +## Example Playbooks ```yaml --- @@ -50,12 +50,12 @@ device_username | string | The username used to login to the device device_name: spine_1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_merged_all/README.md b/roles/ndfc_device_merged_all/README.md index 1f16529..59fc7ff 100644 --- a/roles/ndfc_device_merged_all/README.md +++ b/roles/ndfc_device_merged_all/README.md @@ -2,7 +2,7 @@ Merge all leaf, spine, border_gateway devices into fabric ``fabric_name``. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -34,9 +34,9 @@ Variable | Type | Description device_password | string | The password used to login to the device device_username | string | The username used to login to the device -### Dependencies +## Dependencies -### Example Playbook +## Example Playbook ```yaml --- @@ -48,12 +48,12 @@ device_username | string | The username used to login to the device fabric_name: f1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_model_number_get/README.md b/roles/ndfc_device_model_number_get/README.md index a400af1..a2cbc2d 100644 --- a/roles/ndfc_device_model_number_get/README.md +++ b/roles/ndfc_device_model_number_get/README.md @@ -4,7 +4,7 @@ Retrieve ``device_model_number`` from NDFC controller, given ``device_name``. The device's model number is returned in variable ``device_model_number``. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -19,7 +19,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml # Query NX-OS switch associated with fabric_name + device_name @@ -38,12 +38,12 @@ See the following for details: when: "device_model_number != ''" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_names_get/README.md b/roles/ndfc_device_names_get/README.md index ccf00c4..4fe9869 100644 --- a/roles/ndfc_device_names_get/README.md +++ b/roles/ndfc_device_names_get/README.md @@ -2,7 +2,7 @@ Use ``set_fact`` to set a list (``device_names``) of device names matching devices in fabric ``fabric_name`` with role ``role``. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -19,7 +19,7 @@ See the following for details: [./inventory/group_vars/README.md](https://github.com/allenrobel/ndfc-roles/tree/master/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -37,12 +37,12 @@ See the following for details: when: "device_names != ''" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_device_serial_number_get/README.md b/roles/ndfc_device_serial_number_get/README.md index 9fe2c9f..c9b15e5 100644 --- a/roles/ndfc_device_serial_number_get/README.md +++ b/roles/ndfc_device_serial_number_get/README.md @@ -4,7 +4,7 @@ Return ``device_serial_number`` given ``device_name``. The device's serial number is returned in variable ``device_serial_number``. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -18,7 +18,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml # Query NX-OS switch associated with fabric_name + device_name @@ -37,12 +37,12 @@ See the following for details: when: "device_serial_number != ''" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_fabric_config_get/README.md b/roles/ndfc_fabric_config_get/README.md index 99ed7b2..0a00e56 100644 --- a/roles/ndfc_fabric_config_get/README.md +++ b/roles/ndfc_fabric_config_get/README.md @@ -7,7 +7,7 @@ Retrieve config for ``fabric_name`` from the following sections of ``./inventory - switch_fabrics - external_fabrics -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -21,7 +21,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -33,12 +33,12 @@ See the following for details: fabric_name: f1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_network_config_get/README.md b/roles/ndfc_network_config_get/README.md index 9d9a9ee..db63c97 100644 --- a/roles/ndfc_network_config_get/README.md +++ b/roles/ndfc_network_config_get/README.md @@ -2,7 +2,7 @@ Retrieve local configuration for ``network_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -33,12 +33,12 @@ See the following for details: var: network_config ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_network_deleted/README.md b/roles/ndfc_network_deleted/README.md index c4ea8e9..b71828c 100644 --- a/roles/ndfc_network_deleted/README.md +++ b/roles/ndfc_network_deleted/README.md @@ -2,7 +2,7 @@ Delete network ``network_name`` where ``network_name`` matches the ``name`` key in the local ``networks`` dictionary in [./inventory/group_vars/ndfc/03_networks.yml](/inventory/group_vars/ndfc/03_networks.yml) -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,9 +16,9 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbooks +## Example Playbooks -# Delete network_name f1_n1111 +### Delete network_name f1_n1111 ```yaml --- @@ -30,7 +30,7 @@ See the following for details: network_name: f1_n1111 ``` -# Delete network_name msd_n1111, which resides in fabric MSD (an msd fabric) +### Delete network_name msd_n1111, which resides in fabric MSD (an msd fabric) This will delete network_name msd_n1111 from all child fabrics of fabric MSD. @@ -44,10 +44,10 @@ This will delete network_name msd_n1111 from all child fabrics of fabric MSD. network_name: msd_n1111 ``` -### License +## License BSD -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_network_deleted_all/README.md b/roles/ndfc_network_deleted_all/README.md index 48ab995..86d2ec6 100644 --- a/roles/ndfc_network_deleted_all/README.md +++ b/roles/ndfc_network_deleted_all/README.md @@ -4,7 +4,7 @@ Delete all networks in fabric ``fabric_name`` NOTE: If the networks were created in an MSD fabric, Ansible will throw an InvalidFabric error if you set ``fabric_name`` to that of a child/switch fabric. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -18,9 +18,9 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbooks +## Example Playbooks -# Delete all networks in external fabric_name f1 +### Delete all networks in external fabric_name f1 ```yaml --- @@ -32,12 +32,12 @@ See the following for details: fabric_name: MSD ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_network_info_get/README.md b/roles/ndfc_network_info_get/README.md index 4d71f2e..cf1f18a 100644 --- a/roles/ndfc_network_info_get/README.md +++ b/roles/ndfc_network_info_get/README.md @@ -2,7 +2,7 @@ Query the NDFC controller and retrieve ``network_info`` dictionary given ``network_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -24,7 +24,7 @@ Variable | Type | Description ----------------|------|---------------------------------------- network_info | dict | information pertaining to network ``network_name`` -### Example Playbooks +## Example Playbooks Retrieve ``network_info`` dictionary for ``network_name`` msd_n1111 @@ -42,10 +42,12 @@ Retrieve ``network_info`` dictionary for ``network_name`` msd_n1111 msg: "network_info: {{ network_info | default('unable to find network. Check network_name.', true) }}" ``` -### License +## Licensing -BSD +GNU General Public License v3.0 or later. -### Author Information +See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. + +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_network_replaced/README.md b/roles/ndfc_network_replaced/README.md index 03b1ad4..335eea5 100644 --- a/roles/ndfc_network_replaced/README.md +++ b/roles/ndfc_network_replaced/README.md @@ -2,7 +2,7 @@ Replace network ``network_name`` with its current local definition in [./inventory/group_vars/ndfc/03_networks.yml](/inventory/group_vars/ndfc/03_networks.yml) -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -17,7 +17,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -29,12 +29,12 @@ See the following for details: network_name: f1_n1111 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_network_replaced_all/README.md b/roles/ndfc_network_replaced_all/README.md index 0947a6d..29ea994 100644 --- a/roles/ndfc_network_replaced_all/README.md +++ b/roles/ndfc_network_replaced_all/README.md @@ -2,7 +2,7 @@ Replace all networks in fabric ``fabric_name`` with their current definitions in Replace all networks in fabric ``fabric_name`` with their current definitions in ``./roles/ndfc_common/vars/main.yml`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -17,7 +17,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -29,12 +29,12 @@ See the following for details: fabric_name: MSD ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_policy_vrf_rt_import_evpn/README.md b/roles/ndfc_policy_vrf_rt_import_evpn/README.md index 951d0fb..3bbf36f 100644 --- a/roles/ndfc_policy_vrf_rt_import_evpn/README.md +++ b/roles/ndfc_policy_vrf_rt_import_evpn/README.md @@ -6,7 +6,7 @@ NOTE: This role isn't needed when route-target imports are added to a VRF's conf - [./inventory/group_vars/README.md](/inventory/group_vars/README.md) - [./inventory/group_vars/ndfc/04_vrfs.yml](/inventory/group_vars/ndfc/04_vrfs.yml) -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -26,7 +26,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml # Import vrf v2's route-targets into vrf v1 on device leaf_2 in fabric f1, using Ansible state 'merged' @@ -43,12 +43,12 @@ See the following for details: state: merged ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_policy_vrf_rt_import_evpn_loop/README.md b/roles/ndfc_policy_vrf_rt_import_evpn_loop/README.md index 650519c..232ac52 100644 --- a/roles/ndfc_policy_vrf_rt_import_evpn_loop/README.md +++ b/roles/ndfc_policy_vrf_rt_import_evpn_loop/README.md @@ -8,7 +8,7 @@ NOTE 2: This role isn't needed when route-target imports are added to a VRF's co - [./inventory/group_vars/README.md](/inventory/group_vars/README.md) - [./inventory/group_vars/ndfc/04_vrfs.yml](/inventory/group_vars/ndfc/04_vrfs.yml) -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -28,7 +28,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook The example below performs a bi-directional import of route-targets between vrfs v1 and v2 on four leaf devices in fabric f1. @@ -85,12 +85,12 @@ The example below performs a bi-directional import of route-targets between vrfs fabric_name: f1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_config_deploy/README.md b/roles/ndfc_rest_config_deploy/README.md index 8a0acef..0ab1396 100644 --- a/roles/ndfc_rest_config_deploy/README.md +++ b/roles/ndfc_rest_config_deploy/README.md @@ -2,7 +2,7 @@ Issue NDFC POST REST API calls to invoke config-save on ``fabric_name`` and config-deploy on fabric ``fabric_name`` device ``device_name``. -### Role Variables +## Role Variables Variable | Type | Description -------------------|---------|------------ @@ -15,7 +15,7 @@ Variable | Type | Description forceShowRun | boolean | default, false inclAllMSDSwitches | boolean | default, false -### Example Playbook +## Example Playbook ```yaml --- @@ -27,12 +27,12 @@ inclAllMSDSwitches | boolean | default, false device_name: leaf_1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_config_deploy_all/README.md b/roles/ndfc_rest_config_deploy_all/README.md index e68b078..1d7b1f9 100644 --- a/roles/ndfc_rest_config_deploy_all/README.md +++ b/roles/ndfc_rest_config_deploy_all/README.md @@ -2,7 +2,7 @@ Issue NDFC POST REST API calls to invoke config-save and config-deploy in fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description -------------------|---------|------------ @@ -23,7 +23,7 @@ Variable | Type | Description forceShowRun | boolean | default, false inclAllMSDSwitches | boolean | default, false -### Example Playbook +## Example Playbook ```yaml --- @@ -35,12 +35,12 @@ inclAllMSDSwitches | boolean | default, false fabric_name: f1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_device_intent_config_get/README.md b/roles/ndfc_rest_device_intent_config_get/README.md index f1efe24..2baa284 100644 --- a/roles/ndfc_rest_device_intent_config_get/README.md +++ b/roles/ndfc_rest_device_intent_config_get/README.md @@ -2,7 +2,7 @@ Retrieve intended config for ``device_name`` -### Role Variables +## Role Variables Variable | Type | Description -------------------|---------|------------ @@ -23,7 +23,7 @@ Variable | Type | Description forceShowRun | boolean | default, false inclAllMSDSwitches | boolean | default, false -### Example Playbook +## Example Playbook ```yaml --- @@ -40,12 +40,12 @@ inclAllMSDSwitches | boolean | default, false var: device_intent_config ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_device_list_by_fabric/README.md b/roles/ndfc_rest_device_list_by_fabric/README.md index e1dcb5a..b6ea036 100644 --- a/roles/ndfc_rest_device_list_by_fabric/README.md +++ b/roles/ndfc_rest_device_list_by_fabric/README.md @@ -5,7 +5,7 @@ Retrieve list of devices in fabric ``fabric_name`` Returns JSON object ``switch_list`` which will be a list of switch dictionaries if the GET request succeeded, or an empty list if the GET request failed. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -20,7 +20,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook The playbook below prints select information for every switch in fabric f2. @@ -42,12 +42,12 @@ The playbook below prints select information for every switch in fabric f2. label: device_info ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_device_rediscover/README.md b/roles/ndfc_rest_device_rediscover/README.md index f13a19c..cfc217c 100644 --- a/roles/ndfc_rest_device_rediscover/README.md +++ b/roles/ndfc_rest_device_rediscover/README.md @@ -2,7 +2,7 @@ Rediscover device ``device_name`` in fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -19,7 +19,7 @@ See the following for details: [./inventory/group_vars/README.md](https://github.com/allenrobel/ndfc-roles/tree/master/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -32,10 +32,12 @@ See the following for details: device_name: spine_1 ``` -### License +## Licensing -BSD +GNU General Public License v3.0 or later. -### Author Information +See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. + +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_device_set_role/README.md b/roles/ndfc_rest_device_set_role/README.md index b5c54f9..987577f 100644 --- a/roles/ndfc_rest_device_set_role/README.md +++ b/roles/ndfc_rest_device_set_role/README.md @@ -2,7 +2,7 @@ Set role for device ``device_name``. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -26,9 +26,9 @@ Variable | Type | Description forceShowRun | boolean | Default: ``false`` Included in the config-deploy REST call payload. inclAllMSDSwitches | boolean | Default: ``false`` Included in the config-deploy REST call payload. -### Dependencies +## Dependencies -### Example Playbooks +## Example Playbooks ```yaml --- @@ -42,12 +42,12 @@ inclAllMSDSwitches | boolean | Default: ``false`` Included in the config-deploy role: spine ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_access_mode_get/README.md b/roles/ndfc_rest_fabric_access_mode_get/README.md index d4b28f5..93486e0 100644 --- a/roles/ndfc_rest_fabric_access_mode_get/README.md +++ b/roles/ndfc_rest_fabric_access_mode_get/README.md @@ -2,7 +2,7 @@ Given ``fabric_name`` return fabric access_mode in var ``read_only`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example playbook +## Example playbook ```yaml --- @@ -32,12 +32,12 @@ See the following for details: msg: "fabric {{ fabric_name }} read_only: {{ read_only }}" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_access_mode_set/README.md b/roles/ndfc_rest_fabric_access_mode_set/README.md index 11fb232..c42772b 100644 --- a/roles/ndfc_rest_fabric_access_mode_set/README.md +++ b/roles/ndfc_rest_fabric_access_mode_set/README.md @@ -2,7 +2,7 @@ Given ``fabric_name`` set the fabric access_mode to true or false via var ``read_only`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|---------|---------------------------------------- @@ -17,12 +17,12 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_active_fabrics_get/README.md b/roles/ndfc_rest_fabric_active_fabrics_get/README.md index c8980cf..2ab0a6b 100644 --- a/roles/ndfc_rest_fabric_active_fabrics_get/README.md +++ b/roles/ndfc_rest_fabric_active_fabrics_get/README.md @@ -2,13 +2,13 @@ Returns the list of active fabrics on the Nexus Dashboard Fabric Controller. -### Returned Variables +## Returned Variables Variable | Type | Description ----------------|--------------|---------------------------------------- active_fabrics | list of dict | a list of active fabrics -### Example Playbook +## Example Playbook ```yaml --- @@ -23,12 +23,12 @@ active_fabrics | list of dict | a list of active fabrics when: "active_fabrics != ''" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_asn_get/README.md b/roles/ndfc_rest_fabric_asn_get/README.md index b199f17..60c9df8 100644 --- a/roles/ndfc_rest_fabric_asn_get/README.md +++ b/roles/ndfc_rest_fabric_asn_get/README.md @@ -2,13 +2,13 @@ Given ``fabric_name`` return fabric BGP ASN in var ``fabric_asn`` -### Returned variables +## Returned variables Variable | Type | Description ----------------|--------|---------------------------------------- fabric_asn | string | The BGP AS of the queried fabric -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -22,7 +22,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbooks +## Example Playbooks ```yaml --- @@ -39,12 +39,12 @@ See the following for details: when: "fabric_asn != ''" ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_create_easy_fabric/README.md b/roles/ndfc_rest_fabric_create_easy_fabric/README.md index 0465d36..1482f69 100644 --- a/roles/ndfc_rest_fabric_create_easy_fabric/README.md +++ b/roles/ndfc_rest_fabric_create_easy_fabric/README.md @@ -2,7 +2,7 @@ Create fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -28,12 +28,12 @@ See the following for details: fabric_name: f1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_create_easy_fabric_ebgp/README.md b/roles/ndfc_rest_fabric_create_easy_fabric_ebgp/README.md index f75df49..a22d799 100644 --- a/roles/ndfc_rest_fabric_create_easy_fabric_ebgp/README.md +++ b/roles/ndfc_rest_fabric_create_easy_fabric_ebgp/README.md @@ -2,7 +2,7 @@ Create Easy_Fabric_eBGP fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -28,12 +28,12 @@ See the following for details: fabric_name: EBGP_1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_create_external/README.md b/roles/ndfc_rest_fabric_create_external/README.md index 5fabade..3f98b28 100644 --- a/roles/ndfc_rest_fabric_create_external/README.md +++ b/roles/ndfc_rest_fabric_create_external/README.md @@ -2,7 +2,7 @@ Create External_Fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -28,12 +28,12 @@ See the following for details: fabric_name: ext_fabric_1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_create_lan_classic/README.md b/roles/ndfc_rest_fabric_create_lan_classic/README.md index 546d6fe..24f5f1a 100644 --- a/roles/ndfc_rest_fabric_create_lan_classic/README.md +++ b/roles/ndfc_rest_fabric_create_lan_classic/README.md @@ -2,7 +2,7 @@ Create LAN_Classic fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -28,12 +28,12 @@ See the following for details: fabric_name: LC_1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_create_msd/README.md b/roles/ndfc_rest_fabric_create_msd/README.md index ac2e89d..83f02ac 100644 --- a/roles/ndfc_rest_fabric_create_msd/README.md +++ b/roles/ndfc_rest_fabric_create_msd/README.md @@ -2,7 +2,7 @@ Create Multi-Site Domain (MSD) fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](https://github.com/allenrobel/ndfc-roles/tree/master/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -28,12 +28,12 @@ See the following for details: fabric_name: MSD ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_delete/README.md b/roles/ndfc_rest_fabric_delete/README.md index 297a3fd..8796385 100644 --- a/roles/ndfc_rest_fabric_delete/README.md +++ b/roles/ndfc_rest_fabric_delete/README.md @@ -2,7 +2,7 @@ Delete fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -28,12 +28,12 @@ See the following for details: fabric_name: f1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_info_get/README.md b/roles/ndfc_rest_fabric_info_get/README.md index a808119..66286ad 100644 --- a/roles/ndfc_rest_fabric_info_get/README.md +++ b/roles/ndfc_rest_fabric_info_get/README.md @@ -2,7 +2,7 @@ Returns information for ``fabric_name`` in variable ``fabric_info`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Default Variables +## Default Variables Defaults for the following are in [./roles/ndfc_rest_fabric_info_get/defaults/main.yml](/roles/ndfc_rest_fabric_info_get/defaults/main.yml) @@ -25,7 +25,7 @@ Variable | Type | Description greenfield_debug_flag | str() | Default: enable IS_READ_ONLY | bool() | Default: false -### Example Playbook +## Example Playbook ```yaml --- @@ -42,12 +42,12 @@ IS_READ_ONLY | bool() | Default: false var: fabric_info ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_msd_child_add/README.md b/roles/ndfc_rest_fabric_msd_child_add/README.md index 67d6da6..c61bd6f 100644 --- a/roles/ndfc_rest_fabric_msd_child_add/README.md +++ b/roles/ndfc_rest_fabric_msd_child_add/README.md @@ -2,7 +2,7 @@ Add ``child_fabric`` to Multi-Site Domain (MSD) fabric ``msd_fabric`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -17,7 +17,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook Add ``child_fabric`` f1 to ``msd_fabric`` MSD @@ -32,12 +32,12 @@ Add ``child_fabric`` f1 to ``msd_fabric`` MSD msd_fabric: MSD ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_fabric_msd_child_remove/README.md b/roles/ndfc_rest_fabric_msd_child_remove/README.md index fb405dc..6ee1206 100644 --- a/roles/ndfc_rest_fabric_msd_child_remove/README.md +++ b/roles/ndfc_rest_fabric_msd_child_remove/README.md @@ -2,7 +2,7 @@ Remove child fabric ``child_fabric`` from Multi-Site Domain (MSD) fabric ``msd_fabric`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -17,7 +17,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook Remove ``child_fabric`` f1 from ``msd_fabric`` MSD @@ -32,12 +32,12 @@ Remove ``child_fabric`` f1 from ``msd_fabric`` MSD msd_fabric: MSD ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_interface_no_shutdown/README.md b/roles/ndfc_rest_interface_no_shutdown/README.md index 0eec88f..31230ef 100644 --- a/roles/ndfc_rest_interface_no_shutdown/README.md +++ b/roles/ndfc_rest_interface_no_shutdown/README.md @@ -2,7 +2,7 @@ Administratively ``no shutdown`` interface ``interface_name`` on ``device_name``. -### Role Variables +## Role Variables Variable | Type | Description ----------------|-------|------------------------------------------------ @@ -27,9 +27,9 @@ Variable | Type | Description forceShowRun | boolean | Default: ``false`` Included in the config-deploy REST call payload. inclAllMSDSwitches | boolean | Default: ``false`` Included in the config-deploy REST call payload. -### Dependencies +## Dependencies -### Example Playbooks +## Example Playbooks ```yaml --- @@ -42,12 +42,12 @@ inclAllMSDSwitches | boolean | Default: ``false`` Included in the config-deploy interface_name: Ethernet1/32 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_interface_shutdown/README.md b/roles/ndfc_rest_interface_shutdown/README.md index 55ffec4..f0d39dc 100644 --- a/roles/ndfc_rest_interface_shutdown/README.md +++ b/roles/ndfc_rest_interface_shutdown/README.md @@ -2,7 +2,7 @@ Administratively shutdown interface ``interface_name`` on ``device_name``. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|------------------------------------------------ @@ -27,9 +27,9 @@ Variable | Type | Description forceShowRun | bool() | Default: ``false`` Included in the config-deploy REST call payload. inclAllMSDSwitches | bool() | Default: ``false`` Included in the config-deploy REST call payload. -### Dependencies +## Dependencies -### Example Playbooks +## Example Playbooks ```yaml # example_ndfc_rest_interface_shutdown.yml @@ -43,12 +43,12 @@ inclAllMSDSwitches | bool() | Default: ``false`` Included in the config-deploy R interface_name: Ethernet1/32 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_service_node_add/README.md b/roles/ndfc_rest_service_node_add/README.md index 0a84089..9335ae5 100644 --- a/roles/ndfc_rest_service_node_add/README.md +++ b/roles/ndfc_rest_service_node_add/README.md @@ -11,7 +11,7 @@ Role | service_node_type ndfc_rest_service_node_add | Firewall, ADC, VNF ndfc_service_node_create | firewall, load_balancer, virtual_network_function -### Role Variables +## Role Variables Variable | Type | Description ------------------|--------|---------------------------------------- @@ -25,7 +25,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Default Variables +## Default Variables Defaults for the following are in ``./roles/ndfc_rest_service_node_add/defaults/main.yml``: @@ -40,7 +40,7 @@ interface_bpduguard_enabled | boolean | Default: true interface_porttype_fast_enabled | boolean | Default: true interface_admin_state | boolean | true -### Example Playbook +## Example Playbook ```yaml --- @@ -52,12 +52,12 @@ interface_admin_state | boolean | true service_node_name: sn_1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_vpc_create/README.md b/roles/ndfc_rest_vpc_create/README.md index 33c9fcc..55179bb 100644 --- a/roles/ndfc_rest_vpc_create/README.md +++ b/roles/ndfc_rest_vpc_create/README.md @@ -2,7 +2,7 @@ Create vpc peering ``vpc_name`` in fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -20,7 +20,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -34,12 +34,12 @@ See the following for details: vpc_name: vpc2 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_vpc_delete/README.md b/roles/ndfc_rest_vpc_delete/README.md index f532054..239bc08 100644 --- a/roles/ndfc_rest_vpc_delete/README.md +++ b/roles/ndfc_rest_vpc_delete/README.md @@ -2,7 +2,7 @@ Delete vpc peering ``vpc_name`` in fabric ``fabric_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,19 +16,19 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook This currently does not work. We're investigating it and will update the repo once a resolution is found. ```yaml ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_rest_vrf_list_by_fabric/README.md b/roles/ndfc_rest_vrf_list_by_fabric/README.md index 34b6607..ccf5e2b 100644 --- a/roles/ndfc_rest_vrf_list_by_fabric/README.md +++ b/roles/ndfc_rest_vrf_list_by_fabric/README.md @@ -5,14 +5,14 @@ Retrieve list of VRFs in fabric ``fabric_name`` Returns JSON object ``info`` which will be a list of vrf dictionaries if the GET request succeeded, or an empty list if the GET request failed. -### Role Variables +## Role Variables Variable | Type | Description ----------------|-------|---------------------------------------- fabric_name | str() | The fabric to be queried -### Example Playbook +## Example Playbook The playbook below prints select information for every VRF in fabric_name f2. @@ -34,12 +34,12 @@ The playbook below prints select information for every VRF in fabric_name f2. label: vrf_info ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_service_node_config_get/README.md b/roles/ndfc_service_node_config_get/README.md index fc2c97a..c39193b 100644 --- a/roles/ndfc_service_node_config_get/README.md +++ b/roles/ndfc_service_node_config_get/README.md @@ -2,7 +2,7 @@ Retrieve local configuration for ``service_node_name`` -### Role Variables +## Role Variables Variable | Type | Description ------------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -33,12 +33,12 @@ See the following for details: var: service_node_config ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_service_node_deleted/README.md b/roles/ndfc_service_node_deleted/README.md index 216c5c0..6401c5e 100644 --- a/roles/ndfc_service_node_deleted/README.md +++ b/roles/ndfc_service_node_deleted/README.md @@ -2,7 +2,7 @@ Delete service node ``service_node_name`` -### Role Variables +## Role Variables Variable | Type | Description ------------------|--------|---------------------------------------- @@ -17,7 +17,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -29,12 +29,12 @@ See the following for details: service_node_name: sn_1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_service_node_merged/README.md b/roles/ndfc_service_node_merged/README.md index d2a575e..ace9493 100644 --- a/roles/ndfc_service_node_merged/README.md +++ b/roles/ndfc_service_node_merged/README.md @@ -13,7 +13,7 @@ Role | service_node_type ndfc_rest_service_node_add | Firewall, ADC, VNF ndfc_service_node_merged | firewall, load_balancer, virtual_network_function -### Role Variables +## Role Variables Variable | Type | Description ------------------|--------|---------------------------------------- @@ -28,7 +28,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -40,12 +40,12 @@ See the following for details: service_node_name: sn_1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_service_route_peering_config_get/README.md b/roles/ndfc_service_route_peering_config_get/README.md index ec0d556..f44a093 100644 --- a/roles/ndfc_service_route_peering_config_get/README.md +++ b/roles/ndfc_service_route_peering_config_get/README.md @@ -2,7 +2,7 @@ Retrieve configuration for ``service_route_peering_name`` from the Ansible inventory -### Role Variables +## Role Variables Variable | Type | Description ---------------------------|--------|---------------------------------------- @@ -17,7 +17,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -34,12 +34,12 @@ See the following for details: var: service_route_peering_config ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_service_route_peering_intra_tenant_fw_merged/README.md b/roles/ndfc_service_route_peering_intra_tenant_fw_merged/README.md index 1850245..8a75a23 100644 --- a/roles/ndfc_service_route_peering_intra_tenant_fw_merged/README.md +++ b/roles/ndfc_service_route_peering_intra_tenant_fw_merged/README.md @@ -4,7 +4,7 @@ Create intra-tenant service route peering NOTE 1: This role is not tested (or documented satisfactorily) yet. -### Role Variables +## Role Variables Variable | Type | Description ---------------------------|-------|---------------------------------------- @@ -19,7 +19,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -31,12 +31,12 @@ See the following for details: service_route_peering_name: srp_1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_vpc_config_get/README.md b/roles/ndfc_vpc_config_get/README.md index 7334c67..ac01e53 100644 --- a/roles/ndfc_vpc_config_get/README.md +++ b/roles/ndfc_vpc_config_get/README.md @@ -2,7 +2,7 @@ Retrieve configuration for ``vpc_name`` from the local inventory -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -28,12 +28,12 @@ See the following for details: vpc_name: vpc1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_vpc_interface_merged_all/README.md b/roles/ndfc_vpc_interface_merged_all/README.md index 9240daa..1cc2d14 100644 --- a/roles/ndfc_vpc_interface_merged_all/README.md +++ b/roles/ndfc_vpc_interface_merged_all/README.md @@ -2,7 +2,7 @@ Merge all vpc interfaces for vpc peer ``vpc_name`` -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -16,7 +16,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -29,12 +29,12 @@ See the following for details: vpc_name: vpc1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_vrf_all/README.md b/roles/ndfc_vrf_all/README.md index 565d9fb..31ea29b 100644 --- a/roles/ndfc_vrf_all/README.md +++ b/roles/ndfc_vrf_all/README.md @@ -2,14 +2,14 @@ Create, update, or delete all defined VRFs in fabric ``fabric_name``. -### Role Variables +## Role Variables Variable | Description ------------ | ----------- fabric_name | The name of the fabric in which the VRFs reside.
Typically defined in the playbook's vars: section. state | Ansible state. One of merged, overridden, replaced, or deleted. -### Other variables +## Other variables This role reads the ``vrfs`` dictionary from: @@ -33,9 +33,10 @@ service_vrf_template | ServiceVrf | string | Service vrf template attach | See example | list of dict | List of mgmt0 ip addresses of switches on which the VRF is configured attach.ip_address | 192.168.1.1 | IP address | mgmt0 address of the switch to which the vrf is attached -### Example Playbooks +## Example Playbooks + +### delete all vrf in fabric f2 -##### delete all vrf in fabric f2 ```yaml --- - hosts: ndfc @@ -49,7 +50,8 @@ attach.ip_address | 192.168.1.1 | IP address | mgmt0 address of the sw state: deleted ``` -##### merge all vrf in fabric f1 +### merge all vrf in fabric f1 + ```yaml --- - hosts: ndfc @@ -63,7 +65,7 @@ attach.ip_address | 192.168.1.1 | IP address | mgmt0 address of the sw state: merged ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. diff --git a/roles/ndfc_vrf_config_get/README.md b/roles/ndfc_vrf_config_get/README.md index 1c466a5..3884afe 100644 --- a/roles/ndfc_vrf_config_get/README.md +++ b/roles/ndfc_vrf_config_get/README.md @@ -2,13 +2,13 @@ Retrieve the configuration for vrf ``vrf_name`` -### Returns (via set_fact) +## Returns (via set_fact) Variable | Type | Description ----------------|--------|---------------------------------------- vrf_config | object | A JSON object containing ``vrf_name``'s current configuration -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -22,7 +22,7 @@ See the following for details: [./inventory/group_vars/README.md](/inventory/group_vars/README.md) -### Example Playbook +## Example Playbook ```yaml --- @@ -38,7 +38,7 @@ See the following for details: var: vrf_config ``` -### Example returned object +## Example returned object ```json { @@ -94,12 +94,13 @@ See the following for details: } } ``` -### Licensing + +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_vrf_query/README.md b/roles/ndfc_vrf_query/README.md index ab303c4..14a25f7 100644 --- a/roles/ndfc_vrf_query/README.md +++ b/roles/ndfc_vrf_query/README.md @@ -2,7 +2,7 @@ Query VRF ``vrf_name`` and return json object ``vrf_info`` which contains vrf information for ``vrf_name`` from the NDFC controller. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -14,7 +14,7 @@ VRF parameters are defined in the following files: NOTE, ``vrf_name`` above corresponds to the ``name:`` key within the vrfs dictionary in the file noted above. The ``name:`` key is unique across all defined vrfs, whereas the ``vrf_name:`` key is not unique and cannot be used with this role. By way of example, in the entry below, you would use the value of ``name:`` rather than the value of ``vrf_name``. The example playbook below shows the correct value to use. -#### Example entry in the vrfs dictionary +## Example entry in the vrfs dictionary ```yaml f2_v1: @@ -33,7 +33,7 @@ NOTE, ``vrf_name`` above corresponds to the ``name:`` key within the vrfs dictio - ip_address: "{{ devices.leaf_8.ip }}" ``` -#### Example playbook to query the above vrf +### Example playbook to query the above vrf ```yaml --- @@ -56,12 +56,12 @@ See the following for details: [./inventory/group_vars/README.md](https://github.com/allenrobel/ndfc-roles/tree/master/inventory/group_vars/README.md) -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc) diff --git a/roles/ndfc_vrf_replaced/README.md b/roles/ndfc_vrf_replaced/README.md index 72ebb81..5b12520 100644 --- a/roles/ndfc_vrf_replaced/README.md +++ b/roles/ndfc_vrf_replaced/README.md @@ -2,7 +2,7 @@ Replace vrf ``vrf_name`` in fabric ``fabric_name`` with the current user-defined parameters. -### Role Variables +## Role Variables Variable | Type | Description ----------------|--------|---------------------------------------- @@ -34,7 +34,7 @@ service_vrf_template | ServiceVrf | string | Service vrf temp attach | See example | list of dict | List of mgmt0 ip addresses of switches on which the VRF is configured attach.ip_address | 192.168.1.1 | IP address | mgmt0 address of the switch to which the vrf is attached -#### Example entry in vrfs dictionary +## Example entry in vrfs dictionary ```yaml vrfs: @@ -56,7 +56,7 @@ vrfs: - ip_address: "{{ devices.leaf_8.ip }}" ``` -## Example Playbook (referencing the above example vrf entry) +### Example Playbook (referencing the above example vrf entry) ```yaml --- @@ -68,12 +68,12 @@ vrfs: vrf_name: f2_v1 ``` -### Licensing +## Licensing GNU General Public License v3.0 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt) for full text. -### Author Information +## Author Information Allen Robel (@packetcalc)