DOC-01: Przygotowanie infrastruktury (Proxmox i Ubuntu)
Pierwszy krok w zaopatrzeniu zasobów w Proxmox VE, konfiguracji Ubuntu Server i wdrożeniu stabilnego silnika Docker.
1. Wprowadzenie
Sección titulada «1. Introducción»Ten dokument techniczny ustanawia wytyczne operacyjne dla przygotowania i parametryzacji systemu operacyjnego bazowego (Ubuntu Server) w środowisku wirtualizowanym na hipervisorze Proxmox VE, przygotowując węzeł do wdrożenia stека kontenerów Redmine.
2. Wymagania maszyny wirtualnej (Proxmox VE)
Sección titulada «2. Requisitos de la Máquina Virtual (Proxmox VE)»Podczas tworzenia maszyny wirtualnej w panelu administracyjnym Proxmox należy skonfigurować następujące minimalne limity zasobów, aby uniknąć wąskich gardeł generowanych przez architekturę Ruby on Rails (wewnętrzny silnik Redmine) i silnik bazy danych MySQL:
- CPU (Procesor): 2 vCPUs o wysokiej wydajności (zalecane jest skonfigurowanie
Type: hostw Proxmox, aby włączyć bezpośrednią translację instrukcji procesora fizycznego). - Pamięć RAM: co najmniej 4 GB (Ruby on Rails zużywa znaczne ilości pamięci podczas kompilacji statycznych zasobów).
- Magazyn (Dysk): 30 GB SSD (lub NVMe) z cienkim przydziałem (thin provisioning).
- System Operacyjny (OS): Ubuntu Server 24.04 LTS lub 22.04 LTS (czysta instalacja).
3. Przygotowanie systemu operacyjnego
Sección titulada «3. Preparación del Sistema Operativo»Po zakończeniu procesu instalacji systemu bazowego i ustanowieniu bezpiecznego dostępu zdalnego za pomocą SSH, wykonaj polecenia opisane w celu zaktualizowania systemu:
3.1 Aktualizacja i poprawki bezpieczeństwa
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 Instalacja narzędzi operacyjnych
Sección titulada «3.2. Instalación de Utilidades de Operación»Zainstaluj podstawowe narzędzia niezbędne do debugowania i edycji konfiguracji w konsoli:
sudo apt install -y curl wget git nano unzip htop4. Instalacja silnika Docker (oficjalny kanał stabilny)
Sección titulada «4. Instalación de Docker Engine (Canal Oficial Stable)»[!IMPORTANT] Użycie wersji Docker zapakowanej za pomocą
snaplub domyślnych źródeł Ubuntu jest zabronione, ponieważ brakuje im bezpośredniej kompatybilności z zaktualizowanymi wtyczkami Compose V2. Postępuj zgodnie z oficjalnym przepływem:
# 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. Zarządzanie uprawnieniami operacyjnymi (po instalacji)
Sección titulada «5. Gestión de Privilegios Operativos (Post-Instalación)»Aby uniknąć ciągłego używania polecenia sudo podczas interakcji z gniazdem Docker (mitigując ryzyko operacyjne i upraszczając automatyzację), dodaj użytkownika systemu do grupy silnika:
sudo usermod -aG docker $USER[!CAUTION] Obowiązkowy krok operacyjny: Konieczne jest zamknięcie aktywnej sesji terminala (
exit) i ponowne zalogowanie się do serwera SSH, aby załadować uprawnienia tokena użytkownika.
6. Weryfikacja Działania
Sección titulada «6. Verificación de Funcionamiento»Sprawdź, czy usługa jest aktywna, a użytkownik ma pełne uprawnienia do demona lokalnego:
docker info# Debería imprimir información de diagnóstico del host sin advertencias de denegación de acceso📊 Lista Kontrolna Przygotowania Host
Sección titulada «📊 Checklist de Preparación de Host»- ✓ Zasoby Przydzielone: Walidacja CPU, pamięci i dysku w węźle Proxmox.
- ✓ Docker Oficjalny: Weryfikacja kanału instalacji
stablew stosunku do przestarzałych wersji snap. - ✓ Bezpieczeństwo Dostępu: Przeładowanie sesji konsoli w celu obsługi silnika kontenerów.

