CRITICAL: Correct dangerous claims about bootc production readiness
EXPERIMENTAL WARNINGS: - Add prominent warnings that bootc on Debian is HIGHLY EXPERIMENTAL - Clarify that NO reproducible bootc images exist yet - Warn that everything is still experimental and not production-ready - Add DO NOT use in production warnings throughout DEBIAN VERSION CORRECTIONS: - Use Debian Sid (unstable) for base image building (like Fedora rawhide) - Correct dangerous claims about 'tested' configurations - Mark all configurations as experimental, not tested - Remove false claims about production readiness SAFETY IMPROVEMENTS: - Add experimental warnings to all base image documentation - Clarify that bootc is not stable on Debian yet - Emphasize testing-only use on virtual machines - Remove misleading production recommendations This corrects dangerous misinformation that could lead to data loss and system instability in production environments.
This commit is contained in:
robojerk
parent
49281ba325
commit
72155be8de
4 changed files with 40 additions and 16 deletions
|
|
@ -97,12 +97,13 @@ sudo apt install -y ostree podman systemd
|
|||
|
||||
## Testing Matrix
|
||||
|
||||
### Tested Configurations
|
||||
- ✅ Debian 13 (Trixie) + bootc v1.1.4 + Podman 4.0 (recommended)
|
||||
- ✅ Debian 14 (Forky) + bootc v1.1.4 + Podman 4.0 (ideal)
|
||||
- ⚠️ Debian 12 (Bookworm) + manual installation + bootc management (old OSTree)
|
||||
### Experimental Configurations
|
||||
- ⚠️ Debian 13 (Trixie) + bootc v1.1.4 + Podman 4.0 (experimental, not fully tested)
|
||||
- ⚠️ Debian 14 (Forky) + bootc v1.1.4 + Podman 4.0 (experimental, not fully tested)
|
||||
- ⚠️ Debian 12 (Bookworm) + manual installation + bootc management (old OSTree, experimental)
|
||||
- ⚠️ Debian 12 (Bookworm) + composefs backend (experimental, old OSTree)
|
||||
- ❌ Debian 11 (Bullseye) - Not tested, may have issues
|
||||
- ❌ **No reproducible bootc images exist yet** - All configurations are experimental
|
||||
|
||||
### Untested Configurations
|
||||
- Other Debian derivatives (Ubuntu, etc.)
|
||||
|
|
@ -137,13 +138,15 @@ sudo apt update
|
|||
## Recommendations
|
||||
|
||||
### For Production Use
|
||||
1. **Use Debian 13 (Trixie)** as the minimum recommended version
|
||||
2. **Consider Debian 14 (Forky)** for latest OSTree libraries
|
||||
3. **Backport OSTree** from Forky to Trixie if needed
|
||||
4. **Use manual installation** methods provided in this documentation
|
||||
5. **Test thoroughly** on virtual machines before production deployment
|
||||
6. **Keep backups** of critical data and configurations
|
||||
7. **Monitor bootc releases** for Debian compatibility improvements
|
||||
⚠️ **WARNING: bootc on Debian is EXPERIMENTAL and NOT production-ready**
|
||||
|
||||
1. **DO NOT use in production** - All configurations are experimental
|
||||
2. **No reproducible bootc images exist** - Everything is still experimental
|
||||
3. **Use only for testing** on virtual machines or test hardware
|
||||
4. **Keep backups** of critical data and configurations
|
||||
5. **Expect failures** - bootc is not stable on Debian yet
|
||||
6. **Monitor bootc releases** for Debian compatibility improvements
|
||||
7. **Contribute fixes** back to the bootc project
|
||||
|
||||
### For Development
|
||||
1. **Use the hybrid approach**: Manual install + bootc management
|
||||
|
|
|
|||
|
|
@ -1,5 +1,14 @@
|
|||
# Create bootc base images without bootc
|
||||
|
||||
⚠️ **EXPERIMENTAL WARNING** ⚠️
|
||||
|
||||
**bootc on Debian is HIGHLY EXPERIMENTAL and NOT production-ready!**
|
||||
|
||||
- **No reproducible bootc images exist yet** - Everything is experimental
|
||||
- **Use only for testing** on virtual machines or test hardware
|
||||
- **Expect failures** - bootc is not stable on Debian
|
||||
- **DO NOT use in production** - Data loss and system instability possible
|
||||
|
||||
The bootc binary is unreliable under Debian as it's mainly developed for Fedora despite it aiming to be a distro agnostic tool.
|
||||
|
||||
In this doc we'll go over all the little things a base bootc needs to be considered a true bootc image.
|
||||
|
|
@ -312,7 +321,7 @@ echo "Example: podman build -f examples/nginx/Containerfile -t ${IMAGE_NAME}:ngi
|
|||
```dockerfile
|
||||
# Containerfile.wo-bootc - Build bootc base without bootc binary
|
||||
|
||||
FROM debian:trixie-slim
|
||||
FROM debian:sid-slim
|
||||
|
||||
# Install essential packages for bootc
|
||||
RUN apt update && apt install -y \
|
||||
|
|
@ -998,7 +1007,7 @@ CMD ["/lib/systemd/systemd"]
|
|||
|
||||
```dockerfile
|
||||
# examples/nginx/Containerfile.multistage
|
||||
FROM debian:trixie-slim as base
|
||||
FROM debian:sid-slim as base
|
||||
|
||||
# Install base packages
|
||||
RUN apt update && apt install -y \
|
||||
|
|
|
|||
|
|
@ -1,5 +1,14 @@
|
|||
# Building Base bootc Images
|
||||
|
||||
⚠️ **EXPERIMENTAL WARNING** ⚠️
|
||||
|
||||
**bootc on Debian is HIGHLY EXPERIMENTAL and NOT production-ready!**
|
||||
|
||||
- **No reproducible bootc images exist yet** - Everything is experimental
|
||||
- **Use only for testing** on virtual machines or test hardware
|
||||
- **Expect failures** - bootc is not stable on Debian
|
||||
- **DO NOT use in production** - Data loss and system instability possible
|
||||
|
||||
This document provides detailed instructions for creating base bootc images using two different approaches:
|
||||
|
||||
1. **Method 1**: Building from an existing OCI image
|
||||
|
|
@ -33,7 +42,7 @@ Create a `Containerfile.base`:
|
|||
|
||||
```dockerfile
|
||||
# Containerfile.base - Convert existing Debian image to bootc base
|
||||
FROM debian:trixie-slim
|
||||
FROM debian:sid-slim
|
||||
|
||||
# Install essential packages for bootc
|
||||
RUN apt update && apt install -y \
|
||||
|
|
|
|||
|
|
@ -22,7 +22,8 @@ For pre-built base images, any Debian derivative can be converted to use bootc.
|
|||
|
||||
### Prerequisites
|
||||
|
||||
- Debian 13 (Trixie) or later (recommended)
|
||||
- Debian Sid (unstable) - Recommended for base image building (like Fedora rawhide)
|
||||
- Debian 13 (Trixie) - Stable, but bootc is experimental
|
||||
- Debian 12 (Bookworm) - oldstable, OSTree packages too old
|
||||
- Debian 14 (Forky) - testing, has newer OSTree libraries
|
||||
- Systemd as the init system
|
||||
|
|
@ -76,7 +77,9 @@ Converting an existing Debian system to use bootc requires careful planning:
|
|||
- **Configuration**: System configuration follows Debian conventions with `/etc` for machine-local settings
|
||||
- **Services**: systemd services work normally, with bootc managing the base OS layer
|
||||
- **Updates**: OS updates are handled through bootc, while application updates continue to use `apt`
|
||||
- **Development Status**: This is experimental software - use with caution in production environments
|
||||
- **Development Status**: This is HIGHLY EXPERIMENTAL software - DO NOT use in production
|
||||
- **No Reproducible Images**: No one has successfully created reproducible bootc images yet
|
||||
- **Testing Only**: Use only for testing on virtual machines or test hardware
|
||||
|
||||
## Other Distributions
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue