Tutorial configurando vagrant para una aplicación 2526 - Historial de revisiones

Jmorenol: /* Estructura del Proyecto */

2025-11-18T08:47:01Z

‎Estructura del Proyecto

Brgutierrez: /* Paso 1: Modificar el Vagrantfile */

2025-11-18T07:21:40Z

‎Paso 1: Modificar el Vagrantfile

Brgutierrez en 18:28 17 nov 2025

2025-11-17T18:28:35Z

Brgutierrez en 18:26 17 nov 2025

2025-11-17T18:26:49Z

Mostrar los cambios

Brgutierrez en 18:12 17 nov 2025

2025-11-17T18:12:19Z

Brgutierrez en 17:23 17 nov 2025

2025-11-17T17:23:30Z

Brgutierrez: /* Crear el script de aprovisionamiento */

2025-11-17T17:16:06Z

‎Crear el script de aprovisionamiento

Brgutierrez: /* Paso 7: Iniciar el Entorno Virtual con Vagrant */

2025-11-17T16:35:59Z

‎Paso 7: Iniciar el Entorno Virtual con Vagrant

Brgutierrez en 16:35 17 nov 2025

2025-11-17T16:35:22Z

Brgutierrez en 16:31 17 nov 2025

2025-11-17T16:31:41Z

@@ Línea 45: / Línea 45: @@
 │   ├── app.py
 │   ├── models.py
-│   └── routes.py
+│   ├── routes.py
-└── templates/
+│   └── templates/
-     └── tasks.html
+└──     └── tasks.html
   </pre>
@@ Línea 394: / Línea 394: @@
 </syntaxhighlight>
 = Parte 1: Aprovisionamiento mediante un Script de Shell =

@@ Línea 699: / Línea 699: @@
    config.vm.network "forwarded_port", guest: 5000, host: 5001
-   # 3. Provisionamiento: Ejecuta el Playbook de Ansible
+   # 3. Aprovisionamiento: Ejecuta el Playbook de Ansible
    config.vm.provision "ansible" do |ansible|
      # Especifica que Vagrant debe ejecutar el archivo playbook.yml

← Revisión anterior		Revisión del 18:28 17 nov 2025
Línea 928:		Línea 928:

	Verificación y Mensaje Final: Las últimas tareas verifican que el proceso Flask esté corriendo y muestran un mensaje de éxito, indicando que la aplicación está lista en <code>http://localhost:5001</code>.		Verificación y Mensaje Final: Las últimas tareas verifican que el proceso Flask esté corriendo y muestran un mensaje de éxito, indicando que la aplicación está lista en <code>http://localhost:5001</code>.
		+
		+	La aplicación Flask estará disponible en `http://localhost:5001` cuando finalice el aprovisionamiento.
		+
		+	'''¿Qué has podido observar ahora en la terminal en la etapa de aprovisionamiento? ¿Crees que la MV estará funcionando igual que en el aprovisionamiento por shell script?'''
		+
		+	=Conclusión=
		+
		+	Este tutorial te ha guiado a través de dos métodos de aprovisionamiento de una aplicación Flask en Vagrant, utilizando un script de shell y un playbook de Ansible. ¡Ahora deberías tener una mejor comprensión del aprovisionamiento automático y de cómo desplegar aplicaciones en entornos virtuales reproducibles!
		+
		+	¡Enhorabuena si has llegado hasta aquí! Y, recuerda, las máquinas virtuales consumen recursos de tu equipo, apágalas y elimínalas cuando ya no las necesites.

