mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2025-07-17 22:14:25 +02:00
Another big round of refactoring and cleaning...
This commit is contained in:
parent
aa61bf2a44
commit
168c5c0da6
@ -12,10 +12,10 @@ CyMaIS covers everything from essential system setups to advanced configurations
|
|||||||
Every business is unique, and so is CyMaIS! With a modular architecture, it adapts to specific requirements, whether for startups, growing businesses, NGOs, or large enterprises.
|
Every business is unique, and so is CyMaIS! With a modular architecture, it adapts to specific requirements, whether for startups, growing businesses, NGOs, or large enterprises.
|
||||||
|
|
||||||
## Proactive Monitoring & Maintenance 🔍
|
## Proactive Monitoring & Maintenance 🔍
|
||||||
With automated updates, system health checks, and security audits, CyMaIS ensures your infrastructure is always up-to-date and running smoothly. Roles such as `mon-bot-docker-container`, `mon-bot-btrfs`, and `mon-bot-webserver` help monitor system integrity.
|
With automated updates, system health checks, and security audits, CyMaIS ensures your infrastructure is always up-to-date and running smoothly. Roles such as `sys-hlth-docker-container`, `sys-hlth-btrfs`, and `sys-hlth-webserver` help monitor system integrity.
|
||||||
|
|
||||||
## Uncompromised Security 🔒
|
## Uncompromised Security 🔒
|
||||||
Security is a top priority! CyMaIS includes robust security features like full-disk encryption recommendations, 2FA enforcement, encrypted server deployments (`web-app-keycloak`, `svc-openldap`), and secure backup solutions (`bkp-remote-to-local`, `bkp-data-to-usb`).
|
Security is a top priority! CyMaIS includes robust security features like full-disk encryption recommendations, 2FA enforcement, encrypted server deployments (`web-app-keycloak`, `svc-openldap`), and secure backup solutions (`sys-bkp-remote-to-local`, `svc-sys-bkp-data-to-usb`).
|
||||||
|
|
||||||
## User-Friendly with Expert Support 👩💻
|
## User-Friendly with Expert Support 👩💻
|
||||||
No need to be a Linux or Docker expert! CyMaIS simplifies deployment with intuitive role-based automation. Documentation and community support make IT administration accessible to all experience levels.
|
No need to be a Linux or Docker expert! CyMaIS simplifies deployment with intuitive role-based automation. Documentation and community support make IT administration accessible to all experience levels.
|
||||||
|
@ -10,13 +10,13 @@ Follow these guides to install and configure CyMaIS:
|
|||||||
|
|
||||||
## Key Responsibilities 🔧
|
## Key Responsibilities 🔧
|
||||||
- **User Management** - Configure LDAP, Keycloak, and user permissions.
|
- **User Management** - Configure LDAP, Keycloak, and user permissions.
|
||||||
- **Security & Backups** - Set up `bkp-remote-to-local`, `bkp-data-to-usb`, and `core-security` roles.
|
- **Security & Backups** - Set up `sys-bkp-remote-to-local`, `svc-sys-bkp-data-to-usb`, and `core-security` roles.
|
||||||
- **Application Hosting** - Deploy services like `Nextcloud`, `Matrix`, `Gitea`, and more.
|
- **Application Hosting** - Deploy services like `Nextcloud`, `Matrix`, `Gitea`, and more.
|
||||||
- **Networking & VPN** - Configure `WireGuard`, `OpenVPN`, and `Nginx Reverse Proxy`.
|
- **Networking & VPN** - Configure `WireGuard`, `OpenVPN`, and `Nginx Reverse Proxy`.
|
||||||
|
|
||||||
## Managing & Updating CyMaIS 🔄
|
## Managing & Updating CyMaIS 🔄
|
||||||
- Regularly update services using `update-docker`, `update-pacman`, or `update-apt`.
|
- Regularly update services using `update-docker`, `update-pacman`, or `update-apt`.
|
||||||
- Monitor system health with `mon-bot-btrfs`, `mon-bot-webserver`, and `mon-bot-docker-container`.
|
- Monitor system health with `sys-hlth-btrfs`, `sys-hlth-webserver`, and `sys-hlth-docker-container`.
|
||||||
- Automate system maintenance with `maint-lock`, `cln-backups-service`, and `maint-docker-restart`.
|
- Automate system maintenance with `sys-lock`, `sys-cln-bkps-service`, and `sys-rpr-docker-hard`.
|
||||||
|
|
||||||
For more details, refer to the specific guides above.
|
For more details, refer to the specific guides above.
|
@ -13,23 +13,23 @@ system_maintenance_lock_timeout_restart_docker: "{{system_maintenance_lock_ti
|
|||||||
|
|
||||||
### Defined Services for Backup Tasks
|
### Defined Services for Backup Tasks
|
||||||
system_maintenance_backup_services:
|
system_maintenance_backup_services:
|
||||||
- "bkp-docker-to-local"
|
- "sys-bkp-docker-to-local"
|
||||||
- "bkp-remote-to-local"
|
- "svc-sys-bkp-rmt-2-loc"
|
||||||
- "bkp-data-to-usb"
|
- "svc-sys-bkp-data-to-usb"
|
||||||
- "bkp-docker-to-local-everything"
|
- "sys-bkp-docker-to-local-everything"
|
||||||
|
|
||||||
### Defined Services for System Cleanup
|
### Defined Services for System Cleanup
|
||||||
system_maintenance_cleanup_services:
|
system_maintenance_cleanup_services:
|
||||||
- "cln-backups"
|
- "sys-cln-backups"
|
||||||
- "cln-disc-space"
|
- "sys-cln-disc-space"
|
||||||
- "cln-failed-docker-backups"
|
- "sys-cln-faild-bkps"
|
||||||
|
|
||||||
### Services that Manipulate the System
|
### Services that Manipulate the System
|
||||||
system_maintenance_manipulation_services:
|
system_maintenance_manipulation_services:
|
||||||
- "maint-docker-heal"
|
- "sys-rpr-docker-soft"
|
||||||
- "update-docker"
|
- "update-docker"
|
||||||
- "cln-docker-storage-optimizer"
|
- "sys-opt-ssd-hdd"
|
||||||
- "maint-docker-restart"
|
- "sys-rpr-docker-hard"
|
||||||
|
|
||||||
## Total System Maintenance Services
|
## Total System Maintenance Services
|
||||||
system_maintenance_services: "{{ system_maintenance_backup_services + system_maintenance_cleanup_services + system_maintenance_manipulation_services }}"
|
system_maintenance_services: "{{ system_maintenance_backup_services + system_maintenance_cleanup_services + system_maintenance_manipulation_services }}"
|
||||||
|
@ -3,4 +3,4 @@
|
|||||||
path_administrator_home: "/home/administrator/"
|
path_administrator_home: "/home/administrator/"
|
||||||
path_administrator_scripts: "/opt/scripts/"
|
path_administrator_scripts: "/opt/scripts/"
|
||||||
path_docker_compose_instances: "/opt/docker/"
|
path_docker_compose_instances: "/opt/docker/"
|
||||||
path_system_lock_script: "/opt/scripts/maint-lock.py"
|
path_system_lock_script: "/opt/scripts/sys-lock.py"
|
@ -15,7 +15,7 @@ For a complete list of role categories and detailed definitions, see:
|
|||||||
Fundamental system configuration (SSH, journald, sudo, etc.)
|
Fundamental system configuration (SSH, journald, sudo, etc.)
|
||||||
|
|
||||||
- **gen-***
|
- **gen-***
|
||||||
Generic helpers and language/tool installers (e.g. `gen-git`, `gen-locales`, `gen-timer`)
|
Generic helpers and language/tool installers (e.g. `gen-git`, `gen-locales`, `sys-timer`)
|
||||||
|
|
||||||
- **desk-***
|
- **desk-***
|
||||||
Desktop environment and application roles (e.g. `desk-gnome`, `desk-browser`, `desk-libreoffice`)
|
Desktop environment and application roles (e.g. `desk-gnome`, `desk-browser`, `desk-libreoffice`)
|
||||||
@ -59,13 +59,13 @@ For a complete list of role categories and detailed definitions, see:
|
|||||||
|
|
||||||
## Monitoring & Alerting
|
## Monitoring & Alerting
|
||||||
|
|
||||||
- **mon-bot-***
|
- **sys-hlth-***
|
||||||
“Bot”-style health checks (Btrfs, disk‐space, Docker, journalctl, CSP crawler, webserver) with alerts.
|
“Bot”-style health checks (Btrfs, disk‐space, Docker, journalctl, CSP crawler, webserver) with alerts.
|
||||||
|
|
||||||
- **monitor-core-***
|
- **monitor-core-***
|
||||||
Low-level system monitors (journalctl, Docker containers, disk space, etc.)
|
Low-level system monitors (journalctl, Docker containers, disk space, etc.)
|
||||||
|
|
||||||
- **alert-***
|
- **sys-alm-***
|
||||||
Notification handlers for failures (core, email, Telegram).
|
Notification handlers for failures (core, email, Telegram).
|
||||||
|
|
||||||
---
|
---
|
||||||
@ -78,14 +78,14 @@ For a complete list of role categories and detailed definitions, see:
|
|||||||
- **maint-docker-***
|
- **maint-docker-***
|
||||||
Automated recovery and restarts for Docker Compose workloads.
|
Automated recovery and restarts for Docker Compose workloads.
|
||||||
|
|
||||||
- **cln-***
|
- **sys-cln-***
|
||||||
Housekeeping tasks (old backups, expired certs, log rotation).
|
Housekeeping tasks (old backups, expired certs, log rotation).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Backup & Restore
|
## Backup & Restore
|
||||||
|
|
||||||
- **bkp-***
|
- **sys-bkp-***
|
||||||
Local and remote backup strategies for files, Docker volumes, databases.
|
Local and remote backup strategies for files, Docker volumes, databases.
|
||||||
|
|
||||||
---
|
---
|
||||||
@ -112,8 +112,8 @@ For a complete list of role categories and detailed definitions, see:
|
|||||||
|
|
||||||
> **Tip:** To find a role quickly, search for its prefix:
|
> **Tip:** To find a role quickly, search for its prefix:
|
||||||
> `core-`, `gen-`, `desk-`, `srv-web-`, `web-svc-`, `web-app-`,
|
> `core-`, `gen-`, `desk-`, `srv-web-`, `web-svc-`, `web-app-`,
|
||||||
> `net-`, `svc-`, `mon-bot-`, `monitor-core-`, `alert-`,
|
> `net-`, `svc-`, `sys-hlth-`, `monitor-core-`, `sys-alm-`,
|
||||||
> `maint-`, `maint-docker-`, `cln-`, `bkp-`, `update-`,
|
> `maint-`, `maint-docker-`, `sys-cln-`, `sys-bkp-`, `update-`,
|
||||||
> `pkgmgr-`, `user-`.
|
> `pkgmgr-`, `user-`.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
@ -1,8 +0,0 @@
|
|||||||
[Unit]
|
|
||||||
Description=Notifier for %i
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=oneshot
|
|
||||||
ExecStart=/usr/bin/systemctl start alert-telegram.cymais@%i.service alert-email.cymais@%i.service
|
|
||||||
User=root
|
|
||||||
Group=systemd-journal
|
|
@ -1,4 +0,0 @@
|
|||||||
- name: "restart alert-email service"
|
|
||||||
systemd:
|
|
||||||
name: alert-email.cymais.service
|
|
||||||
daemon_reload: yes
|
|
@ -1,2 +0,0 @@
|
|||||||
systemd_notifier_email_folder: '{{path_administrator_scripts}}alert-email/'
|
|
||||||
application_id: email
|
|
@ -1,4 +0,0 @@
|
|||||||
- name: "restart alert-telegram service"
|
|
||||||
systemd:
|
|
||||||
name: alert-telegram.cymais.service
|
|
||||||
daemon_reload: yes
|
|
@ -1,2 +0,0 @@
|
|||||||
systemd_telegram_folder: /opt/ansible-roles/alert-telegram/
|
|
||||||
systemd_telegram_script: '{{systemd_telegram_folder}}alert-telegram.sh'
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload bkp-data-to-usb.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: bkp-data-to-usb.cymais.service
|
|
||||||
state: reloaded
|
|
||||||
daemon_reload: yes
|
|
@ -1,2 +0,0 @@
|
|||||||
backup_directory_validator_folder: '{{path_administrator_scripts}}directory-validator/'
|
|
||||||
application_id: directory-validator
|
|
@ -1,9 +0,0 @@
|
|||||||
- name: "reload bkp-docker-to-local-everything.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: bkp-docker-to-local-everything.cymais.service
|
|
||||||
daemon_reload: yes
|
|
||||||
|
|
||||||
- name: "reload bkp-docker-to-local.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: bkp-docker-to-local.cymais.service
|
|
||||||
daemon_reload: yes
|
|
@ -1 +0,0 @@
|
|||||||
application_id: provider
|
|
@ -1,4 +0,0 @@
|
|||||||
- name: "reload bkp-remote-to-local service"
|
|
||||||
systemd:
|
|
||||||
name: bkp-remote-to-local.cymais.service
|
|
||||||
daemon_reload: yes
|
|
@ -1,2 +0,0 @@
|
|||||||
docker_backup_remote_to_local_folder: '{{path_administrator_scripts}}bkp-remote-to-local/'
|
|
||||||
application_id: bkp-remote-to-local
|
|
@ -1,14 +1,41 @@
|
|||||||
roles:
|
roles:
|
||||||
core:
|
sys:
|
||||||
title: "Core & System"
|
title: "System"
|
||||||
description: "Fundamental system configuration"
|
alm:
|
||||||
icon: "fas fa-cogs"
|
title: "Alerting"
|
||||||
invokable: true
|
description: "Notification handlers for system events"
|
||||||
|
icon: "fas fa-bell"
|
||||||
|
invokable: false
|
||||||
|
cln:
|
||||||
|
title: "Cleanup"
|
||||||
|
description: "Roles for cleaning up various system resources—old backups, unused certificates, temporary files, Docker volumes, disk caches, deprecated domains, and more."
|
||||||
|
icon: "fas fa-trash-alt"
|
||||||
|
invokable: false
|
||||||
|
hlth:
|
||||||
|
title: "Monitoring"
|
||||||
|
description: "Roles for system monitoring and health checks—encompassing bot-style automated checks and core low-level monitors for logs, containers, disk usage, and more."
|
||||||
|
icon: "fas fa-chart-area"
|
||||||
|
invokable: false
|
||||||
|
bkp:
|
||||||
|
title: "Backup & Restore"
|
||||||
|
description: "Backup strategies & restore procedures"
|
||||||
|
icon: "fas fa-hdd"
|
||||||
|
invokable: false
|
||||||
|
update:
|
||||||
|
title: "Updates & Package Management"
|
||||||
|
description: "OS & package updates"
|
||||||
|
icon: "fas fa-sync"
|
||||||
|
invokable: false
|
||||||
drv:
|
drv:
|
||||||
title: "Drivers"
|
title: "Drivers"
|
||||||
description: "Roles for installing and configuring hardware drivers—covering printers, graphics, input devices, and other peripheral support."
|
description: "Roles for installing and configuring hardware drivers—covering printers, graphics, input devices, and other peripheral support."
|
||||||
icon: "fas fa-microchip"
|
icon: "fas fa-microchip"
|
||||||
invokable: true
|
invokable: true
|
||||||
|
core:
|
||||||
|
title: "Core & System"
|
||||||
|
description: "Fundamental system configuration"
|
||||||
|
icon: "fas fa-cogs"
|
||||||
|
invokable: true
|
||||||
gen:
|
gen:
|
||||||
title: "Generic"
|
title: "Generic"
|
||||||
description: "Helper roles & installers (git, locales, timer, etc.)"
|
description: "Helper roles & installers (git, locales, timer, etc.)"
|
||||||
@ -73,38 +100,8 @@ roles:
|
|||||||
description: "Docker infrastructure services (DBMS, LDAP, Redis, etc.)"
|
description: "Docker infrastructure services (DBMS, LDAP, Redis, etc.)"
|
||||||
icon: "fas fa-database"
|
icon: "fas fa-database"
|
||||||
invokable: true
|
invokable: true
|
||||||
mon:
|
|
||||||
title: "Monitoring"
|
|
||||||
description: "Roles for system monitoring and health checks—encompassing bot-style automated checks and core low-level monitors for logs, containers, disk usage, and more."
|
|
||||||
icon: "fas fa-chart-area"
|
|
||||||
invokable: true
|
|
||||||
alert:
|
|
||||||
title: "Alerting"
|
|
||||||
description: "Notification handlers for system events"
|
|
||||||
icon: "fas fa-bell"
|
|
||||||
invokable: false
|
|
||||||
maint:
|
|
||||||
title: "Maintenance & Healing"
|
|
||||||
description: "Periodic maintenance & auto-recovery"
|
|
||||||
icon: "fas fa-tools"
|
|
||||||
invokable: true
|
|
||||||
bkp:
|
|
||||||
title: "Backup & Restore"
|
|
||||||
description: "Backup strategies & restore procedures"
|
|
||||||
icon: "fas fa-hdd"
|
|
||||||
invokable: true
|
|
||||||
update:
|
|
||||||
title: "Updates & Package Management"
|
|
||||||
description: "OS & package updates"
|
|
||||||
icon: "fas fa-sync"
|
|
||||||
invokable: true
|
|
||||||
user:
|
user:
|
||||||
title: "Users & Access"
|
title: "Users & Access"
|
||||||
description: "User accounts & access control"
|
description: "User accounts & access control"
|
||||||
icon: "fas fa-users"
|
icon: "fas fa-users"
|
||||||
invokable: false
|
invokable: false
|
||||||
cln:
|
|
||||||
title: "Cleanup"
|
|
||||||
description: "Roles for cleaning up various system resources—old backups, unused certificates, temporary files, Docker volumes, disk caches, deprecated domains, and more."
|
|
||||||
icon: "fas fa-trash-alt"
|
|
||||||
invokable: true
|
|
||||||
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload cln-backups.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: cln-backups.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -1,2 +0,0 @@
|
|||||||
cleanup_backups_directory: '{{path_administrator_scripts}}cln-backups/'
|
|
||||||
application_id: backups-service
|
|
@ -1 +0,0 @@
|
|||||||
application_id: backups-timer
|
|
@ -1,6 +0,0 @@
|
|||||||
- name: "Reload and restart cln-certs.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: cln-certs.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
||||||
state: restarted
|
|
@ -1 +0,0 @@
|
|||||||
application_id: certs
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload cln-disc-space.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: cln-disc-space.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -1,26 +0,0 @@
|
|||||||
- name: "create {{cleanup_disc_space_folder}}"
|
|
||||||
file:
|
|
||||||
path: "{{cleanup_disc_space_folder}}"
|
|
||||||
state: directory
|
|
||||||
mode: 0755
|
|
||||||
|
|
||||||
- name: create cln-disc-space.sh
|
|
||||||
template:
|
|
||||||
src: cln-disc-space.sh.j2
|
|
||||||
dest: "{{cleanup_disc_space_folder}}cln-disc-space.sh"
|
|
||||||
|
|
||||||
- name: create cln-disc-space.cymais.service
|
|
||||||
template:
|
|
||||||
src: cln-disc-space.service.j2
|
|
||||||
dest: /etc/systemd/system/cln-disc-space.cymais.service
|
|
||||||
notify: reload cln-disc-space.cymais.service
|
|
||||||
|
|
||||||
- name: "set 'service_name' to '{{ role_name }}'"
|
|
||||||
set_fact:
|
|
||||||
service_name: "{{ role_name }}"
|
|
||||||
|
|
||||||
- name: "include role for gen-timer for {{service_name}}"
|
|
||||||
include_role:
|
|
||||||
name: gen-timer
|
|
||||||
vars:
|
|
||||||
on_calendar: "{{on_calendar_cleanup_disc_space}}"
|
|
@ -1,2 +0,0 @@
|
|||||||
cleanup_disc_space_folder: '{{path_administrator_scripts}}cln-disc-space/'
|
|
||||||
application_id: disc-space
|
|
@ -1 +0,0 @@
|
|||||||
application_id: docker-anonymous-volumes
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload cln-docker-storage-optimizer.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: cln-docker-storage-optimizer.cymais.service
|
|
||||||
state: reloaded
|
|
||||||
daemon_reload: yes
|
|
@ -1,22 +0,0 @@
|
|||||||
- name: "create {{storage_optimizer_directory}}"
|
|
||||||
file:
|
|
||||||
path: "{{storage_optimizer_directory}}"
|
|
||||||
state: directory
|
|
||||||
mode: 0755
|
|
||||||
|
|
||||||
- name: create cln-docker-storage-optimizer.cymais.service
|
|
||||||
template:
|
|
||||||
src: cln-docker-storage-optimizer.service.j2
|
|
||||||
dest: /etc/systemd/system/cln-docker-storage-optimizer.cymais.service
|
|
||||||
notify: reload cln-docker-storage-optimizer.cymais.service
|
|
||||||
|
|
||||||
- name: create cln-docker-storage-optimizer.py
|
|
||||||
copy:
|
|
||||||
src: cln-docker-storage-optimizer.py
|
|
||||||
dest: "{{storage_optimizer_script}}"
|
|
||||||
mode: 0755
|
|
||||||
|
|
||||||
- name: "optimize storage performance"
|
|
||||||
systemd:
|
|
||||||
name: cln-docker-storage-optimizer.cymais.service
|
|
||||||
state: started
|
|
@ -1,3 +0,0 @@
|
|||||||
storage_optimizer_directory: '{{path_administrator_scripts}}cln-docker-storage-optimizer/'
|
|
||||||
storage_optimizer_script: '{{storage_optimizer_directory}}cln-docker-storage-optimizer.py'
|
|
||||||
application_id: docker-storage-optimizer
|
|
@ -1 +0,0 @@
|
|||||||
application_id: domains
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "Reload cln-failed-docker-backups.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: cln-failed-docker-backups.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -13,4 +13,4 @@
|
|||||||
when: applications | is_feature_enabled('central_database',application_id)
|
when: applications | is_feature_enabled('central_database',application_id)
|
||||||
|
|
||||||
- name: "Add database to backup"
|
- name: "Add database to backup"
|
||||||
include_tasks: "{{ playbook_dir }}/roles/bkp-docker-to-local/tasks/seed-database-to-backup.yml"
|
include_tasks: "{{ playbook_dir }}/roles/sys-bkp-docker-to-local/tasks/seed-database-to-backup.yml"
|
@ -1 +0,0 @@
|
|||||||
application_id: daemon
|
|
@ -1 +0,0 @@
|
|||||||
application_id: journalctl
|
|
@ -1,21 +0,0 @@
|
|||||||
# System Security
|
|
||||||
|
|
||||||
## Description
|
|
||||||
|
|
||||||
This role configures security-related settings on the target system to ensure that essential security services are properly managed. It reinforces system security by integrating with related roles and enforcing best practices.
|
|
||||||
|
|
||||||
## Overview
|
|
||||||
|
|
||||||
The role focuses on:
|
|
||||||
- Configuring key security services such as [SSH](https://en.wikipedia.org/wiki/Secure_Shell).
|
|
||||||
- Integrating with other security roles to maintain a robust system security posture.
|
|
||||||
- Ensuring that security configurations are applied consistently across the system.
|
|
||||||
|
|
||||||
## Purpose
|
|
||||||
|
|
||||||
The primary purpose of this role is to enhance overall system security by managing and configuring essential security services and settings.
|
|
||||||
|
|
||||||
## Features
|
|
||||||
|
|
||||||
- **Security Configuration:** Applies recommended security settings for core services.
|
|
||||||
- **Integration:** Works alongside related roles such as [sshd](https://en.wikipedia.org/wiki/SSH_daemon) to provide comprehensive security management.
|
|
@ -1,24 +0,0 @@
|
|||||||
---
|
|
||||||
galaxy_info:
|
|
||||||
author: "Kevin Veen-Birkenbach"
|
|
||||||
description: "Configures security-related settings on the target system and ensures essential security services are properly managed."
|
|
||||||
license: "CyMaIS NonCommercial License (CNCL)"
|
|
||||||
license_url: "https://s.veen.world/cncl"
|
|
||||||
company: |
|
|
||||||
Kevin Veen-Birkenbach
|
|
||||||
Consulting & Coaching Solutions
|
|
||||||
https://www.veen.world
|
|
||||||
min_ansible_version: "2.9"
|
|
||||||
platforms:
|
|
||||||
- name: Linux
|
|
||||||
versions:
|
|
||||||
- all
|
|
||||||
galaxy_tags:
|
|
||||||
- security
|
|
||||||
- ssh
|
|
||||||
- system
|
|
||||||
repository: "https://s.veen.world/cymais"
|
|
||||||
issue_tracker_url: "https://s.veen.world/cymaisissues"
|
|
||||||
documentation: "https://s.veen.world/cymais"
|
|
||||||
dependencies:
|
|
||||||
- core-sshd
|
|
@ -1 +0,0 @@
|
|||||||
application_id: security
|
|
@ -1 +0,0 @@
|
|||||||
application_id: sshd
|
|
@ -1 +0,0 @@
|
|||||||
application_id: sudo
|
|
@ -10,7 +10,7 @@ Targeting user environments on Arch Linux (e.g., Manjaro), this role sets up the
|
|||||||
|
|
||||||
## Purpose
|
## Purpose
|
||||||
|
|
||||||
The purpose of this role is to automate the configuration of cloud-integrated user directories by ensuring that common folders like `Downloads`, `Music`, and `Workspaces` are transparently redirected into a centralized cloud structure. This makes it easier to maintain bkp-friendly, cloud-ready setups for homelab and professional workflows.
|
The purpose of this role is to automate the configuration of cloud-integrated user directories by ensuring that common folders like `Downloads`, `Music`, and `Workspaces` are transparently redirected into a centralized cloud structure. This makes it easier to maintain sys-bkp-friendly, cloud-ready setups for homelab and professional workflows.
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
|
@ -27,9 +27,9 @@ galaxy_info:
|
|||||||
documentation: "https://s.veen.world/cymais/docker"
|
documentation: "https://s.veen.world/cymais/docker"
|
||||||
|
|
||||||
dependencies:
|
dependencies:
|
||||||
- bkp-docker-to-local
|
- sys-bkp-docker-to-local
|
||||||
- user-administrator
|
- user-administrator
|
||||||
- mon-bot-docker-container
|
- sys-hlth-docker-container
|
||||||
- mon-bot-docker-volumes
|
- sys-hlth-docker-volumes
|
||||||
- maint-docker-heal
|
- sys-rpr-docker-soft
|
||||||
- maint-docker-restart
|
- sys-rpr-docker-hard
|
||||||
|
@ -16,7 +16,7 @@
|
|||||||
group: administrator
|
group: administrator
|
||||||
when: run_once_docker is not defined
|
when: run_once_docker is not defined
|
||||||
|
|
||||||
- name: Set docker_enabled to true, to activate cln-docker-storage-optimizer
|
- name: Set docker_enabled to true, to activate sys-opt-ssd-hdd
|
||||||
set_fact:
|
set_fact:
|
||||||
docker_enabled: true
|
docker_enabled: true
|
||||||
when: run_once_docker is not defined
|
when: run_once_docker is not defined
|
||||||
|
@ -9,4 +9,4 @@ galaxy_info:
|
|||||||
- all
|
- all
|
||||||
dependencies:
|
dependencies:
|
||||||
- gen-aur-helper
|
- gen-aur-helper
|
||||||
- alert-compose
|
- sys-alm-compose
|
||||||
|
@ -25,9 +25,9 @@
|
|||||||
set_fact:
|
set_fact:
|
||||||
service_name: "{{ role_name }}"
|
service_name: "{{ role_name }}"
|
||||||
|
|
||||||
- name: "include role for gen-timer for {{service_name}}"
|
- name: "include role for sys-timer for {{service_name}}"
|
||||||
include_role:
|
include_role:
|
||||||
name: gen-timer
|
name: sys-timer
|
||||||
vars:
|
vars:
|
||||||
on_calendar: "{{on_calendar_msi_keyboard_color}}"
|
on_calendar: "{{on_calendar_msi_keyboard_color}}"
|
||||||
persistent: "true"
|
persistent: "true"
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
[Unit]
|
[Unit]
|
||||||
Description=Keyboard Color Service
|
Description=Keyboard Color Service
|
||||||
OnFailure=alert-compose.cymais@%n.service
|
OnFailure=sys-alm-compose.cymais@%n.service
|
||||||
|
|
||||||
[Service]
|
[Service]
|
||||||
Type=oneshot
|
Type=oneshot
|
||||||
|
@ -1 +0,0 @@
|
|||||||
application_id: msmtp
|
|
@ -1 +0,0 @@
|
|||||||
application_id: timer
|
|
@ -1,4 +0,0 @@
|
|||||||
- name: "reload maint-btrfs-auto-balancer.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: maint-btrfs-auto-balancer.cymais.service
|
|
||||||
daemon_reload: yes
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: restart maint-docker-heal.cymais.service
|
|
||||||
systemd:
|
|
||||||
name: maint-docker-heal.cymais.service
|
|
||||||
state: restarted
|
|
||||||
daemon_reload: yes
|
|
@ -1,8 +0,0 @@
|
|||||||
[Unit]
|
|
||||||
Description=restart unhealthy docker containers
|
|
||||||
OnFailure=alert-compose.cymais@%n.service
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=oneshot
|
|
||||||
ExecStartPre=/bin/sh -c '/usr/bin/python {{ path_system_lock_script }} {{ system_maintenance_services | join(' ') }} --ignore {{system_maintenance_cleanup_services| join(' ') }} maint-docker-heal --timeout "{{system_maintenance_lock_timeout_heal_docker}}"'
|
|
||||||
ExecStart=/bin/sh -c '/bin/python {{heal_docker}}maint-docker-heal.py {{path_docker_compose_instances}}'
|
|
@ -1,2 +0,0 @@
|
|||||||
heal_docker: '{{path_administrator_scripts}}maint-docker-heal/'
|
|
||||||
application_id: docker-heal
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload maint-docker-restart.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: maint-docker-restart.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -1,3 +0,0 @@
|
|||||||
restart_docker_folder: '{{path_administrator_scripts}}maint-docker-restart/'
|
|
||||||
restart_docker_script: '{{restart_docker_folder}}maint-docker-restart.py'
|
|
||||||
application_id: docker-restart
|
|
@ -1 +0,0 @@
|
|||||||
application_id: lock
|
|
@ -1 +0,0 @@
|
|||||||
application_id: swapfile
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload mon-bot-btrfs.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: mon-bot-btrfs.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -1,26 +0,0 @@
|
|||||||
- name: "create {{docker_health_btrfs_folder}}"
|
|
||||||
file:
|
|
||||||
path: "{{docker_health_btrfs_folder}}"
|
|
||||||
state: directory
|
|
||||||
mode: 0755
|
|
||||||
|
|
||||||
- name: create mon-bot-btrfs.sh
|
|
||||||
copy:
|
|
||||||
src: mon-bot-btrfs.sh
|
|
||||||
dest: "{{docker_health_btrfs_folder}}mon-bot-btrfs.sh"
|
|
||||||
|
|
||||||
- name: create mon-bot-btrfs.cymais.service
|
|
||||||
template:
|
|
||||||
src: mon-bot-btrfs.service.j2
|
|
||||||
dest: /etc/systemd/system/mon-bot-btrfs.cymais.service
|
|
||||||
notify: reload mon-bot-btrfs.cymais.service
|
|
||||||
|
|
||||||
- name: "set 'service_name' to '{{ role_name }}'"
|
|
||||||
set_fact:
|
|
||||||
service_name: "{{ role_name }}"
|
|
||||||
|
|
||||||
- name: "include role for gen-timer for {{service_name}}"
|
|
||||||
include_role:
|
|
||||||
name: gen-timer
|
|
||||||
vars:
|
|
||||||
on_calendar: "{{on_calendar_health_btrfs}}"
|
|
@ -1,7 +0,0 @@
|
|||||||
[Unit]
|
|
||||||
Description=Check btrfs status
|
|
||||||
OnFailure=alert-compose.cymais@%n.service
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=oneshot
|
|
||||||
ExecStart=/bin/bash {{docker_health_btrfs_folder}}mon-bot-btrfs.sh
|
|
@ -1,2 +0,0 @@
|
|||||||
docker_health_btrfs_folder: '{{path_administrator_scripts}}mon-bot-btrfs/'
|
|
||||||
application_id: bot-btrfs
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload mon-bot-csp.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: mon-bot-csp.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -1,3 +0,0 @@
|
|||||||
health_csp_crawler_folder: '{{ path_administrator_scripts }}mon-bot-csp/'
|
|
||||||
health_csp_crawler_script: '{{ health_csp_crawler_folder }}mon-bot-csp.py'
|
|
||||||
application_id: bot-csp
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload mon-bot-disc-space.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: mon-bot-disc-space.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -1,26 +0,0 @@
|
|||||||
- name: "create {{health_disc_space_folder}}"
|
|
||||||
file:
|
|
||||||
path: "{{health_disc_space_folder}}"
|
|
||||||
state: directory
|
|
||||||
mode: 0755
|
|
||||||
|
|
||||||
- name: create mon-bot-disc-space.sh
|
|
||||||
copy:
|
|
||||||
src: mon-bot-disc-space.sh
|
|
||||||
dest: "{{health_disc_space_folder}}mon-bot-disc-space.sh"
|
|
||||||
|
|
||||||
- name: create mon-bot-disc-space.cymais.service
|
|
||||||
template:
|
|
||||||
src: mon-bot-disc-space.service.j2
|
|
||||||
dest: /etc/systemd/system/mon-bot-disc-space.cymais.service
|
|
||||||
notify: reload mon-bot-disc-space.cymais.service
|
|
||||||
|
|
||||||
- name: "set 'service_name' to '{{ role_name }}'"
|
|
||||||
set_fact:
|
|
||||||
service_name: "{{ role_name }}"
|
|
||||||
|
|
||||||
- name: "include role for gen-timer for {{service_name}}"
|
|
||||||
include_role:
|
|
||||||
name: gen-timer
|
|
||||||
vars:
|
|
||||||
on_calendar: "{{on_calendar_health_disc_space}}"
|
|
@ -1,7 +0,0 @@
|
|||||||
[Unit]
|
|
||||||
Description=checking disc space
|
|
||||||
OnFailure=alert-compose.cymais@%n.service
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=oneshot
|
|
||||||
ExecStart=/bin/bash {{health_disc_space_folder}}mon-bot-disc-space.sh {{size_percent_disc_space_warning}}
|
|
@ -1,2 +0,0 @@
|
|||||||
health_disc_space_folder: '{{path_administrator_scripts}}mon-bot-disc-space/'
|
|
||||||
application_id: bot-disc-space
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload mon-bot-docker-container.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: mon-bot-docker-container.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -1,7 +0,0 @@
|
|||||||
[Unit]
|
|
||||||
Description=Checking docker health
|
|
||||||
OnFailure=alert-compose.cymais@%n.service
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=oneshot
|
|
||||||
ExecStart=/bin/bash {{health_docker_container_folder}}mon-bot-docker-container.sh
|
|
@ -1,2 +0,0 @@
|
|||||||
health_docker_container_folder: '{{path_administrator_scripts}}mon-bot-docker-container/'
|
|
||||||
application_id: bot-docker-container
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload mon-bot-docker-volumes.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: mon-bot-docker-volumes.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -1,7 +0,0 @@
|
|||||||
[Unit]
|
|
||||||
Description=Checking docker health
|
|
||||||
OnFailure=alert-compose.cymais@%n.service
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=oneshot
|
|
||||||
ExecStart=/bin/bash {{ health_docker_volumes_folder }}mon-bot-docker-volumes.sh "{{ whitelisted_anonymous_docker_volumes | join(' ') }}"
|
|
@ -1,2 +0,0 @@
|
|||||||
health_docker_volumes_folder: '{{path_administrator_scripts}}mon-bot-docker-volumes/'
|
|
||||||
application_id: bot-docker-volumes
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload mon-bot-journalctl.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: mon-bot-journalctl.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -1,7 +0,0 @@
|
|||||||
[Unit]
|
|
||||||
Description=checking journalctl health
|
|
||||||
OnFailure=alert-compose.cymais@%n.service
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=oneshot
|
|
||||||
ExecStart=/bin/bash {{health_journalctl_folder}}mon-bot-journalctl.sh
|
|
@ -1,2 +0,0 @@
|
|||||||
health_journalctl_folder: '{{path_administrator_scripts}}mon-bot-journalctl/'
|
|
||||||
application_id: bot-journalctl
|
|
@ -1,21 +0,0 @@
|
|||||||
# mon-bot-msmtp
|
|
||||||
|
|
||||||
## Description
|
|
||||||
|
|
||||||
This Ansible role sends periodic health check emails using **msmtp** to verify that your mail transport agent is operational. It deploys a simple script and hooks it into a systemd service and timer, with failure notifications sent via Telegram.
|
|
||||||
|
|
||||||
## Overview
|
|
||||||
|
|
||||||
Optimized for Archlinux, this role creates the required directory structure, installs and configures the mon-bot-check script, and integrates with the **alert-telegram** role. It uses the **gen-timer** role to schedule regular checks based on your customizable `OnCalendar` setting.
|
|
||||||
|
|
||||||
## Purpose
|
|
||||||
|
|
||||||
The **mon-bot-msmtp** role ensures that your mail transport system stays available by sending a test email at defined intervals. If the email fails, a Telegram alert is triggered, allowing you to detect and address issues before they impact users.
|
|
||||||
|
|
||||||
## Features
|
|
||||||
|
|
||||||
- **Directory & Script Deployment:** Sets up `mon-bot-msmtp/` and deploys a templated Bash script to send test emails via msmtp.
|
|
||||||
- **Systemd Service & Timer:** Provides `.service` and `.timer` units to run the check and schedule it automatically.
|
|
||||||
- **Failure Notifications:** Leverages **alert-telegram** to push alerts when the script exits with an error.
|
|
||||||
- **Configurable Schedule:** Define your desired check frequency using the `on_calendar_health_msmtp` variable.
|
|
||||||
- **Email Destination:** Specify the recipient via the `users.administrator.email` variable.
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: reload mon-bot-msmtp.cymais.service
|
|
||||||
systemd:
|
|
||||||
name: mon-bot-msmtp.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -1,27 +0,0 @@
|
|||||||
- name: "create {{ health_msmtp_folder }}"
|
|
||||||
file:
|
|
||||||
path: "{{ health_msmtp_folder }}"
|
|
||||||
state: directory
|
|
||||||
mode: 0755
|
|
||||||
|
|
||||||
- name: create mon-bot-msmtp.sh
|
|
||||||
template:
|
|
||||||
src: mon-bot-msmtp.sh.j2
|
|
||||||
dest: "{{ health_msmtp_folder }}mon-bot-msmtp.sh"
|
|
||||||
mode: '0755'
|
|
||||||
|
|
||||||
- name: create mon-bot-msmtp.cymais.service
|
|
||||||
template:
|
|
||||||
src: mon-bot-msmtp.service.j2
|
|
||||||
dest: /etc/systemd/system/mon-bot-msmtp.cymais.service
|
|
||||||
notify: reload mon-bot-msmtp.cymais.service
|
|
||||||
|
|
||||||
- name: "set 'service_name' to '{{ role_name }}'"
|
|
||||||
set_fact:
|
|
||||||
service_name: "{{ role_name }}"
|
|
||||||
|
|
||||||
- name: include role for gen-timer for {{ service_name }}
|
|
||||||
include_role:
|
|
||||||
name: gen-timer
|
|
||||||
vars:
|
|
||||||
on_calendar: "{{ on_calendar_health_msmtp }}"
|
|
@ -1,7 +0,0 @@
|
|||||||
[Unit]
|
|
||||||
Description=Check msmtp liveliness
|
|
||||||
OnFailure=alert-telegram.cymais@%n.service
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=oneshot
|
|
||||||
ExecStart=/bin/bash {{ health_msmtp_folder }}mon-bot-msmtp.sh
|
|
@ -1,2 +0,0 @@
|
|||||||
health_msmtp_folder: '{{ path_administrator_scripts }}mon-bot-msmtp/'
|
|
||||||
application_id: bot-msmtp
|
|
@ -1,5 +0,0 @@
|
|||||||
- name: "reload mon-bot-webserver.cymais.service"
|
|
||||||
systemd:
|
|
||||||
name: mon-bot-webserver.cymais.service
|
|
||||||
enabled: yes
|
|
||||||
daemon_reload: yes
|
|
@ -1,7 +0,0 @@
|
|||||||
[Unit]
|
|
||||||
Description=Check nginx configuration status
|
|
||||||
OnFailure=alert-compose.cymais@%n.service
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=oneshot
|
|
||||||
ExecStart=/usr/bin/python3 {{ health_nginx_folder }}mon-bot-webserver.py
|
|
@ -1,2 +0,0 @@
|
|||||||
health_nginx_folder: '{{ path_administrator_scripts }}mon-bot-webserver/'
|
|
||||||
application_id: bot-webserver
|
|
@ -13,7 +13,7 @@ This Ansible role simplifies the deployment of **Let's Encrypt certificates** in
|
|||||||
- Automatically **reloads or restarts Nginx services** when certificates are updated.
|
- Automatically **reloads or restarts Nginx services** when certificates are updated.
|
||||||
- **Configures and manages a `systemd` service** for automated certificate deployment.
|
- **Configures and manages a `systemd` service** for automated certificate deployment.
|
||||||
- **Includes a `systemd` timer** for scheduled renewals.
|
- **Includes a `systemd` timer** for scheduled renewals.
|
||||||
- **Handles dependent services** like `alert-compose`.
|
- **Handles dependent services** like `sys-alm-compose`.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -29,7 +29,7 @@ This Ansible role simplifies the deployment of **Let's Encrypt certificates** in
|
|||||||
3. **Configure `systemd` Service**
|
3. **Configure `systemd` Service**
|
||||||
- Deploys a `systemd` service file for the deployment process.
|
- Deploys a `systemd` service file for the deployment process.
|
||||||
|
|
||||||
4. **Include `gen-timer` Role**
|
4. **Include `sys-timer` Role**
|
||||||
- Schedules automatic certificate deployment using a `systemd` timer.
|
- Schedules automatic certificate deployment using a `systemd` timer.
|
||||||
|
|
||||||
### **2️⃣ Handlers**
|
### **2️⃣ Handlers**
|
||||||
|
@ -21,5 +21,5 @@ galaxy_info:
|
|||||||
- name: Any
|
- name: Any
|
||||||
versions: [ all ]
|
versions: [ all ]
|
||||||
dependencies:
|
dependencies:
|
||||||
- alert-compose
|
- sys-alm-compose
|
||||||
|
|
||||||
|
@ -23,9 +23,9 @@
|
|||||||
dest: "/etc/systemd/system/srv-proxy-6-6-tls-deploy.{{application_id}}.cymais.service"
|
dest: "/etc/systemd/system/srv-proxy-6-6-tls-deploy.{{application_id}}.cymais.service"
|
||||||
notify: restart srv-proxy-6-6-tls-deploy.cymais.service
|
notify: restart srv-proxy-6-6-tls-deploy.cymais.service
|
||||||
|
|
||||||
- name: "include role for gen-timer for {{service_name}}"
|
- name: "include role for sys-timer for {{service_name}}"
|
||||||
include_role:
|
include_role:
|
||||||
name: gen-timer
|
name: sys-timer
|
||||||
vars:
|
vars:
|
||||||
on_calendar: "{{on_calendar_deploy_certificates}}"
|
on_calendar: "{{on_calendar_deploy_certificates}}"
|
||||||
service_name: "srv-proxy-6-6-tls-deploy.{{application_id}}"
|
service_name: "srv-proxy-6-6-tls-deploy.{{application_id}}"
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
[Unit]
|
[Unit]
|
||||||
Description=Let's Encrypt deploy to {{docker_compose.directories.instance}}
|
Description=Let's Encrypt deploy to {{docker_compose.directories.instance}}
|
||||||
OnFailure=alert-compose.cymais@%n.service
|
OnFailure=sys-alm-compose.cymais@%n.service
|
||||||
|
|
||||||
[Service]
|
[Service]
|
||||||
Type=oneshot
|
Type=oneshot
|
||||||
|
@ -6,12 +6,12 @@ This role automates the setup of an automatic [Let's Encrypt](https://letsencryp
|
|||||||
|
|
||||||
## 📖 Overview
|
## 📖 Overview
|
||||||
|
|
||||||
Optimized for Archlinux systems, this role installs the `certbot-nginx` package, configures a dedicated `systemd` service for certificate renewal, and integrates with a `gen-timer` to schedule periodic renewals. After a renewal, Nginx is reloaded to apply the updated certificates immediately.
|
Optimized for Archlinux systems, this role installs the `certbot-nginx` package, configures a dedicated `systemd` service for certificate renewal, and integrates with a `sys-timer` to schedule periodic renewals. After a renewal, Nginx is reloaded to apply the updated certificates immediately.
|
||||||
|
|
||||||
### Key Features
|
### Key Features
|
||||||
- **Automatic Renewal:** Schedules unattended certificate renewals using gen-timers.
|
- **Automatic Renewal:** Schedules unattended certificate renewals using sys-timers.
|
||||||
- **Seamless Nginx Reload:** Reloads the Nginx service automatically after successful renewals.
|
- **Seamless Nginx Reload:** Reloads the Nginx service automatically after successful renewals.
|
||||||
- **Systemd Integration:** Manages renewal operations reliably with `systemd` and `alert-compose`.
|
- **Systemd Integration:** Manages renewal operations reliably with `systemd` and `sys-alm-compose`.
|
||||||
- **Quiet and Safe Operation:** Uses `--quiet` and `--agree-tos` flags to ensure non-interactive renewals.
|
- **Quiet and Safe Operation:** Uses `--quiet` and `--agree-tos` flags to ensure non-interactive renewals.
|
||||||
|
|
||||||
## 🎯 Purpose
|
## 🎯 Purpose
|
||||||
@ -22,8 +22,8 @@ The Nginx Certbot Automation role ensures that Let's Encrypt SSL/TLS certificate
|
|||||||
|
|
||||||
- **Certbot-Nginx Package Installation:** Installs required certbot plugins for Nginx.
|
- **Certbot-Nginx Package Installation:** Installs required certbot plugins for Nginx.
|
||||||
- **Custom Systemd Service:** Configures a lightweight, dedicated renewal service.
|
- **Custom Systemd Service:** Configures a lightweight, dedicated renewal service.
|
||||||
- **Timer Setup:** Uses gen-timer to run certbot renewals periodically.
|
- **Timer Setup:** Uses sys-timer to run certbot renewals periodically.
|
||||||
- **Failure Notification:** Integrated with `alert-compose` for alerting on failures.
|
- **Failure Notification:** Integrated with `sys-alm-compose` for alerting on failures.
|
||||||
|
|
||||||
## 🔗 Learn More
|
## 🔗 Learn More
|
||||||
|
|
||||||
|
@ -29,5 +29,5 @@ galaxy_info:
|
|||||||
dependencies:
|
dependencies:
|
||||||
- gen-certbot
|
- gen-certbot
|
||||||
- srv-web-7-4-core
|
- srv-web-7-4-core
|
||||||
- alert-compose
|
- sys-alm-compose
|
||||||
- cln-certs
|
- sys-cln-certs
|
||||||
|
@ -17,9 +17,9 @@
|
|||||||
service_name: "{{ role_name }}"
|
service_name: "{{ role_name }}"
|
||||||
when: run_once_nginx_certbot is not defined
|
when: run_once_nginx_certbot is not defined
|
||||||
|
|
||||||
- name: "include role for gen-timer for {{service_name}}"
|
- name: "include role for sys-timer for {{service_name}}"
|
||||||
include_role:
|
include_role:
|
||||||
name: gen-timer
|
name: sys-timer
|
||||||
vars:
|
vars:
|
||||||
on_calendar: "{{on_calendar_renew_lets_encrypt_certificates}}"
|
on_calendar: "{{on_calendar_renew_lets_encrypt_certificates}}"
|
||||||
persistent: "true"
|
persistent: "true"
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
[Unit]
|
[Unit]
|
||||||
Description=Let's Encrypt renewal
|
Description=Let's Encrypt renewal
|
||||||
OnFailure=alert-compose.cymais@%n.service
|
OnFailure=sys-alm-compose.cymais@%n.service
|
||||||
|
|
||||||
[Service]
|
[Service]
|
||||||
Type=oneshot
|
Type=oneshot
|
||||||
|
@ -20,5 +20,5 @@ galaxy_info:
|
|||||||
issue_tracker_url: "https://github.com/kevinveenbirkenbach/cymais/issues"
|
issue_tracker_url: "https://github.com/kevinveenbirkenbach/cymais/issues"
|
||||||
documentation: "https://github.com/kevinveenbirkenbach/cymais/roles/srv-web-7-4-core"
|
documentation: "https://github.com/kevinveenbirkenbach/cymais/roles/srv-web-7-4-core"
|
||||||
dependencies:
|
dependencies:
|
||||||
- mon-bot-webserver
|
- sys-hlth-webserver
|
||||||
- mon-bot-csp
|
- sys-hlth-csp
|
@ -16,7 +16,7 @@ This role is built on top of your existing `srv-web-7-4-core` role, and it autom
|
|||||||
When you apply **srv-web-7-6-https**, it will:
|
When you apply **srv-web-7-6-https**, it will:
|
||||||
|
|
||||||
1. **Include** the `srv-web-7-4-core` role to install and configure Nginx.
|
1. **Include** the `srv-web-7-4-core` role to install and configure Nginx.
|
||||||
2. **Clean up** any stale vHost files under `cln-domains`.
|
2. **Clean up** any stale vHost files under `sys-cln-domains`.
|
||||||
3. **Deploy** the Let’s Encrypt challenge-and-redirect snippet from `srv-web-7-7-letsencrypt`.
|
3. **Deploy** the Let’s Encrypt challenge-and-redirect snippet from `srv-web-7-7-letsencrypt`.
|
||||||
4. **Reload** Nginx automatically when any template changes.
|
4. **Reload** Nginx automatically when any template changes.
|
||||||
|
|
||||||
|
@ -25,5 +25,5 @@ galaxy_info:
|
|||||||
|
|
||||||
dependencies:
|
dependencies:
|
||||||
- srv-web-7-4-core
|
- srv-web-7-4-core
|
||||||
- cln-domains
|
- sys-cln-domains
|
||||||
- srv-web-7-7-letsencrypt
|
- srv-web-7-7-letsencrypt
|
@ -1198,7 +1198,7 @@ input.ng-empty::placeholder,.ng-empty::placeholder {
|
|||||||
border-color: var(--color-01-67)
|
border-color: var(--color-01-67)
|
||||||
}
|
}
|
||||||
|
|
||||||
.alert-info {
|
.sys-alm-info {
|
||||||
--bs-alert-color: var(--color-03-14);
|
--bs-sys-alm-color: var(--color-03-14);
|
||||||
--bs-alert-bg: var(--color-01-86);
|
--bs-sys-alm-bg: var(--color-01-86);
|
||||||
}
|
}
|
@ -21,7 +21,7 @@ def main():
|
|||||||
machine_id = subprocess.run(["sha256sum", "/etc/machine-id"], capture_output=True, text=True).stdout.strip()[:64]
|
machine_id = subprocess.run(["sha256sum", "/etc/machine-id"], capture_output=True, text=True).stdout.strip()[:64]
|
||||||
print(f"machine id: {machine_id}")
|
print(f"machine id: {machine_id}")
|
||||||
|
|
||||||
versions_path = os.path.join(backup_to_usb_destination_path, f"{machine_id}/bkp-data-to-usb/")
|
versions_path = os.path.join(backup_to_usb_destination_path, f"{machine_id}/svc-sys-bkp-data-to-usb/")
|
||||||
print(f"versions path: {versions_path}")
|
print(f"versions path: {versions_path}")
|
||||||
|
|
||||||
if not os.path.isdir(versions_path):
|
if not os.path.isdir(versions_path):
|
5
roles/svc-sys-bkp-data-to-usb/handlers/main.yml
Normal file
5
roles/svc-sys-bkp-data-to-usb/handlers/main.yml
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
- name: "reload svc-sys-bkp-data-to-usb.cymais.service"
|
||||||
|
systemd:
|
||||||
|
name: svc-sys-bkp-data-to-usb.cymais.service
|
||||||
|
state: reloaded
|
||||||
|
daemon_reload: yes
|
@ -23,5 +23,5 @@ galaxy_info:
|
|||||||
issue_tracker_url: https://s.veen.world/cymaisissues
|
issue_tracker_url: https://s.veen.world/cymaisissues
|
||||||
documentation: https://s.veen.world/cymais
|
documentation: https://s.veen.world/cymais
|
||||||
dependencies:
|
dependencies:
|
||||||
- cln-backups-service
|
- sys-cln-bkps-service
|
||||||
- maint-lock
|
- sys-lock
|
@ -1,6 +1,6 @@
|
|||||||
- name: Copy backup script to the scripts directory
|
- name: Copy backup script to the scripts directory
|
||||||
copy:
|
copy:
|
||||||
src: bkp-data-to-usb.python
|
src: svc-sys-bkp-data-to-usb.python
|
||||||
dest: "{{ backup_to_usb_script_path }}"
|
dest: "{{ backup_to_usb_script_path }}"
|
||||||
owner: root
|
owner: root
|
||||||
group: root
|
group: root
|
||||||
@ -8,9 +8,9 @@
|
|||||||
|
|
||||||
- name: Copy systemd service to systemd directory
|
- name: Copy systemd service to systemd directory
|
||||||
template:
|
template:
|
||||||
src: bkp-data-to-usb.service.j2
|
src: svc-sys-bkp-data-to-usb.service.j2
|
||||||
dest: /etc/systemd/system/bkp-data-to-usb.cymais.service
|
dest: /etc/systemd/system/svc-sys-bkp-data-to-usb.cymais.service
|
||||||
owner: root
|
owner: root
|
||||||
group: root
|
group: root
|
||||||
mode: '0644'
|
mode: '0644'
|
||||||
notify: reload bkp-data-to-usb.cymais.service
|
notify: reload svc-sys-bkp-data-to-usb.cymais.service
|
@ -1,12 +1,12 @@
|
|||||||
[Unit]
|
[Unit]
|
||||||
Description=Backup to USB when mounted to {{ backup_to_usb_mount }}
|
Description=Backup to USB when mounted to {{ backup_to_usb_mount }}
|
||||||
Wants={{systemctl_mount_service_name}}
|
Wants={{systemctl_mount_service_name}}
|
||||||
OnFailure=alert-compose.cymais@%n.service
|
OnFailure=sys-alm-compose.cymais@%n.service
|
||||||
|
|
||||||
[Service]
|
[Service]
|
||||||
Type=oneshot
|
Type=oneshot
|
||||||
ExecStart=/bin/python {{ backup_to_usb_script_path }} {{backup_to_usb_source}} {{backup_to_usb_destination}}
|
ExecStart=/bin/python {{ backup_to_usb_script_path }} {{backup_to_usb_source}} {{backup_to_usb_destination}}
|
||||||
ExecStartPost=/bin/systemctl start cln-backups.cymais.service
|
ExecStartPost=/bin/systemctl start sys-cln-backups.cymais.service
|
||||||
|
|
||||||
[Install]
|
[Install]
|
||||||
WantedBy=multi-user.target
|
WantedBy=multi-user.target
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
x
Reference in New Issue
Block a user