+++
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.
- Su acceso a la VPN del clúster ya configurado (el mismo que usa para `ssh mcps` y los demás servicios 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 clúster con su propio inicio de sesión web y su propio puerto SSH, por lo que 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:

   ```bash
   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, usuario@equipo) y guarde.

## 3. Confirmar que la llave quedó activa

```bash
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:

```bash
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.

Cada miembro debe completar 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://`.