← Revisión anterior		Revisión del 18:12 17 nov 2025
Línea 679:		Línea 679:

	El aprovisionamiento con Ansible ofrece varias ventajas frente al uso de scripts de shell. Mientras que los scripts de shell son imperativos, es decir, detallan los pasos exactos para lograr un objetivo, Ansible adopta un enfoque '''declarativo''', donde especificamos el estado deseado del sistema y Ansible se encarga de llevarlo a cabo. Esto permite una mayor '''idempotencia''', es decir, que la configuración se pueda aplicar varias veces sin causar efectos no deseados. Además, Ansible facilita la gestión de infraestructuras grandes de forma '''escalable y reproducible''', lo que hace que sea más fácil mantener entornos consistentes y automatizados en comparación con los scripts tradicionales. Un aspecto clave de Ansible es que permite aprovisionar diferentes máquinas sin importar el sistema operativo o la infraestructura subyacente, ya que simplemente le indicamos qué necesitamos y Ansible se encarga de implementar la configuración adecuada, independientemente de cómo o dónde se ejecute.		El aprovisionamiento con Ansible ofrece varias ventajas frente al uso de scripts de shell. Mientras que los scripts de shell son imperativos, es decir, detallan los pasos exactos para lograr un objetivo, Ansible adopta un enfoque '''declarativo''', donde especificamos el estado deseado del sistema y Ansible se encarga de llevarlo a cabo. Esto permite una mayor '''idempotencia''', es decir, que la configuración se pueda aplicar varias veces sin causar efectos no deseados. Además, Ansible facilita la gestión de infraestructuras grandes de forma '''escalable y reproducible''', lo que hace que sea más fácil mantener entornos consistentes y automatizados en comparación con los scripts tradicionales. Un aspecto clave de Ansible es que permite aprovisionar diferentes máquinas sin importar el sistema operativo o la infraestructura subyacente, ya que simplemente le indicamos qué necesitamos y Ansible se encarga de implementar la configuración adecuada, independientemente de cómo o dónde se ejecute.
		+
		+
		+	== Paso 1: Modificar el Vagrantfile ==
		+
		+	Modifica el Vagrantfile para ejecutar un playbook de Ansible en lugar del script provision.sh:
		+
		+	<syntaxhighlight lang="ruby">
		+	# Vagrantfile
		+	# -- mode: ruby --
		+	# vi: set ft=ruby :
		+
		+	Vagrant.configure("2") do \|config\|
		+
		+	# 1. Sistema Operativo
		+	config.vm.box = "ubuntu/jammy64"
		+
		+	# 2. Mapear puerto de Flask (usando 5001 como puerto de host para evitar colisiones)
		+	# Aplicación accesible en http://localhost:5001
		+	config.vm.network "forwarded_port", guest: 5000, host: 5001
		+
		+	# 3. Provisionamiento: Ejecuta el Playbook de Ansible
		+	config.vm.provision "ansible" do \|ansible\|
		+	# Especifica que Vagrant debe ejecutar el archivo playbook.yml
		+	ansible.playbook = "playbook.yml"
		+
		+	# Ejecutar tareas con privilegios de root (sudo)
		+	ansible.become = true
		+
		+	# Asegura que se ejecuta en el host de la MV
		+	ansible.limit = "all"
		+	end
		+	end
		+
		+
		+	</syntaxhighlight>
		+
		+	== Paso 2: Crea el <code>playbook.yml</code> ==

← Revisión anterior		Revisión del 17:23 17 nov 2025
Línea 674:		Línea 674:

	'''¿Has podido ver qué ocurría en cada paso? ¡Prueba a entrar en la máquina virtual y ver cómo está funcionando todo por dentro!'''		'''¿Has podido ver qué ocurría en cada paso? ¡Prueba a entrar en la máquina virtual y ver cómo está funcionando todo por dentro!'''
		+
		+
		+	= Parte 2: Aprovisionamiento mediante un playbook de Ansible =
		+
		+	El aprovisionamiento con Ansible ofrece varias ventajas frente al uso de scripts de shell. Mientras que los scripts de shell son imperativos, es decir, detallan los pasos exactos para lograr un objetivo, Ansible adopta un enfoque '''declarativo''', donde especificamos el estado deseado del sistema y Ansible se encarga de llevarlo a cabo. Esto permite una mayor '''idempotencia''', es decir, que la configuración se pueda aplicar varias veces sin causar efectos no deseados. Además, Ansible facilita la gestión de infraestructuras grandes de forma '''escalable y reproducible''', lo que hace que sea más fácil mantener entornos consistentes y automatizados en comparación con los scripts tradicionales. Un aspecto clave de Ansible es que permite aprovisionar diferentes máquinas sin importar el sistema operativo o la infraestructura subyacente, ya que simplemente le indicamos qué necesitamos y Ansible se encarga de implementar la configuración adecuada, independientemente de cómo o dónde se ejecute.

@@ Línea 552: / Línea 552: @@
 fi
-# 5b. Aplicar las migraciones. Esto crea las tablas en la base de datos.
+# 5b. Crear la migración inicial si es necesario (ESTA ES LA LÍNEA FALTANTE)
 flask db upgrade

@@ Línea 661: / Línea 661: @@
 <code> deactivate</code>: Sale del entorno virtual de Python.
-== Paso 7: Iniciar el Entorno Virtual con Vagrant ==
+== Iniciar el Entorno Virtual con Vagrant ==
 Desde la terminal, navega al directorio `flask_testing_project/` y ejecuta el siguiente comando:
   <syntaxhighlight lang="bash">

@@ Línea 399: / Línea 399: @@
 = Parte 1: Aprovisionamiento mediante un Script de Shell =
 En la primera parte del tutorial, aprovisionaremos el entorno de desarrollo con un script de shell (`provision.sh`).
 == Crear el Vagrantfile ==
