VM.es.md

Instrucciones para la configuración

Aquí abajo encontrarás las instrucciones para configurar tu computadora para el curso de Data Science de Le Wagon

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

¡Comencemos! 🚀

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.

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

Configuración de Google Cloud Platform

GCP es una solución en la nube que usarás para colocar tus productos basados en Machine Learning en producción.

🚨 Si estás en el grupo de estudiantes del Bootcamp de Medio Tiempo, ¡IGNORA ESTA SECCIÓN POR AHORA! GCP ofrece $300 en créditos durante 3 meses, así que no es buena idea activar tu cuenta GCP demasiado pronto 🙅‍♂️

Preparación del Proyecto

• Ve a Google Cloud y crea una cuenta si aún no tienes una
• En la consola de Cloud, en la lista de proyectos, selecciona o crea un proyecto Cloud

• Asígnale un nombre como Wagon Bootcamp por ejemplo
• Verás que se creará un ID automáticamente para el proyecto e. g. wagon-bootcamp-123456

Idioma de la cuenta

Abre las preferencias en tu cuenta GCP para facilitar el seguimiento de las instrucciones durante el bootcamp:

https://myaccount.google.com/language

Si el idioma de preferencia no es:

• English
• United States

Cámbialo a inglés:

• Haz clic en el logo edición (es una lapicera)
• Selecciona English
• Selecciona United States
• Haz clic en Select

Cuenta de facturación

Ahora conecta tu cuenta con tu tarjeta de crédito. Este paso es obligatorio para poder usar los servicios que suministra GCP. No te preocupes, podrás utilizar la mayoría de los servicios de GCP por medio de créditos gratuitos durante el bootcamp.

• Haz clic en Billing
• Haz clic en MANAGE BILLING ACCOUNTS
• Haz clic en ADD BILLING ACCOUNT
• Asígnale un nombre a tu cuenta de facturación, e. g. My Billing Account
• Haz clic en "I have read..." y acepta los términos de uso
• Haz clic en CONTINUE
• Selecciona tu tipo de cuenta: Individual
• Agrega tu nombre y dirección

Verás que tienes créditos gratuitos con un valor de "$300 a utilizar en los próximos 90 días".

• Haz clic en los detalles de la tarjeta
• Agrega la información de tu tarjeta de crédito
• Haz clic en START MY FREE TRIAL. Esto significa comenzar mi período de prueba.

Cuando termines, verifica que la cuenta de facturación esté conectada con tu proyecto GCP.

• Selecciona tu proyecto
• Ve a Billing
• Selecciona LINK A BILLING ACCOUNT
• Selecciona My Billing Account
• Haz clic en SET ACCOUNT

Ahora deberías ver lo siguiente:

Free trial status: $300 credit and 91 days remaining - with a full account, you'll get unlimited access to all of Google Cloud Platform.

Esto significa Estado de período de prueba: crédito de $300 y 91 días para usarlo - con la full account, tendrás acceso ilimitado a todo lo que ofrece Google Cloud Platform.

👉 Si no tienes una tarjeta de crédito 👈

Si no tienes una tarjeta de crédito, puedes abrir una cuenta en Revolut. Revolut es una aplicación que funciona como un banco y que te permitirá crear una tarjeta de crédito virtual conectada a la dirección de facturación de tu smartphone.

Ignora este paso si ya tienes una tarjeta de crédito. Simplemente úsala para hacer la configuración.

Descarga la app Revolut o ve a revolut y sigue los pasos para descargar la app (introduce tu número de teléfono móvil y haz clic en Get Started).

• Abre la app Revolut
• Agrega tu número de teléfono móvil
• Agrega el código de verificación que recibiste por SMS
• La app te preguntará por tu país, dirección, primer y segundo nombre, fecha de nacimiento y el email
• La app también te pedirá tu profesión y una selfie
• La app te pedirá una foto de tu documento nacional de identidad o pasaporte

