fix(gitea): actualizar stack y documentación

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

gitea/README.md

@@ -28,12 +28,12 @@ Este stack despliega Gitea con:
    - Repository URL: `<tu-repositorio>`
    - Repository reference: `main`
    - Compose path: `gitea/docker-compose.yml`
-5. Carga el archivo de variables de entorno: `gitea/stack.env`
+5. Copia `gitea/stack.env` a `gitea/.env` y carga `gitea/.env` como archivo de variables de entorno
 6. Haz clic en **Deploy the stack**
 
 ### Variables de Entorno Importantes
 
-Edita el archivo `stack.env`:
+Edita el archivo `.env`:
 
 ```env
 # Imágenes
@@ -80,7 +80,7 @@ Para habilitar CI/CD con Gitea Actions:
 
 #### Paso 2: Actualizar el Stack
 
-1. Edita el archivo `stack.env`
+1. Edita el archivo `.env`
 2. Añade el token:
    ```env
    GITEA_RUNNER_REGISTRATION_TOKEN=tu-token-copiado
@@ -139,7 +139,7 @@ Este stack tiene una configuración especial para Authentik:
    - Client Secret: (de Authentik)
    - OpenID Connect Auto Discovery URL: `https://auth.tudominio.com/application/o/gitea/.well-known/openid-configuration`
 
-5. Actualiza las variables en `stack.env`:
+5. Actualiza las variables en `.env`:
    ```env
    GITEA_ENABLE_OPENID_SIGNIN=true
    GITEA_ENABLE_OPENID_SIGNUP=true
@@ -157,7 +157,7 @@ Las siguientes opciones están preconfiguradas:
 - **Visibilidad por defecto**: Privada
 - **Requiere login para ver**: Activado
 
-Para cambiar estas opciones, edita `stack.env` y actualiza el stack.
+Para cambiar estas opciones, edita `.env` y actualiza el stack.
 
 ### Limitar Acceso por Organización
 
@@ -168,7 +168,7 @@ GITEA_DEFAULT_ORG_VISIBILITY=private
 
 ### Notificaciones por Email
 
-Añade al archivo `stack.env`:
+Añade al archivo `.env`:
 
 ```env
 GITEA__mailer__ENABLED=true
@@ -241,7 +241,7 @@ jobs:
    docker logs gitea-act-runner
    ```
 
-2. Verifica que el token es correcto en `stack.env`
+2. Verifica que el token es correcto en `.env`
 
 3. Regenera el token en Gitea si es necesario
 
@@ -338,7 +338,7 @@ Esto crea un archivo `gitea-dump-*.zip` con todo lo necesario para restaurar.
 ## 🔄 Actualizaciones
 
 1. **Backup primero**: Siempre haz backup antes de actualizar
-2. Actualiza la versión en `stack.env`:
+2. Actualiza la versión en `.env`:
    ```env
    GITEA_IMAGE=gitea/gitea:1.21.0
    ```
@@ -370,7 +370,7 @@ docker logs -f gitea-act-runner
 
 Gitea soporta exportación de métricas para Prometheus:
 
-1. Habilita métricas en `stack.env`:
+1. Habilita métricas en `.env`:
    ```env
    GITEA__metrics__ENABLED=true
    GITEA__metrics__TOKEN=tu-token-secreto

gitea/docker-compose.yml

@@ -9,7 +9,7 @@ services:
       POSTGRES_PASSWORD: ${GITEA_DB_PASSWORD}
       TZ: ${TZ}
     volumes:
-      - /opt/gitea/postgres:/var/lib/postgresql/data:Z
+      - ${GITEA_POSTGRES_PATH}:/var/lib/postgresql/data:Z
     networks:
       - gitea
 
@@ -61,14 +61,31 @@ services:
       GITEA__ui__DEFAULT_THEME: ${GITEA_DEFAULT_THEME}
       GITEA__ui__THEMES: ${GITEA_UI_THEMES}
 
+      # Correo
+      GITEA__mailer__ENABLED: ${GITEA_MAILER_ENABLED}
+      GITEA__mailer__FROM: ${GITEA_MAILER_FROM}
+      GITEA__mailer__PROTOCOL: ${GITEA_MAILER_PROTOCOL}
+      GITEA__mailer__SMTP_ADDR: ${GITEA_MAILER_SMTP_ADDR}
+      GITEA__mailer__SMTP_PORT: ${GITEA_MAILER_SMTP_PORT}
+      GITEA__mailer__USER: ${GITEA_MAILER_USER}
+      GITEA__mailer__PASSWD: ${GITEA_MAILER_PASSWD}
+
     volumes:
