Skip to content

WINDOWS_keep_current.es.md

Latest commit

 

History

History
431 lines (256 loc) · 13.7 KB

WINDOWS_keep_current.es.md

File metadata and controls

431 lines (256 loc) · 13.7 KB
Raw

Mantén tu configuración actualizada

Esta sección contiene los pasos que debes seguir para asegurarte de que tu configuración esté actualizada.

Ante todo, para poder trabajar en buenas condiciones, asegúrate de que:

  • tienes una conexión a internet de alta velocidad;
  • tu ordenador tiene suficiente memoria (8 GB) para ejecutar tu código de manera eficiente;
  • tu ordenador tiene suficiente espacio en disco (30 GB) para trabajar con conjuntos de datos grandes.

En esta guía nos centramos en lo esencial:

  • Git y GitHub.
  • Los dotfiles, los archivos de configuración de tu shell. Son importantes para que Python funcione.
  • Instalar Python y sus dependencias con uv.
  • Autenticarte con Google Cloud.

Según tu caso de uso, es posible que también quieras actualizar otras partes. Si es así, consulta las instrucciones completas de configuración.

git

Verifica que git funciona:

git --version

👉 Deberías obtener un resultado similar a este, que muestra la versión de git:

git version 2.33.0

Si esto no funciona, te recomendamos seguir las instrucciones completas de configuración.

GitHub

Comprueba que la CLI de gh está autenticada:

✔️ Si obtienes este resultado, todo está correcto 👍

✔️ Logged in to github.com as <YOUR GITHUB USERNAME>
- Active account: true
- Git operation protocol: ssh
...

Presta atención a ssh en la tercera línea. Si aparece otra cosa, tu configuración ya no está actualizada.

❌ Si no es así, te recomendamos seguir las instrucciones completas de configuración.

Actualizar tus dotfiles

Los dotfiles experimentaron un cambio importante en septiembre de 2026. Si los instalaste antes, debes actualizarlos.

Sigue las instrucciones que aparecen a continuación si eres un estudiante que regresa.

Dotfiles

Mejoremos la experiencia de tu máquina instalando los dotfiles 🔗 preconfigurados de Le Wagon. Son archivos de configuración para tu terminal, zsh, git y VS Code.

Obtener tu nombre de usuario de GitHub

Ejecuta el siguiente comando:

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

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

❌ Si no es así, detente aquí y pide ayuda. Puede haber un problema con el paso anterior (gh auth).

Crear un fork de los dotfiles

Para personalizar esta configuración, tendrás que crear un fork del repositorio en tu propia cuenta de GitHub.

Crear un fork genera una copia del repositorio en tu cuenta (your_github_username/dotfiles), que luego podrás modificar con tus datos personales, como tu nombre.

❗ Si ya hiciste otro bootcamp de Le Wagon (Desarrollo web, Desarrollo de software con IA, Análisis de datos, Ciencia de datos e IA), abre un ticket con un TA y abre esta sección para ver las instrucciones ❗

Es posible que tengas una versión antigua de los dotfiles de Le Wagon. Podrían ser incompatibles con la configuración actual.

Junto con un TA, haz una de las siguientes acciones:

Estoy usando la misma máquina (o una máquina nueva que ya tiene los dotfiles).

  1. Ve a tu carpeta actual de dotfiles:

    cd ~/code/$GITHUB_USERNAME/dotfiles

  2. Comprueba las diferencias con la versión actual de los dotfiles de Le Wagon:

    git diff upstream/master

Si no hay diferencias importantes aparte de tu nombre y correo electrónico, continúa con la configuración.

Estoy usando una máquina nueva sin los dotfiles.

  1. Ve a GitHub y encuentra tu repositorio de dotfiles.

  2. Comprueba cuántos commits por detrás y por delante está de lewagon/dotfiles:master. Puedes verlo justo encima de la lista de archivos.

  3. Haz clic en los enlaces de commits por detrás y por delante, y desplázate hacia abajo para ver las diferencias.

Si no hay diferencias importantes aparte de tu nombre y correo electrónico, continúa con la configuración.

