Skip to content

Latest commit

 

History

History
1255 lines (783 loc) · 44.3 KB

windows.es.md

File metadata and controls

1255 lines (783 loc) · 44.3 KB

Instrucciones de la configuración

Aquí abajo encontrarás las instrucciones para la configuración que tu computadora necesita para el curso de Desarrollo Web de Le Wagon.

Por favor, léelas cuidadosamente y ejecuta todos los comandos en el orden indicado. Si tienes algún problema, no dudes en pedirle ayuda a tu profesor 🙋

¡Comencemos! 🚀

Zoom

Para poder interactuar cuando no estemos en el mismo lugar físico, usaremos Zoom, una herramienta de videoconferencia.

⚠️ Si ya tienes Zoom instalado, por favor asegúrate de que por lo menos tienes versión 5.6.

Ve a zoom.us/download.

Haz clic en el botón Download debajo de Zoom Client.

Abre el archivo que acabas de descargar para instalar la aplicación.

Abre la aplicación Zoom.

Si ya tienes una cuenta Zoom, inicia sesión con tus credenciales.

Si no, haz clic en el enlace Sign Up Free, que significa registrarse gratuitamente:

Registrarse gratuitamente en Zoom

Te redireccionarán a la página de Zoom para que completes un formulario.

Cuando termines, regresa a la aplicación Zoom e inicia sesión usando tus credenciales.

Deberías ver una pantalla como la siguiente:

Pantalla de inicio de Zoom

Ya puedes cerrar la aplicación Zoom.

Cuenta GitHub

¿Ya tienes una cuenta GitHub? Si no es el caso, ábrela ya.

👉 Sube una foto y escribe tu nombre correctamente en tu cuenta GitHub. Esto es importante porque nosotros usaremos un tablero de comando interno con tu avatar. Por favor hazlo ahora antes de dar un paso más en esta guía.

Foto GitHub

👉 Habilita la Autenticación de Dos Factores (2FA). GitHub te enviará mensajes de texto con un código cuando intentes iniciar sesión. Esto es importante para la seguridad y también pronto será necesario para contribuir código en GitHub.

La versión de Windows

Antes de comenzar, necesitamos verificar que la versión de Windows instalada en tu computadora sea compatible con estas instrucciones de configuración.

Windows 10 o Windows 11

Para poder configurar tu computadora, necesitas tener Windows 10 o Windows 11 instalado.

Para chequear la versión de tu Windows:

  • Presiona Windows + R
  • Escribe winver
  • Presiona Enter

✔️ Si las primeras palabras de esta ventana son Windows 10 o Windows 11, entonces todo está bien y puedes continuar trabajando en la configuración 👍

❌ Si no es el caso, no puedes continuar. Primero debes actualizar tu versión a Windows 10 👇

Actualizar a Windows 10
  • Descarga Windows 10 desde Microsoft
  • Instálalo. Debería tomar como una hora pero realmente depende de tu computadora.
  • Cuando termine la instalación, ejecuta los comandos de aquí arriba ☝️ para chequear que tengas Windows 10.

ℹ️ La actualización de Windows 11 está en curso en este momento. Esto significa que puede que esté o que aún no esté disponible para tu computadora.

⚠️ Si tienes Windows 10 instalado, no necesitas actualizarlo a Windows 11 para hacer esta configuración.

Últimas actualizaciones

Una vez que estés seguro de que estés usando Windows 10 o 11, instala las siguientes actualizaciones.

Abre Windows Update:

  • Presiona Windows + R
  • Escribe ms-settings:windowsupdate
  • Presiona Enter
  • Haz clic en Check updates

✔️ Si tienes una marca verde y el siguiente mensaje "You're up to date", entonces todo está bien 👍

⚠️ Si obtienes una exclamación roja y el siguiente mensaje "Update available", por favor instala las actualizaciones y repite el proceso hasta que diga que todo está actualizado ➿

❌ Si obtienes un mensaje de error diciendo que Windows no puede aplicar las actualizaciones, por favor contacta a un profesor.

Activa Windows Update Service para resolver las Actualizaciones

Algunos antivirus y programas deshabilitan las actualizaciones que necesitamos y luego se muestra un error. ¡Solucionemos esto!

  • Presiona Windows + R
  • Escribe services.msc
  • Presiona Enter
  • Haz doble clic en Windows Update Service
  • Coloca su Startup en Automatic
  • Haz clic en Start
  • Haz clic en Ok ¡Ahora intenta instalar las actualizaciones nuevamente!

Requisito mínimo para la versión

Algunas de las herramientas que necesitamos han salido con la versión 1903 o superior de Windows 10, así que necesitamos asegurarnos de que al menos tengamos esa.

  • Presiona Windows + R
  • Escribe winver
  • Presiona Enter

Verifica el número de la versión:

✔️ Si dice al menos 1903, entonces todo está bien 👍

❌ Si es inferior a 1903, por favor contacta a un profesor.

Virtualización

Tenemos que asegurarnos de que las opciones de Virtualización estén habilitadas en el BIOS de tu computadora.

