Ir al contenido

DOC-01: Подготовка инфраструктуры (Proxmox & Ubuntu)

Первоначальный шаг по обеспечению ресурсов в Proxmox VE, настройка Ubuntu Server и развертывание стабильного движка Docker.

0просмотры

Этот технический документ устанавливает оперативные директивы для обеспечения и параметризации базовой операционной системы (Ubuntu Server) в виртуализированной среде на гипервизоре Proxmox VE, готовя узел для развертывания стека контейнеров Redmine.


2. Требования к виртуальной машине (Proxmox VE)

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

При создании виртуальной машины в панели управления Proxmox необходимо настроить следующие минимальные ограничения ресурсов, чтобы избежать узких мест, вызванных архитектурой Ruby on Rails (внутренним движком Redmine) и движком базы данных MySQL:

  • ЦП (Процессор): 2 виртуальных ЦП с высокой производительностью (рекомендуется настроить Type: host в Proxmox, чтобы включить прямую трансляцию инструкций физического процессора).
  • ОЗУ (Память): 4 ГБ как минимум (Ruby on Rails потребляет значительное количество памяти во время компиляции статических ресурсов).
  • Хранилище (Диск): 30 ГБ SSD (или NVMe) с тонким выделением ресурсов (thin provisioning).
  • Операционная система (ОС): Ubuntu Server 24.04 LTS или 22.04 LTS (чистая установка).

3. Подготовка операционной системы

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

После завершения процесса установки базовой системы и настройки безопасного удаленного доступа через SSH, выполните описанные команды для обновления системы:

3.1. Обновление и патчи безопасности

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

3.2. Установка утилит эксплуатации

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

Установите базовые инструменты, необходимые для отладки и редактирования конфигураций в консоли:

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

4. Установка Docker Engine (официальный стабильный канал)

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

[!IMPORTANT] Запрещено использование версии Docker, упакованной с помощью snap или из стандартных источников Ubuntu, поскольку они лишены прямой совместимости с обновленными плагинами Compose V2. Следуйте официальному потоку:

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. Управление оперативными привилегиями (после установки)

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

Чтобы избежать постоянного использования команды sudo при взаимодействии с сокетом Docker (смягчая оперативные риски и упрощая автоматизацию), добавьте системного пользователя в группу двигателя:

Ventana de terminal
sudo usermod -aG docker $USER

[!CAUTION] Обязательный Оперативный Шаг: Строго необходимо выйти из активной терминальной сессии (exit) и снова войти на SSH-сервер, чтобы перезагрузить привилегии токена текущего пользователя.


6. Проверка работоспособности

Sección titulada «6. Verificación de Funcionamiento»

Проверьте, что служба активна и пользователь имеет полные права доступа к локальному демон:

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

📊 Checklist подготовки хоста

Sección titulada «📊 Checklist de Preparación de Host»
  • ✓ Назначенные ресурсы: Проверка CPU, памяти и диска в узле Proxmox.
  • ✓ Официальный Docker: Проверка канала установки stable перед устаревшими версиями snap.
  • ✓ Безопасность доступа: Перезагрузка сеанса консоли выполнена для работы с двигателем контейнеров.