Ir al contenido

DOC-01: Infrastructuurvoorbereiding (Proxmox & Ubuntu)

Eerste stap voor de provisioning van resources in Proxmox VE, configuratie van Ubuntu Server en de uitrol van een stabiele Docker-engine.

0lecturas

Dit technische document stelt de operationele richtlijnen vast voor het provisionen en parametriseren van het basissysteem (Ubuntu Server) in een gevirtualiseerde omgeving op een Proxmox VE-hypervisor, waarbij de node wordt voorbereid voor de uitrol van de Redmine-containerstack.


2. Vereisten voor de Virtuele Machine (Proxmox VE)

Sección titulada «2. Requisitos de la Máquina Virtual (Proxmox VE)»

Bij het instantiëren van de virtuele machine in het Proxmox-beheerpaneel moeten de volgende minimale bronlimieten worden geconfigureerd om knelpunten te voorkomen die worden veroorzaakt door de Ruby on Rails-architectuur (de interne engine van Redmine) en de MySQL-database-engine:

  • CPU (Processor): 2 snelle vCPU's (het wordt aanbevolen om Type: host in Proxmox te configureren om directe instructietranslatie van de fysieke processor in te schakelen).
  • RAM (Geheugen): minimaal 4 GB (Ruby on Rails verbruikt aanzienlijk veel geheugen tijdens het compileren van statische resources).
  • Opslag (Schijf): 30 GB SSD (of NVMe) met thin provisioning (thin provisioning).
  • Besturingssysteem (OS): Ubuntu Server 24.04 LTS of 22.04 LTS (schone installatie).

3. Voorbereiding van het Besturingssysteem

Sección titulada «3. Preparación del Sistema Operativo»

Nadat het installatieproces van het basissysteem is voltooid en de veilige externe toegang via SSH is ingesteld, voert u de beschreven commando's uit om het systeem bij te werken:

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

3.2. Installatie van Operationele Hulpprogramma's

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

Installeer de basisgereedschappen die nodig zijn voor het debuggen en bewerken van configuraties in de console:

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

4. Installatie van Docker Engine (Officieel Stable Kanaal)

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

[!IMPORTANT] Het gebruik van de Docker-versie verpakt via snap of standaard Ubuntu-bronnen wordt verboden, omdat deze geen directe compatibiliteit hebben met de bijgewerkte Compose V2-plug-ins. Volg de officiële workflow:

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. Beheer van Operationele Rechten (Post-Installatie)

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

Om het voortdurende gebruik van het commando sudo bij interactie met de Docker-socket te voorkomen (het beperken van operationele risico's en het vereenvoudigen van automatisering), voeg de systeemgebruiker toe aan de engine-groep:

Ventana de terminal
sudo usermod -aG docker $USER

[!CAUTION] Obligatoire operationele stap: Het is strikt noodzakelijk om de actieve terminalsessie (exit) te sluiten en opnieuw in te loggen op de SSH-server om de privileges van de huidige gebruikers token te herladen.


Controleer of de service actief is en de gebruiker volledige rechten heeft op de lokale daemon:

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

  • ✓ Toegewezen middelen: Validatie van CPU, geheugen en schijf op de Proxmox-node.
  • ✓ Officiële Docker: Verificatie van het installatiekanaal stable versus verouderde snap-versies.
  • ✓ Toegangsbeveiliging: Console-sessie ververst om de container-engine te kunnen bedienen.