Ir al contenido

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.

0lectures

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

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:

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

Installa les eines bàsiques necessàries per a la depuració i edició de configuracions a la consola:

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

4. 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 snap o de les fonts per defecte d'Ubuntu, ja que no tenen compatibilitat directa amb els plugins actualitzats de Compose V2. Segueix el flux 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ó 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:

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


Verifica que el servei estigui actiu i l'usuari tingui permisos plens 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 Assignats: Validació de CPU, memòria i disc al node Proxmox.
  • ✓ Docker Oficial: Verificació del canal d'instal·lació stable davant de versions snap obsoletes.
  • ✓ Seguretat d'Accés: Recàrrega de la sessió de consola realitzada per operar el motor de contenidors.