4.9 KiB
Ingreso y logueo al gitea
Ingresa a: http://192.168.223.105:3000/ en iniciar sesión costado superior derecho
(posteriormente será 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.