UD2.7 · Preparación de Debian y servicios con systemd¶
Módulo: Sistemas Informáticos · 1.º DAM
Modalidad: Individual · Debian GNU/Linux
Herramientas: Git, Python, Flask, Bash, venv y systemd
1. Servidores asignados¶
Cada alumno dispone de un Debian con dirección IP propia y diez puertos TCP. Para acceder a una aplicación desde la red del instituto se utiliza la dirección del router: 192.168.29.133.
| Alumno | ID LXC | Equipo | IP del Debian | Puertos TCP |
|---|---|---|---|---|
| Alejandro | 151 | alejandro-dam70 | 192.168.40.151 | 11000–11009 |
| Adrián | 152 | adrian-dam93 | 192.168.40.152 | 11010–11019 |
| Leonel | 153 | leonel-dam94 | 192.168.40.153 | 11020–11029 |
| José | 154 | jose-dam96 | 192.168.40.154 | 11030–11039 |
| David | 155 | david-dam98 | 192.168.40.155 | 11040–11049 |
| Javier | 156 | javier-dam99 | 192.168.40.156 | 11050–11059 |
| Miguel | 157 | miguel-dam79 | 192.168.40.157 | 11060–11069 |
| Otman | 158 | otman-dam100 | 192.168.40.158 | 11070–11079 |
| Joshimar | 159 | joshimar-dam82 | 192.168.40.159 | 11080–11089 |
| Javier | 160 | javier-dam103 | 192.168.40.160 | 11090–11099 |
| Denis | 161 | denis-dam104 | 192.168.40.161 | 11100–11109 |
| Samuel | 162 | samuel-dam87 | 192.168.40.162 | 11110–11119 |
| Daniel | 163 | daniel-dam88 | 192.168.40.163 | 11120–11129 |
| Óscar | 164 | oscar-dam90 | 192.168.40.164 | 11130–11139 |
| Diego | 165 | diego-dam107 | 192.168.40.165 | 11140–11149 |
| Sergio | 166 | sergio-dam108 | 192.168.40.166 | 11150–11159 |
| Mathías | 167 | mathias-dam77 | 192.168.40.167 | 11160–11169 |
| DAMX | 168 | damx-168 | 192.168.40.168 | 11170–11179 |
La puerta de enlace de los Debian es 192.168.40.1. Utiliza solo uno de los puertos de tu fila.
2. Preparar .gitignore en el repositorio actual¶
Antes de utilizar el nuevo Debian, entra en el repositorio Git en el que trabajas actualmente. Crea o edita el archivo .gitignore de la raíz del repositorio (por ejemplo, /workspace/.gitignore) e incorpora lo siguiente:
# Entornos virtuales
.venv/
venv/
env/
# Variables de entorno y credenciales
.env
.env.*
!.env.example
!.env.template
# Python
__pycache__/
*.py[cod]
*.egg-info/
.pytest_cache/
.mypy_cache/
# Editores y temporales
.idea/
.vscode/
*.log
*.tmp
*.bak
*~
# Bases de datos locales
*.sqlite
*.sqlite3
*.db
# Aplicaciones web
node_modules/
dist/
build/
# Sistema operativo
.DS_Store
Thumbs.db
Este archivo evita incluir entornos virtuales, variables de entorno y archivos temporales. Desde la raíz de tu repositorio actual, comprueba los cambios, confirma el archivo y súbelo al servidor Git:
Una vez subido, ya puedes preparar el Debian nuevo y clonar el repositorio con el .gitignore incluido.
3. Preparar Git en el nuevo Debian¶
Ahora sí, entra en tu nuevo Debian. Instala Git y las herramientas de Python. Estos comandos requieren permisos de administrador.
Configura la identidad con la que harás los commits:
git config --global user.name "Nombre Apellidos"
git config --global user.email "tu-correo@ejemplo.com"
git config --global --list
Para que Git recuerde tus credenciales HTTPS entre operaciones:
Al hacer el primer git clone, git pull o git push, introduce tu usuario y el token de acceso del servidor Git cuando te pida la contraseña. Git guardará la credencial en ~/.git-credentials. Comprueba sus permisos:
Este método guarda el token sin cifrar. Úsalo solo en tu Debian individual y no subas nunca ese archivo al repositorio. La configuración se guarda para el usuario Linux que ejecuta los comandos.
Clona en /workspace el repositorio que acabas de actualizar. La carpeta debe estar vacía:
Si ya tienes el repositorio clonado, entra en /workspace y utiliza git pull en lugar de clonarlo de nuevo.
4. Crear un entorno virtual de Python¶
Prepara la carpeta de la actividad:
mkdir -p /workspace/ud2/servicios
cd /workspace/ud2/servicios
python3 -m venv .venv
source .venv/bin/activate
pip install flask
pip freeze > requirements.txt
El entorno virtual contiene las bibliotecas de este proyecto y no se debe subir a Git.
Para salir del entorno:
Para volver a activarlo:
5. Actividad: ejecutar una aplicación Python como servicio¶
Un servicio de sistema se define mediante un archivo .service y se administra con systemctl. El objetivo es que tu aplicación continúe funcionando sin mantener una terminal abierta y se inicie al arrancar Debian.
5.1. Crear la aplicación¶
Crea /workspace/ud2/servicios/app.py:
from flask import Flask
app = Flask(__name__)
@app.route("/")
def inicio():
return "Servicio de Sistemas Informáticos"
if __name__ == "__main__":
app.run(host="0.0.0.0", port=11000, debug=False)
Sustituye el puerto 11000 por el primero de tu rango asignado. Modifica el mensaje para incluir el nombre de tu máquina y añade una segunda ruta /estado que devuelva Servicio activo.
Prueba la aplicación:
Comprueba que responde y deténla con Ctrl+C antes de configurar el servicio.
5.2. Crear la unidad de systemd¶
Comprueba que Debian utiliza systemd:
Crea /workspace/ud2/servicios/ud2-servicio.service:
[Unit]
Description=Aplicacion Flask de Sistemas Informaticos
After=network.target
[Service]
Type=simple
User=TU_USUARIO
WorkingDirectory=/workspace/ud2/servicios
ExecStart=/workspace/ud2/servicios/.venv/bin/python /workspace/ud2/servicios/app.py
Restart=on-failure
[Install]
WantedBy=multi-user.target
Sustituye TU_USUARIO por el usuario Linux que ejecutará la aplicación, obtenido con whoami. Ese usuario debe tener acceso a /workspace/ud2/servicios. No hace falta activar el entorno virtual en el archivo: ExecStart utiliza directamente su intérprete de Python.
5.3. Explicación del archivo .service¶
Un archivo .service se divide en tres secciones principales:
| Apartado | Función |
|---|---|
[Unit] |
Información general del servicio y orden de inicio. |
Description= |
Nombre o descripción que muestra systemctl. |
After=network.target |
Ordena el inicio después del objetivo de red; no garantiza que ya exista conexión a Internet. |
[Service] |
Indica cómo se ejecuta el programa. |
Type=simple |
Considera iniciado el servicio al arrancar el proceso principal. |
User=TU_USUARIO |
Usuario de Linux que ejecutará el programa. |
WorkingDirectory= |
Directorio de trabajo desde el que se ejecutará el programa. |
ExecStart= |
Comando completo que inicia el programa. |
Restart=on-failure |
Reinicia el programa si falla, pero no cuando se detiene con systemctl stop. |
[Install] |
Establece cómo se habilita el arranque automático del servicio. |
WantedBy=multi-user.target |
Permite habilitarlo para el arranque normal del sistema con systemctl enable. |
En el servicio de Python, ExecStart utiliza /workspace/ud2/servicios/.venv/bin/python, el intérprete del entorno virtual, para ejecutar app.py. Por eso no hace falta utilizar source .venv/bin/activate en el archivo de servicio.
5.4. Instalar e iniciar el servicio¶
Instala y arranca el servicio con permisos de administrador:
cp /workspace/ud2/servicios/ud2-servicio.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable --now ud2-servicio.service
systemctl status ud2-servicio.service
5.5. Comprobar su funcionamiento¶
Utiliza los siguientes comandos:
systemctl stop ud2-servicio.service
systemctl start ud2-servicio.service
systemctl restart ud2-servicio.service
systemctl status ud2-servicio.service
journalctl -u ud2-servicio.service -n 20 --no-pager
Comprueba desde un navegador de la red del instituto:
Sustituye TU_PUERTO por el puerto de tu aplicación. Comprueba también que el servicio vuelve a iniciarse al reiniciar tu Debian.
6. Actividad: ejecutar un script Bash como servicio¶
Ahora crearás otro servicio, esta vez sin Python. El script escribirá la fecha en el registro del servicio cada diez segundos y seguirá funcionando aunque cierres la terminal.
6.1. Crear el script¶
Crea /workspace/ud2/servicios/registro.sh:
Asígnale permisos de ejecución:
Prueba el script y detenlo con Ctrl+C:
6.2. Crear el servicio de Bash¶
Crea /workspace/ud2/servicios/ud2-bash.service:
[Unit]
Description=Servicio Bash de Sistemas Informaticos
After=network.target
[Service]
Type=simple
User=TU_USUARIO
WorkingDirectory=/workspace/ud2/servicios
ExecStart=/bin/bash /workspace/ud2/servicios/registro.sh
Restart=on-failure
[Install]
WantedBy=multi-user.target
Sustituye TU_USUARIO por tu usuario de Linux. Debe poder leer el script y acceder a la carpeta.
Este archivo tiene las mismas secciones que el servicio Python. La diferencia principal está en ExecStart:
- Python: inicia
app.pycon el intérprete de.venv. - Bash: inicia
registro.shcon/bin/bash.
El proceso de Bash permanece en ejecución gracias al bucle while. Los mensajes de echo se guardan en el registro del servicio y pueden consultarse con journalctl.
6.3. Activar y comprobar el servicio Bash¶
Instala el archivo y arranca el servicio con permisos de administrador:
cp /workspace/ud2/servicios/ud2-bash.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable --now ud2-bash.service
systemctl status ud2-bash.service
Consulta sus mensajes:
Comprueba que aparecen líneas nuevas con la fecha. Después prueba:
systemctl stop ud2-bash.service
systemctl start ud2-bash.service
systemctl restart ud2-bash.service
systemctl status ud2-bash.service
6.4. Comandos de administración de servicios¶
| Comando | Función |
|---|---|
systemctl daemon-reload |
Recarga los archivos de servicio después de crearlos o modificarlos. |
systemctl start nombre.service |
Inicia el servicio en este momento. |
systemctl stop nombre.service |
Detiene el servicio. |
systemctl restart nombre.service |
Detiene y vuelve a iniciar el servicio. |
systemctl status nombre.service |
Muestra su estado. |
systemctl enable nombre.service |
Habilita el inicio automático; no arranca inmediatamente el servicio. |
systemctl disable nombre.service |
Deshabilita el inicio automático; no detiene el servicio actual. |
systemctl enable --now nombre.service |
Habilita el inicio automático y lo arranca ahora. |
journalctl -u nombre.service |
Muestra los mensajes registrados por el servicio. |
Tras habilitarlos, comprueba que los dos servicios vuelven a arrancar al reiniciar el Debian.
7. Entrega¶
Sube al repositorio:
/workspace/.gitignore/workspace/ud2/servicios/app.py/workspace/ud2/servicios/requirements.txt/workspace/ud2/servicios/ud2-servicio.service/workspace/ud2/servicios/registro.sh/workspace/ud2/servicios/ud2-bash.service/workspace/ud2/servicios/respuestas.md
En respuestas.md, indica:
- Tu puerto TCP y la URL desde la que accedes a Flask.
- Qué aparece al consultar el estado del servicio Python y del servicio Bash.
- Para qué sirven
[Unit],[Service]y[Install]. - Qué hacen
User,WorkingDirectory,ExecStartyRestart. - La diferencia entre
startyenable.
cd /workspace
git status
git add .gitignore ud2/servicios/
git commit -m "UD2.7 Servicios Python y Bash con systemd"
git push
No subas .venv, .env ni credenciales. Los servicios se utilizarán únicamente para las prácticas de la red del instituto.