Primer commit

docs/herramientas-auxiliares.md

@@ -0,0 +1,74 @@
+# 🛠️ Herramientas auxiliares
+
+Esta sección recoge los scripts y utilidades que facilitan el trabajo con los repositorios Git del clúster, automatizando tareas como publicar, subir o clonar todos los manifiestos gestionados por Argo CD y Gitea.
+
+---
+
+## `git-publish`
+
+Publica un repositorio local en Gitea automáticamente.  
+Crea el repositorio remoto (si no existe), hace `init`, `add`, `commit`, crea la rama `main` y hace `push`.
+
+📝 Documentación: [`herramienta git-publish.md`](herramienta%20git-publish.md)
+
+---
+
+## `publicar-todos.sh`
+
+Script que recorre todas las carpetas de servicios (`k8s-*`) y ejecuta `git-publish` en cada una de ellas.
+
+Ideal para hacer el primer despliegue completo de manifiestos en Gitea.
+
+📝 Documentación: [`herramienta publicar-todos.md`](herramienta%20publicar-todos.md)
+
+---
+
+## `git-subirtodos`
+
+Hace `git add`, `commit` y `push` en todos los subrepositorios del clúster.
+
+Útil cuando se ha trabajado localmente en varias apps y se quiere subir todo de golpe.
+
+📝 Documentación: [`herramienta git-subirtodos.md`](herramienta%20git-subirtodos.md)
+
+---
+
+## `git-bajartodos`
+
+Clona todos los repositorios hijos (servicios del clúster) desde Gitea.
+
+Permite replicar rápidamente toda la estructura del clúster en un nuevo entorno de desarrollo.
+
+📝 Documentación: [`herramienta git-bajartodos.md`](herramienta%20git-bajartodos.md)
+
+---
+
+## `git-chilremove`
+
+Elimina todos los subrepositorios Git de carpetas hijas (útil para limpiar y reestructurar).
+
+Requiere confirmación para evitar errores destructivos.
+
+📝 Documentación: [`herramienta git-chilremove.md`](herramienta%20git-chilremove.md)
+
+---
+
+## Requisitos
+
+- Token de Gitea guardado en `.env`
+- Nombre de usuario y URL base configurados en los scripts
+- Estructura de carpetas estándar (`k8s-*` con su `readme.md` y `kustomization.yaml`)
+
+---
+
+## Ejemplo de uso rápido
+
+```bash
+# Publicar todos los manifiestos como repos en Gitea
+./publicar-todos.sh
+
+# Hacer commit y push masivo
+./docs/git-subirtodos.sh
+
+# Clonar todos los servicios desde Gitea
+./docs/git-bajartodos.sh