Ir al contenido

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.

0čtení

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

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:

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

Nainstalujte základní nástroje potřebné pro ladění a úpravu konfigurací v konzoli:

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

4. 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 snap o de las fuentes por defecto de Ubuntu, ya que carecen de compatibilidad directa con los plugins actualizados de Compose V2. Sigue el flujo oficial:

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

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:

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


Ověřte, že je služba aktivní a uživatel má plná oprávnění k lokálnímu démonovi:

Ventana de terminal
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 stable proti zastaralým verzím snap.
  • ✓ Zabezpečení přístupu: Znovu načtení relace konzole pro provoz motoru kontejnerů.