https://github.com/roles-ansible/ansible_collection_git
Ansible Collection l3d.git for installing git server
https://github.com/roles-ansible/ansible_collection_git
ansible collection hacktoberfest
Last synced: over 1 year ago
JSON representation
Ansible Collection l3d.git for installing git server
- Host: GitHub
- URL: https://github.com/roles-ansible/ansible_collection_git
- Owner: roles-ansible
- License: mit
- Created: 2023-03-31T11:46:44.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-01-18T23:16:16.000Z (over 1 year ago)
- Last Synced: 2025-01-26T09:44:19.551Z (over 1 year ago)
- Topics: ansible, collection, hacktoberfest
- Homepage: https://galaxy.ansible.com/l3d/git
- Size: 119 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://galaxy.ansible.com/ui/repo/published/l3d/git/)
[](https://ansible.l3d.space/#l3d.git)
[](LICENSE)
Ansible Collection - l3d.git
============================
This is the Ansible Collection ``l3d.git``.
Here are all our ansible roles for installing git server.
## Ansible Roles in l3d.git
- [](https://github.com/roles-ansible/ansible_role_gitea.git) - Ansible role to install gitea or forgejo git server
- [](https://github.com/roles-ansible/ansible_role_forgeo_runner.git) - Ansible role to install forgejo runner
## Using this Collection
You can install the collection using ansible-galaxy by running:
```bash
ansible-galaxy collection install l3d.git:1.1.10
```
Remember you can to Upgrade to the latest version of the l3d.git collection using the ``--upgrade`` parameter:
```bash
ansible-galaxy collection install l3d.git --upgrade
```
Or you could clone this collection in your local ansible project for example to ``collections/ansible_collections/l3d/git/``. Make sure you checkout [git submodules](https://git-scm.com/docs/git-submodule) too. Example:
```
# Clone git Repo with submodules to specified path
git clone --recursive https://github.com/roles-ansible/ansible_collection_git.git collections/ansible_collections/l3d/git/
# change directory
cd collections/ansible_collections/l3d/git/
# optionally init git submodules
git submodule update --init --recursive
```
You can also list a collection in ``requirements.yml``:
```yaml
---
collections:
- name: l3d.git
version: ">=1.1.10"
```
## Include roles in your playbook
Example Playbook using the l3d.git.gitea role:
```yaml
---
- name: "Install forgejo git server from collection l3d.git"
hosts: git.example.com
roles:
- {role: l3d.git.gitea, tags: forgejo}
vars:
# Here we assume we are behind a reverse proxy that will
# handle https for us, so we bind on localhost:3000 using HTTP
# see https://docs.gitea.io/en-us/reverse-proxies/#nginx
gitea_fqdn: 'git.example.com'
gitea_root_url: 'https://git.example.com'
gitea_protocol: http
gitea_start_ssh: true
gitea_fork: 'forgejo'
```
## Requirements
The roles in this collection using the ``ansible.builtin`` and ``community.general`` ansible Collections. To download the latest forgejo/gitea release we use json_query. This requires ``jmespath`` to be available.
### Example Python Requirements Installation:
```bash
# pip requirements
pip install -r requirements.txt
```