Cuando termines, selecciona el plan estándar (gratuito). No tienes que agregar la tarjeta a Apple pay, pedir que te envíen una tarjeta a tu domicilio ni tampoco agregar dinero a la cuenta.

Ahora tienes una tarjeta virtual que podrás usar para hacer la configuración de GCP.

En la vista principal de la app Revolut

• Haz clic en Ready to use
• Haz clic en the card
• Haz clic en Show card details
• Toma nota de la información de la tarjeta de crédito virtual y úsala para completar la configuración de GCP

👉 Si recibes un email de Google diciendo "Urgent: your billing account XXXXXX-XXXXXX-XXXXXX has been suspended" 👈

Esto puede pasar justo después de haber creado la cuenta en Revolut.

• Haz clic en PROCEED TO VERIFICATION
• Te pedirán que envíes una foto de tu tarjeta de crédito (solo los últimos 4 dígitos, nada más)
• Si ya has usado Revolut, puedes enviar una captura de pantalla de tu tarjeta de crédito virtual (no olvides quitar la fecha de vencimiento de la captura)
• Explica que estás haciendo el bootcamp de Le Wagon, que no tienes una tarjeta de crédito y que acabas de crear una cuenta en Revolut para poder configurar GCP para el bootcamp con una tarjeta de crédito virtual

Es posible que te validen la cuenta pero también es posible que te pidan más información en los próximos 30 minutos.

Cuando la cuenta sea validada recibirás un email diciendo lo siguiente: "Your Google Cloud Platform billing account XXXXXX-XXXXXX-XXXXXX has been fully reinstated and is ready to use.". Esto significa que tu cuenta Google Cloud Platform ha sido restablecida

Habilitación de servicios de GCP

• Asegúrate de que la facturación está habilitada para tu proyecto Google Cloud

ℹ️ Tienes un crédito de $300 para usar con recursos de Google Cloud. Esto será más que suficiente para el bootcamp.

• Habilita las APIs AI Platform Training & Prediction y Compute Engine APIs (Esto puede tomar varios minutos)

Configuración de Cloud sdk

• Autentica el CLI de gcloud con la cuenta que usaste para GCP

gcloud auth login

• Inicia sesión en tu cuenta Google en la nueva pestaña que se abrió en tu navegador
• Lista la cuenta que tienes activa y verifica que el email que usaste para GCP está ahí

gcloud auth list

• Define tu proyecto actual (reemplaza PROJECT_ID con el ID de tu proyecto e.g. wagon-bootcamp-123456)

gcloud config set project PROJECT_ID

• Lista la cuenta que tienes activa y tu proyecto actual y verifica que tu proyecto está ahí

gcloud config list

Crea una llave 🔑 de cuenta de servicio

Como ya creaste una cuenta GCP account y un project (identificado por su PROJECT_ID), vamos a configurar las acciones (llamadas API calls) que quieres que tu código ejecute.

🤔 ¿Por qué necesitamos una clave de cuenta de servicio?

Creaste una cuenta GCP conectada a una tarjeta de crédito. Te facturarán de acuerdo al uso que les des a los recursos de Google Cloud Platform. El cargo se hará si utilizas algo después de que el período de prueba gratuito se haya terminado o si te excedes del límite de consumo que te permite dicho período.

En tu cuenta GCP has creado un solo proyecto GCP identificado por su PROJECT_ID. Los proyectos GCP te permiten organizar y monitorear la manera en que consumes los recursos GCP de forma más precisa. En este bootcamp solo crearemos un solo proyecto.

Ahora necesitamos una manera de saber qué recursos nuestro código podrá consumir dentro de un GCP project. Nuestro código consume recursos GCP por medio de llamadas API.

Ya que las llamadas API no son gratuitas, es importante definir cuidadosamente cómo nuestro código las utilizará. Sin embargo, durante el bootcamp no habrá restricciones. Le permitiremos a nuestro código que utilice todas las API GCP sin restricciones.

