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.
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.
2. Požiadavky virtuálneho stroja (Proxmox VE)
Sección titulada «2. Requisitos de la Máquina Virtual (Proxmox VE)»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: hostv 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).
3. Príprava operačného systému
Sección titulada «3. Preparación del Sistema Operativo»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»# Actualizar base de datos de paquetes y parches del kernelsudo apt update && sudo apt upgrade -y3.2. Inštalácia prevádzkových nástrojov
Sección titulada «3.2. Instalación de Utilidades de Operación»Inštalujte základné nástroje potrebné pre ladenie a úpravu konfigurácií v konzole:
sudo apt install -y curl wget git nano unzip htop4. 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
snapalebo 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:
# 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. 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:
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.
6. Overenie funkčnosti
Sección titulada «6. Verificación de Funcionamiento»Overte, či služba je aktívna a používateľ má plné povolenia nad lokálnym démonom:
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
stableoproti zastaraným verziám snap. - ✓ Bezpečnosť prístupu: Reloadovanie relácie konzoly pre operáciu s motorom kontajnerov.