-      - /opt/gitea/data:/data:Z
+      - ${GITEA_DATA_PATH}:/data:Z
     networks:
       - gitea
+      - mail_internal
       - proxy
     ports:
       - "${GITEA_SSH_PORT}:${GITEA_SSH_PORT}"
     labels:
+      traefik.enable: "true"
+      traefik.docker.network: "${TRAEFIK_DOCKER_NETWORK}"
+      traefik.http.routers.gitea.rule: "Host(`${GITEA_DOMAIN}`)"
+      traefik.http.routers.gitea.entrypoints: "${TRAEFIK_ENTRYPOINT_SECURE}"
+      traefik.http.routers.gitea.tls: "true"
+      traefik.http.routers.gitea.tls.certresolver: "${TRAEFIK_CERTRESOLVER}"
+      traefik.http.routers.gitea.middlewares: "crowdsec-bouncer@file"
       traefik.http.services.gitea.loadbalancer.server.port: "3000"
 
   gitea-runner:
@@ -83,7 +100,7 @@ services:
       GITEA_RUNNER_NAME: ${GITEA_RUNNER_NAME}
       GITEA_RUNNER_LABELS: ${GITEA_RUNNER_LABELS}
     volumes:
-      - /opt/gitea/runner:/data:Z
+      - ${GITEA_RUNNER_DATA_PATH}:/data:Z
       - /var/run/docker.sock:/var/run/docker.sock:Z
     networks:
       - gitea
@@ -91,5 +108,7 @@ services:
 networks:
   gitea:
     driver: bridge
+  mail_internal:
+    external: true
   proxy:
     external: true

gitea/stack.env

@@ -2,7 +2,7 @@
 GITEA_POSTGRES_IMAGE=postgres:16
 GITEA_DB_NAME=gitea
 GITEA_DB_USER=gitea
-GITEA_DB_PASSWORD=pon_una_pass_fuerte_aqui
+GITEA_DB_PASSWORD=change-me
 TZ=Europe/Madrid
 GITEA_POSTGRES_PATH=/opt/gitea/postgres
 
@@ -15,12 +15,12 @@ GITEA_DB_TYPE=postgres
 GITEA_DB_HOST=postgres
 GITEA_DB_PORT=5432
 
-GITEA_DOMAIN=gitea.thehomelesssherlock.com
-GITEA_ROOT_URL=https://gitea.thehomelesssherlock.com/
+GITEA_DOMAIN=app.example.com
+GITEA_ROOT_URL=https://app.example.com
 GITEA_SERVER_PROTOCOL=http
 GITEA_HTTP_PORT=3000
 
-GITEA_SSH_DOMAIN=gitea.thehomelesssherlock.com
+GITEA_SSH_DOMAIN=app.example.com
 GITEA_SSH_PORT=1516
 GITEA_START_SSH_SERVER=true
 
@@ -38,12 +38,29 @@ GITEA_DEFAULT_VISIBILITY=private
 GITEA_DEFAULT_THEME=gitea-dark
 GITEA_UI_THEMES=gitea-dark
 
+##### Correo (SMTP) #####
+GITEA_MAILER_ENABLED=true
+GITEA_MAILER_FROM=gitea@example.com
+GITEA_MAILER_PROTOCOL=smtp
+GITEA_MAILER_SMTP_ADDR=mail-relay
+GITEA_MAILER_SMTP_PORT=587
+GITEA_MAILER_USER=
+GITEA_MAILER_PASSWD=
+
 GITEA_DATA_PATH=/opt/gitea/data
 
+##### Traefik #####
+TRAEFIK_DOCKER_NETWORK=proxy
+TRAEFIK_ENTRYPOINT_SECURE=websecure
+TRAEFIK_CERTRESOLVER=letsencrypt
+TRAEFIK_AUTH_MIDDLEWARE=ths-authentik@docker
+
 ##### Runner #####
 GITEA_RUNNER_IMAGE=docker.io/gitea/act_runner:latest
-GITEA_INSTANCE_URL=http://gitea:3000
-GITEA_RUNNER_REGISTRATION_TOKEN=LRex9dPrXdrEeh1tIPiaRXndu4L1o7Co9j9PSjis
+GITEA_INSTANCE_URL=https://app.example.com
+GITEA_RUNNER_REGISTRATION_TOKEN=change-me
 GITEA_RUNNER_NAME=almasrv-runner-1
 GITEA_RUNNER_LABELS=
 GITEA_RUNNER_DATA_PATH=/opt/gitea/runner
+SERVICE_URL_GITEA=https://app.example.com
+SERVICE_FQDN_GITEA=app.example.com