manuales(RUN-20260818-BA0A96): Configurar acceso al servicio Git

2026-08-17 23:25:20 -06:00
parent a086df8f13
commit 94cf529420
1 changed files with 86 additions and 0 deletions
@@ -0,0 +1,86 @@
+++
+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:
+
+   ```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, el nombre de su 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.
+
+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://`.