@@ Línea 636: / Línea 660: @@
 <code> deactivate</code>: Sale del entorno virtual de Python.

@@ Línea 292: / Línea 292: @@
 </syntaxhighlight>
-===== OPCIONAL: Script <code>local_setup.sh</code> para lanzar la app en local =====
+===== Script <code>local_setup.sh</code> para lanzar la app en local =====
 Si quieres lanzar la aplicación de manera local, puedes utilizar este script:
@@ Línea 585: / Línea 585: @@
 Este bloque configura la base de datos y el usuario de manera idempotente (es decir, puede ejecutarse varias veces sin causar errores).
 <code> sudo systemctl enable mariadb / sudo systemctl start mariadb</code>: Asegura que el servicio MariaDB esté habilitado para arrancar con el sistema y lo inicia inmediatamente.
@@ Línea 602: / Línea 600: @@
 * <code>FLUSH PRIVILEGES</code>: Ordena a MariaDB que recargue la tabla de permisos inmediatamente.
-Paso 4: Preparación del Entorno Python
+==== Paso 4: Preparación del Entorno Python ====
 En esta sección se configura el entorno de ejecución del proyecto.
-    cd $PROJECT_DIR: Navega al directorio raíz del proyecto (/vagrant).
+<code>cd $PROJECT_DIR </code>: Navega al directorio raíz del proyecto (/vagrant).
-    if [ ! -d ".venv" ]; then python3 -m venv .venv; fi: Crea el entorno virtual (.venv) si aún no existe (idempotencia).
+<code>if [ ! -d ".venv" ]; then python3 -m venv .venv; fi </code>: Crea el entorno virtual (.venv) si aún no existe (idempotencia).
-    source .venv/bin/activate: Activa el entorno virtual. Esto hace que los comandos como pip y flask apunten a los binarios dentro del .venv.
+<code>source .venv/bin/activate </code>: Activa el entorno virtual. Esto hace que los comandos como pip y flask apunten a los binarios dentro del .venv.
-    pip install -r requirements.txt: Instala todas las dependencias de Python listadas en el archivo requirements.txt.
+<code>pip install -r requirements.txt </code>: Instala todas las dependencias de Python listadas en el archivo requirements.txt.
-Paso 5: Migraciones y Creación de Tablas
+==== Paso 5: Migraciones y Creación de Tablas ====
 Se utiliza Flask-Migrate (Alembic) para configurar la base de datos con el esquema de modelos de SQLAlchemy.
-    echo "--- 5. Ejecutando migraciones de Flask (Alembic) ---": Mensaje informativo.
+<code>if [ ! -d "migrations" ]; then flask db init; fi</code>: Comprueba si el directorio migrations existe. Si no, inicializa el repositorio de migraciones de Alembic.
-    flask db upgrade: Comando crucial. Aplica la migración más reciente a la base de datos, lo que resulta en la creación de todas las tablas definidas por los modelos de la aplicación.
+<code>flask db upgrade</code>: Aplica la migración más reciente a la base de datos, lo que resulta en la creación de todas las tablas definidas por los modelos de la aplicación.
-Paso 6: Lanzamiento de la Aplicación
+==== Paso 6: Lanzamiento de la Aplicación ====
 Finalmente, se lanza la aplicación Flask y se sale del entorno de aprovisionamiento.
-    echo "--- 6. Iniciando la aplicación Flask en segundo plano ...": Mensaje informativo.
+<code>pkill -f 'flask run --host=0.0.0.0'</code>: Intenta detener cualquier proceso Flask anterior que pudiera estar ejecutándose, asegurando que solo haya una instancia activa.
-    pkill -f 'flask run --host=0.0.0.0': Intenta detener cualquier proceso Flask anterior que pudiera estar ejecutándose, asegurando que solo haya una instancia activa.
+<code>nohup flask run --host=0.0.0.0 > /tmp/flask_app.log 2>&1 &</code>: Lanza el servidor Flask:
-    nohup flask run --host=0.0.0.0 > /tmp/flask_app.log 2>&1 &: Lanza el servidor Flask:
+* <code>--host=0.0.0.0</code>: Permite que la aplicación sea accesible desde fuera de la VM (a través del puerto reenviado en Vagrantfile).
-        --host=0.0.0.0: Permite que la aplicación sea accesible desde fuera de la VM (a través del puerto reenviado en Vagrantfile).
+* <code> nohup ... &</code>: Ejecuta el comando en segundo plano (&) y lo hace inmune a colgarse (nohup), manteniendo el servidor activo incluso después de que termine la sesión de aprovisionamiento. La salida se redirige al archivo /tmp/flask_app.log.
-    deactivate: Sale del entorno virtual de Python.
+<code> deactivate</code>: Sale del entorno virtual de Python.