https://github.com/josef-friedrich/ansible-module-gitupdater

Ansible module for the git-repo-updater (gitup).
https://github.com/josef-friedrich/ansible-module-gitupdater

ansible ansible-modules

Last synced: 5 months ago
JSON representation

Ansible module for the git-repo-updater (gitup).

• Host: GitHub
• URL: https://github.com/josef-friedrich/ansible-module-gitupdater
• Owner: Josef-Friedrich
• License: gpl-3.0
• Created: 2017-05-28T06:46:00.000Z (about 9 years ago)
• Default Branch: main
• Last Pushed: 2025-01-07T18:52:55.000Z (over 1 year ago)
• Last Synced: 2025-08-23T09:08:59.585Z (11 months ago)
• Topics: ansible, ansible-modules
• Language: Python
• Homepage: https://github.com/earwig/git-repo-updater
• Size: 228 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
.. image:: https://github.com/Josef-Friedrich/ansible-module-gitupdater/actions/workflows/tests.yml/badge.svg

    :target: https://github.com/Josef-Friedrich/ansible-module-gitupdater/actions/workflows/tests.yml

    :alt: Tests

ansible-module-gitupdater

=========================

Ansible module for the `git-repo-updater `__ (gitup).

:: 

    > MODULE gitupdater (/etc/ansible/library/gitupdater.py)

      gitup https://github.com/earwig/git-repo-updater is a console script

      that allows you to easily update multiple git repositories at once.

    OPTIONS (red indicates it is required):

       cleanup  Clean up the repositories that have been deleted.

            default: false

       path    Full path to the git repository.

            default: false

       state   State of the gitup configuration for this repository. The

               git repository itself is not affected.

            choices: [present, absent]

            default: present

    REQUIREMENTS:  git-repo-updater

    AUTHOR: Josef Friedrich (@Josef-Friedrich)

    METADATA:           metadata_version: '1.0'

              status:

              - preview

              supported_by: community

    EXAMPLES:

    # Bookmark a repository, state can be omitted

    - gitupdater:

        path: /var/repos/project

    # Bookmark a repository

    - gitupdater:

        path: /var/repos/project

        state: present

    # Delete bookmark

    - gitupdater:

        path: /var/repos/project

        state: absent

    # Delete non-existent repositories

    - gitupdater:

        cleanup: true

    RETURN VALUES:

       path    Full path to the git repository

            returned: always

            sample: /path/to/repository

            type: string

       state   State of the gitup configuration for this repository

            returned: always

            sample: present

            type: string

Development

===========

Test functionality

------------------

::

   /usr/local/src/ansible/hacking/test-module -m gitupdater.py -a

Test documentation

------------------

::

   source /usr/local/src/ansible/hacking/env-setup

   /usr/local/src/ansible/test/sanity/validate-modules/validate-modules --arg-spec --warnings gitupdater.py

Generate documentation

----------------------

::

   ansible-doc -M . gitupdater