Ir al contenido

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.

0lecturas

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

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:

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

3.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:

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

4. 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 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

5. 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:

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


Verifica que el servicio esté activo y el usuario cuente con permisos plenos sobre el daemon local:

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

  • ✓ Recursos Asignados: Validación de CPU, memoria y disco en el nodo Proxmox.
  • ✓ Docker Oficial: Verificación del canal de instalación stable frente a versiones snap obsoletas.
  • ✓ Seguridad de Acceso: Recarga de sesión de consola realizada para operar el motor de contenedores.