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.
1. Introduction
Sección titulada «1. Introducción»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: hostdans 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»# Actualizar base de datos de paquetes y parches del kernelsudo apt update && sudo apt upgrade -y3.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 :
sudo apt install -y curl wget git nano unzip htop4. 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
snapou 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 :
# 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. 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 :
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.
6. Vérification du fonctionnement
Sección titulada «6. Verificación de Funcionamiento»Vérifiez que le service est actif et que l'utilisateur dispose de toutes les autorisations sur le démon local :
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
stablepar rapport aux versions snap obsolètes. - ✓ Sécurité d'Accès : Rechargement de la session console effectué pour faire fonctionner le moteur de conteneurs.

