diff --git a/content/manuales/2026-08-18-run-20260818-ba0a96-configurar-acceso-al-servicio-git.md b/content/manuales/2026-08-18-run-20260818-ba0a96-configurar-acceso-al-servicio-git.md new file mode 100644 index 0000000..ba4fd12 --- /dev/null +++ b/content/manuales/2026-08-18-run-20260818-ba0a96-configurar-acceso-al-servicio-git.md @@ -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, ! 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://`.