feat(ansible): Ansible modules added.

Author: jcook3701

docs/jekyll/ansible-docs/ansible-autodoc.md

@@ -21,6 +21,36 @@ parent: jcook3701.homelab
 * `infrastructure` - 
 
 
+* `{{ autobuild.git_repo.tags }}` - 
+
+
+* `server` - 
+
+
+* `update-workstations` - 
+
+
+* `backup-workstations` - 
+
+
+* `backup-nas` - 
+
+
+* `create-cron` - 
+
+
+* `remove-cron` - 
+
+
+* `workstation` - 
+
+
+* `clear-logs` - 
+
+
+* `debug` - 
+
+
 
 Documentation generated using: [Ansible-autodoc](https://github.com/AndresBott/ansible-autodoc)
 

roles/autobuild/README.md

@@ -0,0 +1 @@
+# Autobuild

roles/autobuild/meta/main.yml

@@ -0,0 +1,32 @@
+# SPDX-FileCopyrightText: Copyright © 2026, Jared Cook
+# SPDX-License-Identifier: AGPL-3.0-or-later
+---
+galaxy_info:
+  author: Jared Cook
+  description: ""
+  # company: "Optional Company Name"
+
+  license: "AGPL-3.0-or-later"
+
+  min_ansible_version: ">=2.10"
+  role_name: autobuild
+
+  platforms:
+    - name: EL
+      versions:
+        - "8"
+        - "9"
+    - name: Debian
+      versions:
+        - all
+    - name: Ubuntu
+      versions:
+        - all
+
+  galaxy_tags:
+    - homelab
+    - desktop
+    - server
+    - apps
+
+dependencies: []

roles/autobuild/tasks/autovars/autobuild-variable-init.yml

@@ -0,0 +1,46 @@
+# SPDX-FileCopyrightText: Copyright © 2026, Jared Cook
+# SPDX-License-Identifier: AGPL-3.0-or-later
+---
+# Subroutine of pkg-source-build-init-routine
+# Purpose is to initialize all variables required to install a specific
+# package from source code.
+
+- name: Initialize autobuild variable
+  block:
+    - name: Create autobuild variable.
+      ansible.builtin.set_fact:
+        autobuild: null
+
+    - name: Set the local 'git_repo' variable within the autobuild variable
+      ansible.builtin.set_fact:
+        autobuild:
+          git_repo: "{{ git_repo }}"
+      when: git_repo is defined
+
+    - name: Set the local 'build' variable within the autobuild variable
+      ansible.builtin.set_fact:
+        autobuild: >-
+          {{ autobuild
+            | combine({'build': build})
+          }}
+      when: build is defined
+
+      # NOTE: This is commented because bashrc vars are being moved to build
+#    - name: set the local 'bashrc' variable within the autobuild variable
+#      ansible.builtin.set_fact:
+#        autobuild: >-
+#          {{ autobuild | combine({'bashrc': bashrc }) }}
+#      when: bashrc is defined
+
+    - name: Set the local 'pkgs' variable within the autobuild variable
+      ansible.builtin.set_fact:
+        autobuild: >-
+          {{ autobuild
+            | combine({'pkgs': pkgs})
+          }}
+      when: pkgs is defined
+
+    - name: Display Autobuild Variable after initialization
+      ansible.builtin.debug:
+        msg: "{{ autobuild }}"
+      when: autobuild is defined

roles/autobuild/tasks/autovars/bashrc-variable-init.yml

@@ -0,0 +1,45 @@
+# SPDX-FileCopyrightText: Copyright © 2026, Jared Cook
+# SPDX-License-Identifier: AGPL-3.0-or-later
+---
+- name: Collect running user facts
+  when: sudo_user is not defined
+  ansible.builtin.include_tasks: utilities/sudo_user_facts.yml
+
+# TODO: When autobuild.build.prefix need to update autobuild.bashrc.marker to include install path
+
+- name: Initialize bashrc variables
+  block:
+    - name: set base bashrc export type fact
+      when: autobuild.build.type is defined
+      ansible.builtin.set_fact:
+        bashrc_export: >-
+          {{ bash_export_types[autobuild.build.type] }}
+
+    - name: set bashrc block for lib or bin prefix
+      when: bashrc_export is defined
+      ansible.builtin.set_fact:
+        bashrc_block: >-
+          {{ ['export', ' ', bashrc_export, '=', autobuild.build.full_install_path, '$', bashrc_export]
+            | join('')
+          }}
+
+    - name: set base bashrc facts
+      ansible.builtin.set_fact:
+        bashrc:
+          name: "{{ autobuild.git_repo.name }}"
+          marker: "# {mark} Ansible - {{ autobuild.git_repo.name }}"
+          block: "{{ lookup('template', 'utilities/bashrc-block.j2') }}"
+
+    - name: View .bashrc settings
+      ansible.builtin.debug:
+        msg: >-
+          {{ bashrc }}
+
+    - name: Set bashrc block  build with prefix defined
+      ansible.builtin.set_fact:
+        autobuild: >-
+          {{ autobuild
+            | combine({'bashrc': bashrc })
+          }}
+
+#  when: autobuild.build.bashrc is not defined and autobuild.build.prefix is defined

roles/autobuild/tasks/autovars/checkinstall-variable-init.yml

@@ -0,0 +1,51 @@
+# SPDX-FileCopyrightText: Copyright © 2026, Jared Cook
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+# Subroutine of pkg-source-build-routine
+
+# @param item?: {raw_tag: string, project: string, major: string, minor: string, patch: string}
+---
+- name: Collect running user facts
+  ansible.builtin.include_tasks: utilities/sudo_user_facts.yml
+  when: sudo_user is not defined
+
+- name: Initialize checkinstall variables
+  when: item is defined and autobuild is defined
+  block:
+    - name: Package Version
+      ansible.builtin.set_fact:
+        pkgversion: >-
+          {{ [item.major, item.minor, item.patch] | select('defined') | join('.') }}
+
+    - name: Package Name
+      ansible.builtin.set_fact:
+        pkgname: >-
+          {{ autobuild.git_repo.name }}-{{ pkgversion }}
+
+    - name: View Package Version
+      ansible.builtin.debug:
+        msg: >-
+          {{ pkgversion }}
+
+    - name: Set pkgsource
+      ansible.builtin.set_fact:
+        pkgsource: >-
+          {{ autobuild.git_repo.directory }}
+      when: autobuild.build.script == "make"
+
+    - name: Set pkgsource
+      ansible.builtin.set_fact:
+        pkgsource: >-
+          {{ autobuild.git_repo.directory }}/build
+      when: autobuild.build.script == "cmake" or autobuild.build.script == "meson-ninja"
+
+    - name: Checkinstall Settings Generation
+      ansible.builtin.set_fact:
+        checkinstall:
+          pkgname: "{{ pkgname }}"
+          pkgrelease: "{{ item.major if item.major is defined else omit }}"
+          pkgversion: "{{ pkgversion }}"
+          pkgsource: "{{ pkgsource }}"
+          provides: "{{ pkgname }}"
+          maintainer: "{{ sudo_user }}@"
+          pakdir: "{{ sudo_user_home }}/{{ build_paths.pkg_store }}"

roles/autobuild/tasks/autovars/update-alternatives-variable-init.yml

@@ -0,0 +1,49 @@
+# SPDX-FileCopyrightText: Copyright © 2026, Jared Cook
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+# Subroutine of pkg-source-build-routine
+# Purpose is to Generate 'update-alternatives' variable used in update-alternatives.yml
+
+# @param item?: {raw_tag: string, project: string, major: string, minor: string, patch: string}
+---
+- name: Collect running user facts
+  ansible.builtin.include_tasks: utilities/sudo_user_facts.yml
+  when: sudo_user is not defined
+
+- name: Initialize update-alternatives variables
+  when: item is defined and autobuild is defined
+  block:
+
+    - name: Generate empty update-alternatives variable
+      ansible.builtin.set_fact:
+        update_alternatives: null
+
+    - name: Update update-alternatives variable with link
+      ansible.builtin.set_fact:
+        update_alternatives: >-
+          {{ update_alternatives
+            | combine({'link': ( '/usr/bin/', git_repo.name ) | path_join})
+          }}
+
+    - name: Update update-alternatives variable with name
+      ansible.builtin.set_fact:
+        update_alternatives: >-
+          {{ update_alternatives
+            | combine({'name': git_repo.name})
+          }}
+
+      # TODO: Finish this so it isn't using checkinstall variable
+    - name: Update update-alternatives variable with with installation path
+      ansible.builtin.set_fact:
+        update_alternatives: >-
+          {{ update_alternatives
+            | combine({'path': ( build_paths.install_path, autobuild.git_repo.name, pkgname ) | path_join})
+          }}
+
+
+    - name: Display 'update_alternatives' variable after initialization
+      ansible.builtin.debug:
+        msg: "{{ update_alternatives }}"
+      when: update_alternatives is defined
+
+    # TODO: Maybe set option for priority otherwise it is always going to default back to 50.

roles/autobuild/tasks/build-tools/cmake-build.yml

@@ -0,0 +1,33 @@
+# SPDX-FileCopyrightText: Copyright © 2026, Jared Cook
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+# This is a subroutine of pkg-source-build-routine
+---
+- name: Collect running user facts
+  ansible.builtin.include_tasks: utilities/sudo_user_facts.yml
+  when: sudo_user is not defined
+
+- name: Source Build of {{ autobuild.git_repo.name }} using Cmake
+  when: autobuild.git_repo is defined and autobuild.git_repo.directory is defined
+  become: true
+  become_user: "{{ sudo_user }}"
+  block:
+    #  - name: Create a build directory
+    #    ansible.builtin.file:
+    #      path: "{{ project_build_dir }}/build"
+    #      state: directory
+
+    - name: Configure build for {{ autobuild.git_repo.name }} with Cmake
+      ansible.builtin.shell:
+        cmd: |
+          "cmake ..
+          -DCMAKE_BUILD_TYPE=Release
+          -DCMAKE_INSTALL_PREFIX={{ autobuild.build.full_install_path }} > ansible-cmake.log
+        executable: /bin/bash
+        chdir: "{{ autobuild.git_repo.directory }}/build"
+
+    - name: Build {{ autobuild.git_repo.name }} with Make
+      ansible.builtin.shell: make > ansible-make.log
+      args:
+        executable: /bin/bash
+        chdir: "{{ autobuild.git_repo.directory }}/build"

roles/autobuild/tasks/build-tools/make-build.yml

@@ -0,0 +1,81 @@
+# SPDX-FileCopyrightText: Copyright © 2026, Jared Cook
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+# This is a subroutine of pkg-source-build-routine
+---
+- name: Collect running user facts
+  ansible.builtin.include_tasks: utilities/sudo_user_facts.yml
+  when: sudo_user is not defined
+
+- name: Build {{ autobuild.git_repo.name }} from source using Make
+  become: true
+  become_user: "{{ sudo_user }}"
+  when: autobuild.git_repo is defined and autobuild.git_repo.directory is defined
+  block:
+    - name: Clean {{ autobuild.git_repo.name }} with Make to ensure clean build
+      ansible.builtin.command: make clean
+      args:
+        chdir: "{{ autobuild.git_repo.directory }}"
+      become: true
+      become_user: root
+
+    - name: Check if Autogen configure script exists
+      ansible.builtin.stat:
+        path: "{{ autobuild.git_repo.directory }}/configure"
+      register: configure_check
+
+    - name: Make Configuration if using autogen
+      when: configure_check.stat.exists
+      block:
+        # TODO: This same step will need to be added to cmake
+        # NOTE: Assumed that this path is /opt/**
+        - name: Ensure Installation Path exists
+          ansible.builtin.file:
+            path: "{{ autobuild.build.full_install_path }}"
+            state: directory
+            owner: root
+            group: root
+            mode: "0755"
+          become: true
+          become_user: root
+          when: autobuild.build.full_install_path is defined
+
+        - name: Build Prefix Settings Generation
+          ansible.builtin.set_fact:
+            autobuild: >-
+              {{ autobuild
+                | combine({'build': autobuild.build
+                  | combine({'prefix': ('--prefix=', autobuild.build.full_install_path) | join('')})
+                })
+              }}
+
+        - name: View Build Variables
+          ansible.builtin.debug:
+            msg: "{{ autobuild.build }}"
+
+        - name: build configure
+          ansible.builtin.set_fact:
+            configure: >-
+              {{ ['./configure', autobuild.build.prefix, autobuild.build.flags] | select('defined') | join(' ') }}
+
+        - name: View Build Variables
+          ansible.builtin.debug:
+            msg: "{{ configure }}"
+
+        - name: Run ./autogen.sh for autogen project {{ autobuild.git_repo.name }}
+          ansible.builtin.shell: autogen.sh > ansible-autogen.log
+          args:
+            executable: /bin/bash
+            chdir: "{{ autobuild.git_repo.directory }}"
+
+        - name: Run ./configure for autogen project {{ autobuild.git_repo.name }}
+          ansible.builtin.shell: "{{ configure }} > ansible-configure.log"
+          args:
+            executable: /bin/bash
+            chdir: "{{ autobuild.git_repo.directory }}"
+
+    - name: Build {{ autobuild.git_repo.name }} with Make
+      ansible.builtin.shell: make > ansible-make.log
+      args:
+        executable: /bin/bash
+        chdir: "{{ autobuild.git_repo.directory }}"