El paso anterior mostró diferencias importantes.

Si estás de acuerdo con perder tus dotfiles actuales (recomendado):

Ten en cuenta que esto eliminará cualquier cambio personal que hayas hecho en la configuración de tu shell, como cargar utilidades adicionales o cambiar su apariencia. Si no recuerdas haber hecho cambios, no debería haber ningún problema.

  1. Elimina tu repositorio actual de dotfiles en GitHub.
  2. Elimina el repositorio local: 
    cd ~/code && rm -rf ~/code/$GITHUB_USERNAME/dotfiles
  3. Continúa con la configuración.
Si no quieres perder tus dotfiles actuales, te recomendamos trabajar con ramas. Haz clic para abrir.

En tu portátil, o donde tengas una copia local de tu versión actual de los dotfiles.

  1. Haz commit de tu versión actual de los dotfiles:

    git add .
git status # Comprueba qué se incluirá en el commit
git commit -m "Version prior to new setup"

  2. Crea una rama de tu configuración actual de dotfiles y súbela a GitHub:

    git checkout -b old-setup
git push origin old-setup

  3. Vuelve a master: git checkout master.

  4. En tu master local, ejecuta git pull upstream master.

  5. Comprueba que no estés en estado MERGING. Si lo estás, resuelve los conflictos.

    Es importante que aceptes los cambios entrantes en los archivos .zshrc, .zprofile y settings.json, especialmente todo lo relacionado con pyenv y los entornos de Python.

    Si hay demasiados conflictos, usa tu editor de código para reemplazar el contenido de los archivos en conflicto por el de los dotfiles de Le Wagon.

    Haz commit de la resolución de conflictos: git commit --no-edit

  6. Sube tus cambios a GitHub: git push origin master.

  7. Continúa con la configuración.


Es hora de crear un fork del repositorio y clonarlo en tu ordenador:

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

Si aparece la pregunta "Are you sure you want to continue connecting (yes/no/[fingerprint])?", escribe yes y pulsa Enter.

Instalar los dotfiles

Ejecuta el instalador de dotfiles con:

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

Comprueba los correos electrónicos registrados en tu cuenta de GitHub. Tendrás que elegir uno en el siguiente paso:

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

Ejecuta el instalador de git:

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

☝️ Se te pedirá tu nombre (FirstName LastName) y tu correo electrónico.

⚠️ Debes introducir uno de los correos que aparecen arriba, obtenidos con el comando gh api .... Si no lo haces, Kitt no podrá realizar un seguimiento de tu progreso.

💡 Selecciona la dirección ...@users.noreply.github.com si no quieres que tu correo aparezca en repositorios públicos a los que contribuyas.

Instalar Python y sus dependencias

Tu sistema operativo - macOS, o Ubuntu (nativo, o dentro de WSL) - viene con un "Python del sistema". Esa es una versión de Python de la que depende tu sistema. No vamos a tocar esa. Vamos a hacer una configuración profesional de Python en la que no estropees tu "Python del sistema" y en la que podrás cambiar la versión que quieras usar para cada proyecto en el que trabajes.

Para gestionar diferentes versiones de Python y entornos virtuales (descubrirás qué significa eso durante la clase de configuración), usaremos la herramienta de última generación uv creada por Astral.

Instalar uv

Primero, instalaremos uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

A continuación, reinicia tu shell ejecutando esto:

exec zsh

Crear un entorno virtual

A continuación, crearemos un entorno virtual (un entorno aislado con Python y las dependencias del bootcamp):

uv venv ~/.lewagon/venvs/lewagon --python 3.12.9

Ahora que hemos creado este nuevo entorno virtual, reiniciemos nuestro shell para que lo detecte (esto funciona gracias a los lewagon/dotfiles que instalamos antes):

exec zsh

Comprobemos que todo ha ido bien. Ejecuta esto:

which python3

Debería devolver esto:

/home/your-username/.lewagon/venvs/lewagon/bin/python3

Si no lo hace, ¡consulta con un TA! No continúes con el siguiente paso hasta que hayas resuelto esto.

