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.


Ao instanciar a máquina virtual no painel de administração do Proxmox, devem ser configurados os seguintes limites de recursos mínimos para evitar gargalos gerados pela arquitetura Ruby on Rails (motor interno do Redmine) e pelo motor de banco de dados 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. Instalação de Utilitários de Operação

Sección titulada «3.2. Instalación de Utilidades de Operación»

Instale as ferramentas básicas necessárias para a depuração e edição de configurações no console:

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

4. Instalação do Docker Engine (Canal Oficial Stable)

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

[!IMPORTANT]\r\nÉ proibido o uso da versão do Docker embutida por meio de snap ou das fontes padrão do Ubuntu, pois carecem de compatibilidade direta com os plugins atualizados do Compose V2. Siga o fluxo 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. Gestão de Privilégios Operacionais (Pós-Instalação)

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

Para evitar o uso contínuo do comando sudo ao interagir com o socket de Docker, adicione o usuário do sistema ao grupo do motor.

Ventana de terminal
sudo usermod -aG docker $USER

[!CAUTION]\r\nPasso Operativo Obrigatório: É estritamente necessário fechar a sessão do terminal ativa (exit) e voltar a entrar no servidor SSH para recarregar os privilégios do token do usuário atual.


Verifique se o serviço está ativo e se o usuário possui permissões totais sobre o 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.