Ir al contenido

DOC-01: Príprava infraštruktúry (Proxmox & Ubuntu)

Počiatočný krok aprovisionovania zdrojov v Proxmox VE, konfigurácia Ubuntu Server a nasadenie stabilného Docker motora.

0lecturas

Tento technický dokument stanovuje operačné smernice pre aprovisionovanie a parametrizáciu základného operačného systému (Ubuntu Server) v virtualizovanom prostredí na hypervizore Proxmox VE, pripravujúci uzol pre nasadenie kontajnerového stacku Redmine.


Pri instancovaní virtuálneho stroja v administračnom paneli Proxmox je nutné nakonfigurovať nasledujúce minimálne limity zdrojov, aby sa predišlo úzkym miestam generovaným architektúrou Ruby on Rails (vnútorný motor Redmine) a motorom databáze MySQL:

  • CPU (procesor): 2 vCPUs rýchleho výkonu (odporúča sa nakonfigurovať Type: host v Proxmox, aby sa umožnil priamy preklad inštrukcií fyzického procesora).
  • RAM (pamäť): 4 GB minimálne (Ruby on Rails spotrebúva značné množstvo pamäte počas kompilácie statických zdrojov).
  • Úložisko (disk): 30 GB SSD (alebo NVMe) s tenkým poskytovaním (thin provisioning).
  • Systém Operatívny (OS): Ubuntu Server 24.04 LTS alebo 22.04 LTS (čistá inštalácia).

Po dokončení procesu inštalácie základného systému a nastavení bezpečného vzdialeného prístupu cez SSH, spustite popísané príkazy na aktualizáciu systému:

3.1. Aktualizácia a bezpečnostné záplaty

Sección titulada «3.1. Actualización y Parches de Seguridad»
Ventana de terminal
# Actualizar base de datos de paquetes y parches del kernel
sudo apt update && sudo apt upgrade -y

Inštalujte základné nástroje potrebné pre ladenie a úpravu konfigurácií v konzole:

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

4. Inštalácia Docker Engine (oficiálny stabilný kanál)

Sección titulada «4. Instalación de Docker Engine (Canal Oficial Stable)»

[!IMPORTANT] Používanie verzie Docker zabalenej pomocou snap alebo zo štandardných zdrojov Ubuntu nie je povolené, pretože chýba priama kompatibilita s aktualizovanými pluginmi Compose V2. Postupujte podľa oficiálneho postupu:

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. Správa prevádzkových privilégií (po inštalácii)

Sección titulada «5. Gestión de Privilegios Operativos (Post-Instalación)»

Aby ste sa vyhli neustálemu používaniu príkazu sudo pri interakcii s Docker socketom (zmierňujúc prevádzkové riziká a zjednodušujúc automatizácie), pridajte systémového používateľa do skupiny motorov:

Ventana de terminal
sudo usermod -aG docker $USER

[!CAUTION] Povinný operačný krok: Je prísne nutné zatvoriť aktívnu reláciu terminálu (exit) a znovu sa prihlásiť na server SSH, aby sa obnovili privilégiá aktuálneho používateľského tokenu.


Overte, či služba je aktívna a používateľ má plné povolenia nad lokálnym démonom:

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

📊 Kontrolný zoznam prípravy hostiteľa

Sección titulada «📊 Checklist de Preparación de Host»
  • ✓ Pridelené prostriedky: Validácia CPU, pamäte a disku na uzle Proxmox.
  • ✓ Oficiálny Docker: Overenie inštalačného kanála stable oproti zastaraným verziám snap.
  • ✓ Bezpečnosť prístupu: Reloadovanie relácie konzoly pre operáciu s motorom kontajnerov.