diff --git a/README.md b/README.md index 2ccb4db..3f45abd 100644 --- a/README.md +++ b/README.md @@ -114,4 +114,122 @@ services: - **Aislamiento:** Permite probar diferentes versiones de Node.js o de librerías sin afectar el sistema global. -- **Despliegue simplificado:** El mismo contenedor que se usa para desarrollo se puede usar en producción, lo que reduce las incompatibilidades. \ No newline at end of file +- **Despliegue simplificado:** El mismo contenedor que se usa para desarrollo se puede usar en producción, lo que reduce las incompatibilidades. + + +## Instalación de Docker en Windows (con WSL) + +Sigue estos pasos para instalar Docker en Windows 10/11 utilizando WSL 2. + +### 1) Habilitar WSL 2 + +- Abre PowerShell como Administrador y ejecuta: + +```powershell +wsl --install +``` + +- Si ya tienes WSL 1, habilita las características necesarias y establece WSL 2 como predeterminado: + +```powershell +dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart +dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart +wsl --set-default-version 2 +``` + +- Reinicia el equipo si te lo solicita. + +### 2) Instalar una distribución Linux (recomendado Ubuntu) + +- Opción rápida (Windows 11 y 10 recientes): + +```powershell +wsl --install -d Ubuntu +``` + +- Alternativa: instala "Ubuntu" desde Microsoft Store y luego inicialízala (crea usuario y contraseña Linux). + +### 3) Instalar Docker Desktop para Windows + +- Descarga e instala desde: [Docker Desktop para Windows](https://www.docker.com/products/docker-desktop/). +- Durante la instalación, deja activada la opción **Use WSL 2 instead of Hyper-V**. +- Abre Docker Desktop y en Settings > Resources > WSL Integration, habilita la integración con tu distro (p. ej., Ubuntu). + +### 4) Verificar instalación + +En una terminal (PowerShell o Ubuntu en WSL): + +```powershell +docker --version +docker compose version +docker run hello-world +``` + +Si el comando `hello-world` imprime un mensaje de bienvenida, Docker está funcionando correctamente. + +> Nota: Si ves errores de permisos desde WSL, asegúrate de que la integración WSL esté habilitada en Docker Desktop y reinicia tanto Docker Desktop como la distro WSL (`wsl --shutdown`). + + +## Instalación de Docker en Ubuntu + +Instalación usando el repositorio oficial de Docker (recomendado para Ubuntu 20.04/22.04/24.04). + +### 1) Preparar el sistema + +```bash +sudo apt-get update +sudo apt-get install -y ca-certificates curl gnupg apt-transport-https software-properties-common +``` + +### 2) Agregar la clave GPG y el repositorio oficial + +```bash +sudo install -m 0755 -d /etc/apt/keyrings +curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg +sudo chmod a+r /etc/apt/keyrings/docker.gpg + +echo \ + "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ + $(. /etc/os-release && echo $UBUNTU_CODENAME) stable" | \ + sudo tee /etc/apt/sources.list.d/docker.list > /dev/null +``` + +### 3) Instalar Docker Engine y complementos + +```bash +sudo apt-get update +sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin +``` + +### 4) Habilitar y probar Docker + +```bash +sudo systemctl enable --now docker +sudo docker run hello-world +``` + +### 5) Usar Docker sin `sudo` (opcional recomendado) + +```bash +sudo usermod -aG docker $USER +newgrp docker +docker run hello-world +docker compose version +``` + +> Nota: Después de agregar tu usuario al grupo `docker`, puede que debas cerrar sesión y volver a iniciarla para que surta efecto. + +### Actualización y desinstalación + +- **Actualizar:** + +```bash +sudo apt-get update && sudo apt-get upgrade -y +``` + +- **Desinstalar:** + +```bash +sudo apt-get purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin +sudo rm -rf /var/lib/docker /var/lib/containerd +``` \ No newline at end of file