From 0f395dd64b32334e3ce5a292ccce827c2a826b80 Mon Sep 17 00:00:00 2001 From: phg Date: Sat, 24 Jan 2026 09:53:57 +0100 Subject: [PATCH] Add Repository structure overview --- README.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/README.md b/README.md index e964d6c..52eee08 100644 --- a/README.md +++ b/README.md @@ -4,11 +4,43 @@ - [Packer based PVE image templates](#packer-based-pve-image-templates) - [Table of Contents](#table-of-contents) + - [Repository structure](#repository-structure) - [Initial Setup](#initial-setup) - [Create Token](#create-token) - [Initialize Packer](#initialize-packer) - [Build](#build) - [Setup new templates](#setup-new-templates) + - [ToDo](#todo) + +## Repository structure + +```shell +❯ la 4 -I .git +Permissions Size User Group Date Modified Git Name +drwxr-xr-x@ - phg staff 23 Jan 22:36 -M  ./ +drwxr-xr-x@ - phg staff 22 Jan 18:19 -- ├──  debian/ Debian template definitions and assets (Packer templates, cloud-init/KS files, provisioning files). +drwxr-xr-x@ - phg staff 24 Jan 00:25 -- │ └──  13-trixie/ Template definition and assets for the Trixie template. +drwxr-xr-x@ - phg staff 24 Jan 00:26 -- │ ├──  files/ Files used for the file provisioner. +.rw-r--r--@ 39 phg staff 24 Jan 00:26 -- │ │ ├── 󱁻 99-pve.cfg Configures the data sources for cloud-init. +.rw-r--r--@ 539 phg staff 24 Jan 00:26 -- │ │ └──  debian.sources Debian package sources. +drwxr-xr-x@ - phg staff 23 Jan 23:07 -- │ ├──  http/ Files that Packer provides during build via http. +.rw-r--r--@ 2.4k phg staff 23 Jan 23:09 -- │ │ ├── 󱁻 ks.cfg Kickstart configuration. +.rw-r--r--@ 0 phg staff 23 Jan 22:51 -- │ │ ├── 󰡯 meta-data cloud-init configuration. +.rw-r--r--@ 596 phg staff 23 Jan 23:08 -- │ │ └── 󰡯 user-data cloud-init configuration. +lrwxr-xr-x - phg staff 23 Jan 14:47 -I │ ├──  credentials.auto.pkrvars.hcl -> ../../credentials.auto.pkrvars.hcl Local secrets for Packer (API token, endpoints) used at build time. +.rw-r--r--@ 3.7k phg staff 24 Jan 00:53 -- │ ├──  debian-trixie.pkr.hcl The build template. +lrwxr-xr-x - phg staff 23 Jan 16:03 -- │ ├──  variables-common.pkr.hcl -> ../../variables-common.pkr.hcl Shared Packer variables used by templates. +.rw-r--r--@ 1.9k phg staff 23 Jan 23:00 -- │ └──  variables.pkr.hcl Packer variables only used for this template +drwxr-xr-x@ - phg staff 23 Jan 21:41 -I ├──  downloaded_iso_path/ Packer ISO cache directory (downloaded ISOs and lock files). +.rw-r--r--@ 791M phg staff 23 Jan 21:38 -I │ ├──  dfbf02854ab0b0b828230f78a14eab621dcc09a8.iso +.rw-------@ 0 phg staff 23 Jan 21:41 -I │ └──  dfbf02854ab0b0b828230f78a14eab621dcc09a8.iso.lock +.rw-r--r--@ 1.7k phg staff 23 Jan 21:44 -- ├── 󰊢 .gitignore +.rw-r--r--@ 111 phg staff 23 Jan 15:56 -I ├──  credentials.auto.pkrvars.hcl Local secrets for Packer (API token, endpoints) used at build time. +.rw-r--r--@ 1.3k phg staff 23 Jan 22:48 -- ├──  mise.toml Task runner definitions for init/build/setup. +.rw-r--r--@ 1.8k phg staff 24 Jan 09:24 -M ├── 󰂺 README.md +.rw-r--r--@ 60 phg staff 23 Jan 16:01 -- ├──  template-credentials.pkrvars.hcl Template to create `credentials.auto.pkrvars.hcl`. +.rw-r--r--@ 303 phg staff 23 Jan 16:58 -- └──  variables-common.pkr.hcl Shared Packer variables used by templates. +``` ## Initial Setup @@ -52,3 +84,11 @@ mise run setup ``` E.g. `mise run setup debian 13-trixie` or `mise run setup nixos 25.11`. + +## ToDo + +- [ ] Setup image with LUKS (check if the passphrase slots can be empty to be set later during provision) +- [ ] Setup dropbear +- [ ] Setup Clevis/Tang +- [ ] Lock down root user (remove password, prohibit all logins) +- [ ] Lock down SSH Server