DOC-01: Infrastrukturvorbereitung (Proxmox & Ubuntu)
Erster Schritt der Ressourcenbereitstellung in Proxmox VE, Konfiguration von Ubuntu Server und Bereitstellung der stabilen Docker-Engine.
1. Einführung
Sección titulada «1. Introducción»Dieses technische Dokument legt die operativen Richtlinien für die Bereitstellung und Parametrierung des Basisbetriebssystems (Ubuntu Server) in einer virtualisierten Umgebung auf einem Proxmox VE-Hypervisor fest, um den Knoten für die Bereitstellung des Redmine-Container-Stacks vorzubereiten.
2. Anforderungen an die virtuelle Maschine (Proxmox VE)
Sección titulada «2. Requisitos de la Máquina Virtual (Proxmox VE)»Bei der Instanziierung der virtuellen Maschine im Proxmox-Verwaltungspanel müssen die folgenden minimalen Ressourcengrenzen konfiguriert werden, um Engpässe zu vermeiden, die durch die Ruby on Rails-Architektur (interne Engine von Redmine) und die MySQL-Datenbank-Engine entstehen:
- CPU (Prozessor): 2 schnelle vCPUs (es wird empfohlen,
Type: hostin Proxmox zu konfigurieren, um die direkte Instruktionstranslation des physischen Prozessors zu ermöglichen). - RAM (Arbeitsspeicher): mindestens 4 GB (Ruby on Rails verbraucht während der Kompilierung statischer Ressourcen erheblich Speicher).
- Speicher (Festplatte): 30 GB SSD (oder NVMe) mit Thin Provisioning (thin provisioning).
- Betriebssystem (OS): Ubuntu Server 24.04 LTS oder 22.04 LTS (Neuinstallation).
3. Vorbereitung des Betriebssystems
Sección titulada «3. Preparación del Sistema Operativo»Nach Abschluss des Installationsprozesses des Basissystems und der Einrichtung des sicheren Fernzugriffs via SSH führen Sie die beschriebenen Befehle aus, um das System zu aktualisieren:
3.1. Aktualisierung und Sicherheitspatches
Sección titulada «3.1. Actualización y Parches de Seguridad»# Actualizar base de datos de paquetes y parches del kernelsudo apt update && sudo apt upgrade -y3.2. Installation von Betriebs-Dienstprogrammen
Sección titulada «3.2. Instalación de Utilidades de Operación»Installieren Sie die grundlegenden Werkzeuge, die für das Debugging und die Bearbeitung von Konfigurationen in der Konsole erforderlich sind:
sudo apt install -y curl wget git nano unzip htop4. Installation der Docker Engine (Offizieller Stable-Kanal)
Sección titulada «4. Instalación de Docker Engine (Canal Oficial Stable)»[!IMPORTANT] Die Verwendung der Docker-Version, die durch
snapoder die Standard-Ubuntu-Quellen verpackt ist, ist verboten, da sie nicht mit den aktualisierten Compose V2-Plugins kompatibel ist. Folgen Sie dem offiziellen Fluss:
# 1. Instalar dependencias previas de enrutamiento segurosudo apt install -y apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release
# 2. Añadir la llave criptográfica GPG oficial del registro de Dockercurl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
# 3. Registrar el repositorio oficial estable en las fuentes de Aptecho "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 4. Instalar el motor de contenedores y el plugin Compose modernosudo apt updatesudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin5. Verwaltung von Betriebsprivilegien (Post-Installation)
Sección titulada «5. Gestión de Privilegios Operativos (Post-Instalación)»Um die kontinuierliche Verwendung des Befehls sudo bei der Interaktion mit dem Docker-Socket zu vermeiden (wodurch betriebliche Risiken gemindert und Automatisierungen vereinfacht werden), fügen Sie den Systembenutzer der Engine-Gruppe hinzu:
sudo usermod -aG docker $USER[!CAUTION] Erforderlicher Betriebsschritt: Es ist zwingend erforderlich, die aktive Terminalsitzung (
exit) zu schließen und erneut auf dem SSH-Server anzumelden, um die Berechtigungen des aktuellen Benutzertokens neu zu laden.
6. Funktionsprüfung
Sección titulada «6. Verificación de Funcionamiento»Überprüfen Sie, ob der Dienst aktiv ist und der Benutzer über volle Berechtigungen für den lokalen Daemon verfügt:
docker info# Debería imprimir información de diagnóstico del host sin advertencias de denegación de acceso📊 Checkliste zur Host-Vorbereitung
Sección titulada «📊 Checklist de Preparación de Host»- ✓ Zugewiesene Ressourcen: Validierung von CPU, Arbeitsspeicher und Festplatte auf dem Proxmox-Knoten.
- ✓ Offizielles Docker: Überprüfung des Installationskanals
stableim Vergleich zu veralteten Snap-Versionen. - ✓ Zugriffssicherheit: Neuladen der Konsolensitzung zum Betrieb des Container-Engines.

