Cómo entregar las prácticas

Estas instrucciones son iguales para todas las prácticas del curso. Sustituye N por el número de tu práctica en los comandos (ej: practica1, practica2…).

---

📦 Estructura de entregas (GitHub)

En lugar de enviar ficheros sueltos por correo, todas las prácticas se entregan en un repositorio de GitHub. Así construyes un portafolio profesional y aprendes el flujo de trabajo real con git.

Estructura del repositorio

lfcs-practicas/
├── practica1/
│   ├── README.md
│   └── entrega/
│       └── verificacion.txt
├── practica2/
│   ├── README.md
│   └── entrega/
│       └── verificacion.txt
├── ...
└── practica6/
    ├── README.md
    └── entrega/
        ├── verificacion.txt
        └── (ficheros específicos)

Regla de oro

Todo lo que se pide guardar en cada ejercicio debe ir dentro de practicaN/entrega/. El README.md explica qué hiciste, cómo y qué problemas tuviste.

---

1. Crear una cuenta de GitHub (si no la tienes)

Paso a paso

1. Ve a https://github.com/join
2. Rellena:
   • Username: elige un nombre (ej: alumno-linux)
   • Email: tu correo real
   • Password: usa una contraseña segura
3. Resuelve el puzzle de verificación
4. Haz clic en Create account
5. Confirma tu correo electrónico con el enlace que recibirás

Email importante

Usa un correo que consultes a menudo. GitHub enviará notificaciones de entregas.

---

2. Configurar autenticación SSH con GitHub

Con SSH no tendrás que escribir tu usuario y contraseña cada vez que subas código.

2.1 Generar clave SSH (en tu máquina local)

Linux / Mac

ssh-keygen -t ed25519 -C "tu-email@ejemplo.com"

Pulsa Enter para aceptar la ruta por defecto (~/.ssh/id_ed25519).
Cuando pida passphrase, puedes pulsar Enter dos veces (sin contraseña, más cómodo para prácticas).

Windows (PowerShell)

ssh-keygen -t ed25519 -C "tu-email@ejemplo.com"

Pulsa Enter para aceptar la ruta por defecto (C:\Users\TU_USUARIO\.ssh\id_ed25519).

2.2 Añadir la clave pública a GitHub

1. Muestra tu clave pública:

Linux / Mac

cat ~/.ssh/id_ed25519.pub

Windows (PowerShell)

type $env:USERPROFILE\.ssh\id_ed25519.pub

2. Copia toda la línea (empieza por ssh-ed25519 y termina con tu email)
3. Ve a GitHub → Settings (icono de tu foto → Settings)
4. En el menú izquierdo: SSH and GPG keys
5. Haz clic en New SSH key
6. Pega la clave y ponle un título (ej: mi-ordenador-portatil)
7. Haz clic en Add SSH key

2.3 Probar la conexión SSH

ssh -T git@github.com

Deberías ver algo como:

Hi alumno-linux! You've successfully authenticated...

Si sale 'Permission denied'

Revisa que copiaste toda la clave pública, incluyendo el prefijo ssh-ed25519 y tu email.

---

3. Instalar y configurar git

Linux (Arch)

sudo pacman -S git

Linux (Debian/Ubuntu)

sudo apt install git

Windows

Git viene con WSL2. Desde PowerShell:

winget install Git.Git

Mac

brew install git

Configurar tu identidad (importante para los commits):

git config --global user.name "Tu Nombre"
git config --global user.email "tu-email@ejemplo.com"

Email correcto

Usa el mismo email que registraste en GitHub. Así aparecerán tus commits asociados a tu cuenta.

---

4. Crear el repositorio principal

1. Ve a https://github.com/new
2. Rellena:
   • Repository name: lfcs-practicas
   • Description: Prácticas del curso LFCS
   • Public (recomendado para portafolio) o Private
   • ❌ No marcar “Add a README”
3. Haz clic en Create repository

---

5. Clonar el repositorio y empezar a trabajar

5.1 Clonar (solo una vez)

git clone git@github.com:TU-USUARIO/lfcs-practicas.git
cd lfcs-practicas

5.2 Crear la estructura de la práctica actual

mkdir -p practicaN/entrega

5.3 Generar los ficheros de entrega (dentro del servidor)

Dentro de Ubuntu (Distrobox/WSL/Lima):

cd ~/lfcs-practicas/practicaN

