Build Windows Templates in RHV

roles/systemli.apt_repositories/README.md

@@ -0,0 +1,107 @@
+apt_repositories
+================
+
+[![Build Status](https://github.com/systemli/ansible-role-apt_repositories/workflows/Integration/badge.svg?branch=master)](https://github.com/systemli/ansible-role-apt_repositories/actions?query=workflow%3AIntegration)
+
+Add third-party repositories in Debian and derivates and pin their packages.
+Follows guide from [Debian wiki](https://wiki.debian.org/DebianRepository/UseThirdParty).
+
+It defaults to deb822, but also allows single line style ([manpage](https://manpages.debian.org/buster/apt/sources.list.5.en.html#THE_DEB_AND_DEB-SRC_TYPES:_GENERAL_FORMAT)).
+
+Requirements
+------------
+
+Debian 9+ or Ubuntu 18.04+. Other versions of Debian/Ubuntu might be supported as well, but aren't tested.
+
+Role Variables
+--------------
+
+```
+apt_repositories:
+  - url: https://...
+    key: |
+      -----BEGIN PGP PUBLIC KEY BLOCK-----
+      MY_ARMORED_KEY
+      ...
+```
+
+Further possible variables (and their defaults) are:
+
+```
+apt_repositories:
+  - url: https://...
+    name: "{{ item.url|urlsplit('hostname') }}"
+    types: deb
+    suites: "{{ ansible_distribution_release }}"
+    components: main
+    packages: []
+    key_path: # a file path in the role `files` dir instead of `key`
+```
+
+Furthermore, it supports `preset` values. For an example see `vars/gitlab.yml`.
+Presets can be partially overridden.
+
+Current presets:
+
+  - gitlab
+  - grafana
+  - jitsi
+  - kubic
+  - prosody
+  - sury
+
+PRs welcome!
+
+Example Playbook
+----------------
+
+```
+- hosts: server
+  roles:
+    - systemli.apt_repositories
+  vars:
+    apt_repositories:
+      - name: packages.gitlab.com
+        url: https://packages.gitlab.com/gitlab/gitlab-ce/debian/
+        key: "{{ gitlab_ce_key }}"
+        packages:
+          - gitlab-ce
+```
+
+or
+
+```
+- hosts: server
+  roles:
+    - systemli.apt_repositories
+  vars:
+    apt_repositories:
+      - preset: gitlab
+```
+
+or just add it as a dependency for `ansible-galaxy`:
+
+```
+# meta/main.yml
+...
+dependencies:
+  - role: systemli.apt_repositories
+    vars:
+      apt_repositories:
+        - name: download.jitsi.org
+          url: https://download.jitsi.org/
+          key_path: jitsi-archive-keyring.gpg
+          suites: stable/
+          components: ''
+          packages: "{{ jitsi_meet_packages }}"
+```
+
+License
+-------
+
+GPLv3
+
+Author Information
+------------------
+
+systemli.org