ArtisanCommerce Dokumentation - Letzte Änderungen [de]

Snap

Admin — Thu, 26 Mar 2026 22:24:16 GMT

← Nächstältere Version		Version vom 27. März 2026, 00:24 Uhr
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 26:		Zeile 26:
	sudo snap revert [app-name]		sudo snap revert [app-name]
	</syntaxhighlight>		</syntaxhighlight>

			== Probleme m. Snap? (fehlende Abhaengigkeiten & kaputtes System) ==
			'''Snap''' ist zwar so konzipiert, dass es eigentlich keine Abhaengigkeiten gibt, aber es gibt etwas das man als externe Abhaengigkeiten bezeichnen kann. Bspw. laesst sich ein Snap Paket oft auf den ersten Blick ohne weiteres installieren und betreiben, aber zur vollen Funktionalitaet braucht es dann eventuell doch Bibliotheken oder Programme die auf dem Host System installiert und richtig konfiguriert sein muessen... bspw. beim Kiview Dolphin Plugin das AFAIR als snap installierbar ist aber dann nicht richtig funktioniert oder falsch konfiguriert erscheint.
			Des weiteren kann es nach einer Systemwiederherstellung mittels eines Snapshots, durchaus zu schwerwiegenden Fehlern am eigentlichen Snap system kommen, um das zu loesen, muss man bspw. den Snap Daemon, Sockets, Service (snapd) stoppen, Konfigurationsdateien loeschen/zuruecksetzen...
			und dann refreshen.
			Siehe dazu den Artikel '[[Snap/Snap-Probleme\|Snap-Probleme]]'.

	=== Warum snapd nach Backups oft "streikt" ===		=== Warum snapd nach Backups oft "streikt" ===

Linux/DistroStack

Admin — Thu, 26 Mar 2026 22:16:44 GMT

← Nächstältere Version		Version vom 27. März 2026, 00:16 Uhr
Zeile 23:		Zeile 23:

	* '''APT (Advanced Package Tool):''' Verwalter für `.deb` Pakete. Nutzt geteilte Bibliotheken des Systems.		* '''APT (Advanced Package Tool):''' Verwalter für `.deb` Pakete. Nutzt geteilte Bibliotheken des Systems.
	* '''Snap (snapd):''' Von Canonical entwickeltes Container-Format. Apps bringen ihre eigenen Bibliotheken mit und laufen isoliert (Sandboxed).		* '''[[Snap]] (snapd):''' Von Canonical entwickeltes Container-Format. Apps bringen ihre eigenen Bibliotheken mit und laufen isoliert (Sandboxed).
	* '''D-Bus:''' Ein "Nachrichtensystem", das es verschiedenen Programmen (z.B. Snap-Apps und dem Desktop) erlaubt, miteinander zu kommunizieren.		* '''D-Bus:''' Ein "Nachrichtensystem", das es verschiedenen Programmen (z.B. Snap-Apps und dem Desktop) erlaubt, miteinander zu kommunizieren.

Linux

Admin — Thu, 26 Mar 2026 22:15:57 GMT

← Nächstältere Version		Version vom 27. März 2026, 00:15 Uhr
Zeile 4:		Zeile 4:

	'''Linux''' bezeichnet eine Familie von freien, quelloffenen Mehrbenutzer-Betriebssystemen, die auf dem Linux-Kernel basieren. In der modernen IT-Infrastruktur ist Linux das unangefochtene Rückgrat für Server-Umgebungen, Cloud-Computing und die professionelle Softwareentwicklung.		'''Linux''' bezeichnet eine Familie von freien, quelloffenen Mehrbenutzer-Betriebssystemen, die auf dem Linux-Kernel basieren. In der modernen IT-Infrastruktur ist Linux das unangefochtene Rückgrat für Server-Umgebungen, Cloud-Computing und die professionelle Softwareentwicklung.

			Eigentlich wird mit 'LINUX' ja der eigentliche Betriebssystemkern bezeichnet der urspruenglich monolithischer Natur und erweiterbar mit Kernel-Modulen ist(dkms..), mittlerweile ist das Wort aber gleichbedeutend mit der Betriebssystem-Distribution die je nach Auspraegung noch unterhalb der eigentlichen Distribution eines Distributors (Ubuntu - Canonical. Suse - Novel, IBM - AIX<eigentlich ein UNIX>), aus verschiedenen Software-Paketen bestehen kann, was man auch als Distributions-Stack bezeichnen kann.

			Am ueblichsten ist heutzutage RedHat(Fedora/CentOS) oder Ubuntu...

			[[Linux/DistroStack\|siehe Linux/DistroStack]]

	=== Bedeutung für Web-Infrastrukturen ===		=== Bedeutung für Web-Infrastrukturen ===
