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. Introdução
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 da Máquina Virtual (Proxmox VE)
Sección titulada «2. Requisitos de la Máquina Virtual (Proxmox VE)»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).
3. Preparação do Sistema Operacional
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. Atualização e Patches de Segurança
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. 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:
sudo apt install -y curl wget git nano unzip htop4. 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
snapou das fontes padrão do Ubuntu, pois carecem de compatibilidade direta com os plugins atualizados do Compose V2. Siga o fluxo 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. 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.
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.
6. Verificação de Funcionamento
Sección titulada «6. Verificación de Funcionamiento»Verifique se o serviço está ativo e se o usuário possui permissões totais sobre o daemon local:
docker info# Debería imprimir información de diagnóstico del host sin advertencias de denegación de acceso📊 Checklist de Preparação do 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 stable frente a versiones snap obsoletas.
- ✓ Seguridad de Acceso: Recarga de sesión de consola realizada para operar el motor de contenedores.

