se agrega .md de tailscale para hacer gitea https

005-Learn/Instructivo launchd iOS.md

@@ -0,0 +1,171 @@
+# Instructivo: Ejecutar un servicio Python con launchd en macOS
+
+## Objetivo
+
+Ejecutar un servicio de Python de forma automática utilizando `launchd`.
+
+## Estructura sugerida
+
+``` text
+/Users/george/services/sap_sunat/
+    .venv/
+    main.py
+    config.ini
+    logs/
+        stdout.log
+        stderr.log
+```
+
+## Verificar el entorno virtual
+
+Activar:
+
+``` bash
+source .venv/bin/activate
+```
+
+Obtener el intérprete:
+
+``` bash
+which python
+```
+
+Usar esa ruta en `ProgramArguments`.
+
+## Archivo .plist
+
+Ubicación recomendada para un usuario:
+
+``` text
+~/Library/LaunchAgents/com.george.sap.sunat.plist
+```
+
+Claves habituales:
+
+-   `Label`
+-   `ProgramArguments`
+-   `WorkingDirectory`
+-   `RunAtLoad`
+-   `KeepAlive`
+-   `StandardOutPath`
+-   `StandardErrorPath`
+
+## Comentarios
+
+Se permiten comentarios XML:
+
+``` xml
+<!-- Comentario -->
+```
+
+También se pueden comentar bloques completos de claves.
+
+## Cargar el servicio
+
+``` bash
+launchctl load ~/Library/LaunchAgents/com.george.sap.sunat.plist
+```
+
+En versiones recientes también:
+
+``` bash
+launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.george.sap.sunat.plist
+```
+
+## Verificar
+
+``` bash
+launchctl list | grep sap
+```
+
+Información detallada:
+
+``` bash
+launchctl print gui/$(id -u)/com.george.sap.sunat
+```
+
+## Detener
+
+``` bash
+launchctl unload ~/Library/LaunchAgents/com.george.sap.sunat.plist
+```
+
+o
+
+``` bash
+launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.george.sap.sunat.plist
+```
+
+## Monitorización
+
+Monitor de Actividad: - Buscar `python` o `python3`.
+
+Terminal:
+
+``` bash
+ps -ef | grep python
+```
+
+Consumo:
+
+``` bash
+ps -o pid,rss,vsz,%cpu,command -p <PID>
+```
+
+Ver logs:
+
+``` bash
+tail -f logs/stdout.log
+tail -f logs/stderr.log
+```
+
+## Recomendaciones
+
+-   Usar `logging` con rotación.
+-   Manejar reconexión a SAP HANA.
+-   Implementar reintentos para SUNAT.
+-   Mantener configuración en `config.ini` o `.env`.
+-   Capturar `SIGTERM` para cerrar conexiones correctamente.
+-   Si el servicio es permanente, controlar internamente la frecuencia
+    de ejecución (cada 10 s entre 06:00 y 13:15; cada 30 min entre 13:15
+    y 14:00).
+
+
+## Ejemplo de archivo .plist
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+
+<plist version="1.0">
+<dict>
+
+    <key>Label</key>
+    <string>com.george.sap.sunat</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>/Users/george/services/sap_sunat/.venv/bin/python</string>
+        <string>/Users/george/services/sap_sunat/main.py</string>
+    </array>
+
+    <key>WorkingDirectory</key>
+    <string>/Users/george/services/sap_sunat</string>
+
+    <key>RunAtLoad</key>
+    <true/>
+
+    <key>KeepAlive</key>
+    <true/>
+
+    <key>StandardOutPath</key>
+    <string>/Users/george/services/sap_sunat/logs/stdout.log</string>
+
+    <key>StandardErrorPath</key>
+    <string>/Users/george/services/sap_sunat/logs/stderr.log</string>
+
+</dict>
+</plist>
+```