Estos d铆as la mejor manera de tener un ambiente de desarrollo en Windows es usando WSL 2, que genera una instalaci贸n de Linux integrada a Windows sin tener que reiniciar.
-
En Windows Terminal ejecuta
wsl --install -
Instala Ubuntu desde la Windows Store https://apps.microsoft.com/store/detail/ubuntu/9PDXGNCFSCZV
Para instalar Windows Terminal, sigue las instrucciones aqu铆.
馃挕 Si est谩s leyendo esto en el futuro (o est谩s dentro del Windows Insiders Program) instalar wsl puede ser tan f谩cil como ejecutar
wsl --installen una consola con permisos de Administrador.
馃挕 Antes de empezar, aseg煤rate de tener una versi贸n de Windows mayor o igual a 1903 o Build 18362. Puedes chequear esto ejecutando con
winveren el buscador del menu de Windows.
<img src='assets/windows-1.png'/>
-
Activa WSL ejecutando lo siguiente en una consola de powershell con permisos de administrador:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart -
Reinicia y ejecuta lo siguiente para activar la virtualizaci贸n necesaria para WSL 2:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart -
Reinicia y descarga la actualizaci贸n del kernel de linux de la siguiente url: https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
-
En una consola de powershell ejecuta el siguiente comando para usar WSL 2 por defecto:
wsl --set-default-version 2 -
Instala Ubuntu desde la tienda de Microsoft y crea un usuario cuando termine la instalaci贸n.
-
Para tener un terminal decente instala Windows Terminal desde la Microsoft Store, desde el repo o usando scoop (
scoop install windows-terminal) (ver Instalando Utilidades)
Es posible que sea necesario limitar la cantidad de memoria que WSL usa. Esto se puede lograr editando (o creando) el archivo C:\\Users\\TU_USUARIO\\.wslconfig con lo siguiente:
```plain text
[wsl2]
memory=4GB
```
Una vez instalado Windows Terminal, el ambiente de desarrollo funciona como cualquier otra instalaci贸n de Linux.
La mayor铆a de los proyectos de Platanus modernos usan Docker para los servicios como postgres o redis pero lo siguiente es una lista de los requisitos m铆nimos y como instalarlos desde Windows Terminal y la shell de Ubuntu:
-
git (
git ) -
rbenv (https://github.com/rbenv/rbenv-installer) y rbenv-aliases (https://github.com/tpope/rbenv-aliases)
-
nodenv (https://github.com/nodenv/nodenv-installer) y nodenv-aliases (https://github.com/nodenv/nodenv-aliases)
-
yarn (
npm install -g yarno https://github.com/pine/nodenv-yarn-install para no tener que instalarlo a mano con cada versi贸n de node) -
dependencia para la gema pg (
sudo apt install libpq-dev) -
dependencia vips (
sudo apt install libvips42 nip2-)
馃挕 Si tienes Git for Windows instalado (con scoop:
scoop install git) puedes usar Git Credential Manager de Windows para que se encargue de recordar tus credenciales de GitHub en WSL.git config --global credential.helper /mnt/c/Users/TU_USUARIO/scoop/apps/git/current/mingw64/bin/git-credential-manager.exe
馃挕 A pesar que WSL 2 lo permite, no te recomendamos clonar los proyectos dentro del filesystem de Windows (
/mnt/co similar) por temas de performance. Lo mejor es mantener los proyectos dentro del filesystem de Linux (~/). Si necesitas entrar a estas carpetas con File Explorer puedes hacerlo ejecutandoexplorer.exe .en la carpeta correspondiente o navegando a\\\\wsl$\\Ubuntu-20.04\\home\\TU_USUARIO\\. En Windows Terminal puedes configurar que siempre se abra en tu home en las opciones.
Aparte de WSL 2, para instalar utilidades nativas de Windows puedes usar scoop, un instalador para la linea de comando que hace muy f谩cil instalar binarios (como imagemagick, ffmpeg, etc) para que queden disponibles en el PATH de Windows.
馃挕 En teor铆a es posible usar scoop y Docker para instalar todo lo necesario ejecutar los proyectos sin necesidad de WSL 2 pero se aleja del setup estandar que usamos en Platanus y no podremos ayudarte si tienes alg煤n problema.