Merge pull request #333 from lewagon/update-nogcp

LGTM, all changes as expected:

- All updates were applied.
- GCP is in separate files, and not included in the overall setup, like it was before.

Author: julesvanrie

LINUX.es.md

@@ -175,24 +175,57 @@ Since the [service account](https://cloud.google.com/iam/docs/service-accounts)
 
 ⚠️ **Do not share you service account json file 🔑** ⚠️ Do not store it on your desktop, do not store it in your git codebase (even if your git repository is private), do not let it by the coffee machine, do not send it as a tweet.
 
-- Go to the [service accounts page](https://console.cloud.google.com/apis/credentials/serviceaccountkey)
-- Select your project in the list of recent projects if asked to
-- Create a service account:
-  - Click on **CREATE SERVICE ACCOUNT**:
-  - Give a `Service account name` to that account
-  - Click on **CREATE AND CONTINUE**
-  - Click on **Select a role** and choose `Quick access/Basic` then **Owner**, which gives full access to all resources
-  - Click on **CONTINUE**
-  - Click on **DONE**
-- Download the service account json file 🔑:
-  - Click on the newly created service account
-  - Click on **KEYS**
-  - Click on **ADD KEY** then **Create new key**
-  - Select **JSON** and click on **CREATE**
-
-![](images/gcp_create_key.png)
-
-The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`)
+#### Go to the Service Accounts page
+
+Navigate to the GCP service accounts page at [this link](https://console.cloud.google.com/apis/credentials/serviceaccountkey).
+
+- Select your project in the list of recent projects if asked to.
+- If not asked, make sure the right project is selected in the Project selecter list at the top of the page.
+
+An alternate way to navigate to the Service Accounts page is from the following:
+
+<img width="400" alt="01 Go to Service Accounts" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-01.png">
+
+#### Create a service account
+
+- Click on **CREATE SERVICE ACCOUNT**.
+
+  <img width="400" alt="02 Create Service Account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-02.png">
+
+- Give your service account a name, an id and a description, and click on **CREATE AND CONTINUE**.
+
+  <img width="400" alt="03 Name the service account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-03.png">
+
+- Click on **Select a role** and choose `Basic` then **`Owner`**, which gives the service account full access to all resources of your GCP project.
+
+  <img width="400" alt="04 Add BigQuery Job User" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-04.png">
+
+- Click on the blue **DONE** button at the bottom of this window. We don't need to worry about the section *Grant your users access to this service account*.
+
+  <img width="400" alt="04 Done" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-05.png">
+
+
+#### Create a json key 🔑 for this service account
+
+- On the service accounts page, click on the email address of the newly created service account.
+
+  <img width="400" alt="05 Select the service account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-06.png">
+
+- Click on the **KEYS** tab at the top of the page.
+
+  <img width="400" alt="06 Go to Keys" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-07.png">
+
+
+- Click on **ADD KEY** then **Create new key**.
+
+  <img width="400" alt="07 Add Key" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-08.png">
+
+
+- Select **JSON** and click on **CREATE**.
+
+  <img width="400" alt="08 Choose JSON and Create" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-09.png">
+
+- The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`).
 
 
 - Store the service account json file somewhere you'll remember, for example:

LINUX.md

@@ -93,7 +93,7 @@ cd $(pyenv root) && git pull
 Instala la versión actual de python:
 
 ```bash
-pyenv install 3.10.6
+pyenv install 3.12.9
 ```
 
 👉 Asegúrate de que el comando se ejecute completamente y luego **reinicia tu terminal**.
@@ -107,7 +107,7 @@ pyenv virtualenv-delete lewagon_current
 Crea un nuevo ambiente virtual:
 
 ```bash
-pyenv virtualenv 3.10.6 lewagon_current
+pyenv virtualenv 3.12.9 lewagon_current
 ```
 
 Define el nuevo ambiente virtual como predeterminado:
@@ -126,8 +126,8 @@ pyenv versions
 
 ``` bash
   system
-  3.10.6
-  3.10.6/envs/lewagon_current
+  3.12.9
+  3.12.9/envs/lewagon_current
   3.7.6
   3.7.6/envs/lewagon
 * lewagon_current
@@ -273,11 +273,19 @@ sudo service docker stop
 ```
 
 
-### Chqueo de la configuración de Python
+## Chequeo de la configuración de Python
+
+### Chequeo de Python y packages
+
+Reinicia tu terminal:
+
+```bash
+cd ~/code && exec zsh
+```
 
 Verifica tu versión de Python con los siguientes comandos:
 ```bash
-zsh -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/python_checker.sh)" 3.10.6
+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:
@@ -290,19 +298,35 @@ Ahora ejecuta el siguiente comando para verificar que puedas cargar estos paquet
 python -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/pip_check.py)"
 ```
 
-Asegúrate de que puedas usar Jupyter:
+### Chequeo de Jupyter
+
+Ahora verifica que puedas iniciar un servidor de notebook en tu máquina:
 
 ```bash
 jupyter notebook
 ```
 
-Y abre un notebook `Python 3`.
+Tu navegador web debería abrir en una ventana `jupyter`:
+
+![jupyter.png](images/jupyter.png)
+
+Haz clic en `New` y, en el menú desplegable, selecciona Python 3 (ipykernel):
+
+![jupyter_new.png](images/jupyter_new.png)
+
+Debería abrirse una pestaña en un nuevo notebook:
+
+![jupyter_notebook.png](images/jupyter_notebook.png)
 
 Asegúrate de que estés usando la versión correcta de python en el notebook. Abre una celda y ejecuta lo siguiente:
 ``` python
 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.
 
 

LINUX_gcp.md

@@ -93,7 +93,7 @@ cd $(pyenv root) && git pull
 Install the current python version :
 
 ```bash
-pyenv install 3.10.6
+pyenv install 3.12.9
 ```
 
 👉 Make sure that the command completes correctly and **restart your terminal**
@@ -107,7 +107,7 @@ pyenv virtualenv-delete lewagon_current
 Create a new virtual environment :
 
 ```bash
-pyenv virtualenv 3.10.6 lewagon_current
+pyenv virtualenv 3.12.9 lewagon_current
 ```
 
 Set the new virtual environment as default :
@@ -126,10 +126,10 @@ pyenv versions
 
 ``` bash
   system
+  3.12.9
+  3.12.9/envs/lewagon_current
   3.10.6
-  3.10.6/envs/lewagon_current
-  3.7.6
-  3.7.6/envs/lewagon
+  3.10.6/envs/lewagon
 * lewagon_current
   lewagon
 ```
@@ -273,11 +273,19 @@ sudo service docker stop
 ```
 
 
-### Python setup check up
+## Python setup check
+
+### Python and packages check
+
+Let's reset your terminal:
+
+```bash
+cd ~/code && exec zsh
+```
 
 Check your Python version with the following commands:
 ```bash
-zsh -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/python_checker.sh)" 3.10.6
+zsh -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/python_checker.sh)" 3.12.9
 ```
 
 Run the following command to check if you successfully installed the required packages:
@@ -290,19 +298,35 @@ Now run the following command to check if you can load these packages:
 python -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/pip_check.py)"
 ```
 
+### Jupyter check
+
 Make sure you can run Jupyter:
 
 ```bash
 jupyter notebook
 ```
 
-And open a `Python 3` notebook.
+Your web browser should open on a `jupyter` window:
+
+![jupyter.png](images/jupyter.png)
 
-Make sure that you are running the correct python version in the notebook. Open a cell and run :
+Click on `New` and in the dropdown menu select `Python 3 (ipykernel)`:
+
+![jupyter_new.png](images/jupyter_new.png)
+
+A tab should open on a new notebook:
+
+![jupyter_notebook.png](images/jupyter_notebook.png)
+
+Make sure that you are running the correct python version in the notebook. Open a cell and run:
 ``` python
 import sys; sys.version
 ```
 
+It should output `3.12.9` followed by some more details. If not, check with a TA.
+
+You can close your web browser then terminate the jupyter server with `CTRL` + `C`.
+
 Here you have it! A complete python virtual env with all the third-party packages you'll need for the whole bootcamp.