Merge branch 'dev'

README.md

@@ -1,5 +1,46 @@
-# terraform-provider-ciscoevpn
-
+# Terraform Provider Cisco EVPN
 Tech Preview (Early field trial)
 
-Examples in [Folder](./examples/).
+terraform-provider-ciscoevpn is a Terraform Provider for Cisco Catalyst 9000 Switches.
+
+## Requirements for Development
+
+- [Terraform](https://www.terraform.io/downloads.html) >= 1.0
+- [Go](https://golang.org/doc/install) >= 1.18
+
+## Using the provider
+
+Use ```terraform init``` to download the plugin from Terrafrom Registry.
+
+Configure the provider to connect towards your Cisco Catalyst 9000 Switches
+```
+terraform {
+  required_providers {
+    ciscoevpn = {
+      source = "robertcsapo/ciscoevpn"
+      version = "1.0.1"
+    }
+  }
+}
+
+provider "ciscoevpn" {
+  username = var.username
+  password = var.password
+  insecure = var.insecure
+  timeout  = var.timeout
+  debug = false
+  roles {
+    spines {
+      iosxe = var.iosxe_spines
+    }
+    borders {
+      iosxe = var.iosxe_borders
+    }
+    leafs {
+      iosxe = var.iosxe_leafs
+    }
+  }
+}
+```
+
+Examples can be found in [examples/](./examples/).

USECASE.md

@@ -0,0 +1,12 @@
+Cisco Catalyst 9000 EVPN with Terrafrom
+=====================================
+_(Deploy EVPN VXLAN on Catalyst 9000 running IOS-XE 17.8+)_
+
+This Terraform Provider [ciscoevpn](https://registry.terraform.io/providers/robertcsapo/ciscoevpn/) allows you to deploy and manage your EVPN Fabric using Infrastructure as a Code (IAC).
+
+### More details about EVPN VXLAN
+- [BGP EVPN VXLAN Configuration Guide, Cisco IOS XE Cupertino 17.9.x](https://www.cisco.com/c/en/us/td/docs/switches/lan/catalyst9300/software/release/17-9/configuration_guide/vxlan/b_179_bgp_evpn_vxlan_9300_cg/bgp_evpn_vxlan_overview.html)
+- [Why Transition to BGP EVPN VXLAN in Enterprise Campus?](https://blogs.cisco.com/networking/why-transition-to-bgp-evpn-vxlan-in-enterprise-campus)
+- [Next-Generation Enterprise Campus Network Virtualization with BGP EVPN VXLAN](https://blogs.cisco.com/networking/next-generation-enterprise-campus-network-virtualization-with-bgp-evpn-vxlan)
+- [VXLAN EVPN — De-Facto Standard, Open and Interoperable](https://blogs.cisco.com/datacenter/vxlan-evpn-de-facto-standard-open-and-interoperable)
+- [Cisco Catalyst 9000 EVPN Terraform Example on GitHub](https://github.com/netascode/terraform-iosxe-evpn-example)

go.mod

@@ -9,7 +9,7 @@ require (
 )
 
 require (
-	github.com/Masterminds/goutils v1.1.0 // indirect
+	github.com/Masterminds/goutils v1.1.1 // indirect
 	github.com/Masterminds/semver v1.5.0 // indirect
 	github.com/Masterminds/sprig v2.22.0+incompatible // indirect
 	github.com/agext/levenshtein v1.2.2 // indirect

go.sum

@@ -3,8 +3,8 @@ cloud.google.com/go v0.34.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMT
 github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU=
 github.com/CiscoDevNet/iosxe-go-client v0.0.2 h1:znyAlYRq4RIR7KhKcwNa6ISdKlToQtIg7TEupS3Kovo=
 github.com/CiscoDevNet/iosxe-go-client v0.0.2/go.mod h1:9+vNRUy6VmQ0ckbieSpfX6RAhGyTJMNaJCOxvETAhms=
-github.com/Masterminds/goutils v1.1.0 h1:zukEsf/1JZwCMgHiK3GZftabmxiCw4apj3a28RPBiVg=
-github.com/Masterminds/goutils v1.1.0/go.mod h1:8cTjp+g8YejhMuvIA5y2vz3BpJxksy863GQaJW2MFNU=
+github.com/Masterminds/goutils v1.1.1 h1:5nUrii3FMTL5diU80unEVvNevw1nH4+ZV4DSLVJLSYI=
+github.com/Masterminds/goutils v1.1.1/go.mod h1:8cTjp+g8YejhMuvIA5y2vz3BpJxksy863GQaJW2MFNU=
 github.com/Masterminds/semver v1.5.0 h1:H65muMkzWKEuNDnfl9d70GUjFniHKHRbFPGBuZ3QEww=
 github.com/Masterminds/semver v1.5.0/go.mod h1:MB6lktGJrhw8PrUyiEoblNEGEQ+RzHPF078ddwwvV3Y=
 github.com/Masterminds/sprig v2.22.0+incompatible h1:z4yfnGrZ7netVz+0EDJ0Wi+5VZCSYp4Z0m2dk6cEM60=