Así como pueden haber varios proyectos asociados a una cuenta GCP, un proyecto puede estar compuesto de muchos servicios (cualquier paquete de código, sin importar su formato, que necesite utilizar llamadas a la API de GCP para cumplir con su propósito).

GCP exige que los servicios de los proyectos que usen llamadas API se registren en la plataforma y que se configuren sus credenciales por medio del acceso concedido a una service account.

Por ahora solo tendremos que usar un solo servicio y crearemos la service account correspondiente.

Ya que la service account es lo que identifica tu aplicación (y por ende tu cuenta de facturación GCP y, en última instancia, tu tarjeta de crédito), lo mejor es ser cuidadoso en los próximos pasos.

⚠️ No compartas la 🔑 del archivo json de tu cuenta de servicio ⚠️ No la guardes en tu escritorio ni en tu código base de git (incluso si tu repositorio git es privado). Que no se te olvide en un lugar como la máquina de café y, por supuesto, no la envíes en un tweet.

• Ve a la página de las cuentas de servicio
• Selecciona tu proyecto en la lista de proyectos recientes si te piden que
• Crees una cuenta de servicio:
  • Haz clic en CREATE SERVICE ACCOUNT que significa crear une cuenta de servicio:
  • Define un Service account name para esa cuenta. Esto significa Nombre de cuenta de servicio
  • Haz clic en CREATE AND CONTINUE que significa crear y continuar
  • Haz clic en Select a role que significa selecciona un rol. Escoge Quick access/Basic luego Owner. Esto otorga acceso total a todos los recursos
  • Haz clic en CONTINUE
  • Haz clic en DONE
• Descarga la 🔑 del archivo json de la cuenta de servicio:
  • Haz clic en la cuenta de servicio recién creada
  • Haz clic en KEYS
  • Haz clic en ADD KEY y luego en Create new key
  • Selecciona JSON y haz clic en CREATE

El navegador acaba de guardar la 🔑 del archivo json de la cuenta de servicio en tu carpeta de descargas (el nombre se le asigna según el nombre de la cuenta de servicio. Es algo como le-wagon-data-123456789abc.json)

Extensiones de VS Code

Instalación

Instala algunas extensiones útiles para VS Code.

code --install-extension ms-vscode.sublime-keybindings
code --install-extension emmanuelbeziat.vscode-great-icons
code --install-extension MS-vsliveshare.vsliveshare
code --install-extension ms-python.python
code --install-extension KevinRose.vsc-python-indent
code --install-extension ms-python.vscode-pylance
code --install-extension ms-toolsai.jupyter
code --install-extension alexcvzz.vscode-sqlite

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

• Sublime Text Keymap and Settings Importer
• VSCode Great Icons
• Live Share
• Python
• Python Indent
• Pylance
• Jupyter
• SQLite

Funciones de IA en VS Code

VS Code incluye muchas y potentes funciones de IA, que son una gran herramienta una vez que ya sabes programar.

Dicho esto, depender de la IA demasiado pronto puede ocultar conceptos importantes y dificultar la comprensión de la depuración. Una vez que estés cómodo con los fundamentos, sabrás cuándo y cómo usar la IA de forma eficaz —sin dejar que haga el trabajo por ti.

Para el inicio del bootcamp, desactivaremos estas funciones. Llegado el momento apropiado en el curso, las volveremos a habilitar para que puedas utilizarlas bien.

En VS Code:

1. Abramos la "Paleta de comandos" de VS Code: escribe Ctrl-Shift-P (Windows / Linux) o Cmd-Shift-P (macOS).
2. Se abrirá la Paleta de comandos: una pequeña caja de texto en la parte superior de la pantalla. Empieza a escribir aifeatures hasta que veas "Chat: Learn How to Hide AI features". Haz clic en ella.
3. Esto abrirá la configuración y te mostrará la opción "Disable and hide built-in AI features ...". Marca la casilla delante de esa opción.

