{"id":18798714,"url":"https://github.com/f5networks/f5-ansible","last_synced_at":"2025-04-12T21:44:28.442Z","repository":{"id":280067290,"uuid":"46580696","full_name":"F5Networks/f5-ansible","owner":"F5Networks","description":"Imperative Ansible modules for F5 BIG-IP products","archived":false,"fork":false,"pushed_at":"2025-04-11T09:30:33.000Z","size":24264,"stargazers_count":25,"open_issues_count":63,"forks_count":2,"subscribers_count":16,"default_branch":"devel","last_synced_at":"2025-04-12T21:43:23.167Z","etag":null,"topics":["ansible","bigip","f5","f5networks"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/F5Networks.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"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":"2015-11-20T18:54:31.000Z","updated_at":"2025-04-11T09:30:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"7acdb928-f8e8-468d-ad18-c03be3157dca","html_url":"https://github.com/F5Networks/f5-ansible","commit_stats":null,"previous_names":["f5networks/f5-ansible"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-ansible","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-ansible/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-ansible/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-ansible/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/F5Networks","download_url":"https://codeload.github.com/F5Networks/f5-ansible/tar.gz/refs/heads/devel","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248637833,"owners_count":21137538,"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","bigip","f5","f5networks"],"created_at":"2024-11-07T22:12:43.586Z","updated_at":"2025-04-12T21:44:28.420Z","avatar_url":"https://github.com/F5Networks.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. raw:: html\n\n   \u003c!--\n   Copyright 2015-2019 F5 Networks Inc.\n\n   Licensed under the Apache License, Version 2.0 (the \"License\");\n   you may not use this file except in compliance with the License.\n   You may obtain a copy of the License at\n\n      http://www.apache.org/licenses/LICENSE-2.0\n\n   Unless required by applicable law or agreed to in writing, software\n   distributed under the License is distributed on an \"AS IS\" BASIS,\n   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n   See the License for the specific language governing permissions and\n   limitations under the License.\n   --\u003e\n\nF5 BIG-IP Imperative Collection for Ansible\n===========================================\n\n|travis badge| |shippable badge|\n\nImportant Warning\n-----------------\n\nDo not use Heroku App link for accessing F5 slack channel. It is not owned/maintained/used by F5 anymore.\nYou might be exposing yourself to security issues if you access this link thinking it to be the link to F5 slack channel. \n\nIntroduction\n------------\n\nThis repository is the source for F5 BIG-IP Imperative Collection for Ansible.\nThe architecture of the modules makes inherent use of the BIG-IP REST APIs as well as the tmsh API where required.\n\nThis repository is an **incubator** for Ansible imperative modules. The modules in this repository **may be\nbroken due to experimentation or refactoring**.\n\nThe F5 BIG-IP Modules for Ansible are freely provided to the open source community for automating BIG-IP device configurations.\n\nIf you want to download the stable modules, please install latest collection release found on galaxy: |f5_collection|.\n\n\nCollections Daily Build\n-----------------------\n\nWe offer a daily build of our most recent collection |dailybuild|. Please use this Collection to test the most\nrecent Ansible module updates between releases.\n\nInstalling the Daily Build\n~~~~~~~~~~~~~~~~~~~~~~~~~~\n.. code-block:: shell\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.. note::\n\n   \"-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\nRunning latest devel in EE\n~~~~~~~~~~~~~~~~~~~~~~~~~~\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 Python 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.. code-block:: yaml\n\n    collections:\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.. note::\n\n   When running the **bigip_device_certificate** module one might see errors related to establishing ssh connection,\n   one reason behind that could be ansible setting the ssh type to **libssh**, there are two ways to fix that,\n   first, set the environemnt variable ``ANSIBLE_NETWORK_CLI_SSH_TYPE=paramiko`` while running the playbook.\n   The second way is to add ``ssh_type = paramiko`` under section ``[persistent_connection]`` in **ansible.cfg**\n\nSupport\n-------\nF5 supports the F5 Imperative Collection for Ansible delivered in |ansible_galaxy|. Please refer to the |support_policy| for details.\n\n\nBugs, Issues\n------------\n\nPlease file any bugs, questions, or enhancement requests by using |ansible_issues|. For details, see |ansiblegethelp|.\n\n.. note:: **We no longer accept external code submissions.**\n\nDocumentation\n-------------\n\nAll documentation is available on |ansiblehelp|.\nChangelog information available on |changelog|.\n\nPython Version Change\n--------------------------\nCollection only supports python 3.6 and above, however F5 recommends Python 3.9 and above.\n\nYour ideas\n----------\n\nWhat types of modules do you want created? If you have a use case and can sufficiently describe the behavior you want to see, open an issue and we will hammer out the details.\n\nIf you've got the time, consider sending an email that introduces yourself and what you do. We love hearing about how you're using the F5 Modules for Ansible.\n\n.. note:: **We no longer accept external code submissions.**\n\n- Wojciech Wypior and the F5 team \n\nCopyright\n---------\n\nCopyright 2017-2023 F5 Networks Inc.\n\n\nLicense\n-------\n\nGPL V3\n~~~~~~\n\nThis License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work.\n\nSee `License`_.\n\n\n.. |travis badge| image:: https://travis-ci.com/F5Networks/f5-ansible.svg?branch=devel\n    :target: https://travis-ci.com/F5Networks/f5-ansible\n    :alt: Build Status\n\n.. |shippable badge| image:: https://api.shippable.com/projects/57c88ded5a5c0d0f0012c53e/badge?branch=devel\n    :target: https://app.shippable.com/github/F5Networks/f5-ansible\n    :alt: Shippable Status\n\n.. _License: https://github.com/F5Networks/f5-ansible/blob/devel/COPYING\n\n\n.. |dailybuild| raw:: html\n\n   \u003ca href=\"https://f5-ansible.s3.amazonaws.com/collections/f5networks-f5_modules-devel.tar.gz\" target=\"_blank\"\u003ehere\u003c/a\u003e\n\n.. |f5_collection| raw:: html\n\n   \u003ca href=\"https://galaxy.ansible.com/f5networks/f5_modules\" target=\"_blank\"\u003eF5 Ansible Modules Collection\u003c/a\u003e\n\n.. |ansible_galaxy| raw:: html\n\n   \u003ca href=\"https://galaxy.ansible.com/f5networks/f5_modules\" target=\"_blank\"\u003eAnsible Galaxy\u003c/a\u003e\n\n.. |support_policy| raw:: html\n\n   \u003ca href=\"https://f5.com/support/support-policies\" target=\"_blank\"\u003eF5 Ansible Support Policy\u003c/a\u003e\n\n.. |ansible_issues| raw:: html\n\n   \u003ca href=\"https://github.com/F5Networks/f5-ansible/issues\" target=\"_blank\"\u003eGithub Issues\u003c/a\u003e\n\n.. |ansiblehelp| raw:: html\n\n   \u003ca href=\"http://clouddocs.f5.com/products/orchestration/ansible/devel/\" target=\"_blank\"\u003eclouddocs.f5.com\u003c/a\u003e\n\n.. |ansibleguidelines| raw:: html\n\n   \u003ca href=\"http://clouddocs.f5.com/products/orchestration/ansible/devel/development/guidelines.html\" target=\"_blank\"\u003eGuidelines\u003c/a\u003e\n\n.. |ansiblegethelp| raw:: html\n\n   \u003ca href=\"http://clouddocs.f5.com/products/orchestration/ansible/devel/usage/support.html\" target=\"_blank\"\u003eGet Help\u003c/a\u003e\n\n.. |changelog| raw:: html\n\n   \u003ca href=\"https://github.com/F5Networks/f5-ansible/blob/devel/ansible_collections/f5networks/f5_modules/CHANGELOG.rst\" target=\"_blank\"\u003eChangelogs\u003c/a\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff5networks%2Ff5-ansible","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ff5networks%2Ff5-ansible","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff5networks%2Ff5-ansible/lists"}