DOC-01: Preparació d'infraestructura (Proxmox & Ubuntu)
Pas inicial d'aprovisionament de recursos a Proxmox VE, configuració d'Ubuntu Server i desplegament del motor Docker estable.
1. Introducció
Sección titulada «1. Introducción»Aquest document tècnic estableix les directives operatives per aprovisionar i parametritzar el sistema operatiu base (Ubuntu Server) en un entorn virtualitzat sobre un hipervisor Proxmox VE, preparant el node per al desplegament de la pila de contenidors de Redmine.
2. Requisits de la màquina virtual (Proxmox VE)
Sección titulada «2. Requisitos de la Máquina Virtual (Proxmox VE)»En instanciar la màquina virtual al panell d'administració de Proxmox, s'han de configurar els següents límits de recursos mínims per evitar els congestionaments generats per l'arquitectura Ruby on Rails (motor intern de Redmine) i el motor de base de dades MySQL:
- CPU (Processador): 2 vCPUs de rendiment ràpid (es suggereix configurar
Type: hosta Proxmox per habilitar la traducció directa d'instruccions del processador físic). - RAM (Memòria): 4 GB com a mínim (Ruby on Rails consumeix memòria de manera considerable durant la compilació de recursos estàtics).
- Emmagatzematge (Diss): 30 GB SSD (o NVMe) amb aprovisionament xinès (thin provisioning).
- Sistema Operatiu (OS): Ubuntu Server 24.04 LTS o 22.04 LTS (instal·lació neta).
3. Preparació del Sistema Operatiu
Sección titulada «3. Preparación del Sistema Operativo»Un acabar el procés d'instal·lació del sistema base i establir l'accés remot segur via SSH, executa els comandes descrits per actualitzar el sistema:
3.1. Actualització i Parxes de Seguretat
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. Instal·lació d'Utilitats d'Operació
Sección titulada «3.2. Instalación de Utilidades de Operación»Installa les eines bàsiques necessàries per a la depuració i edició de configuracions a la consola:
sudo apt install -y curl wget git nano unzip htop4. Instal·lació de Docker Engine (Canal Oficial Stable)
Sección titulada «4. Instalación de Docker Engine (Canal Oficial Stable)»[!IMPORTANT] Es prohibeix l'ús de la versió de Docker empaquetada mitjançant
snapo de les fonts per defecte d'Ubuntu, ja que no tenen compatibilitat directa amb els plugins actualitzats de Compose V2. Segueix el flux 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ó de Privilegis Operatius (Post-instal·lació)
Sección titulada «5. Gestión de Privilegios Operativos (Post-Instalación)»Per evitar l'ús continu del comand sudo en interagir amb el socket de Docker (mitigant riscos operatius i simplificant automatitzacions), afegeix l'usuari del sistema al grup del motor:
sudo usermod -aG docker $USER[!CAUTION] Pas Operatiu Obligatori: És estrictament necessari tancar la sessió de la terminal activa (
exit) i tornar a entrar al servidor SSH per recarregar els privilegis del token de l'usuari actual.
6. Verificació de Funcionament
Sección titulada «6. Verificación de Funcionamiento»Verifica que el servei estigui actiu i l'usuari tingui permisos plens 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ó de l'host
Sección titulada «📊 Checklist de Preparación de Host»- ✓ Recursos Assignats: Validació de CPU, memòria i disc al node Proxmox.
- ✓ Docker Oficial: Verificació del canal d'instal·lació
stabledavant de versions snap obsoletes. - ✓ Seguretat d'Accés: Recàrrega de la sessió de consola realitzada per operar el motor de contenidors.