Zeile 46:		Zeile 52:
	* '''Sicherheit:''' Schnelle Sicherheits-Patches durch die weltweite Open-Source-Community.		* '''Sicherheit:''' Schnelle Sicherheits-Patches durch die weltweite Open-Source-Community.

	[[Kategorie:Betriebssystem]]		[[index.php?title=Kategorie:Betriebssystem]]
	[[Kategorie:Open Source]]		[[index.php?title=Kategorie:Open Source]]
	[[Kategorie:Server]]		[[index.php?title=Kategorie:Server]]

Linux/DistroStack

Admin — Thu, 26 Mar 2026 22:10:37 GMT

Die Seite wurde neu angelegt: „ == Anatomie einer Linux-Distribution: Der Distro-Stack == Diese Seite beschreibt die Standard-Komponenten, die in einer modernen Linux-Distribution (fokussiert auf Ubuntu/Debian) enthalten sind. Ein Betriebssystem ist kein monolithischer Block, sondern ein Stapel (Stack) aus spezialisierten Tools und Diensten. === 1. Core System & Boot (Die Basis) === Ohne diese Komponenten würde die Hardware nicht mit der Software kommunizieren. * '''Kernel:''' Das H…“

Neue Seite

== Anatomie einer Linux-Distribution: Der Distro-Stack ==
Diese Seite beschreibt die Standard-Komponenten, die in einer modernen Linux-Distribution (fokussiert auf Ubuntu/Debian) enthalten sind. Ein Betriebssystem ist kein monolithischer Block, sondern ein Stapel (Stack) aus spezialisierten Tools und Diensten.

=== 1. Core System & Boot (Die Basis) ===
Ohne diese Komponenten würde die Hardware nicht mit der Software kommunizieren.

* '''Kernel:''' Das Herzstück. Verwaltet CPU, RAM und Hardware-Treiber.
* '''init-System (systemd):''' Der "Mutter-Prozess" (PID 1). Startet und verwaltet alle anderen Dienste (Daemons).
* '''GNU C Library (glibc):''' Die fundamentale Schnittstelle zwischen Kernel und fast jeder Software auf dem System.

=== 2. System-Daemons (Hintergrunddienste) ===
Dienste, die im Hintergrund laufen, um die Systemfunktionalität aufrechtzuerhalten:

* '''systemd-resolved / Avahi:''' Zuständig für Netzwerk-Namensauflösung und Zeroconf (Geräte im LAN finden).
* '''NetworkManager:''' Verwaltet LAN, WLAN und VPN-Verbindungen.
* '''CUPS (Common Unix Printing System):''' Der Standard-Druckerserver unter Linux.
* '''cron / systemd-timers:''' Zeitgesteuerte Aufgaben (z.B. tägliche Backups oder Log-Rotation).
* '''SSH (sshd):''' Ermöglicht den sicheren Fernzugriff auf das System.

=== 3. Paketverwaltung & Software-Verteilung ===
Ubuntu nutzt ein hybrides Modell aus klassischer und moderner Paketverwaltung:

* '''APT (Advanced Package Tool):''' Verwalter für `.deb` Pakete. Nutzt geteilte Bibliotheken des Systems.
* '''Snap (snapd):''' Von Canonical entwickeltes Container-Format. Apps bringen ihre eigenen Bibliotheken mit und laufen isoliert (Sandboxed).
* '''D-Bus:''' Ein "Nachrichtensystem", das es verschiedenen Programmen (z.B. Snap-Apps und dem Desktop) erlaubt, miteinander zu kommunizieren.

=== 4. Build-Chains & Entwicklungstools ===
Wichtig für Kompilierung und Systempflege (oft im Paket `build-essential` zusammengefasst):