Normalmente ya es el caso en muchas computadoras. Verifiquemos:

  • Presiona Windows + R
  • Escribe taskmgr
  • Presiona Enter
  • Haz clic en la pestaña Performance
  • Haz clic en CPU

Windows task manager

✔️ Si ves "Virtualization: Enabled", entonces todo está bien 👍

❌ Si falta la línea o si la virtualización está desactivada, por favor contacta a un profesor antes de intentar activar la Virtualización por tu cuenta

Activa la Virtualización

Debemos acceder al BIOS / UEFI de la computadora para activarla.

  • Presiona Windows + R
  • Escribe shutdown.exe /r /o /t 1
  • Presiona Enter
  • Espera a que la computadora se apague
  • Haz clic en Troubleshoot
  • Haz clic en Advanced Options
  • Haz clic en UEFI Firmware Settings
  • Haz clic en Restart

Debes activar la opción de la virtualización para tu procesador aquí:

  • La mayoría de las veces se hace en los parámetros avanzados, los parámetros del CPU o los parámetros de Northbridge
  • El nombre de la opción puede variar de una computadora a otra:
    • Intel: Intel VT-x, Intel Virtualization Technology, Virtualization Extensions, Vanderpool...
    • AMD: SVM Mode o AMD-V
  • Guarda los cambios después de la activación y reinicia la computadora con las opciones correspondientes

Subsistema de Windows para Linux (WSL)

WSL es el ambiente de entorno que estamos usando para usar Ubuntu. Puedes aprender más sobre WSL aquí.

ℹ️ Las instrucciones que verás a continuación dependen de la versión de Windows que tengas. Por favor ejecuta solamente las instrucciones que correspondan a tu versión 👇

Windows 11

Si usas Windows 11, instalaremos WSL 2 y Ubuntu con un comando a través de la terminal de Windows.

⚠️ en esta instrucción, utiliza el atajo Ctrl + Shift + Enter para usar la terminal de Windows con privilegios de administrador en lugar de simplemente hacer clic en Ok o presionar Enter.

  • Presiona Windows + R
  • Escribe wt
  • Presiona Ctrl + Shift + Enter

⚠️ tal vez tengas que aceptar la confirmación UAC sobre el cambio en los privilegios.

Un ventana de terminal azul aparecerá:

  • Copia el siguiente comando (Ctrl + C)
  • Pégalo en la ventana de la terminal (Ctrl + V o haciendo clic derecho en la ventana)
  • Ejecútalo presionado Enter
wsl --install

✔️ Si el comando se ejecutó sin ningún error, por favor reinicia tu computadora y continúa con las siguientes instrucciones aquí abajo 👍

❌ Si obtienes un mensaje de error (o si ves algún texto en rojo en la ventana), por favor contacta a un profesor

Windows 10

Instalación de WSL 1

Si tienes Windows 10, primero instalaremos WSL 1 por medio de la Terminal de PowerShell.

⚠️ en esta instrucción, utiliza el atajo Ctrl + Shift + Enter para usar Windows PowerShell con privilegios de administrador en lugar de hacer clic en Ok o presionar Enter.

  • Presiona Windows + R
  • Escribe powershell
  • Presiona Ctrl + Shift + Enter

⚠️ tal vez tengas que aceptar la confirmación UAC sobre el cambio en los privilegios.

Un ventana de terminal azul aparecerá:

  • Copia los siguiente comandos uno por uno (Ctrl + C)
  • Pégalos en la ventana de Powershell (Ctrl + V o haciendo clic derecho en la ventana)
  • Ejecútalos presionado Enter
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

✔️ Si los tres comandos se ejecutaron sin ningún error, por favor reinicia tu computadora y continúa con las instrucciones de aquí abajo 👍

❌ Si obtienes un mensaje de error (o si ves algún texto en rojo en la ventada), por favor contacta a un profesor

Actualización a WSL 2

Si tienes Windows 10, actualizaremos WSL a la versión 2.

Cuando se reinicie tu computadora, descarga el instalador de WSL2.

  • Ve a la página de descarga
  • Descarga "el paquete de actualización de WSL2 Linux kernel"
  • Abre el archivo que acabas de descargar
  • Haz clic en Next
  • Haz clic en Finish

Actualiza WSL de la versión 1 a la 2

✔️ Si no obtuviste ningún mensaje de error, entonces puedes continuar 👍

❌ Si obtienes el siguiente error "This update only applies to machines with the Windows Subsystem for Linux", haz clic derecho en el programa y selecciona uninstall; esta vez deberías poder instalarlo sin problemas.

Coloca WSL 2 como el Subsistema Windows por defecto para Linux

Si tienes Windows 10, pondremos la versión predeterminada de WSL en 2.

Ahora coloca WSL 2 como la versión predeterminada. Esto lo podemos hacer porque ya está instalado:

  • Presiona Windows + R
  • Escribe cmd
  • Presiona Enter

Escribe lo siguiente en la ventana que aparecerá:

wsl --set-default-version 2

