Como usar Codespace

GitHub Codespace es un entorno de desarrollo que corre directamente en el navegador, con Java, Maven, Tomcat y la base de datos ya configurados. No necesitas instalar nada en tu computadora.

---

1. Abrir el Codespace desde la wiki

En cada página de la wiki que tiene código Java vas a ver este banner al principio:

📦 Proyecto: mini-crud-sql (Tema 3 — JDBC + MySQL) — ⬇️ Descargar ZIP · ☁️ Abrir en Codespace

Haz clic en ☁️ Abrir en Codespace.

Se abre una pantalla de GitHub. Haz clic en Create new codespace:

⏳ La primera vez tarda 2 a 3 minutos mientras instala Maven, MariaDB y Tomcat automáticamente.

---

2. Abrir la terminal si no está abierta

Cuando cargue VS Code en el navegador, abre la terminal con:

Ctrl + ` (la tecla del acento grave, abajo a la izquierda)

O desde el menú: Terminal → New Terminal

Para verificar si todo corre normal, ejecuta lo que ves en la siguiente imagen:

---

3. Correr el proyecto

En la terminal escribe:

run

Maven compila el proyecto y arranca Tomcat 10 automáticamente. Cuando veas una línea como:

INFO: Starting Coyote HTTP/1.1 on http-8080

...la app está lista en el puerto 8080.

---

4. Abrir la app en el navegador

Codespaces va a mostrar una notificación azul abajo a la derecha para abrir el puerto 8080. Haz clic en Open in Browser.

Si no aparece la notificación, ve a la pestaña Ports en el panel inferior y haz clic en el 🌐 del puerto 8080.

La URL que se abre muestra la página de inicio de Tomcat. Agrega el nombre del proyecto al final:

Proyecto	URL a agregar
mini-crud0	/mini-crud0
mini-crud1	/mini-crud1
mini-crud-sql	/mini-crud-sql
mini-crud-alumno-sql	/mini-crud-alumno-sql

Por ejemplo:

https://xxxx-8080.app.github.dev/mini-crud-sql

---

5. Explorar y editar el código

El código del proyecto está en src/main/java/. Puedes abrirlo desde el explorador de archivos de VS Code (panel izquierdo).

Cada vez que modifiques algo, presiona Ctrl+C en la terminal para detener Tomcat, y vuelve a correr:

run

⚠️ Importante: los cambios no se guardan solos en GitHub

Editar código en el Codespace no actualiza automáticamente la página de GitHub, ni al revés. Son dos copias separadas hasta que las sincronices a mano:

• Codespace → GitHub: si modificas algo en el Codespace y quieres que quede guardado en el repositorio, hay que hacer en la terminal:

  git add .
  git commit -m "describe brevemente el cambio"
  git push

• GitHub → Codespace: si editaste algo directo en GitHub (por ejemplo desde el navegador) mientras tenías un Codespace abierto, hay que traer ese cambio con:

  git pull

Sobre quién puede modificar tus archivos:

Cualquiera puede abrir un Codespace desde el link de la wiki y probar el proyecto. Pero si esa persona no es colaboradora de tu repositorio, sus cambios nunca llegan al tuyo: GitHub los redirige automáticamente a una copia (fork) propia de esa persona. Tu código queda protegido, a menos que la agregues explícitamente como colaboradora en Settings → Collaborators.

---

6. Volver a usar un Codespace que ya creaste

Los Codespaces se guardan automáticamente. Si cerraste el navegador y quieres volver:

1. Ve a github.com/codespaces
2. Haz clic en el Codespace que creaste antes

Al abrirse, solo necesitas correr:

run

MariaDB arranca sola. run recompila y levanta Tomcat en un solo comando.

---

7. Comandos disponibles

Comando	¿Qué hace?
run	Compila el proyecto y arranca Tomcat 10 en el puerto 8080
mysql-escuela	Abre la consola de MariaDB en la base de datos escuela
Ctrl+C	Detiene Tomcat (en la terminal donde corre run)

---

8. Ver errores

Los errores aparecen directamente en la terminal donde corre run. Si la app no responde, revisa el output en esa misma terminal.

---

← Preparación del entorno Java Web · 🏠 Inicio · Introducción a la Web →