{"id":50385210,"url":"https://github.com/stackhpc/ansible-role-vxlan","last_synced_at":"2026-05-30T14:31:13.823Z","repository":{"id":54700259,"uuid":"522607904","full_name":"stackhpc/ansible-role-vxlan","owner":"stackhpc","description":"Ansible role for configuring VXLANs using `network-scripts`","archived":false,"fork":false,"pushed_at":"2023-05-16T08:46:37.000Z","size":38,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-04-14T22:50:18.566Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stackhpc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2022-08-08T15:34:27.000Z","updated_at":"2023-03-23T16:55:28.000Z","dependencies_parsed_at":"2022-08-14T00:20:52.663Z","dependency_job_id":null,"html_url":"https://github.com/stackhpc/ansible-role-vxlan","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stackhpc/ansible-role-vxlan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackhpc%2Fansible-role-vxlan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackhpc%2Fansible-role-vxlan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackhpc%2Fansible-role-vxlan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackhpc%2Fansible-role-vxlan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stackhpc","download_url":"https://codeload.github.com/stackhpc/ansible-role-vxlan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackhpc%2Fansible-role-vxlan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33696681,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-30T14:31:08.762Z","updated_at":"2026-05-30T14:31:08.825Z","avatar_url":"https://github.com/stackhpc.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"VXLAN\n=========\n\nThis role creates persistent VXLAN interfaces with the use of [Network Scripts](https://pkgs.org/download/network-scripts), [NetworkManger](https://pkgs.org/download/NetworkManager), or [Systemd-Networkd](https://www.freedesktop.org/software/systemd/man/systemd-networkd.service.html).\n\nRole Variables\n--------------\n\nThe role uses the same variable names as `Network Scripts`. It is recommended to review the documentation on [Network Scripts](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/deployment_guide/s1-networkscripts-interfaces). Below are the variables relevant and supported by this role.\n\n`vxlan_vni`: sets the VXLAN network identifier for the VXLAN interfaces\n\n`vxlan_ttl`: set the time-to-live for the packets transmitted over the interface\n\n`vxlan_phys_dev`: set the physical device for the VXLAN interface to pair with\n\n`vxlan_dstport`: set the port for the VXLAN to reside on\n\n`vxlan_bootproto`: specify boot protocol used with the interface (unsupported when using NetworkManger or Systemd-Networkd, always none)\n\n`vxlan_onboot`: set to `yes` if the VXLAN interface should be brought up on boot otherwise `no` (Not supported on Systemd-networkd)\n\n`vxlan_interfaces`: list of interfaces to be created can set specific instances of the variables defined above in addition to some others\n\u003e `device`: name assigned the VXLAN interface\n\u003e\n\u003e `ipaddr`: the IPV4 address assigned to the VXLAN interface (unsupported when using NetworkManger or Systemd-Networkd)\n\u003e\n\u003e `prefix`: the subnet mask use with the `ipaddr` (unsupported when using NetworkManger or Systemd-Networkd)\n\u003e\n\u003e `group`: the multicast group the VXLAN will operate on\n\u003e\n\u003e `bridge`: if set establish a bridge between this VXLAN and the specified interface\n\nBy default, Network Scripts will be used unless it is unavailable. Usage of either Network Scripts, NetworkManager or Systemd-Networkd can be enforced by setting `force_ns`, `force_nm`, or `force_sd` to true. \n\nExample Playbook\n----------------\n\n  Include the role into a playbook as you would any other role.\n\n    - hosts: host1\n      roles:\n        - role: vxlan\n          vars:\n            vxlan_vni: 10\n            vxlan_interfaces:\n              - device: vxlan0\n                ipaddr: 192.168.0.2\n                group: 224.0.0.100\n\n\n  For variables such as `vxlan_ipaddr` it is best to define them on a host by host basis.\n\n  ### /host_vars/host1\n\n    vxlan_interfaces:\n      - device: vxlan0\n        ipaddr: 192.168.0.2\n        group: 224.0.0.100\n\n  ### /host_vars/host2\n\n    vxlan_interfaces:\n      - device: vxlan0\n        ipaddr: 192.168.0.3\n        group: 224.0.0.100\n\nYou may also define multiple VXLAN interfaces per host however you must provide a unique `vxlan_vni` for each device defined in `vxlan_interfaces`\n\n  ### /host_vars/host1\n\n    vxlan_interfaces:\n      - device: vxlan0\n        vni: 10\n        group: 224.0.0.200\n      - device: vxlan1\n        vni: 20\n        group: 224.0.0.200\n\nYou may also set a bridge for vxlan interface to operate over.\n\n  ### /host_vars/host1\n\n    vxlan_interfaces:\n      - device: vxlan0\n        group: 224.0.0.10\n        bridge: breth1\n\nLicense\n-------\n\nApache License 2.0\n\nAuthor Information\n------------------\n\n[StackHPC](https://www.stackhpc.com/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackhpc%2Fansible-role-vxlan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstackhpc%2Fansible-role-vxlan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackhpc%2Fansible-role-vxlan/lists"}