Feature: base
Description
This feature installs the base layer for Garden Linux.
What it does
All artifacts and images are based on the base layer, which represents a minimal setup to run the OS itself. This is achieved by debootstrapping the minbase variant. Within this feature all OS-related base configurations (which may still be adjusted by other features on top of it) are applied.
Files
Files present in this feature and their purpose. See the feature file reference for the semantics of each file type.
| File | Purpose |
|---|---|
exec.config (ref) | Applies base OS configuration: locale, APT settings, and initial system setup. |
exec.post (ref) | Post-build cleanup: removes package caches and build-time artifacts. |
file.exclude (ref) | Removes from rootfs: /etc/group-, /etc/gshadow-, /etc/passwd-, /etc/shadow-, /etc/subgid-, ... (11 total). |
file.include.markers.yaml (ref) | Maps files to test-coverage marker IDs. |
fstab (ref) | Defines partition layout. |
info.yaml (ref) | Declares type: element and included/excluded features. |
pkg.exclude (ref) | Prevents installation of: gcc-9-base, gcc-10-base, gcc-11-base. |
pkg.include (ref) | Installs: garden-repo-manager, rng-tools. |
file.include/etc/ucf.conf (file.include) | Configuration for ucf (Update Configuration File), controlling how config file updates are handled during package upgrades. |
file.include/etc/veritytab (file.include) | dm-verity table definition for read-only verified root filesystem support. |
file.include/etc/apt/apt.conf.d/autoclean (file.include) | APT configuration to automatically clean the package cache after installs. |
file.include/etc/apt/apt.conf.d/gzip-indexes (file.include) | APT configuration to store package indexes in compressed form to reduce disk usage. |
file.include/etc/apt/apt.conf.d/no-caches (file.include) | APT configuration that disables caching of downloaded packages. |
file.include/etc/apt/apt.conf.d/no-languages (file.include) | APT configuration that disables downloading of translation files. |
file.include/etc/apt/apt.conf.d/no-recommends (file.include) | APT configuration that disables automatic installation of recommended packages. |
file.include/etc/apt/apt.conf.d/no-suggests (file.include) | APT configuration that disables automatic installation of suggested packages. |
file.include/etc/apt/preferences.d/gardenlinux (file.include) | APT pinning preferences for the Garden Linux repository. |
file.include/etc/dpkg/dpkg.cfg.d/forceold (file.include) | dpkg configuration to keep existing configuration files when packages are updated. |
file.include/etc/dpkg/dpkg.cfg.d/speedup (file.include) | dpkg configuration that speeds up installation by disabling certain checks. |
file.include/etc/dpkg/origins/gardenlinux (file.include) | Declares Garden Linux as the OS origin for dpkg. |
file.include/etc/sysctl.d/10-disable-sysrq.conf (file.include) | Disables the SysRq key to prevent privileged keyboard shortcuts on physical consoles. |
file.include/var/www/.gitignore (file.include) | Placeholder that ensures /var/www exists in the rootfs. |
Related features
Includes:
_slim— provides a slimmed-down package selection for minimal images.