Docker pour débutants sur un VPS

En tant que rédacteur technique pour Pixzo, je rédige votre contribution de manière directe, pratique et sans détour. Voici la version réécrite selon votre structure et vos règles de style.

Installer Docker sur un VPS Pixzo

Cet article vous aide à installer Docker sur un VPS Pixzo (Debian/Ubuntu) et à lancer votre premier conteneur. Débutants, suivez les étapes précisément.

PRÉREQUIS - Un VPS Pixzo avec Debian 12 ou Ubuntu 22.04 - Accès SSH au VPS en tant qu'utilisateur root ou utilisateur avec droits sudo - Commandes de base dans le terminal

ÉTAPES

1. Mettez à jour le système Assurez-vous que tous les paquets sont à jour pour éviter les conflits. sudo apt update && sudo apt upgrade -y

2. Installez les dépendances requises Docker a besoin de `ca-certificates`, `curl` et `gnupg` pour ajouter le dépôt. sudo apt install ca-certificates curl gnupg -y

3. Ajoutez la clé GPG de Docker Cela vérifie les paquets que vous téléchargez.

sudo curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

4. Ajoutez le dépôt Docker Placez le dépôt dans votre liste de sources.

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

5. Installez Docker Engine et Compose Les outils de base plus le plugin Compose. Docker Engine 24.x ou supérieur sera installé. sudo apt update && sudo apt install docker-ce docker-ce-cli docker-compose-plugin -y

6. Ajoutez votre utilisateur au groupe docker (optionnel mais recommandé) Cela évite `sudo` pour les commandes Docker. Remplacez `$USER` par votre propre nom d'utilisateur. sudo usermod -aG docker $USER Important : déconnectez-vous puis reconnectez-vous (`exit` + SSH à nouveau) pour activer le groupe.

7. Testez Docker avec le conteneur hello-world Lancez un conteneur de test pour vérifier que tout fonctionne. docker run hello-world

8. Lancez votre premier vrai conteneur : Nginx Faites tourner Nginx sur le port 8080. Cela confirme que vos conteneurs ont accès au réseau. docker run -d -p 8080:80 --name nginx-test nginx:latest

VÉRIFICATION Vérifiez que le conteneur tourne : docker ps Vous verrez `nginx-test` dans la liste. Ouvrez ensuite dans votre navigateur : `http://:8080`. Vous verrez la page d'accueil standard de Nginx.

PROBLÈMES FRÉQUENTS

Problème 1 : `permission denied` avec les commandes docker Cause : utilisateur pas dans le groupe docker, ou session non redémarrée. Solution : ajoutez l'utilisateur (étape 6) et reconnectez-vous.

Problème 2 : `Cannot connect to the Docker daemon` Cause : le service Docker ne tourne pas. Solution : démarrez le service avec `sudo systemctl start docker`.

Problème 3 : le conteneur Nginx ne démarre pas sur le port 8080 Cause : le port 8080 est déjà utilisé ou le pare-feu bloque. Solution : vérifiez avec `sudo ss -tlnp | grep 8080`. Modifiez le port à l'étape 8, par exemple vers 8081. Ouvrez le pare-feu Pixzo dans le tableau de bord pour le port 8080.

Cette configuration est à la base de toute application que vous faites tourner sur Pixzo.