5.2 KiB
Configurar freeCodeCamp en el subsistema de Windows para Linux (WSL)
[!NOTE] Antes de seguir estas instrucciones asegúrate de que tu sistema cumple con los requisitos
WSL 2: Windows 10 64-bit (Versión 2004, Build 19041 o superior) - disponible para todas las distribuciones incluyendo Windows 10 Home.
Docker Desktop para Windows: Vea los requisitos correspondientes para Windows 10 Pro y Windows 10 Home
Esta guía cubre algunos pasos comunes con la configuración de WSL2. Una vez resueltos algunos de los problemas comunes con WSL2, debería ser capaz de seguir nuestra guía de configuración local para trabajar con freeCodeCamp en Windows ejecutando una distribución WSL como Ubuntu.
Habilitar WSL
Siga las instrucciones de la documentación oficial para instalar WSL1 y luego actualice a WSL2.
Instalar Ubuntu
-
Recomendamos usar Ubuntu-18.04 o superior con WSL2.
[!NOTE]
Aunque usted puede utilizar otras distribuciones no basadas en debian, todas vienen con sus propios complicaciones y están más allá del alcance de esta guía.
-
Actualizar las dependencias del sistema operativo
sudo apt update sudo apt upgrade -y # cleanup sudo apt autoremove -y
Configurar Git
Git viene preinstalado con Ubuntu 18.04, verifique su versión de Git con git --version
.
~
❯ git --version
git version 2.25.1
(Opcional, pero recomendado) Ahora puedes proceder a configurar tus claves ssh con GitHub.
Instalar un editor de código
Recomendamos encarecidamente instalar Visual Studio Code en Windows 10. Posee un gran soporte para WSL e instala automáticamente todas las extensiones necesarias en tu distribución de WSL.
Esencialmente, editará y almacenará su código en Ubuntu-18.04 con el VS Code instalado en Windows.
Instalando Docker Desktop
Docker Desktop para Windows le permite instalar y ejecutar bases de datos y servicios como MongoDB, NGINX, etc. Esto es útil para evitar problemas comunes con la instalación de MongoDB u otros servicios directamente en Windows o WSL2.
Siga las instrucciones de la documentación oficial e instale Docker Desktop para su distribución de Windows.
Hay algunos requisitos mínimos de hardware para una mejor experiencia.
Configurar Docker Desktop para WSL
Una vez que Docker Desktop está instalado, sigue estas instrucciones y configúralo para usar la instalación de Ubuntu-18.04 como un backend.
Esto hace que los contenedores se ejecuten en WSL en lugar de ejecutarse en Windows. Podrás acceder a los servicios a través de http://localhost
tanto en Windows como en Ubuntu.
Instalar MongoDB desde Docker Hub
Una vez que haya configurado Docker Desktop para trabajar con WSL2, siga estos pasos para iniciar un servicio de MongoDB:
-
Iniciar una nueva terminal Ubuntu-18.04
-
Extraer
MongoDB 3.6
desde dockerHubdocker pull mongo:3
-
Iniciar el servicio MongoDB en el puerto
27017
y configurarlo para que se ejecute automáticamente al reiniciar el sistemadocker run -it \ -v mongodata:/data/db \ -p 27017:27017 \ --name mongodb \ --restart unless-stopped \ -d mongo:3
-
Ahora puede acceder al servicio desde Windows o Ubuntu en
mongodb://localhost:27017
.
Instalando Node.js y npm
Le recomendamos que instale la versión LTS para Node.js con un gestor de versiones de node - nvm.
Una vez instalado, use estos comandos para instalar y usar la versión de Node.js según sea necesario
nvm install --lts
# O también
# nvm install <version>
nvm install 14
# Uso
# nvm use <version>
nvm use 12
Node.js viene empaquetado con npm
, puedes actualizar a las últimas versiones de npm
con:
npm install -g npm@latest
Configurar freeCodeCamp localmente
Ahora que ha instalado los requisitos previos, siga nuestra guía de configuración local para clonar, instalar y configurar freeCodeCamp localmente en su máquina.
[!WARNING]
Tenga en cuenta que en este momento la configuración para las pruebas de Cypress (y las necesidades relacionadas con la interfaz de usuario) es un trabajo en curso. Aún así deberías poder trabajar en la mayor parte del código base.
Enlaces útiles
- Configuración de desarrollador de WSL2 con Ubuntu 20.04, Node.js, MongoDB, VS Code y Docker - un artículo de Mrugesh Mohapatra (desarrollador de Staff en freeCodeCamp.org)
- Preguntas frecuentes sobre: