Día 7 – Proyecto final: tu repositorio profesional de scripts

(estructura, README, wiki, releases y versionado real)

El cierre perfecto para convertir tu trabajo técnico en un proyecto profesional visible, ordenado y mantenible.

---

1. Objetivo del día

Hoy vas a crear tu primer repositorio profesional en GitHub, con todos los elementos que se esperan en un proyecto real:

• estructura clara
• README completo
• documentación en la Wiki
• releases con versiones
• issues para planificar mejoras
• etiquetas y organización
• commit inicial limpio
• repositorio preparado para crecer

Este será tu maletín de trabajo como sysadmin, devops o técnico de monitorización.

---

2. Crear la carpeta del proyecto en tu PC

Escoge un nombre ordenado:

mis-utilidades/

Estructura recomendada:

mis-utilidades/
├─ bash/
├─ python/
├─ sql/
├─ powershell/
├─ docs/
├─ LICENSE
└─ README.md

📌 Nota:
LICENSE indica qué permiso das para reutilizar tu código.
Si no sabes cuál usar, elige MIT (muy común para scripts).

Puedes empezar simple e ir ampliando.

---

3. Crear el repositorio local

cd mis-utilidades
git init

Agregar todo:

git add .
git commit -m "Commit inicial: estructura base del repositorio"

---

4. Crear el repositorio en GitHub

En GitHub:

1. New Repository
2. Nombre: mis-utilidades
3. Privado (muy recomendable)
4. NO crear README → ya lo tienes localmente
5. Crear repositorio

Conectar remoto:

git remote add origin https://github.com/TU_USUARIO/mis-utilidades.git

Subir:

git push -u origin main

---

5. Crear un README profesional

Ejemplo recomendado:

# Mis utilidades de automatización

Repositorio personal con scripts y herramientas creadas para:

- automatización de tareas
- monitorización
- administración de sistemas
- pruebas de red
- manipulación de logs

## Estructura
- bash/     → scripts Bash
- python/   → scripts Python
- docs/     → documentación extendida

## Uso
Cada script incluye instrucciones internas.  
Ejemplo:

./bash/healthcheck.sh servidor.txt

## Notas de seguridad
⚠️ No subir nunca contraseñas, claves privadas, tokens ni datos sensibles.

Commit y push:

git add README.md
git commit -m "Añade README profesional"
git push

---

6. Crear la Wiki del repositorio

Pestaña Wiki → Create the first page

Página recomendada:

Guía de inicio del repositorio

Contenido sugerido:

• Cómo clonar
• Cómo ejecutar los scripts
• Estándares internos
• Reglas para commits
• Explicación de carpetas

Luego puedes añadir otra página:

Plantilla de creación de scripts

---

7. Crear Issues para planificar mejoras

Ejemplos de Issues:

• “Crear script para revisar logs del sistema”
• “Añadir versión PowerShell del healthcheck”
• “Documentar mejores prácticas en Bash”
• “Script para probar puertos TCP en lote”
• “Refactorizar funciones de check_dns”

Esto demuestra orden y planificación profesional.

---

8. Crear tu primera Release (versión estable)

En GitHub → Releases → Draft a new release

Explicación rápida:

• Un tag marca una versión concreta del proyecto.
• Una release es una “foto” estable que puedes descargar o compartir.

Crea la v1.0:

• Tag: v1.0
• Title: “Primera versión estable”
• Descripción:
  • estructura base
  • scripts iniciales
  • documentación inicial

Publicar release.

---

9. Subir tu primer script real

Ejemplo: healthcheck.sh del curso de Bash.

Colócalo en:

bash/healthcheck.sh

Commit:

git add bash/healthcheck.sh
git commit -m "Añade script healthcheck inicial"
git push

---

10. Práctica guiada (30–40 minutos)

1. Crear estructura local
2. Crear README
3. Subir a GitHub
4. crear Wiki básica
5. Abrir 3 issues
6. Crear release v1.0
7. Subir un script real
8. Crear rama develop
9. Fusionar un cambio menor

Al terminar tendrás un proyecto estilo empresa real.

📘 Nota:
Esta práctica no enseña contenido nuevo:
solo ordena todo lo que aprendiste en este mini-tutorial para construir un proyecto completo.

---

11. Checklist del Día 7

• Repositorio profesional creado
• README completo
• Wiki creada
• Issues creados
• Release publicada
• Script real subido
• Flujo completo local ↔ GitHub
• Estructura clara
• Buenas prácticas aplicadas

Si está todo marcado → ¡Curso COMPLETADO!

---

⭐ Cierre del Mini Tutorial de Git & GitHub

Has aprendido a:

• trabajar con repositorios locales
• usar control de versiones real
• subir trabajo a GitHub
• entender push/pull
• crear ramas sin miedo
• resolver conflictos
• documentar correctamente
• usar Git desde terminal y VS Code
• crear repos profesionales con Wiki, Issues y Releases

Lo que has conseguido en solo 7 días es impresionante.
Tienes ahora un repositorio profesional que podrás usar toda tu vida técnica.

Este Mini-Tutorial no te convierte en experto…
pero sí te da la base sólida y práctica que cualquier sysadmin, devops o técnico de monitorización necesita desde el primer día.

Sigue creando, sigue versionando, sigue mejorando.
Tu caja de herramientas técnica acaba de nacer.

¡Nos vemos en el próximo Mini Tutorial de Emergencia!