✔️ Si ves este mensaje "The operation completed successfully", puedes cerrar esta terminal y continuar con las siguientes instrucciones aquí abajo 👍

❌ Si el mensaje que obtienes es sobre virtualización, por favor contacta a un profesor

Habilita de la feature de la Virtual Machine Platform en Windows

Sigue los pasos siguientes hasta que hayas habilitado la Virtual Machine Platform y el Subsistema de Windows para Linux

Habilita la feature de Windows Hyper-V

Sigue los pasos siguientes hasta que hayas habilitado el grupo Hyper-V

ℹ️ Si tienes Windows 10 Home edition, la feature Hyper-V no está disponible para su sistema operativo. No es un bloqueo y puedes continuar con las siguientes instrucciones aquí abajo 👌

Ubuntu

Instalación

ℹ️ Las instrucciones que verás a continuación dependen de la versión de Windows que tengas. Por favor solo sigue las instrucciones que correspondan a tu versión de Windows 👇

Windows 11

Si estás utilizando Windows 11, después de reiniciar tu computadora, deberías ver una ventana de terminal diciendo WSL está retomando el proceso de instalación de Ubuntu. Cuando termine, iniciará Ubuntu.

Windows 10

Si tienes Windows 10, instala la terminal de Windows por medio de la Microsoft Store:

  • Haz clic en Start
  • Escribe Microsoft Store
  • Haz clic en Microsoft Store en la lista
  • Busca Ubuntu en la barra de búsqueda
  • Selecciona la versión sin nombre, simplemente "Ubuntu"
  • Haz clic en Get

⚠️ ¡NO instales Ubuntu 18.04 LTS ni Ubuntu 20.04!

Desinstala las versiones incorrectas de Ubuntu

Para desinstalar las versiones incorrectas de Ubuntu, solo tienes que ir a la Lista de Programas Instalados de Windows 10:

  • Presiona Windows + R
  • Escribe ms-settings:appsfeatures
  • Preiona Enter

Busca el programa que desees desinstalar y haz clic en el botón de desinstalación.

Cuando termine la instalación, el botón Get se transformará en un botón Open: Haz clic en él.

Primer uso

La primera vez que lo abras, te pedirán que:

  • Escojas un username de:
    • una palabra
    • minúscula
    • sin caracteres especiales
    • por ejemplo: lewagon o tu firstname, es decir, tu primer nombre
  • Escoge un password
  • Confírmalo

⚠️ Cuando escribas tu contraseña no verás nada en la pantalla. Esto es normal. Es una herramienta de seguridad para ocultar tanto el contenido de tu contraseña como su longitud. Simplemente escribe tu contraseña y presiona Enter al terminar.

Ahora puedes cerrar la ventana de Ubuntu ya que está instalado en tu computadora.

Chequea la versión WSL de Ubuntu

  • Presiona Windows + R
  • Escribe cmd
  • Presiona Enter

Escribe el siguiente comando:

wsl -l -v

✔️ Si la versión de WSL de Ubuntu es 2, entonces todo está bien y puedes continuar 👍

❌ Si la versión de WSL de Ubuntu es 1, tendremos que pasarla a la versión 2.

Conversión de WSL de Ubuntu V1 a V2

Escribe esto en la ventana de Entrada de Comandos:

wsl --set-version Ubuntu 2

✔️ Deberías obtener el siguiente mensaje en algunos segundos: The conversion is complete. Esto significa que la conversión ha sido completada.

❌ Si no funciona, tendremos que asegurarnos de que los archivos de Ubuntu no estén comprimidos.

Chequea si los archivos no están comprimidos
  • Presiona Windows + R
  • Escribe %localappdata%\Packages
  • Presiona Enter
  • Abre la carpeta CanonicalGroupLimited.UbuntuonWindows...
  • Haz clic derecho en la carpeta LocalState
  • Haz clic en Properties
  • Haz clic en Advanced
  • Asegúrate de que la opción Compress content no esté seleccionada. Luego haz clic en Ok.

Aplícale cambios a esta carpeta solamente y trata de convertir la versión de WSL de Ubuntu nuevamente.

❌ Si la conversión aún no funciona, por favor contacta a un profesor.

Compruebe la locale

La "locale" es un mecanismo que permite adaptar los programas a su idioma y país.

Comprobemos que la configuración regional por defecto es el inglés:

locale

Si la salida no contiene LANG=en_US.UTF-8, ejecute el siguiente comando en un Ubuntu terminal para instalar la locale inglesa:

sudo locale-gen en_US.UTF-8

Si después, recibes una advertencia (bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)) en tu terminal, por favor haz lo siguiente:

Generar la configuración regional<>/summary>

Por favor, ejecuta estas líneas en tu terminal.

sudo update-locale LANG=en_US.UTF8
sudo apt-get update
sudo apt-get install language-pack-en language-pack-en-base manpages

Ya puedes cerrar la ventana de la terminal.

Visual Studio Code

Instalación

Instala el editor de texto Visual Studio Code.

Opciones de instalación de VS Code

