Skip to content

Commit a93cf63

Browse files
author
github-actions
committed
setup guides generated
1 parent 1560a7e commit a93cf63

8 files changed

Lines changed: 493 additions & 244 deletions

File tree

‎LINUX.es.md‎

Lines changed: 122 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Por favor **léelas cuidadosamente y ejecuta todos los comandos en el siguiente
1313

1414
:point_right: **[Sube una foto](https://github.com/settings/profile)** 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.
1515

16-
![Foto GitHub](https://github.com/lewagon/setup/blob/simplify-conso/images/github_picture.png)
16+
![Foto GitHub](https://github.com/lewagon/setup/blob/master/images/github_picture.png)
1717

1818
:point_right: **[Habilita la Autenticación de Dos Factores (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. 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.
1919

@@ -31,12 +31,12 @@ Por favor **léelas cuidadosamente y ejecuta todos los comandos en el siguiente
3131

3232
⚠️ **Importante:** Al crear un proyecto nuevo, verás un campo **Organization**. Déjalo como **"No organization"**. No selecciones ni crees una organización. Elegir una organización aplica restricciones que pueden impedirte utilizar los servicios de Google Cloud durante el bootcamp.
3333

34-
![](https://github.com/lewagon/data-setup/blob/pyenv-to-uv/images/gcp-create-project.png)
34+
![](https://github.com/lewagon/data-setup/blob/master/images/gcp-create-project.png)
3535

3636
- Asígnale un nombre, por ejemplo, `Wagon Bootcamp`
3737
- Observa el `ID` que se crea automáticamente para el proyecto, por ejemplo, `wagon-bootcamp-123456`
3838

39-
![](https://github.com/lewagon/data-setup/blob/pyenv-to-uv/images/gcp_project.png)
39+
![](https://github.com/lewagon/data-setup/blob/master/images/gcp_project.png)
4040

4141
ℹ️ Anota el **Project ID** (por ejemplo, `wagon-bootcamp-123456`), que **no** es lo mismo que el nombre del proyecto que elegiste (por ejemplo, `Wagon Bootcamp`). Necesitarás el ID más adelante al ejecutar comandos en la terminal, pero no te preocupes: siempre puedes encontrarlo en Google Cloud.
4242

@@ -64,7 +64,7 @@ Ahora vincularás tu cuenta a tu tarjeta de crédito. Este paso es obligatorio;
6464

6565
⚠️ En algunos casos, Google puede hacer un cargo en tu tarjeta (de unos 10 €) para verificar que es válida. Desafortunadamente, no se reembolsará una vez aprobada, pero se añadirá como crédito en Google Cloud que podrás utilizar cuando hayas usado o hayan caducado tus créditos gratuitos.
6666

67-
![](https://github.com/lewagon/data-setup/blob/pyenv-to-uv/images/gcp-billing.png)
67+
![](https://github.com/lewagon/data-setup/blob/master/images/gcp-billing.png)
6868

6969
- Haz clic en **Billing**
7070
- Haz clic en **MANAGE BILLING ACCOUNTS**
@@ -226,9 +226,9 @@ En **VS Code**:
226226
227227
1. Abramos la "Paleta de comandos" de VS Code: escribe `Ctrl-Shift-P`.
228228
1. 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.
229-
![The Command Palette at the top of the screen](https://github.com/lewagon/setup/blob/simplify-conso/images/vscode_find_aifeatures.png)
229+
![The Command Palette at the top of the screen](https://github.com/lewagon/setup/blob/master/images/vscode_find_aifeatures.png)
230230
1. 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.
231-
![Check the disable option](https://github.com/lewagon/setup/blob/simplify-conso/images/vscode_disable_aifeatures.png)
231+
![Check the disable option](https://github.com/lewagon/setup/blob/master/images/vscode_disable_aifeatures.png)
232232
233233
Más adelante, si quieres **volver a habilitar** las funciones de IA, puedes seguir las mismas instrucciones para desmarcar la casilla.
234234
@@ -280,7 +280,7 @@ sudo apt update
280280
```
281281
282282
```bash
283-
sudo apt install -y curl git imagemagick jq unzip vim zsh
283+
sudo apt install -y curl git imagemagick jq unzip vim zsh tree direnv
284284
```
285285
286286
Estos comandos te pedirán tu contraseña: escríbela.
@@ -326,7 +326,7 @@ Si te preguntan "Do you want to change your default shell to zsh?", presiona `Y`
326326
327327
Cuando termines, tu terminal debería lucir así:
328328
329-
![La terminal de Ubuntu con OhMyZsh](https://github.com/lewagon/setup/blob/simplify-conso/images/oh_my_zsh.png)
329+
![La terminal de Ubuntu con OhMyZsh](https://github.com/lewagon/setup/blob/master/images/oh_my_zsh.png)
330330
331331
:heavy_check_mark: Si es el caso, puedes continuar :+1:
332332
@@ -391,53 +391,133 @@ gh auth status
391391
392392
Mejoremos la experiencia de tu máquina instalando los [dotfiles 🔗](https://github.com/lewagon/dotfiles) preconfigurados de Le Wagon. Son archivos de configuración para tu terminal, zsh, git y VS Code.
393393
394-
### Hacer un fork de los dotfiles
395394
396-
Para personalizar esta configuración, tendrás que hacer un **fork** del repositorio en tu propia cuenta de Github.
395+
### Obtener tu nombre de usuario de GitHub
397396
398-
Al hacer un **fork**, se crea una copia del repositorio en tu cuenta (`your_github_username/dotfiles`), que luego podrás modificar con tu información personal, como tu nombre.
397+
Ejecuta el siguiente comando:
398+
399+
```bash
400+
export GITHUB_USERNAME=`gh api user | jq -r '.login'`
401+
echo $GITHUB_USERNAME
402+
```
403+
404+
✔️ Deberías ver tu nombre de usuario de GitHub en la pantalla.
405+
406+
❌ Si no es así, detente aquí y pide ayuda. Puede haber un problema con el paso anterior (`gh auth`).
407+
408+
409+
### Crear un fork de los dotfiles
410+
411+
Para personalizar esta configuración, tendrás que crear un **fork** del repositorio en tu propia cuenta de GitHub.
412+
413+
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.
399414
400415
<details>
401-
<summary>❗ <strong>Si</strong> ya hiciste otro bootcamp de Le Wagon (<strong>Desarrollo Web, Desarrollo de Software con IA, Análisis de Datos, Ciencia de Datos e IA</strong>), abre esto primero ❗
416+
<summary>❗ <strong>Si ya hiciste otro bootcamp de Le Wagon</strong> (<em>Desarrollo web, Desarrollo de software con IA, Análisis de datos, Ciencia de datos e IA</em>), <strong>abre un ticket con un TA</strong> y abre esta sección para ver las instrucciones ❗
402417
</summary>
403418
404-
Es posible que tengas una versión anterior de los dotfiles de Le Wagon. Podrían ser incompatibles con la configuración actual.
419+
Es posible que tengas una versión antigua de los dotfiles de Le Wagon. Podrían ser incompatibles con la configuración actual.
420+
405421
422+
**Junto con un TA**, haz una de las siguientes acciones:
406423
407-
**Abre un ticket** con un TA y haz una de las siguientes cosas:
408-
- Compara tus dotfiles existentes con los [dotfiles 🔗](https://github.com/lewagon/dotfiles) actuales de Le Wagon, especialmente `.zshrc`, `.zprofile` y `settings.json`. Si no hay ninguna diferencia significativa aparte de tu nombre y correo electrónico, continúa con la configuración.
409-
- Si no te importa perder tus dotfiles existentes (recomendado):
410-
- Elimina tu repositorio de dotfiles existente en GitHub y continúa con la configuración.
411-
- Elimina el repositorio local: `rm -rf ~/code/<your_github_username>/dotifles`.
412-
- Si no quieres perder tus dotfiles existentes, recomendamos trabajar con ramas:
413-
- En tu **portátil**, o donde tengas una copia **local** de **tu versión existente de los dotfiles**.
414-
- Crea una rama de tu configuración existente de dotfiles (`git checkout -b old-setup`) y súbela a GitHub: `git push origin old-setup`.
415-
- Vuelve a `master`: `git checkout master`.
416-
- En la rama local `master`, ejecuta `git pull upstream master`, resuelve los conflictos, ejecuta `git commit -m "merged"` y `git push origin master`. Es importante que aceptes los cambios entrantes en los archivos `.zshrc`, `.zprofile` y `settings.json`.
417-
- Continúa con la configuración.
424+
<details>
425+
<summary>Estoy usando <strong>la misma máquina</strong> (o una máquina nueva que ya tiene los dotfiles).</summary>
426+
427+
1. Ve a tu carpeta actual de dotfiles:
428+
```bash
429+
cd ~/code/$GITHUB_USERNAME/dotfiles
430+
```
431+
432+
1. Comprueba las diferencias con la versión actual de los dotfiles de Le Wagon:
433+
```bash
434+
git diff upstream/master
435+
```
436+
437+
Si no hay diferencias importantes aparte de tu nombre y correo electrónico, continúa con la configuración.
418438
419439
</details>
420440
421-
<br>
441+
<details>
442+
<summary>Estoy usando <strong>una máquina nueva</strong> sin los dotfiles.</summary>
422443
423-
Ejecuta el siguiente comando:
444+
1. Ve a GitHub y encuentra tu repositorio de `dotfiles`.
424445
425-
```bash
426-
export GITHUB_USERNAME=`gh api user | jq -r '.login'`
427-
echo $GITHUB_USERNAME
428-
```
446+
1. Comprueba cuántos commits por detrás y por delante está de `lewagon/dotfiles:master`. Puedes verlo justo encima de la lista de archivos.
429447
430-
✔️ Deberías ver tu nombre de usuario de Github impreso.
448+
1. Haz clic en los enlaces de commits por detrás y por delante, y desplázate hacia abajo para ver las diferencias.
431449
432-
❌ Si no es así, detente aquí y pide ayuda. Puede haber un problema con el paso anterior (`gh auth`).
450+
Si no hay diferencias importantes aparte de tu nombre y correo electrónico, continúa con la configuración.
433451
434-
Es hora de hacer un fork del repositorio y clonarlo en tu ordenador:
452+
</details>
453+
454+
<details>
455+
<summary>El paso anterior mostró <strong>diferencias importantes</strong>.</summary>
456+
457+
Si estás de acuerdo con perder tus dotfiles actuales (recomendado):
458+
459+
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.
460+
461+
1. Elimina tu repositorio actual de dotfiles en GitHub.
462+
1. Elimina el repositorio local:
463+
```bash
464+
cd ~/code && rm -rf ~/code/$GITHUB_USERNAME/dotfiles
465+
```
466+
1. Continúa con la configuración.
467+
468+
<details>
469+
<summary>Si no quieres perder tus dotfiles actuales, te recomendamos trabajar con ramas. Haz clic para abrir.</summary>
470+
471+
En tu **portátil**, o donde tengas una copia **local** de **tu versión actual de los dotfiles**.
472+
473+
1. Haz commit de tu versión actual de los dotfiles:
474+
475+
```bash
476+
git add .
477+
git status # Comprueba qué se incluirá en el commit
478+
git commit -m "Version prior to new setup"
479+
```
480+
481+
1. Crea una rama de tu configuración actual de dotfiles y súbela a GitHub:
482+
483+
```bash
484+
git checkout -b old-setup
485+
git push origin old-setup
486+
```
487+
488+
1. Vuelve a `master`: `git checkout master`.
489+
490+
1. En tu `master` local, ejecuta `git pull upstream master`.
491+
492+
1. Comprueba que no estés en estado `MERGING`. Si lo estás, resuelve los conflictos.
493+
494+
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.
495+
496+
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](https://www.github.com/lewagon/dotfiles).
497+
498+
Haz commit de la resolución de conflictos: `git commit --no-edit`
499+
500+
1. Sube tus cambios a GitHub: `git push origin master`.
501+
502+
1. Continúa con la configuración.
503+
504+
</details>
505+
506+
</details>
507+
508+
</details>
509+
510+
<br>
511+
512+
Es hora de crear un fork del repositorio y clonarlo en tu ordenador:
435513
436514
```bash
437515
mkdir -p ~/code/$GITHUB_USERNAME && cd $_
438516
gh repo fork lewagon/dotfiles --clone
439517
```
440518
519+
Si aparece la pregunta _"Are you sure you want to continue connecting (yes/no/[fingerprint])?"_, escribe `yes` y pulsa `Enter`.
520+
441521
### Instalar los dotfiles
442522
443523
Ejecuta el instalador de `dotfiles` con:
@@ -458,11 +538,11 @@ Ejecuta el instalador de git:
458538
cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh
459539
```
460540
461-
:point_up: Se te pedirá (**prompt**) tu nombre (`Nombre Apellido`) y tu correo electrónico.
541+
:point_up: Se te pedirá tu nombre (`FirstName LastName`) y tu correo electrónico.
462542
463-
:warning: **Debes** introducir uno de los correos electrónicos indicados arriba mediante el comando anterior `gh api ...`. Si no lo haces, Kitt no podrá realizar el seguimiento de tu progreso.
543+
:warning: **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.
464544
465-
💡 Selecciona la dirección `...@users.noreply.github.com` si no quieres que tu correo electrónico aparezca en repositorios públicos a los que contribuyas.
545+
💡 Selecciona la dirección `...@users.noreply.github.com` si no quieres que tu correo aparezca en repositorios públicos a los que contribuyas.
466546
467547
468548
## Instalar Python y sus dependencias
@@ -525,7 +605,7 @@ Instalemos los más comunes:
525605
526606
527607
``` bash
528-
uv pip install -r /linux.txt
608+
uv pip install -r https://raw.githubusercontent.com/lewagon/data-analytics-setup/master/specs/releases/linux.txt
529609
```
530610
531611
@@ -574,15 +654,15 @@ jupyter notebook
574654
575655
Tu navegador web debería abrir en una ventana `jupyter`:
576656
577-
![jupyter.png](https://github.com/lewagon/data-setup/blob/pyenv-to-uv/images/jupyter.png)
657+
![jupyter.png](https://github.com/lewagon/data-setup/blob/master/images/jupyter.png)
578658
579659
Haz clic en `New` y, en el menú desplegable, selecciona Python 3 (ipykernel):
580660
581-
![jupyter_new.png](https://github.com/lewagon/data-setup/blob/pyenv-to-uv/images/jupyter_new.png)
661+
![jupyter_new.png](https://github.com/lewagon/data-setup/blob/master/images/jupyter_new.png)
582662
583663
Debería abrirse una pestaña en un nuevo notebook:
584664
585-
![jupyter_notebook.png](https://github.com/lewagon/data-setup/blob/pyenv-to-uv/images/jupyter_notebook.png)
665+
![jupyter_notebook.png](https://github.com/lewagon/data-setup/blob/master/images/jupyter_notebook.png)
586666
587667
Asegúrate de que estés usando la versión correcta de python en el notebook. Abre una celda y ejecuta lo siguiente:
588668
``` python
@@ -711,7 +791,7 @@ Abre la aplicación e inicia sesión en `lewagon-alumni`.
711791
712792
Asegúrate de **subir una foto para tu perfil** :point_down:
713793
714-
![Cómo subir una foto de perfil en Slack](https://github.com/lewagon/setup/blob/simplify-conso/images/slack_profile_picture.gif)
794+
![Cómo subir una foto de perfil en Slack](https://github.com/lewagon/setup/blob/master/images/slack_profile_picture.gif)
715795
716796
La idea es tener Slack abierto todo el día para compartir enlaces útiles / pedir ayuda / decidir dónde almorzar / etc.
717797
@@ -724,7 +804,7 @@ Para asegurarte de que todo lo relacionado a videollamadas funcione bien, prueba
724804
- Comprueba que tus dispositivos preferidos de altavoz, micrófono y cámara aparecen en los menús desplegables y haz clic en "Iniciar prueba"
725805
- Haz clic en el botón verde "Start test"
726806
727-
![Chequea el micrófono y la cámara con Slack](https://github.com/lewagon/setup/blob/simplify-conso/images/slack_call_test.png)
807+
![Chequea el micrófono y la cámara con Slack](https://github.com/lewagon/setup/blob/master/images/slack_call_test.png)
728808
729809
:heavy_check_mark: Cuando termine el test deberías ver mensajes de "Succeed" en verde por lo menos para tu micrófono y tu cámara. :+1:
730810

0 commit comments

Comments
 (0)