clusterlogs/content/manuales/2026-08-18-run-20260818-ba0a96-configurar-acceso-al-servicio-git.md

+++ title = "Configurar acceso al servicio Git" description = "Activar su cuenta, agregar su llave SSH y confirmar acceso clonando el repositorio de ejemplo." date = 2026-08-18T05:25:20Z authors = ["gen"] slug = "run-20260818-ba0a96-configurar-acceso-al-servicio-git" template = "page.html" weight = 20

[taxonomies] categories = ["manuales"] tags = ["acceso", "git", "gitea", "ssh"] systems = ["git"]

[extra] id = "RUN-20260818-BA0A96" kind = "manuales" author_id = "gen" author_fingerprint = "SHA256:JhN1Tt4jYqWoJIznDJ6QkMAiOR6HFHr3xLz9aBJqmPg" +++

Prerrequisitos

• Su cuenta en el servicio Git ya está creada; recibió por correo el usuario y una contraseña temporal.
• Acceso de red al clúster ya configurado (el mismo que usa para ssh mcps y los demás hosts internos).
• Su llave SSH personal, la misma que ya usa para acceder al clúster. No hace falta crear una llave nueva.

El servicio Git vive en la misma infraestructura que el host mcps, pero es un servicio aparte (Gitea, detrás de un proxy HTTPS) con su propio inicio de sesión web y su propio puerto SSH — no es lo mismo que iniciar sesión con ssh mcps.

1. Iniciar sesión y cambiar la contraseña

1. Entre a https://git.mcps-epcm.org con el usuario y la contraseña temporal del correo.
2. El sistema le va a pedir que la cambie en ese primer inicio de sesión. Si no se lo pide automáticamente, vaya a su avatar (arriba a la derecha) → Configuración → Cuenta y cambie la contraseña ahí.

La contraseña sólo sirve para la interfaz web. Clonar, subir o bajar cambios por Git usa su llave SSH, que se configura en el siguiente paso.

2. Agregar su llave pública SSH a la cuenta

1. Obtenga el contenido de su llave pública:

   cat ~/.ssh/id_ed25519.pub
   

2. En la interfaz web: avatar → Configuración → Llaves SSH / GPG → Agregar llave.

3. Péguela completa (empieza con ssh-ed25519 o ssh-rsa), póngale un nombre que la identifique (por ejemplo, el nombre de su equipo) y guarde.

3. Confirmar que la llave quedó activa

ssh -p 2222 git@git.mcps-epcm.org

Si todo está bien configurado, va a ver un mensaje similar a:

Hi there, <su-usuario>! You've successfully authenticated with the key named "...", but Gitea does not provide shell access.

Ese mensaje es el resultado esperado — no es un error; Gitea sólo confirma que lo reconoció. Si en cambio ve Permission denied (publickey), revise la sección de solución de problemas más abajo antes de continuar.

4. Confirmar acceso: clonar el repositorio de ejemplo

Con la llave ya confirmada, clone el repositorio de ejemplo (clusterlog) para comprobar que puede traer código del servicio:

git clone ssh://git@git.mcps-epcm.org:2222/fernando/clusterlogs.git
cd clusterlogs
git log --oneline -3

Si el clonado termina sin errores y git log muestra los últimos commits, su acceso quedó confirmado.

Verificación

• ssh -p 2222 git@git.mcps-epcm.org responde con el saludo de Gitea (no "Permission denied").
• git clone ssh://git@git.mcps-epcm.org:2222/fernando/clusterlogs.git termina sin errores.
• cd clusterlogs && git log --oneline -3 muestra commits reales del repositorio.

Avíseme cuando complete estos tres puntos para marcarlo en la reunión.

Solución de problemas

• Permission denied (publickey): confirme que agregó la llave pública (.pub) completa, sin saltos de línea de más, y que es la misma llave que tiene cargada localmente (ssh-add -l para ver cuáles está ofreciendo su agente SSH).
• Could not resolve hostname / tiempo de espera agotado: confirme que tiene acceso de red al clúster activo (el mismo que necesita para ssh mcps); el servicio sólo es alcanzable desde ahí.
• El clonado pide contraseña en vez de usar la llave: revise que la URL use el prefijo ssh://git@...:2222/ tal como está arriba, no una URL https://.