Abre VS Code cuando termine la instalación.

Conexión de VS Code con Ubuntu

Instala la extensión de VS Code llamada Remote - WSL para hacer que VS Code interactúe adecuadamente con Ubuntu.

Abre tu terminal Ubuntu.

Copia y pega los siguientes comandos en la terminal:

code --install-extension ms-vscode-remote.remote-wsl

Luego abre VS Code desde la terminal:

code .

✔️ Si ves WSL: Ubuntu en la esquina inferior izquierda de la ventana de VS Code, entonces todo está bien y puedes continuar 👍

WSL Ubuntu Remote

❌ Si no es el caso, por favor pídele ayuda a un profesor.

Terminal de Windows

Instalación

ℹ️ Las instrucciones que verás a continuación dependen de la versión de Windows que tengas.

Si estás utilizando Windows 11, la terminal de Windows ya está instalada y puedes ir a la siguiente sección 👇

Si tienes Windows 10, instala la terminal de Windows. Verás que es una terminal moderna:

  • Haz clic en Start
  • Escribe Microsoft Store
  • Haz clic en Microsoft Store en la lista
  • Busca Windows Terminal en la barra de búsqueda
  • Selecciona Windows Terminal"
  • Haz clic en Install

⚠️ ¡NO instales Windows Terminal Preview, solo instala Windows Terminal!

Desinstala la versión incorrecta de la terminal de Windows

Para desinstalar la versión incorrecta la terminal de Windows, solamente tienes que ir a la lista de programas instalados de Windows 10:

  • Presiona Windows + R
  • EScribe ms-settings:appsfeatures
  • Presiona Enter

Busca el programa que quieres desinstalar y haz clic en el botón de desinstalación.

Cuando termine la instalación, el botón Install se transformará en un botón Launch: haz clic en él.

Ubuntu como terminal predeterminada

Hagamos que Ubuntu sea la terminal predeterminada de tu aplicación Windows terminal.

Presiona Ctrl + ,

Debería abrir los parámetros de la terminal:

Parámetros de Windows Terminal

  • Cambia el perfil predeterminado a "Ubuntu"
  • Haz clic en "Save"
  • Haz clic en "Open JSON file"

Verás la parte a cambiar en un círculo rojo:

Archivo de parámetros JSON de Windows Terminal

Primero pídele a Ubuntu que inicie directamente dentro de tu Ubuntu Home Directory en vez de hacerlo desde Windows:

  • Localiza el "name": "Ubuntu",
  • Agrega la siguiente línea debajo de eso:
"commandline": "wsl.exe ~",

⚠️ ¡Que no se te olvide la coma al final de la línea!

Luego deshabilita el warning para copiar y pegar comandos entre Windows y Ubuntu:

  • Localiza la línea "defaultProfile": "{2c4de342-...}"
  • Agrega la siguiente línea debajo de eso:
"multiLinePasteWarning": false,

⚠️ ¡No olvides la coma al final de la línea!

Puedes guardar estos cambios presionando Ctrl + S

✔️ Tu Windows Terminal ya está configurada 👍

Esta terminal tiene pestañas: puedes escoger abrir una terminal en una nueva pestaña haciendo clic en el + al lado de la pestaña actual. De ahora en adelante, cada vez que hablemos de la terminal o la consola, nos referiremos a esta. NUNCA más uses otra.

Extensiones de VS Code

Instalación

Vamos a instalar algunas extensiones útiles de VS Code.

Copia y pega los siguientes comandos en tu terminal:

code --install-extension ms-vscode.sublime-keybindings
code --install-extension emmanuelbeziat.vscode-great-icons
code --install-extension github.github-vscode-theme
code --install-extension MS-vsliveshare.vsliveshare
code --install-extension rebornix.ruby
code --install-extension dbaeumer.vscode-eslint
code --install-extension Rubymaniac.vscode-paste-and-indent
code --install-extension alexcvzz.vscode-sqlite
code --install-extension anteprimorac.html-end-tag-labels

Aquí está la lista de las extensiones que estás instalando:

Configuración de Live Share

Visual Studio Live Share es una extensión de VS Code que te permite compartir el código en tu editor de texto para debugging y pair-programming: ¡Instalémoslo!

Abre VS Code desde tu terminal escribiendo code y presionando Enter.

Haz clic en la pequeña flecha de la parte inferior de la barra de la izquierda:

VS Code Live Share

  • Haz clic en el botón "Share". Luego en "GitHub (Inicia sesión usando tu cuenta GitHub)".
  • Va a aparecer una ventana emergente pidiéndote que inicies sesión con GitHub: Haz clic en "Allow".
  • Te redireccionarán a una página GitHub en tu navegador pidiéndote que autorices Visual Studio Code: Haz clic en "Continue" y luego en "Authorize github".
  • Es posible que VS Code muestre más ventanas emergentess: Ciérralas haciendo clic en "OK".

Eso es todo. ¡Ya puedes continuar!

Herramientas de línea de comando

Zsh & Git