# Generar verificacion.txt (u otros ficheros que pida el ejercicio)
{
  echo "=== ENTREGA PRÁCTICA N ==="
  echo "Hostname: $(hostname)"
  echo "Usuario: $(whoami)"
  uname -a
  ip addr show | grep "inet " | grep -v "127.0.0.1"
  timedatectl | grep "Time zone"
  sudo apt list --upgradable 2>/dev/null | wc -l
} > entrega/verificacion.txt

5.4 Escribir el README.md

nano practicaN/README.md

Contenido mínimo:

# Práctica N — [Título de la práctica]

## Servidor utilizado
- Método: Distrobox / WSL2 / Lima
- SO: Ubuntu 22.04 / 24.04
- Hostname: servidor-linux

## Comandos aprendidos
- `comando1` - para qué sirve
- `comando2` - para qué sirve

## Dificultades encontradas
<!-- Describe al menos un problema real y cómo lo solucionaste -->

## Tiempo dedicado
<!-- Ej: 2 horas -->

## Evidencia
Los ficheros generados están en la carpeta `entrega/`

5.5 Guardar también el historial de comandos

history > ~/lfcs-practicas/practicaN/entrega/history.txt

---

6. Subir la práctica a GitHub

cd ~/lfcs-practicas

# Ver qué archivos has modificado/añadido
git status

# Añadir todos los cambios
git add .

# Crear un commit con un mensaje descriptivo
git commit -m "Entrega práctica N: [breve descripción de lo que hiciste]"

# Subir a GitHub
git push

Primera subida

Si es la primera vez que subes algo, es posible que necesites:

git branch -M main
git push -u origin main

---

7. Abrir el repositorio con Visual Studio Code

Desde VS Code

1. Abre Visual Studio Code
2. Pulsa Ctrl+Shift+P (o Cmd+Shift+P en Mac)
3. Escribe Git: Clone
4. Pega la URL del repositorio: git@github.com:TU-USUARIO/lfcs-practicas.git
5. Elige la carpeta donde guardarlo (ej: ~/Documentos/)
6. Cuando termine, haz clic en Open

Desde terminal

# Instalar code si no lo tienes (Linux/Mac)
# En Arch: sudo pacman -S code
# En Debian/Ubuntu: sudo apt install code

# Abrir el repositorio
code ~/lfcs-practicas

Windows (WSL2 + VS Code)

Desde PowerShell o WSL:

code ~/lfcs-practicas

VS Code se abrirá automáticamente con el repositorio cargado.

Extensiones útiles

• Git Graph → visualizar commits y ramas
• GitLens → ver quién escribió cada línea
• Markdown All in One → previsualizar README.md

---

8. Entregar al profesor

Comparte el enlace de tu repositorio:

• Si es público: https://github.com/TU-USUARIO/lfcs-practicas
• Si es privado: Añade al profesor como colaborador
  • Repositorio → Settings → Collaborators → Add people → hola@casset.cat

También se acepta por correo

Si no puedes usar GitHub, empaqueta la carpeta practicaN y envíala a hola@casset.cat con asunto Entrega Práctica N - [tu_nombre]. Pero se recomienda encarecidamente GitHub para construir portafolio.

---

9. Criterios de evaluación comunes

Elemento	Puntuación
Carpeta practicaN/entrega/ existe	1 pto
Ficheros de entrega generados correctamente	3 ptos
README.md completo (mínimo 5 líneas)	2 ptos
Dificultades documentadas (mínimo 1)	1 pto
Commit con mensaje descriptivo	1 pto
Estructura general del repositorio	2 ptos
Total	10 ptos

---

10. Resumen rápido de comandos útiles

# Clonar repositorio
git clone git@github.com:TU-USUARIO/lfcs-practicas.git

# Ver estado
git status

# Añadir todo
git add .

# Hacer commit
git commit -m "Mensaje descriptivo"

# Subir cambios
git push

# Ver historial de commits
git log --oneline

# Abrir en VS Code
code .

---

11. Solución de problemas comunes

Problema	Solución
Permission denied (publickey)	No añadiste la clave SSH a GitHub. Ve a Settings → SSH and GPG keys
fatal: not a git repository	No estás dentro de la carpeta del repositorio. Haz cd lfcs-practicas
rejected: failed to push	Haz git pull primero para bajar cambios remotos
No recuerdo qué cambié	git diff muestra las diferencias
Quiero deshacer un commit	git reset —soft HEAD~1 (mantiene los cambios)

---

¡Buena suerte con las prácticas! 🚀