Ir al contenido

DOC-01 : Préparation de l'infrastructure (Proxmox & Ubuntu)

Étape initiale de provisionnement des ressources sur Proxmox VE, configuration d'Ubuntu Server et déploiement du moteur Docker stable.

0vues

Ce document technique établit les directives opérationnelles pour provisionner et paramétrer le système d'exploitation de base (Ubuntu Server) dans un environnement virtualisé sur un hyperviseur Proxmox VE, préparant le nœud pour le déploiement de la pile de conteneurs Redmine.


2. Exigences de la machine virtuelle (Proxmox VE)

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

Lors de l'instanciation de la machine virtuelle dans le panneau d'administration de Proxmox, les limites de ressources minimales suivantes doivent être configurées pour éviter les goulots d'étranglement générés par l'architecture Ruby on Rails (moteur interne de Redmine) et le moteur de base de données MySQL :

  • CPU (Processeur) : 2 vCPUs haute performance (il est suggéré de configurer Type: host dans Proxmox pour activer la traduction directe des instructions du processeur physique).
  • RAM (Mémoire) : 4 Go minimum (Ruby on Rails consomme une quantité considérable de mémoire lors de la compilation des ressources statiques).
  • Stockage (Disque) : 30 Go SSD (ou NVMe) avec provisionnement fin (thin provisioning).
  • Système d'exploitation (OS) : Ubuntu Server 24.04 LTS ou 22.04 LTS (installation propre).

3. Préparation du système d'exploitation

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

Après avoir terminé le processus d'installation du système de base et établi un accès à distance sécurisé via SSH, exécutez les commandes décrites pour mettre à jour le système :

3.1. Mise à jour et correctifs de sécurité

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. Installation des utilitaires d'exploitation

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

Installez les outils de base nécessaires pour le débogage et l'édition des configurations dans la console :

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

4. Installation de Docker Engine (Canal officiel Stable)

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

[!IMPORTANT] L'utilisation de la version de Docker empaquetée via snap ou des sources par défaut d'Ubuntu est interdite, car elle n'est pas compatible avec les plugins mis à jour de Compose V2. Suivez le flux officiel :

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. Gestion des privilèges opérationnels (Post-installation)

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

Pour éviter l'utilisation continue de la commande sudo lors de l'interaction avec le socket Docker (atténuant ainsi les risques opérationnels et simplifiant les automatisations), ajoutez l'utilisateur du système au groupe du moteur :

Ventana de terminal
sudo usermod -aG docker $USER

[!CAUTION] Étape Opérative Obligatoire : Il est strictement nécessaire de fermer la session de terminal active (exit) et de se reconnecter au serveur SSH pour recharger les privilèges du jeton d'utilisateur actuel.


Vérifiez que le service est actif et que l'utilisateur dispose de toutes les autorisations sur le démon local :

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

📊 Liste de contrôle de préparation de l'hôte

Sección titulada «📊 Checklist de Preparación de Host»
  • ✓ Ressources Allouées : Validation du CPU, de la mémoire et du disque sur le nœud Proxmox.
  • ✓ Docker Officiel : Vérification du canal d'installation stable par rapport aux versions snap obsolètes.
  • ✓ Sécurité d'Accès : Rechargement de la session console effectué pour faire fonctionner le moteur de conteneurs.