Conversion a Markdown

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 <http://TUUSUARIO:TU_TOKEN@192.168.223.105:3000/TUUSUARIO/TUPROYECTO.git>
+
+\#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 <http://TUUSUARIO:TU_TOKEN@192.168.223.1:3000/TUUSUARIO/TUPROYECTO.git>
+
+***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.