Ejecutando el repositorio main en ubuntu 22.04#
Luego de completar el primer reto de guayahack, surge la duda de algunos por saber si ¿Es posible ejecutar el repositorio en nuestra máquina? sin la necesidad de esperar a que nuestros cambios sean aprobados, incorporados en master, se le haga “build” a página y éstos cambios se vean reflejados https://guayahack.co.
Éste tutorial busca resolver la pregunta anterior configurando una máquina en Linux con la distribución de Ubuntu en su versión 22.04. Se debe tener en cuenta que las descargas de las dependencias funcionen, para que nuestro repositorio main clonado sea ejecutable en la máquina y visto desde el navegador, dependerá de la velocidad de su internet y memoria RAM de la máquina.
Si no sabes cuál es el primer reto aquí en Presentándose y Entendiendo GGG (GuayaHack, Git, GitLab) y la solución paso a paso aquí en Como Resolví /reto/on-boarding-git-gitlab
Características de la máquina#
La máquina utilizada en este tutorial utiliza estas características:
Máquina virtual creada en virtual box para este tutorial.#
Instalación de dependencias#
Lo que se debe hacer es instalar la herramienta pipenv que tiene como propósito ayudar con la creación y gestión de proyectos Python en un llamado entorno virtual sin la necesidad de instalar librerías y dependencias en nuestra máquina que después eliminaremos porque no le damos otro uso. Así, las dependencias de la página de GuayaHack quedarán solo asociadas con el proyecto y no serán instaladas a nivel global en el sistema operativo.
Para instalar la herramienta usamos el siguiente comando:
sudo apt install python3-pip -y
Al terminar la instalación siempre verificamos que nuestra librería se encuentre disponible para utilizar:
pip3 --version
Para empezar con nuestra instalación de python versión 3.9 en nuestra distribución necesitamos hacer lo siguiente:
Actualizamos los paquetes de nuestra distribución:
sudo apt update
Instalamos el paquete software-properties-common para manejar diferentes librerias de terceros.
sudo apt install software-properties-common -y
Agregamos el repositorio deadsnakes para agregar nuestras versiones más recientes de python.
sudo add-apt-repository ppa::deadsnakes/ppa
Y aceptamos presionando la tecla enter:
Con la configuración previamente realizada, procedemos a instalar python version 3.9:
sudo apt install python3.9 -y
Escribimos en nuestra terminal python3 y apretamos la tecla TAB
Instalamos nuestra libreria pipenv
pip3 install pipenv
Al terminar de instalar pipenv no va a funcionar desde nuestra terminal, ya que no esta agregada a nuestras variables de entorno. Lo primero que hacemos antes de agregar una variable de entorno es saber como esta para poder contrastarla luego de agregar una nueva.
echo $PATH
Agregamos nuestra nueva variable como se menciona al final de la instalación de pipenv donde se resalta la ruta y la agregamos:
export PATH="/home/david/.local/bin:$PATH"
Volvemos a ver nuestras variables de entorno con nuestra nueva variable agregada:
echo $PATH
Una vez agregada la variable de entorno, verificamos que funcione nuestra libreria pipenv:
pipenv --version
Ejecución del repositorio#
Con nuestra libreria pipenv instalada, lista para utilizar y nuestro proyecto main descargado.
Nos dirigimos a la carpeta de main desde la terminal y colocamos el comando para iniciar nuestro entorno virtual y esperamos hasta que se genere:
pipenv shell
Verificamos que nuestra versión de python sea la 3.9
python --version
Instalamos el paquete distutils el cuál permite crear e instalar módulos adicionales a la instalación de python. El paquete se instalará con la versión puntual de python3.9 y que permitirá que a la hora de ejecutar nuestra aplicación no tenga problemas:
sudo apt-get install python3.9-distutils -y
Finalmente instalamos la herramienta tox que nos permite administrar ambientes virtuales para automatizar y ejecutar pruebas:
pipenv install tox
Y ejecutamos el siguiente comando y esperamos unos minutos:
python -m tox -e live
El comando anterior permite ejecutar el archivo tox.init en el cuál tenemos las dependencias necesarias para que funcione el ambiente virtual sin problemas.
Cuando finalice se visualizara en la parte resaltada de blanco en enlace para abrirlo desde nuestro navegador de preferencia, lo copiamos y pegamos:
Y finalmente podremos navegar al proyecto desde nuestra máquina local 🎉:
