From 52ea91f06b572816bd492ec3549132e41e163139 Mon Sep 17 00:00:00 2001 From: Daniel Escobar Date: Fri, 3 Jul 2026 18:19:49 -0300 Subject: [PATCH] Conversion a Markdown --- Manual Gitea.md | 73 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 Manual Gitea.md diff --git a/Manual Gitea.md b/Manual Gitea.md new file mode 100644 index 0000000..a7113c3 --- /dev/null +++ b/Manual Gitea.md @@ -0,0 +1,73 @@ +Ingreso y logueo al gitea + +Ingresa a: [*http://192.168.223.105:3000/*](http://192.168.223.105:3000/) en iniciar sesión costado superior derecho + +(posteriormente será [*http://192.168.223.1:3000/*](http://192.168.223.1:3000/) cuando se cambie el server) + +Loguearse con el botón Iniciar sesión con Authentik-SX y colocar los datos de logueo del office365 + +Token de Acceso + +Sobre la autenticación + +Al hacer push te pedirá usuario y contraseña. Usuario aldo, y como tenés SSO con Authentik, conviene usar un **token de acceso** en lugar de la contraseña (avatar → Configuración → Aplicaciones → Generar token). Si tu usuario aldo entra solo por Authentik y no tiene contraseña local, el token es directamente la única vía para push por HTTP. + +Es en tu perfil de Gitea: **avatar (arriba a la derecha) → Configuración → Aplicaciones** (Settings → Applications). Ahí está la sección \"Administrar tokens de acceso\" / \"Generar nuevo token\". + +Campos a completar + +**Nombre del token** (Token Name): un nombre descriptivo para que lo reconozcas después. Por ejemplo push-imgssl2 o pull-host-vm. Es solo una etiqueta para vos, no afecta la seguridad. + +**Fecha de expiración** (Expiration): si te lo ofrece, podés dejar el valor por defecto o poner \"sin expiración\" si es para uso permanente en tus scripts de pull. Para algo que va a estar en un remoto de git de forma estable, sin expiración es cómodo (aunque menos seguro); para algo puntual, dejá la expiración por defecto. + +**Permisos / Scopes** (lo más importante): Gitea te muestra una lista de grupos de permisos, cada uno con opciones \"Sin acceso / Lectura / Lectura y escritura\". Para poder hacer **push y pull de repositorios**, el que necesitás es: + +**repository** → ponelo en **Lectura y escritura** (Read and Write). + +Con ese alcanza para clonar, pull y push. Los demás (organization, user, admin, etc.) dejalos en \"Sin acceso\" salvo que tengas una razón específica --- cuantos menos permisos, más seguro es el token. + +Generar y copiar (¡solo se muestra una vez!) + +Dale al botón **Generar token** (Generate Token). Gitea te va a mostrar el token una sola vez, en la parte superior. **Copialo inmediatamente** y guardalo en un lugar seguro --- una vez que salgas de esa pantalla, no lo vas a poder ver de nuevo (tendrías que generar otro). + +Usar el token + +**Forma B --- incrustarlo en la URL del remoto** (útil para pulls automáticos sin que pida nada): + +En consola bash + +\#redirige el repositorio remoto + +git remote set-url origin + +\#Cambias main si se usa main, ves con git branch cual es el nombre de la rama principal + +git push -u origin master + +\#redirige el repositorio remoto (cuando cambie el server) + +git remote set-url origin + +***Para compartir el repositorio*** + +Para compartirlo con un grupo, primero necesitás tener el grupo armado. En Gitea, los grupos viven dentro de **organizaciones** (se llaman \"equipos\"/teams), no sueltos. Te explico las dos situaciones. + +Situación A --- El repo es tuyo (personal) y querés darle acceso a varias personas + +Si imgssl2 está bajo tu usuario aldo (que es el caso: /aldo/imgssl2), es un repo **personal**. Los repos personales no se comparten con \"equipos\" directamente --- se comparten agregando **colaboradores** uno por uno: + +Entrá al repo → **Configuración** (Settings, arriba a la derecha del repo) → **Colaboradores** (Collaborators) → escribís el usuario y elegís su permiso (Lectura, Escritura o Administrador). Repetís por cada persona. + +Esto funciona, pero para varias personas es tedioso (uno por uno). Si vas a compartir con un grupo de forma recurrente, conviene la Situación B. + +Situación B --- Usar una Organización con equipos (recomendado para grupos) + +Para compartir con un **grupo** de verdad (agregar/quitar gente de una sola vez, en varios repos), el repo tiene que pertenecer a una **organización**, no a tu usuario personal. + +**Paso 1 --- Crear la organización** (si no tenés una): el **+** arriba a la derecha → **Nueva organización**. Le ponés nombre (ej. serimax o el de tu equipo). + +**Paso 2 --- Crear un equipo dentro de la organización**: entrás a la organización → pestaña **Equipos** (Teams) → **Nuevo equipo**. Le das nombre (ej. desarrollo), definís el nivel de permiso (Lectura / Escritura / Admin) y qué repos abarca. Agregás los miembros al equipo. + +**Paso 3 --- Mover el repo imgssl2 a la organización**: como el repo ya existe bajo tu usuario, lo transferís. En el repo → **Configuración** → abajo de todo, sección de peligro → **Transferir propiedad** (Transfer Ownership) → elegís la organización como nuevo dueño. + +Una vez transferido, el equipo que definiste tiene acceso automático. Sumar a alguien nuevo al grupo = agregarlo al equipo, y queda con acceso a todos los repos del equipo de una sola vez.