{"id":18798720,"url":"https://github.com/f5networks/f5-ansible-f5modules","last_synced_at":"2025-04-13T17:22:18.807Z","repository":{"id":145234979,"uuid":"560756881","full_name":"F5Networks/f5-ansible-f5modules","owner":"F5Networks","description":"A public facing repository for official releases of f5modules subcollection","archived":false,"fork":false,"pushed_at":"2025-04-09T23:03:16.000Z","size":5624,"stargazers_count":7,"open_issues_count":1,"forks_count":2,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-04-10T00:19:38.583Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/F5Networks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2022-11-02T07:39:36.000Z","updated_at":"2025-02-14T13:44:41.000Z","dependencies_parsed_at":"2023-07-04T06:02:21.305Z","dependency_job_id":"e27e6632-d58e-4f6e-8e60-08a750f6d072","html_url":"https://github.com/F5Networks/f5-ansible-f5modules","commit_stats":null,"previous_names":[],"tags_count":46,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-ansible-f5modules","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-ansible-f5modules/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-ansible-f5modules/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-ansible-f5modules/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/F5Networks","download_url":"https://codeload.github.com/F5Networks/f5-ansible-f5modules/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248750866,"owners_count":21155797,"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":[],"created_at":"2024-11-07T22:12:45.025Z","updated_at":"2025-04-13T17:22:18.800Z","avatar_url":"https://github.com/F5Networks.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# F5 BIG-IP Imperative Collection for Ansible\n\nThis collection includes imperative Ansible modules for BIG-IP and BIG-IQ from F5 Networks.\nThis collection packages and distributes modules, and plugins.\n\n## Requirements\n\n - ansible \u003e= 2.16\n - packaging\n\n## Python Version Notice\nCollection only supports python 3.9 and above.\n\n## Installation\nTo install in ansible default or defined paths use:\n```bash\nansible-galaxy collection install f5networks.f5_modules\n```\n\nTo specify the installation location use `-p`. If specifying a folder, make sure to update the `ansible.cfg` so ansible will check this folder as well.\n```bash\nansible-galaxy collection install f5networks.f5_modules -p collections/\n```\n\nTo specify the version of the collection to install, include it at the end of the collection with `:==1.0.0`:\n```bash\nansible-galaxy collection install f5networks.f5_modules:==1.0.0\n```\n\nSemantic Versioning examples below:\n- Increment major (for example: x in x.y.z) version number for an incompatible API change.\n- Increment minor (for example: y in x.y.z) version number for new functionality in a backwards compatible manner.\n- Increment patch (for example: z in x.y.z) version number for backwards compatible bug fixes.\n\n## Example Usage\n\nTo use a module from a collection, reference the full namespace, collection, and modules name that you want to use:\n\n```\n---\n- name: Using Collections\n  hosts: f5\n  connection: local\n\n  tasks:\n    - f5networks.f5_modules.bigip_pool:\n        name: my-pool\n        ....\n\n```\n\n## Collections Daily Build\n\nWe offer a daily build of our most recent collection [dailybuild]. Use this Collection to test the most\nrecent Ansible module updates between releases. You can also install development build directly from GitHub see [repoinstall].\n\n### Install from GitHub\n```bash\n\nansible-galaxy collection install git+https://github.com/F5Networks/f5-ansible-bigip.git#ansible_collections/f5networks/f5_bigip\n```\n\n### Install from the daily build file\n```bash\n\n    ansible-galaxy collection install \u003ccollection name\u003e -p ./collections\n    e.g.\n    ansible-galaxy collection install f5networks-f5_modules-devel.tar.gz -p ./collections\n```\n\n\u003e **_NOTE:_**  `-p` is the location in which the collection will be installed. This location should be defined in the path for\n    Ansible to search for collections. An example of this would be adding ``collections_paths = ./collections``\n    to your **ansible.cfg**\n\n### Running latest devel in EE\nWe also offer a new method of running the collection inside Ansible's Execution Environment container. \nThe advantage of such approach is that any required package dependencies and minimum supported pyton versions are \ninstalled in an isolated container which minimizes any environment related issues during runtime. More information on EE\ncan be found here [execenv]. Use the below requirements.yml file when building EE container:\n\n```yaml\n---\ncollections:\n  - name: ansible.netcommon\n    version: \"\u003e=2.0.0\"\n  - name: f5networks.f5_modules\n    source: https://github.com/F5Networks/f5-ansible-f5modules#ansible_collections/f5networks/f5_modules\n    type: git\n    version: devel\n```\n\nPlease see [f5execenv] documentation for further instructions how to use and build EE container with our devel branch.\n\n\n## Author Information\n\nF5 Networks\n[F5 Networks](http://www.f5.com)\n\n\n[repoinstall]: https://docs.ansible.com/ansible/latest/collections_guide/collections_installing.html#installing-a-collection-from-a-git-repository\n[dailybuild]: https://f5-ansible.s3.amazonaws.com/collections/f5networks-f5_modules-devel.tar.gz\n[execenv]: https://docs.ansible.com/automation-controller/latest/html/userguide/execution_environments.html\n[f5execenv]: https://clouddocs.f5.com/products/orchestration/ansible/devel/usage/exec-env.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff5networks%2Ff5-ansible-f5modules","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ff5networks%2Ff5-ansible-f5modules","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff5networks%2Ff5-ansible-f5modules/lists"}