commit a9e7f0f87d80acc30d3da8087ee430e15a28e06c Author: L3D Date: Thu Mar 30 00:01:15 2023 +0200 Initialize Collection diff --git a/.yamllint b/.yamllint new file mode 100644 index 0000000..e9713ae --- /dev/null +++ b/.yamllint @@ -0,0 +1,8 @@ +--- +extends: default + +rules: + # 170 chars should be enough, but don't fail if a line is longer + line-length: + max: 170 + level: warning diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..6421dd4 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2023 L3D + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..5c47743 --- /dev/null +++ b/README.md @@ -0,0 +1,42 @@ + Ansible Collection - l3d.git +============================ + +This is the Ansible Collection l3d.git. +Here are all our ansible roles for installing git server. + +## Roles in l3d.git +- [l3d.git.gitea](https://github.com/roles-ansible/ansible_role_gitea.git) - Ansible role to install gitea or forgejo git server + +## Using this Collection +You can install the collection using ansible-galaxy by running: +```bash +ansible-galaxy collection install l3d.git +``` + +Or you could clone this collection in your local ansible project as ``collections/ansible_collections/l3d/git/``. + +You can also list a collection in ``requirements.yml``: +```yaml +--- +collections: + - name: l3d.git +``` + +## 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' +```