En lugar de usar el bash shell predeterminado, usaremos zsh.

También utilizaremos git, un programa de línea de comando para control de versiones.

Vamos a instalarlos, junto con otros programas útiles:

  • Abre una terminal de Ubuntu
  • Copia y pega los siguientes comandos:
sudo apt update
sudo apt install -y curl git imagemagick jq unzip vim zsh

Estos comandos te pedirán tu contraseña: escríbela.

⚠️ Cuando escribas tu contraseña no verás nada en la pantalla. Esto es normal. Es una herramienta de seguridad para ocultar tanto el contenido de tu contraseña como su longitud. Simplemente escribe tu contraseña y presiona Enter al terminar.

Instalación de la CLI de GitHub

Instalemos la CLI oficial de GitHub (Interfaz de Línea de Comando). Es un programa que se usa para interactuar con tu cuenta GitHub por medio de la línea de comando.

En tu terminal, copia y pega los siguientes comandos y escribe tu contraseña si te la piden:

sudo apt remove -y gitsome # gh command can conflict with gitsome if already installed
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install -y gh

Ejecuta el comando que te mostramos a continuación para verificar que gh se haya instalado correctamente en tu máquina:

gh --version

✔️ Si ves esta versión gh version X.Y.Z (YYYY-MM-DD), puedes continuar trabajando 👍

❌ Si no es el caso, por favor contacta a un profesor

Oh-my-zsh

Instalemos el plugin zsh Oh My Zsh.

Ejecuta este comando en la terminal:

sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Si te preguntan "Do you want to change your default shell to zsh?", presiona Y

Cuando termines, tu terminal debería lucir así:

La terminal de Ubuntu con OhMyZsh

✔️ Si es el caso, puedes continuar 👍

❌ Si no, por favor pídele ayuda a un profesor.

Conexión de tu navegador predeterminado con Ubuntu

Para asegurarnos de que puedas interactuar desde la terminal de Ubuntu con el navegador que tienes instalado en Windows, debemos definirlo como tu navegador predeterminado aquí.

⚠️ Tienes que ejecutar al menos uno de los siguientes comandos:

Google Chrome como tu navegador predeterminado

Ejecuta este comando:

  ls /mnt/c/Program\ Files\ \(x86\)/Google/Chrome/Application/chrome.exe

Si obtienes un error como este ls: cannot access... corre el siguiente comandos:

  echo "export BROWSER=\"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc
  echo "export GH_BROWSER=\"'/mnt/c/Program Files/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc

Si no es el caso, ejecuta lo siguiente:

  echo "export BROWSER=\"/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc
  echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc
Mozilla Firefox como tu navegador predeterminado

Ejecuta el siguiente comando:

  ls /mnt/c/Program\ Files\ \(x86\)/Mozilla\ Firefox/firefox.exe

Si obtienes un error como este ls: cannot access... corre el siguiente comandos:

  echo "export BROWSER=\"/mnt/c/Program Files/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc
  echo "export GH_BROWSER=\"'/mnt/c/Program Files/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc

Si no es el caso, ejecuta lo siguiente:

  echo "export BROWSER=\"/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc
  echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc
Microsoft Edge como tu navegador predeterminado

Ejecuta el siguiente comandos:

  echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc

Reinicia tu terminal.

Luego asegúrate de que el siguiente comando devuelva "Browser defined 👌":

[ -z "$BROWSER" ] && echo "ERROR: please define a BROWSER environment variable ⚠️" || echo "Browser defined 👌"

Si no lo hace pero

✔️ sí obtienes este mensaje, puedes continuar 👍

❌ De lo contrario, escoge un navegador de la lista de arriba y ejecuta el comando correspondiente. Luego no olvides reiniciar tu terminal:

exec zsh

No dudes en pedirle ayuda a tu profesor.

GitHub CLI

CLI es una abreviación de Command-line Interface que significa interfaz de línea de comando.

En esta sección usaremos GitHub CLI para interactuar directamente con GitHub desde la terminal.

Ya debería haberse instalado en tu computadora con los comandos que ejecutaste anteriormente.

Lo primero que hay que hacer para iniciar sesión es copiar y pegar el comando siguiente en tu terminal:

⚠️ NO edites el email

gh auth login -s 'user:email' -w

gh le hará algunas preguntas:

What is your preferred protocol for Git operations? Con las flechas, elige SSH y presiona Enter. SSH es un protocolo para iniciar la sesión utilizando claves SSH en lugar de la famosa pareja nombre de usuario y contraseña.

Generate a new SSH key to add to your GitHub account? Presiona Enter para pedirle a gh que genere las claves SSH por ti.

Si ya tienes claves SSH, verás en su lugar Upload your SSH public key to your GitHub account?Con las flechas, selecciona la ruta de tu archivo de clave pública y pulsa Intro.

Enter a passphrase for your new SSH key (Optional). Pon algo que quieras y que recuerdes. Es una contraseña para proteger tu private key que está almacenada en tu disco duro. Luego presiona Enter.

