5.4 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 que algunos de los problemas habituales con WSL2 son solucionados, deberías de ser capaz de seguir esta guía de configuración localpara trabajar con freeCodeCamp en Windows corriendo una distribución WSL como Ubuntu.
Habilitar WSL
Sigue 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 propias 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 pre-instalado con Ubuntu 18.04, verifica tu 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, editaras y almacenaras tu código en Ubuntu-18.04 con el VS Code instalado en Windows.
Si utilizas IntelliJ Idea, quizás necesites actualizar el intérprete de Node y el gestor de paquetes npm que está instalado en tu distribución WSL.
Puedes chequear estas configuraciones yendo a > Idiomas & Librerías > Node.js y NPM.
Instalando Docker Desktop
Docker Desktop para Windows te permite instalar y ejecutar bases de datos como MongoDB y otros servicios como NGNIX y más. Esto sirve para evitar trampas cuando se instala Mongo DB u otros servicios directamente desde Windows o WSL2.
Sigue las instrucciones en la documentación oficial e instala Docker Desktop para Windows.
Hay unos requrimientos mínimos de hardware para una mejor experiencia.
Configurar Docker Desktop para WSL
Una vez instalado Docker Desktop, 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 del lado de WSL en vez de Windows. Serás capaz de acceder a servicios de http://localhost
tanto en Windows como en Ubuntu.
Instalar MongoDB desde Docker Hub
Una vez que hayas configurado Docker Desktop para trabajar con WSL2, sigue estos pasos para iniciar un servicio MongoDB:
-
Inicia una nueva terminal Ubuntu-18.04
-
Extrae
MongoDB 4.0.x
desde dockerhubdocker pull mongo:4.0
-
Inicia el servicio MongoDB en el puerto
27017
, y configúralo 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:4.0
-
Ahora puedes acceder al servicio desde Windows o Ubuntu en
mongodb://localhost:27017
.
Instalando Node.js y npm
Recomendamos que instales la versión LTS de Node.js con un gestor de versiones de node - nvm.
Una vez instalado, usa 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 has instalado los requisitos previos, siguenuestra guía de configuración local para clonar, instalar y configurar freeCodeCamp localmente en tu máquina.
[!WARNING]
Tenga en cuenta que en este momento la configuración para las pruebas Cypress (y las necesidades relacionadas con la interfaz de usuario) son un trabajo en curso. Aún así deberías poder trabajar en la mayor parte del código base.
Enlaces útiles
- Una configuración de desarrollador de WSL2 con Ubuntu 20.04, Node.js, MongoDB, VS Code y Docker - un artículo de Mrugesh Mohapatra (Staff Developer en freeCodeCamp.org)
- Preguntas frecuentes sobre: