DOC-01: Preparación de Infraestructura (Proxmox & Ubuntu)
Paso inicial de aprovisionamiento de recursos en Proxmox VE, configuración de Ubuntu Server y despliegue del motor Docker estable.
1. Introducción
Sección titulada «1. Introducción»Este documento técnico establece las directivas operativas para aprovisionar y parametrizar el sistema operativo base (Ubuntu Server) en un entorno virtualizado sobre un hipervisor Proxmox VE, preparando el nodo para el despliegue del stack de contenedores de Redmine.
2. Requisitos de la Máquina Virtual (Proxmox VE)
Sección titulada «2. Requisitos de la Máquina Virtual (Proxmox VE)»Al instanciar la máquina virtual en el panel de administración de Proxmox, se deben configurar los siguientes límites de recursos mínimos para evitar cuellos de botella generados por la arquitectura Ruby on Rails (motor interno de Redmine) y el motor de base de datos MySQL:
- CPU (Procesador): 2 vCPUs de rendimiento rápido (se sugiere configurar
Type: hosten Proxmox para habilitar la traducción directa de instrucciones del procesador físico). - RAM (Memoria): 4 GB como mínimo (Ruby on Rails consume memoria de manera considerable durante la compilación de recursos estáticos).
- Almacenamiento (Disco): 30 GB SSD (o NVMe) con aprovisionamiento fino (thin provisioning).
- Sistema Operativo (OS): Ubuntu Server 24.04 LTS o 22.04 LTS (instalación limpia).
3. Preparación del Sistema Operativo
Sección titulada «3. Preparación del Sistema Operativo»Tras finalizar el proceso de instalación del sistema base y establecer acceso remoto seguro vía SSH, ejecuta los comandos descritos para actualizar el sistema:
3.1. Actualización y Parches de Seguridad
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. Instalación de Utilidades de Operación
Sección titulada «3.2. Instalación de Utilidades de Operación»Instala las herramientas básicas necesarias para la depuración y edición de configuraciones en consola:
sudo apt install -y curl wget git nano unzip htop4. Instalación de Docker Engine (Canal Oficial Stable)
Sección titulada «4. Instalación de Docker Engine (Canal Oficial Stable)»[!IMPORTANT] 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. Gestión de Privilegios Operativos (Post-Instalación)
Sección titulada «5. Gestión de Privilegios Operativos (Post-Instalación)»Para evitar el uso continuo del comando sudo al interactuar con el socket de Docker (mitigando riesgos operativos y simplificando automatizaciones), añade el usuario del sistema al grupo del motor:
sudo usermod -aG docker $USER[!CAUTION] 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. Verificación de Funcionamiento
Sección titulada «6. Verificación de Funcionamiento»Verifica que el servicio esté activo y el usuario cuente con permisos plenos sobre el daemon local:
docker info# Debería imprimir información de diagnóstico del host sin advertencias de denegación de acceso📊 Checklist de Preparación de Host
Sección titulada «📊 Checklist de Preparación de Host»- ✓ Recursos Asignados: Validación de CPU, memoria y disco en el nodo Proxmox.
- ✓ Docker Oficial: Verificación del canal de instalación
stablefrente a versiones snap obsoletas. - ✓ Seguridad de Acceso: Recarga de sesión de consola realizada para operar el motor de contenedores.

