Primeros pasos¶

Este ambiente de desarrollo está orientado a correr en cualquier plataforma en donde contenedores de Linux sean soportados, pero ha sido principalmente probado en hosts de Ubuntu.

Requisitos¶

Vagrant para controlar el ambiente de desarrollo, por favor siga las instrucciones de instalación para su plataforma aquí.
Docker para proveer un ambiente liviano basado en contenedores para vagrant. Por favor siga las instrucciones de instalación para su plataforma.
Git cliente para clonar el repositorio

Clonar e Iniciar¶

Clone el repositorio de GitHub, luego inicie el ambiente de vagrant

git clone https://github.com/ezamoraa/ie0417
cd ie0417
vagrant up

Tip

Este proceso podría tomar un tiempo la primera vez, ya que Docker va a empezar a descargar la imagen del contenedor desde el registro público de Docker.

Una vez la máquina de Vagrant está arriba y corriendo, puede establecer una conexión remota segura por ssh con vagrant ssh y la salida debe ser similar a:

$ vagrant ssh
Welcome to Ubuntu 20.04.3 LTS (GNU/Linux 5.15.21-1-linux x86_64)

$$$$$$\ $$$$$$$$\        $$$$$$\  $$\   $$\   $$\   $$$$$$$$\
\_$$  _|$$  _____|      $$$ __$$\ $$ |  $$ |$$$$ |  \____$$  |
  $$ |  $$ |            $$$$\ $$ |$$ |  $$ |\_$$ |      $$  /
  $$ |  $$$$$\          $$\$$\$$ |$$$$$$$$ |  $$ |     $$  /
  $$ |  $$  __|         $$ \$$$$ |\_____$$ |  $$ |    $$  /
  $$ |  $$ |            $$ |\$$$ |      $$ |  $$ |   $$  /
$$$$$$\ $$$$$$$$\       \$$$$$$  /      $$ |$$$$$$\ $$  /
\______|\________|       \______/       \__|\______|\__/

      IE0417 development environment 22.03.0

Last login: Mon Feb 28 04:26:37 2022 from 172.17.0.1
dev@ie0417-devel:~/ws$

Note

El vagrant está configurado para sincronizar algunos directorios desde su máquina host hacia su máquina de desarrollo, en especial el directorio con el repositorio de git está disponible en ~/ws y es su directorio por defecto al hacer SSH.

Tip

Usted puede abrir tantas sesiones SSH como quiera. Algunos editores de código como Visual Studio Code soportan ssh remote edition, lo cual es conveniente.

Ciclo de vida de la máquina de desarrollo¶

Una vez haya terminado con su desarrollo, puede “apagar” el contenedor con vagrant halt.

Usted tambien podría destruir el ambiente completamente (por ejemplo para actualizar a una version nueva del ambiente), puede hacerlo con vagrant destroy.

Presentaciones con Jupyter Notebook¶

Para las presentaciones del curso se utiliza el programa Jupyter Notebook. Los notebooks son archivos interactivos en donde se coloca una serie de celdas que pueden contener tanto documentos en formato Markdown como snippets de código.

Los notebooks pueden ser visualizados en un formato sencillo desde la página web del repositorio en GitHub, abriendo los archivos .ipynb. Sin embargo, para lograr el comportamiento interactivo y una mejor visualización se debe ejecutar el programa desde el ambiente de desarrollo.

Para abrir Jupyter Notebook desde el vagrant, puede ejecutar el siguiente script:

dev@ie0417-devel:~/ws$ ./run-jupyter-nb.sh

  (...)

  To access the notebook, open this file in a browser:
      file:///home/dev/.local/share/jupyter/runtime/nbserver-5721-open.html
  Or copy and paste one of these URLs:
      http://172.17.0.2:8888/?token=92e2b76f9a108eec684116d8cd612c5f6a8f15869ff2329b
   or http://127.0.0.1:8888/?token=92e2b76f9a108eec684116d8cd612c5f6a8f15869ff2329b

Posteriormente, desde su navegador acceda a alguno de los URLs indicados por la salida del script. Desde la página web desplegada, puede acceder a las presentaciones del curso que se encuentran en el directorio presentations/, utilizando el navegador de archivos.

Para más información sobre los Jupyter Notebooks y como ejecutarlos, refierase a la documentación oficial de Jupyter.