Ir al contenido

DOC-01: Infrastrukturvorbereitung (Proxmox & Ubuntu)

Erster Schritt der Ressourcenbereitstellung in Proxmox VE, Konfiguration von Ubuntu Server und Bereitstellung der stabilen Docker-Engine.

0Lesungen

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: host in 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).

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:

Ventana de terminal
# Actualizar base de datos de paquetes y parches del kernel
sudo apt update && sudo apt upgrade -y

3.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:

Ventana de terminal
sudo apt install -y curl wget git nano unzip htop

4. 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 snap oder die Standard-Ubuntu-Quellen verpackt ist, ist verboten, da sie nicht mit den aktualisierten Compose V2-Plugins kompatibel ist. Folgen Sie dem offiziellen Fluss:

Ventana de terminal
# 1. Instalar dependencias previas de enrutamiento seguro
sudo 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 Docker
curl -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 Apt
echo "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 moderno
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

5. 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:

Ventana de terminal
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.


Überprüfen Sie, ob der Dienst aktiv ist und der Benutzer über volle Berechtigungen für den lokalen Daemon verfügt:

Ventana de terminal
docker info
# Debería imprimir información de diagnóstico del host sin advertencias de denegación de acceso

  • ✓ Zugewiesene Ressourcen: Validierung von CPU, Arbeitsspeicher und Festplatte auf dem Proxmox-Knoten.
  • ✓ Offizielles Docker: Überprüfung des Installationskanals stable im Vergleich zu veralteten Snap-Versionen.
  • ✓ Zugriffssicherheit: Neuladen der Konsolensitzung zum Betrieb des Container-Engines.