La guia de platanus
  • README
  • Acuerdos
    • Guía de Estilo
      • Ejemplo: Módulo para variables de entorno
  • Stack
    • Getting Started
    • Nuestro MVC extendido
    • Ruby/Rails
      • Power Types
        • General
        • Patrones
          • Commands
          • Utils
          • Services
          • Values
          • Observers
      • Potassium
      • Power API
      • Active Admin
        • General
        • Active Admin Addons
      • Pundit
      • Shrine
        • General
        • Manejo y procesamiento de imágenes
      • Pry
      • Strong Migrations
      • Data Migrate
      • Active Job
      • Gems
      • Engines - Modularización en Rails
    • JavaScript
      • Vue
        • General
        • Testing
      • AlpineJS
    • CSS
    • Mobile
      • Expo
      • React Navigation
      • Redux
        • Crear y conectar una slice en Redux
      • Styling
        • Usando Tailwind en React Native
      • Recursos
    • Resolviendo problemas (debugging)
    • Machine Learning
  • Setup
    • Configuración de tu entorno local
      • Instalación Base
        • OSX
        • Windows
        • Linux
      • Tecnologías
        • Ruby
        • Docker
        • Node
      • Herramientas
        • Linters
        • Editores
          • IDE/Editores de Código
            • Visual Studio Code
            • Sublime Text
        • Git
    • Configuración de proyectos
      • Getting Started
      • Heroku
      • Rails
      • Circle CI
      • Vue
      • Apple App Store
      • Google Play
      • Expo
      • S3
      • Git
      • Cloudflare
      • Sendgrid
      • Dominio + Mailing
      • Google Tag Manager, Analytics, Search Console, etc.
        • Google Tag Manager
          • Configurar Google Tag Manager
        • Google Analytics
        • Indexación en Google
        • Google Ads
      • Crear un bucket de S3
      • SlackBot
      • Google BigQuery
  • Deployment
    • Rails
    • Ruby Gems
    • Browser and Node (Open Source)
    • Mobile
      • Mobile Resources
      • Apple App Storage
      • Google Play
  • Upgrades
    • Upgrade de Vue 2 a Vue 3
    • Migración Hound → reviewdog
    • Upgrade de Postgresql
Con tecnología de GitBook
En esta página
  • Windows 11
  • Windows 10
  • Instalando Windows Terminal
  • Instalando WSL 2
  • Ambiente de Desarrollo
  • Instalando Utilidades
  • Links de Referencia
  1. Setup
  2. Configuración de tu entorno local
  3. Instalación Base

Windows

AnteriorOSXSiguienteLinux

Última actualización hace 1 año

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.

Windows 11

  1. En Windows Terminal ejecuta wsl --install

  2. Instala Ubuntu desde la Windows Store

Windows 10

Instalando Windows Terminal

Para instalar Windows Terminal, sigue las instrucciones .

Instalando WSL 2

💡 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 --install en 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 winver en el buscador del menu de Windows.

<img src='assets/windows-1.png'/>
  1. 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
  2. Reinicia y ejecuta lo siguiente para activar la virtualización necesaria para WSL 2:

    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  3. Reinicia y descarga la actualización del kernel de linux de la siguiente url:

  4. En una consola de powershell ejecuta el siguiente comando para usar WSL 2 por defecto:

    wsl --set-default-version 2
  5. Instala y crea un usuario cuando termine la instalación.

  6. Para tener un terminal decente instala Windows Terminal desde la , desde o usando scoop (scoop install windows-terminal) (ver )


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
```

Ambiente de Desarrollo

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 )

  • 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/c o 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 ejecutando explorer.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.

Instalando Utilidades

💡 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.

Links de Referencia

rbenv () y rbenv-aliases ()

nodenv () y nodenv-aliases ()

yarn (npm install -g yarn o para no tener que instalarlo a mano con cada versión de node)

Aparte de WSL 2, para instalar utilidades nativas de Windows puedes usar , 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.

https://github.com/rbenv/rbenv-installer
https://github.com/tpope/rbenv-aliases
https://github.com/nodenv/nodenv-installer
https://github.com/nodenv/nodenv-aliases
https://github.com/pine/nodenv-yarn-install
scoop
https://docs.microsoft.com/en-us/windows/wsl/install-win10
https://docs.microsoft.com/en-us/windows/terminal/get-started
https://docs.microsoft.com/en-us/windows/wsl/tutorials/wsl-containers
https://docs.microsoft.com/en-us/windows/wsl/wsl-config#configure-global-options-with-wslconfig
https://apps.microsoft.com/store/detail/ubuntu/9PDXGNCFSCZV
aquí
https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
Ubuntu desde la tienda de Microsoft
Microsoft Store
el repo
Instalando Utilidades