V8.00.000.2025.06.17
All checks were successful
🛡️ Shell Script Linting / 🛡️ Shell Script Linting (push) Successful in 1m0s
All checks were successful
🛡️ Shell Script Linting / 🛡️ Shell Script Linting (push) Successful in 1m0s
Signed-off-by: Marc S. Weidner <msw@coresecret.dev>
This commit is contained in:
70
lib/cdi_0000_preliminary/README.md
Normal file
70
lib/cdi_0000_preliminary/README.md
Normal file
@@ -0,0 +1,70 @@
|
||||
---
|
||||
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 -->
|
||||
Reference in New Issue
Block a user