feat: add coding projects role

Author: bruzina

README.md

@@ -9,6 +9,7 @@ This Ansible collection provides a set of roles designed for configuring Kubuntu
 | Role                                                                 | Description                                                                                                                                | Dependencies                   |
 | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------ |
 | [xebis.ansible.apt](roles/apt/README.md)                             | Deb package updates and upgrades using the apt package manager. Can optionally clean up unused packages and reboot the system if required. | `xebis.ansible.system`         |
+| [`xebis.ansible.coding_projects`](roles/coding_projects/README.md)   | Creates and clones coding projects to `~/Projects`                                                                                         | `xebis.ansible.apt`            |
 | [xebis.ansible.grub](roles/grub/README.md)                           | GRUB menu configuration.                                                                                                                   |                                |
 | `xebis.ansible.fail2ban`                                             | Fail2ban IPS                                                                                                                               | `xebis.ansible.apt`            |
 | `xebis.ansible.google_chrome`                                        | Google Chrome (Stable)                                                                                                                     | `xebis.ansible.apt`            |

roles/coding_projects/README.md

@@ -0,0 +1,29 @@
+# Xebis.Ansible.Coding_Projects
+
+Creates and clones coding projects to `~/Projects`.
+
+## Tasks
+
+- Installs `git`
+- Sets git user and email
+- Creates `~/Projects` directory and subdirectory for each _owner_
+- Adds GitHub.com fingerprints to SSH known hosts
+- Clones all repositories (only if not already cloned)
+
+Example play:
+
+```yaml
+---
+- hosts: all
+  roles:
+    - role: xebis.ansible.coding_projects
+      vars:
+        repositories:
+          - owner: xebis
+            name: ansible-collection
+```
+
+## Variables
+
+- `repositories` \[[{owner, name}, ...]]
+  - Repositories to clone. Owner and name have to be valid GitHub owner and repository and the repository has to be initialized.

roles/coding_projects/meta/main.yaml

@@ -0,0 +1,3 @@
+---
+dependencies:
+  - role: xebis.ansible.apt # Expects updated apt cache

roles/coding_projects/tasks/main.yaml

@@ -0,0 +1,52 @@
+---
+- name: Install git
+  become: true
+  ansible.builtin.apt:
+    name: git
+    state: latest
+
+- name: Set up git user name
+  community.general.git_config:
+    name: user.name
+    value: Martin Bruzina
+    scope: global
+    state: present
+
+- name: Set up git user email
+  community.general.git_config:
+    name: user.email
+    value: martin@bruzina.cz
+    scope: global
+    state: present
+
+- name: Create Projects directory
+  ansible.builtin.file:
+    path: "~/Projects"
+    state: directory
+    mode: '0755'
+
+- name: Create owner directory
+  ansible.builtin.file:
+    path: "~/Projects/{{ item.owner }}"
+    state: directory
+    mode: "0755"
+  loop: "{{ repositories }}"
+  loop_control:
+    label: "{{ item.owner }}/{{ item.name }}"
+
+- name: Add GitHub.com to known hosts
+  ansible.builtin.known_hosts:
+    name: github.com
+    key: "{{ lookup('pipe', 'ssh-keyscan github.com') }}"
+    hash_host: true
+    state: present
+
+- name: Clone repository (only if not already cloned)
+  ansible.builtin.git:
+    repo: "git@github.com:{{ item.owner }}/{{ item.name }}"
+    dest: "~/Projects/{{ item.owner }}/{{ item.name }}"
+    version: HEAD
+    update: no
+  loop: "{{ repositories }}"
+  loop_control:
+    label: "{{ item.owner }}/{{ item.name }}"

test.yaml

@@ -32,4 +32,19 @@
     - role: xebis.ansible.google_chrome
     - role: xebis.ansible.obsidian
     - role: xebis.ansible.openssh_client
+    - role: xebis.ansible.coding_projects
+      vars:
+        repositories:
+          - owner: xebis
+            name: .github
+          - owner: xebis
+            name: ansible-collection
+          - owner: xebis
+            name: github-actions-and-workflows
+          - owner: xebis
+            name: github-organization-as-code
+          - owner: xebis
+            name: hetzner-iac-cac
+          - owner: xebis
+            name: infra
     - role: xebis.ansible.visual_studio_code