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.
1. Introduzione
Sección titulada «1. Introducción»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: hostin 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).
3. Preparazione del Sistema Operativo
Sección titulada «3. Preparación del Sistema Operativo»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:
3.1. Aggiornamento e Patch di Sicurezza
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. Installazione delle Utilità Operative
Sección titulada «3.2. Instalación de Utilidades de Operación»Installa gli strumenti di base necessari per il debug e la modifica delle configurazioni da console:
sudo apt install -y curl wget git nano unzip htop4. 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
snapo dalle fonti predefinite di Ubuntu, poiché mancano di compatibilità diretta con i plugin aggiornati di Compose V2. Seguire il flusso ufficiale:
# 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. 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:
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.
6. Verifica del Funzionamento
Sección titulada «6. Verificación de Funcionamiento»Verifica che il servizio sia attivo e che l'utente disponga di pieni permessi sul demone locale:
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
stablerispetto a versioni snap obsolete. - ✓ Sicurezza di Accesso: Ricarica della sessione di console eseguita per operare il motore di container.

