DOC-01: Příprava infrastruktury (Proxmox & Ubuntu)
Počáteční krok provizování prostředků v Proxmox VE, konfigurace Ubuntu Serveru a nasazení stabilního Docker enginu.
Tento technický dokument stanovuje provozní pokyny pro provisioning a parametrizaci základního operačního systému (Ubuntu Server) ve virtualizovaném prostředí na hypervisoru Proxmox VE, čímž připravuje uzel pro nasazení kontejnerového stacku Redmine.
2. Požadavky na virtuální počítač (Proxmox VE)
Sección titulada «2. Requisitos de la Máquina Virtual (Proxmox VE)»Při vytváření instance virtuálního počítače v administračním panelu Proxmox je nutné nakonfigurovat následující minimální limity prostředků, aby se předešlo úzkým hrdlům způsobeným architekturou Ruby on Rails (interní jádro Redmine) a databázovým strojem MySQL:
- CPU (Procesor): 2 vysoce výkonná vCPU (pro povolení přímého překladu instrukcí fyzického procesoru se doporučuje nakonfigurovat
Type: hostv Proxmoxu). - RAM (Paměť): minimálně 4 GB (Ruby on Rails při kompilaci statických prostředků spotřebovává značné množství paměti).
- Úložiště (Disk): 30 GB SSD (nebo NVMe) s tenkým přidělováním (thin provisioning).
- Operační systém (OS): Ubuntu Server 24.04 LTS nebo 22.04 LTS (čistá instalace).
3. Příprava operačního systému
Sección titulada «3. Preparación del Sistema Operativo»Po dokončení procesu instalace základního systému a nastavení bezpečného vzdáleného přístupu přes SSH spusť popsané příkazy pro aktualizaci systému:
3.1. Aktualizace 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. Instalace provozních nástrojů
Sección titulada «3.2. Instalación de Utilidades de Operación»Nainstalujte základní nástroje potřebné pro ladění a úpravu konfigurací v konzoli:
sudo apt install -y curl wget git nano unzip htop4. Instalace Docker Engine (Oficiální kanál Stable)
Sección titulada «4. Instalación de Docker Engine (Canal Oficial Stable)»[!IMPORTANT]\r Se prohíbe el uso de la versión de Docker empaquetada mediante
snapo de las fuentes por defecto de Ubuntu, ya que carecen de compatibilidad directa con los plugins actualizados de Compose V2. Sigue el flujo oficial:
# 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 provozních oprávnění (Po instalaci)
Sección titulada «5. Gestión de Privilegios Operativos (Post-Instalación)»Aby se předešlo neustálému používání příkazu sudo při interakci se socketem Dockeru (čímž se zmírní provozní rizika a zjednoduší automatizace), přidejte systémového uživatele do skupiny docker:
sudo usermod -aG docker $USER[!CAUTION]\r Paso Operativo Obligatorio: Es estrictamente necesario cerrar la sesión de la terminal activa (
exit) y volver a ingresar al servidor SSH para recargar los privilegios del token del usuario actual.
6. Ověření funkčnosti
Sección titulada «6. Verificación de Funcionamiento»Ověřte, že je služba aktivní a uživatel má plná oprávnění k lokálnímu démonovi:
docker info# Debería imprimir información de diagnóstico del host sin advertencias de denegación de acceso📊 Kontrolní seznam přípravy hostitele
Sección titulada «📊 Checklist de Preparación de Host»- ✓ Přiřazené prostředky: Ověření CPU, paměti a disku na uzlu Proxmox.
- ✓ Oficiální Docker: Ověření instalačního kanálu
stableproti zastaralým verzím snap. - ✓ Zabezpečení přístupu: Znovu načtení relace konzole pro provoz motoru kontejnerů.

