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! 🚀
Para poder interactuar cuando no estemos en el mismo lugar físico, usaremos Zoom, una herramienta de videoconferencia.
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:
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:
Ya puedes cerrar la aplicación Zoom.
¿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.
Antes de comenzar, necesitamos verificar que la versión de Windows instalada en tu computadora sea compatible con estas instrucciones de configuración.
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.
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 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
StartupenAutomatic - Haz clic en
Start - Haz clic en
Ok¡Ahora intenta instalar las actualizaciones nuevamente!
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.
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
✔️ 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 ModeoAMD-V
- Intel:
- Guarda los cambios después de la activación y reinicia la computadora con las opciones correspondientes
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 👇
Si usas Windows 11, instalaremos WSL 2 y Ubuntu con un comando a través de la terminal de Windows.
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
Un ventana de terminal azul aparecerá:
- Copia el siguiente comando (
Ctrl+C) - Pégalo en la ventana de la terminal (
Ctrl+Vo 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
Si tienes Windows 10, primero instalaremos WSL 1 por medio de la Terminal de PowerShell.
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
Un ventana de terminal azul aparecerá:
- Copia los siguiente comandos uno por uno (
Ctrl+C) - Pégalos en la ventana de Powershell (
Ctrl+Vo haciendo clic derecho en la ventana) - Ejecútalos presionado
Enter
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linuxdism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestartdism.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
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
✔️ 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.
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 👌
ℹ️ 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 👇
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.
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 Storeen la lista - Busca
Ubuntuen la barra de búsqueda - Selecciona la versión sin nombre, simplemente "Ubuntu"
- Haz clic en
Get
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.
La primera vez que lo abras, te pedirán que:
- Escojas un username de:
- una palabra
- minúscula
- sin caracteres especiales
- por ejemplo:
lewagono tufirstname, es decir, tu primer nombre
- Escoge un password
- Confírmalo
Enter al terminar.
Ahora puedes cerrar la ventana de Ubuntu ya que está instalado en tu computadora.
- 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 contentno esté seleccionada. Luego haz clic enOk.
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.
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:
localeSi 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-8Si 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
sudo update-locale LANG=en_US.UTF8
sudo apt-get update
sudo apt-get install language-pack-en language-pack-en-base manpagesYa puedes cerrar la ventana de la terminal.
Instala el navegador Google Chrome si no lo tienes todavía y configúralo como tu navegador predeterminado.
Sigue los pasos en el siguiente enlace 👉 Instalación de Google Chrome
¿Por qué Chrome?
Lo recomendamos como navegador predeterminado porque es el más compatible con los tests y la ejecución de código. Además trabaja con Google Cloud Platform. Otra opción es Firefox. No recomendamos usar otros navegadores como Opera, Internet Explorer o Safari.
Instala el editor de texto Visual Studio Code.
- Ve a la página de descarga de Visual Studio Code.
- Haz clic en el botón "Windows"
- Abre el archivo que acabas de descargar.
- Instálalo con pocas opciones:
Abre VS Code cuando termine la instalación.
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-wslLuego 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 👍
❌ Si no es el caso, por favor pídele ayuda a un profesor.
ℹ️ 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 Storeen la lista - Busca
Windows Terminalen la barra de búsqueda - Selecciona Windows Terminal"
- Haz clic en
Install
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.
Hagamos que Ubuntu sea la terminal predeterminada de tu aplicación Windows terminal.
Presiona Ctrl + ,
Debería abrir los parámetros de la 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:
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 ~",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,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.
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.jupyterAquí 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
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:
- 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!
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 updatesudo apt install -y curl git imagemagick jq unzip vim zshEstos comandos te pedirán tu contraseña: escríbela.
Enter al terminar.
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 ghEjecuta 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
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.
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í.
Google Chrome como tu navegador predeterminado
Ejecuta este comando:
ls /mnt/c/Program\ Files\ \(x86\)/Google/Chrome/Application/chrome.exeSi 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'\"" >> ~/.zshrcSi 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'\"" >> ~/.zshrcMozilla Firefox como tu navegador predeterminado
Ejecuta el siguiente comando:
ls /mnt/c/Program\ Files\ \(x86\)/Mozilla\ Firefox/firefox.exeSi 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'\"" >> ~/.zshrcSi 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'\"" >> ~/.zshrcMicrosoft Edge como tu navegador predeterminado
Ejecuta el siguiente comandos:
echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrcReinicia 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 zshNo dudes en pedirle ayuda a tu profesor.
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)"' >> ~/.zshrcCLI 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:
email
gh auth login -s 'user:email' -wgh 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.
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
Hay tres opciones, escoge una:
Ya hice el bootcamp de Web Development (FullStack) 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 no estaba lista en ese momento.
Abre tu terminal y ve a tu proyecto dotfiles:
cd ~/code/<YOUR_GITHUB_NICKNAME>/dotfiles
code . # Open it in VS CodeEn VS Codeabre el archivo zshrc. Reemplaza su contenido con la versión más reciente de ese archivo que te suministramos. Luego guárdalo en el disco.
Regresa a la terminal y ejecuta un git diff y pídele a un TA que venga y verifique este cambio de configuración. Debería ver cosas de Python y pyenv.
Cuando el TA termine de hacer la verificación, haz un commit y haz el push de tus cambios:
git add zshrc
git commit -m "Update zshrc for Data Science bootcamp"
git push origin masterO
No he hecho el bootcamp de Web Development (FullStack) de Le Wagon
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. 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.
➡️ Haz clic aquí para hacer el fork del repositorio lewagon/dotfiles a tu cuenta (deberás hacer clic nuevamente en tu foto para confirmar dónde harás el fork).
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.
Abre tu terminal y ejecuta el comando siguiente:
export GITHUB_USERNAME=`gh api user | jq -r '.login'`
echo $GITHUB_USERNAMEDeberí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).
Es hora de hacer el fork del repositorio y clonarlo en tu laptop:
mkdir -p ~/code/$GITHUB_USERNAME && cd $_
gh repo fork lewagon/dotfiles --cloneEjecuta el instalador de dotfiles.
cd ~/code/$GITHUB_USERNAME/dotfiles && zsh install.shVerifica 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.
OR
IYa hice el bootcamp de Web Development (FullStack) de Le Wagon pero tengo una nueva laptop
Abre tu terminal y ejecuta el comando siguiente:
export GITHUB_USERNAME=`gh api user | jq -r '.login'`
echo $GITHUB_USERNAMEDeberí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).
Es hora de hacer el fork del repositorio y clonarlo en tu laptop:
mkdir -p ~/code/$GITHUB_USERNAME && cd $_
gh repo fork lewagon/dotfiles --cloneEjecuta el instalador de dotfiles.
cd ~/code/$GITHUB_USERNAME/dotfiles && zsh install.shVerifica 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.
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 ~/.zshrcLuego:
- Identifica la línea que comienza por
plugins= - Agrega
ssh-agental 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.
Instalando Python (con pyenv)
Como estamos utilizando pyenv para instalar y gestionar la versión de Python, necesitamos desinstalar conda, otro gestor de paquetes que podrías tener en tu computadora si previamente instalaste Anaconda. De esta forma, evitaremos problemas con Python más adelante.
Chequea si tienes conda instalado en tu computadora:
conda listSi aparece zsh: command not found: conda, puedes saltear la desinstalación de conda e ir directo a la sección de Instalar pre-requisitos.
Instrucciones de desinstalación conda
- Instala el paquete Anaconda-Clean desde tu terminal y comienza la limpieza
conda install anaconda-clean
anaconda-clean --yes- Remueve todos los directorios de Anaconda
rm -rf ~/anaconda2
rm -rf ~/anaconda3
rm -rf ~/.anaconda_backup- Elimina el directorio Anaconda de tu
.bash_profile- Abre el archivo con
code ~/.bash_profile - Si el archivo abre, busca la línea que coincida con el siguiente patrón
export PATH="/path/to/anaconda3/bin:$PATH"y eliminala
- Abre el archivo con
- Reinicia la terminal con
exec zsh - Remueve la inicializaciópn de Anaconda de tu
.zshrc:- Abre el archivo con
code ~/.zshrc - Remueve las líneas de código desde
>>> conda initialize >>>hasta<<< conda initialize <<<
- Abre el archivo con
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 zshInstala 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 libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev \
python3-devInstala la última versión estable de Python que sea aceptada en el currículum de Le Wagon:
pyenv install 3.10.6Este 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.10.6
exec zshPara verificar que esto haya funcionado, ejecuta python --version. Si ves 3.10.6, ¡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).
Antes de instalar paquetes de Python, aislaremos la configuración del Bootcamp en un entorno virtual dedicado. Usaremos un plugin pyenv llamado pyenv-virtualenv.
Primero instala este plugin:
git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
exec zshCrea el entorno virtual que usaremos durante todo el bootcamp:
pyenv virtualenv 3.10.6 lewagonDefine el entorno virtual con lo siguiente:
pyenv global lewagon¡Genial! Ahora cada vez que queramos instalar un paquete Python, lo haremos en ese entorno.
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 pipAhora instala algunos paquetes para las primeras semanas del programa:
pip install -r https://raw.githubusercontent.com/lewagon/data-setup/master/specs/releases/linux.txtGenera el archivo de configuración para Jupyter Notebook...
jupyter notebook --generate-configAhora edita el archivo de configuración de Jupyter generado:
code $HOME/.jupyter/jupyter_notebook_config.pyLocaliza la siguiente línea en el archivo de configuración:
# c.NotebookApp.use_redirect_file = TrueY reemplázala por éste precisamente 👇 (incluyendo la eliminación del símbolo #)
c.NotebookApp.use_redirect_file = FalseIntenta usar Jupyter:
jupyter notebookEste comando debió haber abierto una página Jupyter en tu navegador:
Si no es el caso, por favor llama a un TA.
Para cerrar el servidor jupyter en la terminal, presiona CTRL + C, enter y. Luego presiona Enter.
Mejora tu jupyter notebooks con extensiones increíbles:
# install nbextensions
jupyter contrib nbextension install --user
jupyter nbextension enable toc2/main
jupyter nbextension enable collapsible_headings/main
jupyter nbextension enable spellchecker/main
jupyter nbextension enable code_prettify/code_prettifyMejora la visualización del elemento details para revelación de información en tus notebooks.
Abre custom/custom.css en el directorio config:
cd $(jupyter --config-dir)
mkdir -p custom
touch custom/custom.css
code custom/custom.cssEdita custom.css con la siguiente información:
summary {
cursor: pointer;
display:list-item;
}
summary::marker {
font-size: 1em;
}Puedes cerrar VS Code.
Reinicia tu terminal:
exec zshAhora verifica que puedas iniciar un servidor de notebook en tu máquina:
jupyter notebookTu navegador web debería abrir en una ventana jupyter:
Haz clic en New:
Debería abrirse una pestaña en un nuevo notebook:
Haz una revisión de las jupyter notebooks nbextensions. Haz clic en Nbextensions:
Deselecciona "disable configuration for nbextensions without explicit compatibility". Esto significa deshabilitar la configuración de nbextensions sin compatibilidad explícita. Luego verifica que al menos las nbextensions marcadas en rojo estén habilitadas:
Puedes cerrar tu navegador web y luego cerrar el servidor jupyter con CTRL + C.
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.10.6Ejecuta 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)"Asegúrate de que puedas usar Jupyter:
jupyter notebookY abre un notebook Python 3.
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¡Listo! Ya tienes un virtual env de python completo con todos los paquetes tercerizados que necesitarás en el bootcamp.
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.
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$\Ubuntusi 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
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 usarwslview .) - Si obtienes un mensaje de input output error, ejecuta
wsl --shutdownen una PowerShell de Windows y abre la terminal de Ubuntu nuevamente
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
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".
Ancla lo siguiente:
- Tu terminal
- Tu explorador de archivos
- VS Code
- Tu navegador de Internet
- Slack
- Zoom
Algunos paquetes Python requieren de un compilador para funcionar correctamente, así que vamos a instalar uno:
Si no sabes qué programa estás usando, por favor pídele ayuda a un profesor.
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
Ve a Docker para WSL2.
Descarga e instala el backend de Docker Desktop WSL 2.
Cuando termines, inicia Docker.
Deberías poder usarlo en una terminal Ubuntu:
docker run hello-worldDebería aparecer el siguiente mensaje:
Permission denied? (WSL / Ubuntu)
Ejecute los siguientes comandos uno por uno:
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp dockerIntente docker info nuevamente.
¿Ve este error?
WARNING: Error loading config file: /home/user/.docker/config.json - stat /home/user/.docker/config.json: permission denied`?Ejecute el siguiente comando:
sudo rm -rf ~/.docker/Intente docker info nuevamente.
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 🙅♂️
- 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 Bootcamppor ejemplo - Verás que se creará un
IDautomáticamente para el proyecto e. g.wagon-bootcamp-123456
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
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
- 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 BigQuery y Compute Engine (Esto puede tomar varios minutos)
- Autentica el CLI de
gcloudcon 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_IDcon elIDde 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 listComo 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.
- 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 namepara 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/Basicluego 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)
Ahora vamos a mover el archivo json de la cuenta de servicio desde tu disco en Windows al disco en Ubuntu. Esto le permitirá a las herramientas de desarrollo en Ubuntu acceder a los recursos de tu cuenta GCP.
Primero crea un directorio para almacenar el archivo.
👉 Abre una terminal en Ubuntu y ejecuta los siguiente comandos
🚨 reemplaza el GITHUB_NICKNAME por tu nickname de GitHub
cd ~/code/GITHUB_NICKNAME
ls -laSi el comando no muestra el directorio dotfiles, pídele ayuda a un TA 🙏
Si no es el caso, puedes proceder con la configuración:
mkdir gcp
Ahora moveremos el archivo json de la cuenta de servicio al directorio gcp que acabamos de crear.
Abre un Buscador de Archivos de Windows (Win + E) y localiza el directorio gcp en el sistema de archivo de Ubuntu.
Puedes optar por las siguientes alternativas:
- Usar el enlace de Acceso rápido que creamos hace un rato
- O escribir la localización del directorio
gcpmanualmente en la barra de direcciones del sistema de archivos de Ubuntu:
\\wsl$\Ubuntu\home\UBUNTU_USERNAME\code\GITHUB_NICKNAME🚨 Si optas por la segunda opción:
- reemplaza el
UBUNTU_USERNAMEpor el usuario que escogiste durante la configuración de Ubuntu - reemplaza el
GITHUB_NICKNAMEpor tu nickname de GitHub
Cuando hayas localizado el directorio gcp en el Buscador de Archivos de Windows, ponle el archivo json de la cuenta de servicio que descargaste.
Ahora deberías poder ver el archivo desde el sistema de archivos de Ubuntu.
👉 Abre una terminal en Ubuntu y verifica que el archivo json de la cuenta de servicio ha sido movido
cd gcp
ls -la
Si no ves el archivo json de la cuenta de servicio en el directorio gcp, pídele ayuda a un TA 🙏
Ahora almacenaremos la ruta al archivo json de la cuenta de servicio en una variable de entorno.
🚨 Haz las siguientes sustituciones en este comando:
- El
UBUNTU_USERNAMEpor el usuario que escogiste durante la configuración de Ubuntu - El
GITHUB_NICKNAMEpor tu nickname de GitHub - El
SERVICE_ACCOUNT_JSON_FILE_CONTAINING_YOUR_SECRET_KEY.jsonpor el nombre del archivo json de tu cuenta de servicio.
echo 'export GOOGLE_APPLICATION_CREDENTIALS=/home/UBUNTU_USERNAME/code/GITHUB_NICKNAME/gcp/SERVICE_ACCOUNT_JSON_FILE_CONTAINING_YOUR_SECRET_KEY.json' >> ~/.aliasesℹ️ ¿Cómo encontrar la ruta absoluta de un archivo?
Puedes arrastrar el archivo a tu terminal.Reinicia tu terminal y ejecuta lo siguiente:
echo $GOOGLE_APPLICATION_CREDENTIALSDeberías obtener la siguiente información:
/some/absolute/path/to/your/gcp/SERVICE_ACCOUNT_JSON_FILE_CONTAINING_YOUR_SECRET_KEY.jsonAhora verifica si la ruta al archivo json de tu cuenta de servicio es el correcto:
cat $(echo $GOOGLE_APPLICATION_CREDENTIALS)👉 Este comando debería mostrar el contenido del archivo json de tu cuenta de servicio. Si no es el caso, pídele ayuda a un TA 🙏
Tu código y utilidades ahora pueden acceder a los recursos de tu cuenta GCP.
Continuemos con los últimos pasos de la configuración...
- Lista las cuentas de servicio asociadas a tu cuenta activa y a tu proyecto actual
gcloud iam service-accounts list- Recupera el email de la cuenta de servicio e. g.
SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com - Lista los roles de la cuenta de servicio desde la cli (reemplaza el PROJECT_ID y el SERVICE_ACCOUNT_EMAIL)
gcloud projects get-iam-policy PROJECT_ID \
--flatten="bindings[].members" \
--format='table(bindings.role)' \
--filter="bindings.members:SERVICE_ACCOUNT_EMAIL"- Ahora deberías ver que tu cuenta de servicio tiene el rol de
roles/owner
Resolución de problemas
AccessDeniedException: 403 The project to be billed is associated with an absent billing account.. Esto significa que el proyecto a facturar está asociado a una cuenta de facturación que no está habilitada- Asegúrate de habilitar la facturación para tu proyecto https://cloud.google.com/billing/docs/how-to/modify-project
🏁 Listo. ¡Has terminado la configuración de GCP!
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
lewagonteam. Acéptala, de lo contrario no podrás acceder a las diapositivas de las clases.
Slack es una plataforma de comunicación popular en la industria tech.
Descarga la aplicación Slack e instálala.
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!
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.