Skip to main content
Gitea aporta el caso de uso Desarrollo. El workload dev con Gitea ejecuta un servidor Git privado en un contenedor rootless con SQLite en un nodo seleccionado. El registro público está desactivado y los repositorios nuevos se fuerzan a privados. No expone SSH, no instala un runner de CI ni habilita Actions; los flujos de trabajo para usuarios adicionales y tokens de API siguen siendo operaciones nativas de Gitea. El catálogo de casos de uso lista los componentes que declara el release publicado.

Selecciona el workload dev de forma explícita

Desde un workspace de propietario vacío, selecciona Gitea y establece su custodia local del propietario:
Antes de generar, fusiona los siguientes campos en las secciones existentes capabilities, data y routes de tu StackSpec. Conserva sus demás entradas. Este fragmento usa el site inicial home y la política de acceso home-private; adapta esas referencias, el dominio doméstico y las raíces de almacenamiento del host a tu host real.
Gitea requiere esta ruta HTTPS explícita y este vínculo de datos para obtener URL de clonado nativas utilizables. Valida y genera el resultado:
Después sigue el ciclo de entrega normal: valida, inspecciona el plan, y aplica y verifica como se documenta en Revisar, aplicar y verificar. El inventario de host observado debe cumplir los perfiles de módulo seleccionados; la configuración de ejemplo no es evidencia de hardware.

Aporta el nombre y confía en que la ruta funciona

El Git nativo por HTTPS necesita dos cosas que tu host ya debe cumplir:
  • El nombre de host de la ruta (el ejemplo usa dev.home.test) debe resolverse a ese host desde todos los clientes con los que quieras clonar.
  • Los clientes de Git deben confiar en el certificado de la CA interna del host. Sin esa confianza en el cliente, el clonado por HTTPS falla antes de la autenticación.

Revela la contraseña del propietario e inicia sesión

El primer arranque migra la base de datos SQLite y crea el administrador owner antes de atender tráfico; el correo del propietario procede de tu identidad local de propietario, y la referencia owner-password se guarda en la custodia local de secretos existente. Lee la contraseña en un terminal privado:
El comando solo acepta slots declarados por la StackSpec validada actual, escribe el valor en stdout (nunca en los logs de despliegue) y no crea ni restablece ninguna contraseña. Un administrador existente que no coincida, o una base de datos de usuarios sin propietario, hace fallar la entrega sin reemplazar cuentas ni restablecer contraseñas. Inicia sesión como owner, crea un repositorio privado y usa su URL de clonado HTTPS con el almacenamiento de credenciales nativo de Git. Git se autentica directamente con Gitea: ninguna puerta de forward-auth del navegador intercepta las peticiones de Git. Una comprobación de disponibilidad que solo informa de que el proceso HTTP y SQLite son alcanzables no demuestra que hayas clonado, hecho push ni recuperado nada; prueba un push real desde un cliente previsto.

Límite de almacenamiento y recuperación

Ambos volúmenes con nombre pertenecen al contrato de datos y de copia de seguridad del workload. Una recuperación correcta silencia al único escritor de la aplicación, captura ambos volúmenes y los activa juntos con las escrituras detenidas; una copia en vivo del archivo SQLite por sí sola no es ese contrato. Sigue Copia de seguridad y restauración para el ciclo de vida del workspace. Gitea rootless y rootful usan diseños distintos, así que cambiar la imagen no es una migración de almacenamiento.

Límites conocidos

  • SSH no está expuesto; el HTTPS nativo es la vía de acceso a Git documentada.
  • Gitea Actions y los runners de CI no están instalados; la integración de runners aún no tiene una vía documentada.
  • La recreación forzada del contenedor conserva el acceso del propietario, los metadatos de los repositorios privados y la configuración de la aplicación, pero el aprovisionamiento completo de hosts Linux, la distribución real de DNS/CA en la LAN y un ciclo completo de copia de seguridad y restauración son niveles de evidencia aparte y aquí no están demostrados.