Instalar dependencias

Python es genial para datos, porque la comunidad ha desarrollado una enorme cantidad de paquetes que podemos reutilizar.

Instalemos los más comunes:

uv pip install -r https://raw.githubusercontent.com/lewagon/data-setup/master/specs/releases/linux.txt

Configuración de Jupyter Notebook

Dependiendo de tu sistema, necesitamos hacer algunos cambios pequeños en tu configuración de Jupyter.

Ejecuta esto:

bash -c "$(curl -s https://raw.githubusercontent.com/lewagon/data-setup/refs/heads/master/checks/setup_jupyter.sh)"
Si tienes curiosidad sobre lo que sucede aquí, haz clic aquí.

Este script añade una configuración para mejorar la visualización de los elementos details en tus notebooks.

Si estás usando Windows WSL, también soluciona otros problemas.

  • Se asegura de que tu navegador esté configurado correctamente. Ya estaba configurado, pero la configuración de dotfiles lo sobrescribió.
  • Soluciona un error conocido en Jupyter Notebook que siempre abre el árbol de directorios, incluso si especificas una ruta de archivo específica.

Chequeo de la configuración de Python

Chequeo de Python y packages

Reinicia tu terminal:

cd ~/code && exec zsh

Verifica tu versión de Python con los siguientes comandos:

zsh -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/python_checker.sh)" 3.12.9

Ahora verifica que puedas iniciar un servidor de notebook en tu máquina:

jupyter notebook

Tu navegador web debería abrir en una ventana jupyter:

jupyter.png

Haz clic en New y, en el menú desplegable, selecciona Python 3 (ipykernel):

jupyter_new.png

Debería abrirse una pestaña en un nuevo notebook:

jupyter_notebook.png

Asegúrate de que estés usando la versión correcta de python en el notebook. Abre una celda y ejecuta lo siguiente:

import sys; sys.version

Debería mostrar 3.12.9 seguido de algunos detalles adicionales. Si no es así, consulta con un TA.

En otra celda, ejecuta:

import pandas as pd
pd.__version___

Esto podría tomar algunos minutos en ejecutarse. Debería mostrar un número de versión, 2.2.3. Si no es así, consulta con un TA.

Puedes cerrar tu navegador web y luego cerrar el servidor jupyter con CTRL + C.

¡Listo! Ya tienes un virtual env de python completo con todos los paquetes tercerizados que necesitarás en el bootcamp.

CLI de Google Cloud

Instala la CLI de gcloud para comunicar con Google Cloud Platform a través de la terminal:

sudo apt-get update && sudo apt-get install ca-certificates gnupg curl
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
sudo apt-get update && sudo apt-get install google-cloud-cli

👉 Documentación para la instalación

Configurar Cloud SDK

  • Autentica la CLI de gcloud con la cuenta de Google que utilizaste para GCP

    gcloud auth login --no-launch-browser

  • Inicia sesión en tu cuenta de Google en la nueva pestaña que se abrió en tu navegador web

  • Muestra tu cuenta activa y comprueba que aparece la dirección de correo electrónico que utilizaste para GCP

    gcloud auth list

  • Establece tu proyecto actual (reemplaza PROJECT_ID por el ID de tu proyecto, por ejemplo, wagon-bootcamp-123456)

    gcloud config set project PROJECT_ID

  • Muestra tu cuenta activa y tu proyecto actual, y comprueba que aparece tu proyecto

    gcloud config list

  • Ahora vamos a configurar las credenciales predeterminadas de la aplicación para que tu código Python pueda acceder a GCP:

    gcloud auth application-default login

    Esto abrirá una ventana del navegador. Inicia sesión con la misma cuenta de Google que utilizaste para crear tu proyecto de GCP. Tus credenciales se guardarán automáticamente.

  • Verifiquemos que tus credenciales predeterminadas de la aplicación funcionan:

    gcloud auth application-default print-access-token

    Deberías ver una cadena de token larga. Si aparece un error, vuelve a ejecutar gcloud auth application-default login.

    Solución de problemas

🏁 ¡Has terminado la configuración de GCP!