Ir al contenido

DOC-01: Preparazione dell'infrastruttura (Proxmox & Ubuntu)

Passaggio iniziale di provisioning delle risorse in Proxmox VE, configurazione di Ubuntu Server e distribuzione di un motore Docker stabile.

0letture

Questo documento tecnico stabilisce le direttive operative per approvvigionare e parametrizzare il sistema operativo base (Ubuntu Server) in un ambiente virtualizzato su un hypervisor Proxmox VE, preparando il nodo per il deployment dello stack di container di Redmine.


2. Requisiti della Macchina Virtuale (Proxmox VE)

Sección titulada «2. Requisitos de la Máquina Virtual (Proxmox VE)»

Durante l'istanza della macchina virtuale nel pannello di amministrazione di Proxmox, devono essere configurati i seguenti limiti minimi di risorse per evitare colli di bottiglia generati dall'architettura Ruby on Rails (motore interno di Redmine) e dal motore di database MySQL:

  • CPU (Processore): 2 vCPU ad alte prestazioni (si consiglia di configurare Type: host in Proxmox per abilitare la traduzione diretta delle istruzioni del processore fisico).
  • RAM (Memoria): 4 GB minimi (Ruby on Rails consuma una quantità considerevole di memoria durante la compilazione delle risorse statiche).
  • Archiviazione (Disco): 30 GB SSD (o NVMe) con thin provisioning (thin provisioning).
  • Sistema Operativo (OS): Ubuntu Server 24.04 LTS o 22.04 LTS (installazione pulita).

Dopo aver completato il processo di installazione del sistema base e aver stabilito l'accesso remoto sicuro tramite SSH, esegui i comandi descritti per aggiornare il sistema:

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

Installa gli strumenti di base necessari per il debug e la modifica delle configurazioni da console:

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

4. Installazione di Docker Engine (Canale Ufficiale Stable)

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

[!IMPORTANT] È proibito l'uso della versione di Docker fornita tramite snap o dalle fonti predefinite di Ubuntu, poiché mancano di compatibilità diretta con i plugin aggiornati di Compose V2. Seguire il flusso ufficiale:

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. Gestione dei Privilegi Operativi (Post-Installazione)

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

Per evitare l'uso continuo del comando sudo interagendo con il socket di Docker (mitigando i rischi operativi e semplificando le automazioni), aggiungi l'utente di sistema al gruppo del motore:

Ventana de terminal
sudo usermod -aG docker $USER

[!CAUTION] Passo Operativo Obbligatorio: È strettamente necessario chiudere la sessione del terminale attivo (exit) e rientrare nel server SSH per ricaricare i privilegi del token utente corrente.


Verifica che il servizio sia attivo e che l'utente disponga di pieni permessi sul demone locale:

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

📊 Checklist di Preparazione dell'Host

Sección titulada «📊 Checklist de Preparación de Host»
  • ✓ Risorse Assegnate: Validazione di CPU, memoria e disco nel nodo Proxmox.
  • ✓ Docker Ufficiale: Verifica del canale di installazione stable rispetto a versioni snap obsolete.
  • ✓ Sicurezza di Accesso: Ricarica della sessione di console eseguita per operare il motore di container.