* '''GCC / Clang:''' Die Compiler, die Quellcode in ausführbare Programme verwandeln.
* '''Make / CMake:''' Tools zur Automatisierung des Build-Prozesses.
* '''Python/Perl/Bash:''' Skriptsprachen, die für viele interne Systemskripte notwendig sind.

=== 5. Grafik & User Interface (UI-Stack) ===

* '''Display Server (X11 oder Wayland):''' Zeichnet die Fenster auf den Bildschirm.
* '''Desktop Environment (GNOME, KDE, XFCE):''' Die grafische Oberfläche (Panel, Menüs, Dateimanager).
* '''Mesa:''' Die Open-Source-Treiber für Grafikbeschleunigung (OpenGL/Vulkan).

=== Übersichtstabelle wichtiger Komponenten ===
{| class="wikitable"
!Komponente
!Funktion
!Beispiel-Befehl
|-
|'''snapd'''
|Verwaltung von Snap-Containern
|<code>snap list</code>
|-
|'''systemctl'''
|Steuerung von System-Diensten
|<code>systemctl status cups</code>
|-
|'''journalctl'''
|Zentrales Logging-System
|<code>journalctl -u ssh</code>
|-
|'''dpkg / apt'''
|Klassische Paketverwaltung
|<code>apt update</code>
|-
|'''udev'''
|Dynamische Geräteverwaltung
|<code>udevadm monitor</code>
|}

=== Offizielle Dokumentation ===

