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

87 lines
3.9 KiB
Markdown

+++
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://`.