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.
1. Inleiding
Sección titulada «1. Introducción»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: hostin 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:
3.1. Updates en Beveiligingspatches
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. 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:
sudo apt install -y curl wget git nano unzip htop4. 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
snapof standaard Ubuntu-bronnen wordt verboden, omdat deze geen directe compatibiliteit hebben met de bijgewerkte Compose V2-plug-ins. Volg de officiële workflow:
# 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. 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:
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.
6. Verificatie van de Werking
Sección titulada «6. Verificación de Funcionamiento»Controleer of de service actief is en de gebruiker volledige rechten heeft op de lokale daemon:
docker info# Debería imprimir información de diagnóstico del host sin advertencias de denegación de acceso📊 Checklist voor Hostvoorbereiding
Sección titulada «📊 Checklist de Preparación de Host»- ✓ Toegewezen middelen: Validatie van CPU, geheugen en schijf op de Proxmox-node.
- ✓ Officiële Docker: Verificatie van het installatiekanaal
stableversus verouderde snap-versies. - ✓ Toegangsbeveiliging: Console-sessie ververst om de container-engine te kunnen bedienen.

