Marc S. Weidner
45ff672479
All checks were successful
🛡️ Shell Script Linting / 🛡️ Shell Script Linting (push) Successful in 1m0s
Signed-off-by: Marc S. Weidner <msw@coresecret.dev>
71 lines
2.7 KiB
Markdown
71 lines
2.7 KiB
Markdown
---
|
||
gitea: none
|
||
include_toc: true
|
||
---
|
||
|
||
# 1. CISS.debian.installer
|
||
|
||
**Centurion Intelligence Consulting Agency Information Security Standard**<br>
|
||
*The CISS Debian Installer provides a fully automated and hardened installation process.*<br>
|
||
**Master Version**: 8.00<br>
|
||
**Build**: V8.00.000.2025.06.17<br>
|
||
|
||
# 2. Preliminary Components – `cdi_0000_preliminary`
|
||
|
||
This directory contains foundational wrapper scripts for the `CISS.debian.installer` framework. These scripts serve as minimal
|
||
but essential building blocks to ensure consistent versioning, usage helps output, and contact information across the entire
|
||
installer suite.
|
||
|
||
## 2.1. Purpose and Functionality
|
||
|
||
The scripts in this module fulfill the following roles:
|
||
|
||
- **0001_contact.sh**:
|
||
Displays project-related contact details, including PGP fingerprint, security email, and project links. This is shown during
|
||
installer execution or upon request via CLI.
|
||
|
||
- **0002_usage.sh**:
|
||
Provides a user-facing, color-coded help dialog. It details available command-line options such as debugging modes
|
||
(`--debug`), logging configuration, and non-interactive autoinstallation. It also enforces preconditions such as root
|
||
privileges, and the presence of YAML configuration files.
|
||
|
||
- **0003_version.sh**:
|
||
Displays the current project version, latest Git commit, debootstrap version, and host Bash version. This helps contextualize
|
||
the environment for debugging and auditing.
|
||
|
||
## 2.2. Requirements
|
||
|
||
- Bash version ≥ 5.1
|
||
- Proper invocation context (`set -Ceuo pipefail` enforced)
|
||
- Pre-populated configuration files:
|
||
- `.preseed/preseed.yaml`
|
||
- `.preseed/partitioning.yaml`
|
||
- Password files for GRUB, LUKS boot, common, and nuke passphrases
|
||
|
||
These scripts assume they are sourced or executed within a controlled setup shell, with essential global variables
|
||
(e.g. `VAR_VERSION`) predeclared.
|
||
|
||
|
||
## 2.3. Dependencies
|
||
|
||
- `bash` built-ins only (no external binaries invoked except `git`, `debootstrap`, and `uname` in `0003_version.sh`)
|
||
- ANSI color-supporting terminal (via `tput cols`, `echo -e`)
|
||
- Git repository context for versioning (`git log`)
|
||
|
||
|
||
## 2.4. License
|
||
|
||
This component is dual-licensed under the **European Union Public License v1.2 (EUPL-1.2)** or the
|
||
**CoreSecret Custom Contributor License Agreement (CCLA-1.0)**. You may choose either license as per your usage context.
|
||
Usage is permitted under the condition that no warranty is implied. Use at your own risk.
|
||
|
||
## 2.5. Author
|
||
|
||
Developed and maintained by
|
||
**Marc S. Weidner**
|
||
*Centurion Intelligence Consulting Agency*
|
||
|
||
---
|
||
**[no tracking | no logging | no advertising | no profiling | no bullshit](https://coresecret.eu/)**
|
||
<!-- vim: set number et ts=2 sw=2 sts=2 ai tw=128 ft=markdown -->
|