This repository contains the ansible.scm Ansible Collection that allows you to manage Git repositories via Ansible.
This collection has been tested against following Ansible versions: >=2.15.0.
For collections that support Ansible 2.9, please ensure you update your network_os to use the
fully qualified collection name (for example, cisco.ios.ios).
Plugins and modules within a collection may be tested with only specific Ansible versions.
A collection may contain metadata that identifies these versions.
PEP440 is the schema used to describe the versions of Ansible.
Some modules and plugins require external libraries. Please check the requirements for each plugin or module you use in the documentation to find out which requirements are needed.
| Name | Description |
|---|---|
| ansible.scm.git_publish | Publish changes from a repository available on the execution node to a distant location |
| ansible.scm.git_retrieve | Retrieve a repository from a distant location and make it available on the execution node |
ansible-galaxy collection install ansible.scm
You can also include it in a requirements.yml file and install it via ansible-galaxy collection install -r requirements.yml using the format:
collections:
- name: ansible.scmTo upgrade the collection to the latest available version, run the following command:
ansible-galaxy collection install ansible.scm --upgradeYou 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:
ansible-galaxy collection install ansible.scm:==X.Y.ZSee Ansible Using collections for more details.
As a Red Hat Ansible Certified Content, this collection is entitled to support through Ansible Automation Platform (AAP).
If a support case cannot be opened with Red Hat and the collection has been obtained either from Galaxy or GitHub, there is community support available at no charge.
You can join us on #network:ansible.com room or the Ansible Forum Network Working Group.
GNU General Public License v3.0 or later.
See COPYING to see the full text.