Title for your SSH key. Puede dejarlo en la propuesta "GitHub CLI", presiona Enter.

Obtendrás el siguiente resultado:

! First copy your one-time code: 0EF9-D015
- Press Enter to open github.com in your browser...

Selecciona y copia el código (0EF9-D015 en el ejemplo) y luego presiona Enter.

Tu navegador se abrirá y te pedirá que autorices GitHub CLI para usar tu cuenta GitHub. Acepta y espera un poco.

Regresa a la terminal, presiona Enter nuevamente y listo. Eso es todo.

Para verificar que están conectado correctamente, escribe lo siguiente:

gh auth status

✔️ Si obtienes este mensaje: Logged in to github.com as <YOUR USERNAME> , significa que todo está bien 👍

❌ De lo contrario, contacta a un profesor.

Dotfiles (configuración estándar)

Los hackers aman mejorar sus shells y sus herramientas.

Comenzaremos con una configuración predeterminada proporcionada por Le Wagon: lewagon/dotfiles.

Tu configuración es personal, así que necesitas tu propio repositorio para almacenarla. Haz el fork del repositorio de Le Wagon.

Hacer un fork significa crear un nuevo repositorio en tu propia cuenta GitHub $GITHUB_USERNAME/dotfiles el cual es idéntico al original de Le Wagon y que podrás modificar como quieras.

Abre tu terminal y ejecuta los siguientes comandos:

export GITHUB_USERNAME=`gh api user | jq -r '.login'`
echo $GITHUB_USERNAME

✔️ Deberías ver tu usuario GitHub en la pantalla.

❌ Si no es el caso, no des un paso más y pide ayuda. Es posible que haya un problema con el paso anterior (gh auth).

Es hora de hacer el fork del repositorio y clonarlo en tu computadora:

mkdir -p ~/code/$GITHUB_USERNAME && cd $_
gh repo fork lewagon/dotfiles --clone

Instalación de Dotfiles

Ejecuta el instalador de dotfiles:

cd ~/code/$GITHUB_USERNAME/dotfiles
zsh install.sh

Verifica los emails registrados en tu cuenta GitHub. Deberás seleccionar uno en el paso siguiente:

gh api user/emails | jq -r '.[].email'

✔️ Si ves una lista de tus emails registrados, puedes continuar 👍

❌ De lo contrario, por favor haz la autenticación en GitHub nuevamente antes de ejecutar este comando ☝️ again.

Instalación de git

Ejecuta el instalador de git:

cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh

☝️ Esto te pedirá tu nombre (FirstName LastName) y tu email. Cualquier correo que elijas se mostrará públicamente en internet. 💡 Selecciona la dirección @users.noreply.github.com si no quieres que tu correo electrónico aparezca en los repositorios públicos a los que puedas contribuir.

⚠️ Necesitas poner uno de los emails que aparecen arriba gracias al comando anterior gh api .... De lo contrario, Kitt no podrá hacerle seguimiento a tu progreso.

Ahora resetea tu terminal ejecutando lo siguiente:

exec zsh

Desahilitación de la solicitud de SSH passphrase

No vas a querer que te pidan tu passphrase cada vez que te comuniques con un repositorio remoto. Por eso debes agregarle plugin ssh-agent a oh my zsh:

Primero abre el archivo .zshrc:

code ~/.zshrc

Luego:

  • Identifica la línea que comienza por plugins=
  • Agrega ssh-agent al final de la lista de plugins

La lista debería verse de la siguiente manera:

plugins=(gitfast last-working-dir common-aliases zsh-syntax-highlighting history-substring-search pyenv ssh-agent)

✔️ Guarda el archivo .zshrc con Ctrl + S y cierra tu editor de texto.

rbenv

Instala rbenv, un programa para instalar y gestionar entornos ruby.

Primero debemos limpiar cualquier instalación previa de Ruby que tengas en tu computadora:

rvm implode && sudo rm -rf ~/.rvm
# If you got "zsh: command not found: rvm", carry on.
# It means `rvm` is not on your computer, that's what we want!
rm -rf ~/.rbenv

Luego ejecuta lo siguiente en tu terminal:

sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
exec zsh

Ruby

Instalación

Ahora estás listo para instalar la última versión de ruby y ponerla como la versión predeterminada.

Corre este comando, tomará un tiempo (5-10 minutos)

rbenv install 3.1.2

Cuando la instalación de ruby termine, corre este comando para decirle al sistema que use la versión 3.1.2 por defecto.

rbenv global 3.1.2

Reinicia tu terminal y chequea tu versión Ruby:

exec zsh

Luego ejecuta esto:

ruby -v

✔️ Si ves algo que comience por ruby 3.1.2p, entonces puedes continuar +1:

❌ Si no es el caso, pídele ayuda a un profesor.

Instalación de algunas gemas

Si estás en China 🇨🇳 haga clic aquí

⚠️ Si estás en China, deberías actualizar la forma de instalar las gemas con los siguientes comandos.