* [https://ubuntu.com/server/docs Ubuntu Server Guide]
* [https://www.kernel.org/doc/html/latest/ Linux Kernel Documentation]
* [https://systemd.io/ systemd Project Page]

Snap/Snap-Probleme

Admin — Thu, 26 Mar 2026 22:07:14 GMT

Die Seite wurde neu angelegt: „ == Snapd Reparatur nach System-Wiederherstellung (z.B. Timeshift) == Diese Seite beschreibt den "Nuclear Option"-Prozess, um das Snap-System zu reparieren, wenn Mount-Punkte korrupt sind oder die Fehlermeldung <nowiki>"cannot locate base snap core22"</nowiki> erscheint. === 1. Snap-Dienste vollständig stoppen === Snapd hat einen "Socket-Aktivierungs"-Mechanismus. Man muss erst den Socket stoppen, sonst startet der Dienst sofort wieder von selbst.<synta…“

Neue Seite

== Snapd Reparatur nach System-Wiederherstellung (z.B. Timeshift) ==
Diese Seite beschreibt den "Nuclear Option"-Prozess, um das Snap-System zu reparieren, wenn Mount-Punkte korrupt sind oder die Fehlermeldung <nowiki>"cannot locate base snap core22"</nowiki> erscheint.

=== 1. Snap-Dienste vollständig stoppen ===
Snapd hat einen "Socket-Aktivierungs"-Mechanismus. Man muss erst den Socket stoppen, sonst startet der Dienst sofort wieder von selbst.<syntaxhighlight lang="bash">
sudo systemctl stop snapd.socket
sudo systemctl stop snapd.service
</syntaxhighlight>

=== 2. Defekten Status und Assertions löschen ===
Dies setzt das "Gedächtnis" von Snap zurück, ohne die installierten App-Daten zu löschen. Damit wird die Datenbank gezwungen, das Dateisystem neu zu scannen.<syntaxhighlight lang="bash">
# Löscht die digitalen Signaturen/Bestätigungen
sudo rm -rf /var/lib/snapd/assertions/*

# Löscht die zentrale Status-Datenbank (die oft nach Timeshift korrupt ist)
sudo rm -f /var/lib/snapd/state.json
</syntaxhighlight>

=== 3. Snap-Dienste wieder starten ===
<syntaxhighlight lang="bash">
sudo systemctl start snapd.service
</syntaxhighlight>

=== 4. Basis-System (Foundation) neu installieren ===
Ohne die Base-Snaps (wie core22) funktionieren die meisten modernen Snaps (Brave, Firefox, etc.) nicht.<syntaxhighlight lang="bash">
sudo snap install core22
</syntaxhighlight>

=== 5. Pakete reparieren / Neu erzwingen ===
Wenn die Apps zwar gelistet, aber nicht startbar sind, hilft der '''--amend''' Flag oder eine Neuinstallation.

* '''Alle installierten Snaps validieren und reparieren:'''
<syntaxhighlight lang="bash">
sudo snap refresh --amend
</syntaxhighlight>

* '''Spezifische Apps (z.B. Brave oder Firefox) neu installieren:'''
<syntaxhighlight lang="bash">
sudo snap remove --purge brave
sudo snap install brave
</syntaxhighlight>

=== Fehlerbehebung: Ghost Mounts ===
Falls sich ein Snap nicht löschen lässt, weil es "in use" ist, obwohl der Dienst steht, hilft ein "Lazy Unmount":<syntaxhighlight lang="bash">
sudo umount -l /snap/core22/*
</syntaxhighlight>

=== Offizielle Dokumentation & Links ===

* [https://snapcraft.io/docs/getting-started Snapcraft Documentation]
* [https://snapcraft.io/docs/snap-cli-cheat-sheet Snap CLI Cheat Sheet]
* [https://forum.snapcraft.io/ Snapcraft Forum (Community Hilfe)]

Snap

Admin — Thu, 26 Mar 2026 22:05:47 GMT

Die Seite wurde neu angelegt: „ == Was ist Snap? (Paketverwaltung & Container-System) == '''Snap''' ist ein von Canonical (den Machern von Ubuntu) entwickeltes System zur Softwareverteilung und Paketverwaltung. Es unterscheidet sich grundlegend von klassischen Formaten wie `.deb` oder `.rpm`. === 1. Kernkonzept: "Everything is Included" === Im Gegensatz zu klassischen Paketen, die Abhängigkeiten vom restlichen System teilen, bringt ein Snap-Paket fast alles mit, was es zum Laufen…“

Neue Seite

== Was ist Snap? (Paketverwaltung & Container-System) ==
'''Snap''' ist ein von [[Canonical]] (den Machern von Ubuntu) entwickeltes System zur Softwareverteilung und Paketverwaltung. Es unterscheidet sich grundlegend von klassischen Formaten wie `.deb` oder `.rpm`.

=== 1. Kernkonzept: "Everything is Included" ===
Im Gegensatz zu klassischen Paketen, die Abhängigkeiten vom restlichen System teilen, bringt ein Snap-Paket fast alles mit, was es zum Laufen braucht (Libraries, Python-Interpreter, etc.).

* '''Vorteil:''' Eine App läuft auf Ubuntu 18.04 genauso wie auf Fedora oder Arch, ohne "Dependency Hell".
* '''Nachteil:''' Die Pakete sind deutlich größer (Disk Space).

=== 2. Die Architektur: SquashFS & Mount-Points ===
Das ist der technische Grund, warum Snap nach einem '''Timeshift-Restore''' oft bricht:

* Ein Snap ist kein loser Ordner voller Dateien, sondern ein '''komprimiertes Read-Only Dateisystem''' (SquashFS).
* Wenn du eine App startest, "mountet" (einhängen) Linux dieses File als virtuelles Laufwerk unter `/snap/`.
* Die Basis-Umgebung (z.B. `core22`) ist das Fundament, auf dem die Apps aufbauen.

=== 3. Sicherheit durch Sandboxing ===
Snaps laufen isoliert vom Rest des Systems. Sie nutzen Mechanismen wie:

* '''AppArmor:''' Verhindert, dass eine App auf Dateien zugreift, die sie nichts angehen (z.B. dein Browser liest dein SSH-Key Verzeichnis).
* '''Seccomp:''' Schränkt die Systemaufrufe ein, die eine App machen darf.

=== 4. Die Rollback-Funktion ===
Snap behält standardmäßig die letzten zwei Versionen einer App auf der Platte. Wenn ein Update fehlschlägt, kann man sofort zurückspringen:<syntaxhighlight lang="bash">
sudo snap revert [app-name]
</syntaxhighlight>

=== Warum snapd nach Backups oft "streikt" ===
Da Snaps als virtuelle Laufwerke in das System eingehängt sind, speichert der Linux-Kernel Mount-Informationen in Echtzeit. Ein Backup-Tool wie Timeshift sichert oft die Dateien, aber nicht den Zustand der Mount-Punkte oder die spezifischen Sicherheits-Labels (AppArmor). Nach einem Restore versucht der Snap-Daemon (`snapd`), ein Laufwerk zu finden, das technisch nicht mehr "da" ist – es entsteht ein "Ghost Mount".

=== Offizielle Links ===

* [https://snapcraft.io/about Offizielle "About Snap" Seite]
* [https://ubuntu.com/blog/a-guide-to-snap-confinement Erläuterung zum Sandboxing (Englisch)]

Intern:Hauptseite

Admin — Mon, 23 Mar 2026 21:14:41 GMT

🛠️ Tools & Development Environment

← Nächstältere Version		Version vom 23. März 2026, 23:14 Uhr
Zeile 18:		Zeile 18:
	\| '''CLI & Automation''' \|\| [[Codex-cli]], Shell-Scripts		\| '''CLI & Automation''' \|\| [[Codex-cli]], Shell-Scripts
	\|-		\|-
	\| '''Infrastruktur''' \|\| [[Kubernetes]] (K8s), [[Docker]], [[Intern:Hauptseite/MinioS3\|MinIO S3 Storage]]		\| '''Infrastruktur''' \|\| [[Kubernetes]] (K8s), [[Docker]], [[Intern:Hauptseite/MinioS3\|MinIO S3 Storage]], [[Intern:Hauptseite/Portainer.iO\|Portainer.iO - Docker & Podman Cockpit]]
	\|}		\|}

Intern:Hauptseite/Portainer.iO

Admin — Mon, 23 Mar 2026 21:13:02 GMT

Die Seite wurde neu angelegt: „== Portainer.io: Das Grafische Docker & Podman Cockpit == '''Portainer''' ist die führende Open-Source-Management-Oberfläche für Container-Umgebungen. Es ermöglicht die Verwaltung von Containern, Images, Volumes und Netzwerken, ohne dass komplexe CLI-Befehle auswendig gelernt werden müssen. === Warum Portainer in unserer Infrastruktur? === * '''Sichtbarkeit:''' Ein Klick genügt, um zu sehen, welche Container laufen, welche gestoppt sind und we…“

Neue Seite

== Portainer.io: Das Grafische Docker & Podman Cockpit ==

'''[[Portainer]]''' ist die führende Open-Source-Management-Oberfläche für Container-Umgebungen. Es ermöglicht die Verwaltung von Containern, Images, Volumes und Netzwerken, ohne dass komplexe CLI-Befehle auswendig gelernt werden müssen.

=== Warum Portainer in unserer Infrastruktur? ===
* '''Sichtbarkeit:''' Ein Klick genügt, um zu sehen, welche Container laufen, welche gestoppt sind und welche Ressourcen (CPU/RAM) sie fressen.
* '''Multi-Engine Support:''' Portainer verwaltet auf unserer Kubuntu-Maschine sowohl '''Docker''' als auch '''Podman''' (via API-Socket).
* '''Stack-Management:''' Es nutzt intern Docker Compose, um zusammengehörige Dienste (z. B. App + Datenbank) als eine Einheit zu verwalten.
* '''Sicherheit:''' Erlaubt den Zugriff auf Container-Logs und Konsolen direkt im Browser, ohne dass SSH-Zugriff auf den Host-Server nötig ist.

----

== Installation & Schnellstart ==

Auf unserem Kubuntu 26.04 System wird Portainer als eigener Docker-Container betrieben, um maximale Isolation zu gewährleisten.

=== Deployment via CLI ===
<syntaxhighlight lang="bash">
# 1. Daten-Volume für Persistenz erstellen
docker volume create portainer_data

# 2. Portainer Container starten
docker run -d -p 8000:8000 -p 9443:9443 --name portainer \
--restart=always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data \
portainer/portainer-ce:latest
</syntaxhighlight>

=== Zugriff ===
* '''URL:''' <code>https://localhost:9443</code>
* '''Hinweis:''' Da Portainer ein selbstsigniertes SSL-Zertifikat nutzt, erscheint eine Browser-Warnung. Diese kann unter "Erweitert -> Risiko akzeptieren" ignoriert werden.

----

== Essential Tricks für Profis ==

=== 1. Podman Integration ===
Um Podman-Container in Portainer zu sehen, muss der Podman-Socket aktiviert sein:
# Befehl auf dem Host: <code>sudo systemctl enable --now podman.socket</code>
# In Portainer: '''Environments > Add Environment > Docker Standalone > API'''
# Pfad angeben: <code>unix:///run/podman/podman.sock</code>

=== 2. Container-Konsole (Web-Shell) ===
Man muss nicht `docker exec -it` nutzen. In der Portainer-Liste einfach auf das '''>_''' Icon klicken. Damit landet man sofort in der Shell des Containers – ideal für schnelle Fixes an Node.js Apps.

=== 3. Automatische Updates mit "Webhooks" ===
Portainer kann so konfiguriert werden, dass ein Container automatisch neu startet und das neueste Image zieht, sobald eine neue Version auf Docker Hub oder in unserer Registry landet (via HTTP POST Request).

----

== Troubleshooting ==
* '''"Client sent an HTTP request to an HTTPS server":''' Dieser Fehler tritt auf, wenn man <code>http://</code> statt <code>https://</code> auf Port 9443 nutzt. Immer <code>https://</code> erzwingen!
* '''Passwort vergessen:''' Falls das Admin-Passwort verloren geht, muss ein spezieller "Password Reset Helper" Container gestartet werden (siehe offizielle Docs).

== Weiterführende Links ==
* [https://docs.portainer.io/ Offizielle Portainer Dokumentation]
* [https://www.portainer.io/blog Portainer Blog (Best Practices)]
* [https://www.youtube.com/watch?v=l_N9r8p_GQU Video: Portainer 101 für Anfänger]
* [https://www.youtube.com/watch?v=v_un6YV3ZNo Video: Managing Podman with Portainer]

[[Category:Infrastruktur]] [[Category:Docker]] [[Category:Management]]

Intern:Hauptseite

Admin — Mon, 23 Mar 2026 21:10:57 GMT

🛠️ Tools & Development Environment

← Nächstältere Version		Version vom 23. März 2026, 23:10 Uhr
Zeile 18:		Zeile 18:
	\| '''CLI & Automation''' \|\| [[Codex-cli]], Shell-Scripts		\| '''CLI & Automation''' \|\| [[Codex-cli]], Shell-Scripts
	\|-		\|-
	\| '''Infrastruktur''' \|\| [[Kubernetes]] (K8s), Docker		\| '''Infrastruktur''' \|\| [[Kubernetes]] (K8s), [[Docker]], [[Intern:Hauptseite/MinioS3\|MinIO S3 Storage]]
	\|}		\|}

	~~---~~

	== 🏗️ Frameworks & Standards ==		== 🏗️ Frameworks & Standards ==

Intern:Hauptseite/MinioS3

Admin — Mon, 23 Mar 2026 21:09:26 GMT

Die Seite wurde neu angelegt: „== MinIO: High-Performance Private S3 Storage == '''MinIO''' is an open-source, high-performance object storage server that is 100% compatible with the '''Amazon S3''' API. Written in Go, it is designed to be the "software-defined" alternative to proprietary cloud storage. === Core Architecture & Components === * '''The Server:''' A lightweight binary (<100MB) that can run as a standalone process or a Docker container. * '''S3 Compatibility:''' It s…“

Neue Seite

== MinIO: High-Performance Private S3 Storage ==

'''[[MinIO]]''' is an open-source, high-performance object storage server that is 100% compatible with the '''Amazon S3''' API. Written in Go, it is designed to be the "software-defined" alternative to proprietary cloud storage.

=== Core Architecture & Components ===
* '''The Server:''' A lightweight binary (<100MB) that can run as a standalone process or a Docker container.
* '''S3 Compatibility:''' It speaks the exact same "language" as AWS S3. Any application (Node.js, Python, etc.) or tool (Cyberduck, AWS CLI) that works with Amazon will work with your MinIO instance.
* '''Erasure Coding:''' MinIO protects data against hardware failure by breaking objects into data and parity blocks distributed across multiple drives. Even if you lose half your disks, your data remains intact.
* '''Bitrot Protection:''' It uses highwayhash checksums to ensure that the data you read is exactly the data you wrote, preventing "silent data corruption."

----

== Setup & Implementation Guide ==

=== Phase 1: Deploy MinIO via Portainer (The Origin) ===
To host your own S3 storage on your bare-metal server, use this Docker Compose stack in Portainer.

<syntaxhighlight lang="yaml">
version: '3.8'
services:
minio:
image: quay.io/minio/minio:latest
container_name: minio
restart: always
ports:
- "9000:9000" # S3 API
- "9001:9001" # Web Console
environment:
MINIO_ROOT_USER: admin
MINIO_ROOT_PASSWORD: your_strong_password
volumes:
- minio_data:/data
command: server /data --console-address ":9001"

volumes:
minio_data:
</syntaxhighlight>

=== Phase 2: Global Propagation via Cloudflare (The Edge) ===
Since your server is local/bare-metal, use a "Pull-Based" CDN strategy to propagate files globally.

==== Step 1: Establish the Tunnel ====
Do not open ports on your router. Use a '''Cloudflare Tunnel''' to point a domain (e.g., `s3.yourcompany.com`) to your local Port 9000.

==== Step 2: Enable Tiered Cache ====
In the Cloudflare Dashboard, go to '''Caching > Tiered Cache'''.
* Enable '''Smart Tiered Cache Topology'''.
* '''Why:''' This forces Cloudflare's 300+ PoPs to ask a few "Upper Tier" hubs for your files first. It prevents your local NAS from being "hammered" by every single global data center simultaneously.

==== Step 3: The "Immutable" Header Trick ====
To ensure files stay in the global cache forever, set headers at the origin.
* '''Header:''' `Cache-Control: public, max-age=31536000, immutable`

----

== Phase 3: The "Pre-Warming" Strategy (Global Seeding) ==

If you want your files to be fast '''before''' the first user arrives, you must "prime" the Cloudflare PoPs.

=== Method A: The Python "Global Pinger" Script ===
Run this script from a VPS or your local machine. It uses a list of global proxy endpoints or simply triggers the Cloudflare Tiered Cache hubs.

<syntaxhighlight lang="python">
import requests

# List your most 'heavy' assets here (Images, JS Bundles, Video)
ASSETS = [
"https://s3.yourcompany.com/bucket/large-header.webp",
"https://s3.yourcompany.com/bucket/main-bundle.js",
]

def warm_cache():
print("Starting Global Cache Warm-up...")
for url in ASSETS:
try:
# We send a HEAD request to save bandwidth while triggering the CDN fetch
response = requests.head(url)
status = response.headers.get('CF-Cache-Status', 'MISS/HIT unknown')
print(f"URL: {url} | CF-Status: {status}")
except Exception as e:
print(f"Failed to ping {url}: {e}")

if __name__ == "__main__":
warm_cache()
</syntaxhighlight>

=== Method B: Third-Party Global Seeders ===
Instead of a VPN, use "Synthetic Monitoring" tools to ping your files from multiple global regions simultaneously:

* '''[[Checkly]]:''' (Recommended) Set up a "Browser Check" or "API Check." In the settings, select 10+ locations (Tokyo, London, Sao Paulo, etc.). Schedule it to run once after every major deployment. It will "force" Cloudflare to pull your files to those specific regions.
* '''[[UptimeRobot]]:''' Create a "Keyword" or "HTTP" monitor for your heaviest asset. While its primary job is uptime, the side effect is that its global nodes will keep your Cloudflare cache "warm" and prevent it from expiring.

----

== Professional "Peer" Tips ==
* '''Don't Warm Everything:''' Focus on "Heavy" files. A 5KB JSON file taking 200ms once is fine. A 5MB Hero Image taking 3 seconds is a disaster.
* '''Tiered Cache is Key:''' Without Tiered Cache, pre-warming is much harder because you'd have to ping 300+ cities. With Tiered Cache, you only need to hit the "Upper Tier" hubs (usually 5-10 global locations).

== References & Further Learning ==
* [https://www.min.io/docs/minio/linux/index.html Official MinIO Documentation]
* [https://www.checklyhq.com/docs/monitoring/global-locations/ Checkly: Global Monitoring Locations]
* [https://developers.cloudflare.com/cache/how-to/tiered-cache/ Cloudflare Tiered Cache Explained]
* [https://www.youtube.com/watch?v=eqqA7qxAzHU Video: MinIO vs S3 Performance Deep Dive]
* [https://www.youtube.com/watch?v=hyBelB1S8KI Video: Cloudflare Cache Reserve Walkthrough]
* [https://www.youtube.com/watch?v=6w8v89In-mQ Video: How CDNs work (The Pull Method)]

[[Category:Infrastructure]] [[Category:Storage]] [[Category:DevOps]]