Ir al contenido

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.

0odwiedzin

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.


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

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»
Ventana de terminal
# Actualizar base de datos de paquetes y parches del kernel
sudo apt update && sudo apt upgrade -y

Zainstaluj podstawowe narzędzia niezbędne do debugowania i edycji konfiguracji w konsoli:

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

4. 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ą snap lub 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:

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. 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:

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


Sprawdź, czy usługa jest aktywna, a użytkownik ma pełne uprawnienia do demona lokalnego:

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

  • ✓ Zasoby Przydzielone: Walidacja CPU, pamięci i dysku w węźle Proxmox.
  • ✓ Docker Oficjalny: Weryfikacja kanału instalacji stable w stosunku do przestarzałych wersji snap.
  • ✓ Bezpieczeństwo Dostępu: Przeładowanie sesji konsoli w celu obsługi silnika kontenerów.