# China only!
gem sources --remove https://rubygems.org/
gem sources -a https://gems.ruby-china.com/
gem sources -l
# *** CURRENT SOURCES ***
# https://gems.ruby-china.com/
# Ruby-china.com must be in the list now

Todos, todas, en China o no, continúen aquí para instalar gemas.

En el universo de ruby, a las librerías externas se les llama gems: son pedazos de código ruby que puedes descargar y ejecutar en tu computadora. ¡Instalemos algunas!

Primero, vamos a actualizar bundler, que es lo que nos permite instalar gemas:

gem update bundler

En tu terminal, copia y pega el siguiente comando:

gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3:1.7.3 activerecord:7.1.3.2

✔️ Si obtienes xx gems installed, entonces todo está bien 👍

❌ Si obtienes el siguiente error:

ERROR: While executing gem ... (TypeError)
incompatible marshal file format (can't be read)
format version 4.8 required; 60.33 given

Ejecuta el siguiente comando:

rm -rf ~/.gemrc

Ejecuta el comando nuevamente para instalar las gemas.

⚠️ ¡NUNCA instales una gema con sudo gem install! Incluso si encuentras una solución en Stackoverflow (o la terminal) diciéndote que lo hagas.

Node.js

Node.js es un JavaScript runtime para ejecutar código JavaScript en la terminal. Instálalo con nvm, aun gestionador de versiones para Node.js.

En una terminal, ejecuta estos comandos:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh
exec zsh

Luego corre el siguiente comando:

nvm -v

Deberías ver una versión. Si no, pídele ayuda a tu profesor.

Ahora instala node:

nvm install 16.15.1

Cuando termine la instalación, corre lo siguiente:

node -v

Si ves v16.15.1, the installation succeeded ✔️ entonces ahora puedes ejecutar lo siguiente:

nvm cache clear

❌ De lo contrario, contacta a un profesor.

yarn

yarn es un gestor de paquetes para instalar librerías JavaScript. Instálalo:

En una terminal, ejecuta los siguientes comandos:

npm install --global yarn
exec zsh

Luego ejecuta este comando:

yarn -v

✔️ si ves una versión, entonces todo está bien 👍

❌ Si no es el caso, pídele ayuda a un profesor

SQLite

En algunas semanas hablaremos de bases de datos y de SQL. SQLite es un sistema utilizado en bases de datos para ejecutar consultas SQL en bases de datos de un solo archivo. Vamos a instalarlo:

En un terminal, ejecuta los siguientes comandos:

sudo apt-get install sqlite3 libsqlite3-dev

A continuación, ejecuta el siguiente comando:

sqlite3 -version

✔️ Si ves una versión, puedes continuar 👍

❌ Si no, pídele ayuda a un profesor

PostgreSQL

A veces SQLite no es suficiente y necesitaremos una herramienta más avanzada llamada PostgreSQL. Esta es un sistema para bases de datos de código abierto y listo para usar en producción.

Vamos a instalarlo ahora.

Ejecuta los siguientes comandos:

sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential
sudo /etc/init.d/postgresql start
sudo -u postgres psql --command "CREATE ROLE `whoami` LOGIN createdb superuser;"

Puedes configurar PostgreSQL para que inicie automáticamente para no tener que ejecutar el comando sudo /etc/init.d/postgresql start cada vez que abras una nueva terminal:

sudo echo "`whoami` ALL=NOPASSWD:/etc/init.d/postgresql start" | sudo tee /etc/sudoers.d/postgresql
sudo chmod 440 /etc/sudoers.d/postgresql
echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc

Abre una nueva terminal.

✔️ Si ves un mensaje * Starting postgresql (via systemctl): postgresql.service O * Starting PostgreSQL 14 database server, entonces todo está bien y puedes continuar 👍

❌ Si no es el caso, contacta a un profesor.

Chequeo

Verifiquemos si has instalado todo bien.

Ejecuta el siguiente comando en tu terminal:

exec zsh

Luego ejecuta lo siguiente:

curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb

✔️ Si obtienes un mensaje verde diciendo Awesome! Your computer is now ready!, significa que tu computadora está lista y que todo está bien 👍

❌ De lo contrario, habla con tu profesor.

Kitt

⚠️ Si recibiste una invitación por email de Le Wagon para crear una cuenta en Kitt (nuestra plataforma de aprendizaje), ignora este paso y sigue las instrucciones en el email si es que todavía no lo has hecho.

Si no sabes que hacer, haz clic en este enlace. Si ya iniciaste sesión, puedes omitir esta sección. Si no, haz clic en Enter Kitt as a Student. Esto significa iniciar sesión como estudiante. Si no tienes problemas para iniciar sesión, puedes omitir este paso. De lo contrario pídele a un profesor que te confirme si debiste haber recibido o si debes seguir las instrucciones de aquí abajo.

Registrate como alumni de Le Wagon yendo a kitt.lewagon.com/onboarding. Selecciona tu batch, inicia sesión con GitHub y completa toda la información que te piden.

Ahora tu profesor podrá validar que realmente eres parte del batch. Pídele que lo haga justo después de que hayas completado el formulario de registro.

Cuando el profesor haya aprobado tu perfil, ve a la bandeja de entrada de tu email. Deberías tener 2 nuevos emails:

  • Uno de Slack, invitándote a la comunidad de los alumni de Le Wagon en slack (donde podrás chatear con tus compañeros y todos los demás alumni). Haz clic en Join y completa la información que te piden.
  • Otro de GitHub, invitándote a lewagon team. Acéptala, de lo contrario no podrás acceder a las diapositivas de las clases.

Slack

Slack es una plataforma de comunicación popular en la industria tech.

Instalación

Descarga la aplicación Slack e instálala.

⚠️ Si ya estás usando Slack en tu navegador, por favor descarga e instala la aplicación de escritorio la cual tiene todas las funciones.

Parámetros

Abre la aplicación e inicia sesión en lewagon-alumni.

Asegúrate de subir una foto para tu perfil 👇

Cómo subir una foto de perfil en Slack

La idea es tener Slack abierto todo el día para compartir enlaces útiles / pedir ayuda / decidir dónde almorzar / etc.

Para asegurarte de que todo lo relacionado a videollamadas funcione bien, prueba tu cámara y tu micrófono:

  • Abre la aplicación Slack
  • Haz clic en tu foto de perfil en la esquina superior derecha
  • Selecciona "Preferencias" en el menú.
  • Haz clic en "Audio y vídeo" en la columna de la izquierda.
  • Debajo de "Solución de problemas", haz clic en "Ejecutar una prueba de audio, vídeo y pantalla compartida". La prueba se abrirá en una nueva ventana.
  • Comprueba que tus dispositivos preferidos de altavoz, micrófono y cámara aparecen en los menús desplegables y haz clic en "Iniciar prueba"
  • Haz clic en el botón verde "Start test"

Chequea el micrófono y la cámara con Slack

✔️ Cuando termine el test deberías ver mensajes de "Succeed" en verde por lo menos para tu micrófono y tu cámara. 👍

❌ Si no es el caso, contacta a un profesor.

¡También puedes instalar la aplicación Slack en tu smartphone e iniciar sesión en lewagon-alumni!

Parámetros de Windows

Intercambio de archivos entre Windows y Ubuntu

Necesitamos una manera fácil de transferir archivos de Windows a Ubuntu y viceversa.

Para ello, vamos a crear atajos a directorios Ubuntu en el Explorador de Archivos de Windows:

  • Abre el Explorador de Archivos de Windows (o usa el atajo WIN + E)
  • En la Barra de Direcciones, coloca \\wsl$\ (o \\wsl$\Ubuntu si eso no funciona)
  • Ahora tienes acceso al sistema de archivos de Ubuntu
  • Navega por el sistema de archivos de Ubuntu para encontrar los directorios que te interesen
  • Arrastra las carpetas que te interesen a la Barra de Direcciones para crear atajos

Cómo agregar un atajo al sistema de archivos de Ubuntu en Windows

Abre el Explorador de Archivos de Windows desde la terminal de Ubuntu

Otra opción para mover archivos es abrir el Explorador de Archivos de Windows desde la terminal de Ubuntu:

  • Abre una terminal de Ubuntu
  • Ve al directorio que quieres explorar
  • Ejecuta el comando explorer.exe . (Otra alternativa es usar wslview .)
  • Si obtienes un mensaje de input output error, ejecuta wsl --shutdown en una PowerShell de Windows y abre la terminal de Ubuntu nuevamente

Cómo abrir Windows Explorer desde la terminal de Ubuntu

Uso del Sistema de Archivos de Ubuntu

Es posible que quieras averiguar la localización exacta de un directorio en Windows en el sistema de archivos de Ubuntu o viceversa.

Para convertir una ruta Windows a una Ubuntu y viceversa:

  • Abre una terminal de Ubuntu
  • Usa el comando wslpath "C:\Program Files" para traducir la ruta Windows a una Ubuntu
  • Usa el comando wslpath -w "/home" para traducir una ruta Ubuntu a una Windows
  • El comando wslpath -w $(pwd) devuelve la ruta Windows del directorio Ubuntu actual

Cómo acceder a una ruta Windows desde una terminal de Ubuntu

Anclaje de aplicaciones a tu barra de tareas

Usarás frecuentemente casi todas las aplicaciones que has instalado hoy. ¡Anclémoslas a tu barra de tareas para que estén a solo un clic de ti!

Para ello, abre la aplicación. Haz clic derecho en el ícono de la barra de tareas para hacer que aparezca el menú contextual (también llamado emergente) y selecciona "Pin to taskbar".

Cómo anclar una aplicación a la barra de tareas en Windows

Ancla lo siguiente:

  • Tu terminal
  • Tu explorador de archivos
  • VS Code
  • Tu navegador de Internet
  • Slack
  • Zoom

¡Fin de la configuración!

Tu computadora está lista para el curso de Desarrollo Web de Le Wagon 💪 👏

Disfrútalo, sabemos que te va a ir genial 🚀