Más adelante, si quieres volver a habilitar las funciones de IA, puedes seguir las mismas instrucciones para desmarcar la casilla.

Herramientas de línea de comando

Comprueba la configuración regional (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

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í:

✔️ Si es el caso, puedes continuar 👍

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

direnv

direnv es una extensión del shell. Facilita trabajar con variables de entorno por proyecto, lo cual será útil para customizar el comportamiento de tu código.

sudo apt-get update; sudo apt-get install direnv
echo 'eval "$(direnv hook zsh)"' >> ~/.zshrc

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.

Usaremos la GitHub CLI (gh) para conectarnos a GitHub utilizando SSH, un protocolo para iniciar la sesión utilizando claves SSH en lugar de la famosa pareja nombre de usuario y contraseña.

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 --git-protocol ssh

gh le hará algunas preguntas:

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

CLI de Google Cloud

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

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 install apt-transport-https ca-certificates gnupg
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
sudo apt-get update && sudo apt-get install google-cloud-sdk
sudo apt-get install google-cloud-sdk-app-engine-python

👉 Documentación para la instalación

• Guarda el archivo json de la cuenta de servicio en un lugar que recuerdes. Por ejemplo:

/home/LINUX_USERNAME/code/GITHUB_NICKNAME/gcp/SERVICE_ACCOUNT_JSON_FILE_CONTAINING_YOUR_SECRET_KEY.json

• Guarda la ruta absoluta al archivo JSON como una variable de entorno:

echo 'export GOOGLE_APPLICATION_CREDENTIALS=/path/to/the/SERVICE_ACCOUNT_JSON_FILE_CONTAINING_YOUR_SECRET_KEY.json' >> ~/.aliases

Dotfiles

Los hackers aman mejorar sus shells y sus herramientas. Comenzaremos con una configuración por defecto genial proporcionada por Le Wagon y almacenada en GitHub.

Verifica tu configuración de GitHub CLI

Primero, hagamos una verificación rápida. Abre tu terminal y ejecuta el comando siguiente:

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

Deberías ver tu usuario GitHub. Si no es así, no hagas más nada y pide ayuda. Parece que hay un problema con el paso anterior (gh auth).

Fork y/o clone los archivos de configuración

Hay tres opciones, escoge una:

No he hecho el bootcamp de Web Development o Data Science & AI de Le Wagon

Tu configuración es personal, así que necesitas tu propio repositorio para almacenarla. Primero tienes que hacer el fork del repositorio en tu cuenta GitHub.

Hacer un fork significa que crearás un nuevo repositorio en tu cuenta GitHub idéntico al original. Tendrás un nuevo repositorio en tu cuenta GitHub, your_github_username/dotfiles. El fork es necesario porque cada uno de ustedes necesitará poner información específica (e.g. tu nombre) en esos archivos.

Ejecutemos este comando para hacer un fork del repositorio lewagon/dotfiles y clonarlo:

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

Ya hice el bootcamp de Web Development o Data Science & AI de Le Wagon pero tengo una nueva laptop

Esto significa que ya has hecho el fork del repositorio GitHub lewagon/dotfiles pero tal vez la configuración para el nuevo bootcamp de Data Science & AI no estaba lista en ese momento.Actualicémoslo. Pide a un TA que te acompañe en los siguientes pasos.

Es hora de clonarlo el repositorio en tu laptop:

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

Abre tu terminal y ve a tu proyecto dotfiles:

cd ~/code/$GITHUB_USERNAME$/dotfiles

Es hora de fusionar los cambios de lewagon/dotfiles en los tuyos:

1. Commit la versión actual de tus dotfiles:

   git add .
   git status # Check what will be committed
   git commit -m "Version prior to new setup"

2. Trae los cambios del repositorio upstream: git merge upstream/master

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

4. Haz un git diff HEAD~1 HEAD para revisar qué cambió.

5. Si todo parece estar en orden, continúa.

¿Demasiados conflictos?

Vamos a tomar la versión actual de lewagon/dotfiles.

Primero aborta la merge: git merge --abort.

Ejecuta code .

En VS Code, abre el archivo zshrc. Reemplaza su contenido con la versión más reciente. Luego guárdalo en el disco.

Aún en VS Code, abre el archivo zprofile. Reemplaza su contenido con la versión más reciente. Luego guárdalo en el disco.

Regresa a la terminal y ejecuta un git diff y verifica que esto no haya eliminado ninguna configuración personal que quisieras conservar.

Es hora de guardar tus cambios y subirlos.

git add .
git commit -m "Update for Data Science bootcamp"
git push origin master

Ya hice el bootcamp de Web Development o Data Science & AI de Le Wagon en la misma laptop

Esto significa que ya has hecho el fork del repositorio GitHub lewagon/dotfiles pero tal vez la configuración para el nuevo bootcamp de Data Science & AI no estaba lista en ese momento. Actualicémoslo. Pide a un TA que te acompañe en los siguientes pasos.

Abre tu terminal y ve a tu proyecto dotfiles:

cd ~/code/$GITHUB_USERNAME$/dotfiles

Es hora de fusionar los cambios de lewagon/dotfiles en los tuyos:

1. Commit la versión actual de tus dotfiles:

   git add .
   git status # Check what will be committed
   git commit -m "Version prior to new setup"

2. Trae los cambios del repositorio upstream: git merge upstream/master

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

4. Haz un git diff HEAD~1 HEAD para revisar qué cambió.

5. Si todo parece estar en orden, continúa.

¿Demasiados conflictos?

Vamos a tomar la versión actual de lewagon/dotfiles.

Primero aborta la merge: git merge --abort.

Ejecuta code .

En VS Code, abre el archivo zshrc. Reemplaza su contenido con la versión más reciente. Luego guárdalo en el disco.

Aún en VS Code, abre el archivo zprofile. Reemplaza su contenido con la versión más reciente. Luego guárdalo en el disco.

Regresa a la terminal y ejecuta un git diff y verifica que esto no haya eliminado ninguna configuración personal que quisieras conservar.

Es hora de guardar tus cambios y subirlos.

git add .
git commit -m "Update for Data Science bootcamp"
git push origin master

Ejecuta el instalador 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 de ellos en el próximo paso:

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

Ejecuta el instalador de git:

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

☝️ Esto te guiará con tu nombre (FirstName LastName) y con tu email. :warning: Cuidado, debes poner uno de los emails de la lista de arriba que te suministra el comando gh api ... usado anteriormente. Si haces eso, Kitt no podrá hacerle seguimiento a tu progreso. 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.

Ahora cierra todas las ventanas de tu terminal que tengas abiertas por favor.

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.

Instala pyenv

Ubuntu viene con una versión vieja de Python que no queremos usar. Tal vez ya hayas instalado Anaconda u otro programa para utilizar Python y paquetes de Ciencia de Datos. Si es así, no pasa nada ya que haremos una configuración profesional de Python que te permitirá cambiar de versión cuando quieras al escribir python en la terminal.

Primero instala pyenv con el siguiente comando en la Terminal:

git clone https://github.com/pyenv/pyenv.git ~/.pyenv
exec zsh

Instala algunas dependencias necesarias para crear Python desde pyenv:

sudo apt-get update; sudo apt-get install make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev sqlite3 libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev \
python3-dev

Instala Python

Instala la última versión estable de Python que sea aceptada en el currículum de Le Wagon:

pyenv install 3.12.9

Este comando puede tomar un tiempo en ejecutarse. Esto es completamente normal. ¡No dudes en ayudar a los estudiantes que estén sentados cerca de ti!

OK. Cuando este comando termine de ejecutarse, le diremos al sistema que use esta versión de Python por defecto. Esto se hace con:

pyenv global 3.12.9
exec zsh

Para verificar que esto haya funcionado, ejecuta python --version. Si ves 3.12.9, ¡todo está bien! Si no, pídele ayuda a un TA para resolver el problema por medio de versiones de pyenv y type -a python (python debería estar usando la versión .pyenv/shims de primero).

Entorno Virtual de Python

Antes de instalar paquetes de Python, aislaremos la configuración del Bootcamp en un entorno virtual dedicado. Usaremos un plugin pyenv llamado pyenv-virtualenv.

Instala un virtualenv

Primero instala este plugin:

git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
exec zsh

Crea el entorno virtual que usaremos durante todo el bootcamp:

pyenv virtualenv 3.12.9 lewagon

Define el entorno virtual con lo siguiente:

pyenv global lewagon

¡Genial! Ahora cada vez que queramos instalar un paquete Python, lo haremos en ese entorno.

Paquetes de Python

Ahora que tenemos el ambiente virtual de lewagon adecuado, es hora de instalarle algunos paquetes.

Primero, actualiza pip, la herramienta para instalar Paquetes Python desde pypi.org. Ejecuta lo siguiente en la última terminal donde esté activado el virtualenv de lewagon:

pip install --upgrade pip

Ahora instala algunos paquetes para las primeras semanas del programa:

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

Mejora Jupyter Notebook

Mejora la visualización del elemento details para revelación de información en tus notebooks.

Ejecuta las siguientes líneas para crear una hoja de estilos custom.css en tu directorio de configuración de Jupyter:

LOCATION=$(jupyter --config-dir)/custom
SOURCE=https://raw.githubusercontent.com/lewagon/data-setup/refs/heads/master/specs/jupyter/custom.css
mkdir -p $LOCATION
curl $SOURCE > $LOCATION/custom.css

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

Ejecuta el comando siguiente para verificar que hayas instalado los paquetes requeridos correctamente:

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

Ahora ejecuta el siguiente comando para verificar que puedas cargar estos paquetes:

python -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/pip_check.py)"

