{"id":13766562,"url":"https://github.com/ansible-collections/community.network","last_synced_at":"2025-04-04T16:13:30.901Z","repository":{"id":37924995,"uuid":"250188521","full_name":"ansible-collections/community.network","owner":"ansible-collections","description":"Ansible Community Network Collection","archived":false,"fork":false,"pushed_at":"2024-10-15T06:11:01.000Z","size":4115,"stargazers_count":131,"open_issues_count":77,"forks_count":91,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-03-28T15:06:21.522Z","etag":null,"topics":["ansible-collection","network-automation","network-programming"],"latest_commit_sha":null,"homepage":"http://galaxy.ansible.com/community/network","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ansible-collections.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-26T07:22:50.000Z","updated_at":"2025-03-13T09:16:34.000Z","dependencies_parsed_at":"2024-07-16T07:42:52.801Z","dependency_job_id":"dfc59819-21be-4e9f-9245-b3dbb43a7d5e","html_url":"https://github.com/ansible-collections/community.network","commit_stats":null,"previous_names":[],"tags_count":37,"template":false,"template_full_name":"ansible-collections/collection_template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fcommunity.network","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fcommunity.network/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fcommunity.network/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fcommunity.network/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ansible-collections","download_url":"https://codeload.github.com/ansible-collections/community.network/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247208139,"owners_count":20901570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["ansible-collection","network-automation","network-programming"],"created_at":"2024-08-03T16:00:57.431Z","updated_at":"2025-04-04T16:13:30.877Z","avatar_url":"https://github.com/ansible-collections.png","language":"Python","funding_links":[],"categories":["Automation"],"sub_categories":["Ansible"],"readme":"# Community Network Collection\n\n:warning: **DEPRECATED: This collection is not not actively maintained anymore.**\n\nFor more information why we decided to deprecate the collection, please see [this thread](https://forum.ansible.com/t/8030).\n\n[![Build Status](https://dev.azure.com/ansible/community.network/_apis/build/status/CI?branchName=main)](https://dev.azure.com/ansible/community.network/_build?definitionId=32)\n[![Codecov](https://img.shields.io/codecov/c/github/ansible-collections/community.network)](https://codecov.io/gh/ansible-collections/community.network)\n\nThis repository contains the `community.network` Ansible Collection. The collection is a part of the `ansible` package and includes many network modules and plugins supported by Ansible community which are not part of more specialized community collections.\n\nYou can find [documentation for this collection on the Ansible docs site](https://docs.ansible.com/ansible/latest/collections/community/network/).\n\n## Code of Conduct\n\nWe follow [Ansible Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html) in all our interactions within this project.\n\nIf you encounter abusive behavior violating the [Ansible Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html), please refer to the [policy violations](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html#policy-violations) section of the Code of Conduct for information on how to raise a complaint.\n\n## Contributing to this collection\n\nThe content of this collection is made by good people just like you, a community of individuals collaborating on making the world better through developing automation software.\n\nWe are actively accepting new contributors.\n\nAll types of contributions are very welcome.\n\nYou don't know how to start? Refer to our [contribution guide](https://github.com/ansible-collections/community.network/blob/main/CONTRIBUTING.md)!\n\nSee the [Ansible Community Guide](https://docs.ansible.com/ansible/latest/community/index.html) for details on contributing to Ansible.\n\nIf you're interested in becoming a maintainer of this collection, refer to the [Maintainer guidelines](https://github.com/ansible/community-docs/blob/main/maintaining.rst) for details.\n\n## Communication\n\n* Join the Ansible forum:\n    * [Get Help](https://forum.ansible.com/c/help/6): get help or help others.\n    * [Posts tagged with 'network'](https://forum.ansible.com/tag/network): subscribe to participate in network-related conversations.\n    * [Social Spaces](https://forum.ansible.com/c/chat/4): gather and interact with fellow enthusiasts.\n    * [News \u0026 Announcements](https://forum.ansible.com/c/news/5): track project-wide announcements including social events.\n\n* The Ansible [Bullhorn newsletter](https://docs.ansible.com/ansible/devel/community/communication.html#the-bullhorn): used to announce releases and important changes.\n\nFor more information about communication, see the [Ansible communication guide](https://docs.ansible.com/ansible/devel/community/communication.html).\n\n## Tested with ansible-core\n\nTested with supported versions of ansible-core.\nRefer to the [AZP test matrix](.azure-pipelines/azure-pipelines.yml) for details.\n\n### Supported connections\n\nThe community network collection supports `network_cli`  and `httpapi` connections.\n\n## Included content\n\nClick the `Content` button to see the list of content included in this collection, or check the [documentation on the Ansible docs site](https://docs.ansible.com/ansible/latest/collections/community/network/).\n\n## Installing this collection\n\nThis collection is shipped with the `ansible` package. So if you have it installed, no more action is required.\n\nIf you have a minimal installation (only Ansible Core installed) or you want to use the latest version of the collection along with the whole `ansible` package, you need to install the collection from [Ansible Galaxy](https://galaxy.ansible.com/ui/repo/published/community/network/) manually with the `ansible-galaxy` command-line tool:\n\n    ansible-galaxy collection install community.network\n\nYou can also include it in a `requirements.yml` file and install it with `ansible-galaxy collection install -r requirements.yml`, using the format:\n\n```yaml\n---\ncollections:\n  - name: community.network\n    # If you need a specific version of the collection, you can specify like this:\n    # version: ...\n```\n\nNote that if you install the collection manually, it will not be upgraded automatically when you upgrade the `ansible` package. To upgrade the collection to the latest available version, run the following command:\n\n```bash\nansible-galaxy collection install community.network --upgrade\n```\n\nYou can also install a specific version of the collection, for example, if you need to downgrade when something is broken in the latest version (please report an issue in this repository). Use the following syntax where `X.Y.Z` can be any [available version](https://galaxy.ansible.com/ui/repo/published/community/network/):\n\n```bash\nansible-galaxy collection install community.network:==X.Y.Z\n```\nSee [Ansible Using collections](https://docs.ansible.com/ansible/latest/user_guide/collections_using.html) for more details.\n\n## Using this collection\n\nYou can call modules by their Fully Qualified Collection Name (FQCN), such as `community.network.a10_server`.\nThe following example task creates a new server load balancer object on an A10 Networks device, using the FQCN:\n\n```yaml\n---\n    - name: Create a new server\n      community.network.a10_server:\n        host: a10.mydomain.com\n        username: myadmin\n        password: mypassword\n        partition: mypartition\n        server: test\n        server_ip: 192.0.2.100\n        server_ports:\n          - port_num: 8080\n            protocol: tcp\n          - port_num: 8443\n            protocol: TCP\n```\n\nAlternately, you can call modules by their short name if you list the `community.network` collection in the playbook's `collections`, as follows:\n\n```yaml\n---\n- hosts: \"{{desired_inventory_group}}\"\n  connection: local\n\n  collections:\n    - community.network\n\n  tasks:\n    - name: Create a new server\n      a10_server:\n            host: a10.mydomain.com\n            username: myadmin\n            password: mypassword\n            partition: mypartition\n            server: test\n            server_ip: 192.0.2.100\n            server_ports:\n              - port_num: 8080\n                protocol: tcp\n              - port_num: 8443\n                protocol: TCP\n```\n\n### See Also:\n\n* [Ansible Using collections](https://docs.ansible.com/ansible/latest/user_guide/collections_using.html) for more details.\n\n## Changelogs\n\nSee [here](https://github.com/ansible-collections/community.network/tree/main/CHANGELOG.rst).\n\n## Roadmap\n\n\u003c!-- Optional. Include the roadmap for this collection, and the proposed release/versioning strategy so users can anticipate the upgrade/update cycle. --\u003e\n\n## More information\n\n- [Ansible network resources](https://docs.ansible.com/ansible/latest/network/getting_started/network_resources.html)\n- [Ansible Collection overview](https://github.com/ansible-collections/overview)\n- [Ansible User guide](https://docs.ansible.com/ansible/latest/user_guide/index.html)\n- [Ansible Developer guide](https://docs.ansible.com/ansible/latest/dev_guide/index.html)\n- [Ansible Community code of conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html)\n\n## Licensing\n\nGNU General Public License v3.0 or later.\n\nSee [COPYING](https://www.gnu.org/licenses/gpl-3.0.txt) to see the full text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fansible-collections%2Fcommunity.network","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fansible-collections%2Fcommunity.network","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fansible-collections%2Fcommunity.network/lists"}