git
Ansible role git
Install and configure git on your system.
GitHub | Version | Issues | Pull Requests | Downloads |
---|---|---|---|---|
Example Playbook
This example is taken from molecule/default/converge.yml
and is tested on each push, pull request and release.
---
- name: Converge
hosts: all
become: true
gather_facts: true
vars:
git_username: root
git_groupname: root
git_repository_destination: /root
git_repositories:
- repo: https://github.com/buluma/buluma.bootstrap
dest: bootstrap
- repo: https://github.com/buluma/buluma.bootstrap
dest: bootstrap-force
force: true
- repo: https://github.com/buluma/buluma.bootstrap
dest: bootstrap-version
version: "v2.0.0"
pre_tasks:
- name: Update apt cache.
apt: update_cache=true cache_valid_time=600
when: ansible_os_family == 'Debian'
roles:
- role: buluma.git
The machine needs to be prepared. In CI this is done using molecule/default/prepare.yml
:
---
- name: Prepare
hosts: all
gather_facts: false
become: true
serial: 30%
roles:
- role: buluma.bootstrap
Also see a full explanation and example on how to use these roles.
Role Variables
The default values for the variables are set in defaults/main.yml
:
---
# defaults file for git
# The system username in /home where to place the gitconfig file.
# git_username: johndoe
# The group to own directories.
# git_groupname: "{{ git_username }}"
# Settings for git configuration.
# git_user_email: [email protected]
# git_user_name: John Doe
# Where to place the copies of the repositories.
git_repository_destination: /home/{{ git_username | default('unset') }}/Documents/github.com/{{ git_username | default('unset') }}
# Should git force (overwrite locally changed) clone? (Can also be controlled
# per repository, see below.
git_force: false
# The repositories to check out, bootstrap is pinned to a version, java will get HEAD/latest.
# git_repositories:
# - repo: https://github.com/robertdebock/ansible-role-bootstrap.git
# dest: bootstrap
# version: "2.2.4"
# - repo: ssh://[email protected]/robertdebock/ansible-role-java.git
# dest: java
# - repo: ssh://[email protected]/robertdebock/ansible-role-tomcat.git
# dest: tomcat
# force: true
Requirements
- pip packages listed in requirements.txt.
State of used roles
The following roles are used to prepare a system. You can prepare your system in another way.
Requirement | GitHub | Version |
---|---|---|
buluma.bootstrap |
Context
This role is a part of many compatible roles. Have a look at the documentation of these roles for further information.
Here is an overview of related roles:
Compatibility
This role has been tested on these container images:
container | tags |
---|---|
Alpine | all |
Amazon | Candidate |
EL | 8 |
Debian | all |
Fedora | all |
opensuse | all |
Ubuntu | all |
The minimum version of Ansible required is 2.12, tests have been done to:
- The previous version.
- The current version.
- The development version.
If you find issues, please register them in GitHub
Changelog
License
Author Information
ansible-galaxy install buluma/ansible-role-git