Chequeo de Jupyter

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:

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

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

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.

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.

DBeaver

DDescarga e instala DBeaver, una herramienta poderosa, gratuita y de código abierto para conectar con cualquier base de datos, explorar su esquema e incluso hacer consultas SQL.

Docker 🐋

Docker es una plataforma abierta para desarrollo, entrega y operación de aplicaciones.

Si ya tienes Docker instalado en tu máquina, por favor actualízalo con la versión más reciente

Instalación de Docker

Ve a la documentación de instalación de Docker.

Luego sigue las instrucciones del tutorial para instalar Docker usando el repositorio. Hay 2 pasos:

1. Set up Docker's apt repository. > Esto significa configurar el repositorio
2. Install the Docker packages. > Esto significa instalar el motor de Docker

Ahora, asegurémonos de que podemos ejecutar docker sin sudo.

Ejecute los siguientes comandos uno por uno:

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker
sudo rm -rf ~/.docker/

Cuando termines, podrás ejecutar lo siguiente:

docker run hello-world

Debería aparecer el siguiente mensaje:

Kitt

Deberías haber recibido un correo electrónico de Le Wagon invitándote a registrarte en Kitt (nuestra plataforma de aprendizaje).

Entonces deberías recibir una invitación adicional 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.

Si no lo has recibido, por favor contacta a tu equipo de enseñanza.

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 👇

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"

✔️ 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!

Kata (Extra)

Si has terminado la configuración, te pedimos que preguntes si alguien necesita ayuda con la suya (macOS, Linux o Windows). Las primeras clases son a las 2pm. Hablaremos de la configuración que acabas de hacer y de Kitt.

Si no tienes mucha experiencia con git y GitHub, por favor ve nuevamente el video de este workshop (puedes verlo a 1.25 de velocidad).

Si aún te queda tiempo, puedes esperar trabajar en este Kata de Tic-Tac-Toe mientras esperas la primera clase.