1
0
Fork 0
mirror of https://github.com/roles-ansible/ansible_collection_git.git synced 2024-09-14 20:12:03 +02:00
Find a file
L3D d4510721d9
Merge pull request #34 from roles-ansible/u
adding local user support in gitea/forgejo
2024-03-26 18:33:59 +01:00
.github Merge pull request #30 from roles-ansible/dependabot/github_actions/ansible-actions/ansible-lint-action-1.0.3 2024-03-22 11:25:48 +01:00
meta Integrate gitea role 2023-03-31 13:45:14 +02:00
roles adding local user support in gitea/forgejo 2024-03-26 18:31:57 +01:00
.gitmodules Create forgejo runner 2024-03-21 17:12:54 +01:00
.yamllint Initialize Collection 2023-03-31 13:32:54 +02:00
changelog Integrate gitea role 2023-03-31 13:45:14 +02:00
CHANGELOG.md Integrate gitea role 2023-03-31 13:45:14 +02:00
CHANGELOG.rst Integrate gitea role 2023-03-31 13:45:14 +02:00
galaxy.yml adding local user support in gitea/forgejo 2024-03-26 18:31:57 +01:00
LICENSE Initialize Collection 2023-03-31 13:32:54 +02:00
README.md adding local user support in gitea/forgejo 2024-03-26 18:31:57 +01:00
requirements.txt Improve gitea gpg permissions and requirements 2023-05-15 16:18:32 +02:00
requirements.yml Update community.general requirement 2024-02-13 19:55:06 +01:00

collection l3d.git Maintainance 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

  • l3d.git.gitea - Ansible role to install gitea or forgejo git server
  • l3d.git.forgejo_runner - Ansible role to install forgejo runner

Using this Collection

You can install the collection using ansible-galaxy by running:

ansible-galaxy collection install l3d.git:1.1.2

Remember you can to Upgrade to the latest version of the l3d.git collection using the --upgrade parameter:

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 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

# optionally install all requirements
ansible-galaxy collection install -r requirements.yml --upgrade

You can also list a collection in requirements.yml:

---
collections:
  - name: l3d.git
    version: ">=1.1.2"

Include roles in your playbook

Example Playbook using the l3d.git.gitea role:

---
- 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 Requirements Installation:

# galaxy requirements
ansible-galaxy collection install -r requirements.yml --upgrade

# pip requirements
pip install -r requirements.txt