Skip to main content

Uso de GitHub Codespaces con GitHub Classroom

Puedes usar GitHub Codespaces como editor preferido en tus asignaciones para dar a los alumnos acceso a un entorno de Visual Studio Code basado en explorador con una configuración con un solo clic.

Who can use this feature

Organization owners who are admins for a classroom can enable GitHub Codespaces for their organization and integrate GitHub Codespaces as the supported editor for an assignment. Para obtener más información sobre los administradores de aulas, consulte "Acerca de la administración de aulas".

GitHub Codespaces está disponible para su uso con GitHub Classroom para las organizaciones que usan GitHub Team. Para saber si tienes derecho a una mejora gratuita de GitHub Team, consulta «Solicitar acceso al GitHub Global Campus como profesor».

Acerca de GitHub Codespaces

GitHub Codespaces es un entorno de desarrollo instantáneo basado en la nube que usa un contenedor para proporcionar lenguajes comunes, herramientas y utilidades para el desarrollo. GitHub Codespaces también es configurable, lo cual te permite crear un entorno de desarrollo personalizado que sea igual para todos los usuarios del proyecto. Para obtener más información, consulta "Introducción a GitHub Codespaces".

Una vez que GitHub Codespaces esté habilitado en una organización o empresa, los usuarios podrán crear un codespace desde cualquier rama o confirmación de un repositorio de la organización o empresa y empezar a desarrollar mediante el uso de recursos de proceso basados en la nube. Puedes conectarte a un codespace desde el explorador o localmente mediante Visual Studio Code.

Para empezar a trabajar con GitHub Codespaces, consulta "Inicio rápido de GitHub Codespaces". Para obtener más información sobre cómo crear un codespace, consulta "Creación de un codespace para un repositorio" o "Creación de un codespace a partir de una plantilla". Si quieres volver a un codespace que has creado, consulta "Apertura de un codespace existente". Para obtener más información sobre cómo funciona GitHub Codespaces, consulta "Profundización en GitHub Codespaces".

El establecimiento de GitHub Codespaces como editor preferido para una asignación de GitHub Classroom resulta beneficioso tanto para los alumnos como para los profesores. GitHub Codespaces es una buena opción para los alumnos que usan dispositivos prestados o sin acceso a una configuración del IDE local, ya que cada codespace está basado en la nube y no requiere ninguna configuración local. Los alumnos pueden iniciar un codespace para un repositorio de tareas en Visual Studio Code directamente en el explorador y empezar a desarrollar inmediatamente sin necesidad de ninguna configuración adicional.

En el caso de las tareas con entornos de configuración complejos, los profesores pueden personalizar la configuración del contenedor de desarrollo para los codespaces de un repositorio. Esto garantiza que, cuando un alumno cree un codespace, se abra automáticamente con el entorno de desarrollo que haya configurado el profesor. Para obtener más información sobre los contenedores de desarrollo, vea "Introducción a los contenedores de desarrollo".

Nota: Los codespaces individuales se eliminan automáticamente si se detienen y dejan sin usar durante un período prolongado. Para más información, consulta "Configuración de la eliminación automática de los codespaces".

Los alumnos verificados obtienen el uso gratuito de GitHub Codespaces hasta 180 horas básicas cada mes para sus cuentas personales. La cantidad mensual de almacenamiento y horas de uso del núcleo disponibles para los alumnos equivale a la cantidad incluida en las cuentas GitHub Pro. Para más información, consulta "Acerca de la facturación de GitHub Codespaces".

Nota: Si los alumnos usan GitHub Codespaces en sus repositorios de asignaciones para GitHub Classroom, el uso se cobrará a la organización propietaria del aula y no afectará al uso de la cuenta personal de un alumno.

Acerca de la ventaja Codespaces Education para profesores verificados

La ventaja Codespaces Education proporciona a los profesores verificados una asignación mensual gratuita de GitHub Codespaces horas para su uso en GitHub Classroom. Se estima que la asignación gratuita es suficiente para una clase de 50 alumnos con cinco tareas al mes, en una máquina de dos núcleos con un codespace almacenado por alumno.

Nota: la prestación de Educación Codespaces se encuentra actualmente en versión beta pública y está sujeta a cambios. Durante la versión beta, tu organización no deberá pagar si supera la concesión gratuita.

Si quieres convertirte en un profesor verificado, debes contar con aprobación para obtener una ventaja para educadores o profesores. Para obtener más información, consulta «Solicitar acceso al GitHub Global Campus como profesor».

Una vez que hayas confirmado que eres un profesor verificado, visita GitHub Global Campus para profesores con el fin de actualizar la organización a GitHub Team. Para obtener más información, consulta "Productos de GitHub".

Si cumples los requisitos para obtener la ventaja Codespaces Education al habilitar GitHub Codespaces en GitHub Classroom para la organización, GitHub agrega automáticamente una directiva de codespace para restringir los tipos de máquina de todos los codespaces de la organización a dos máquinas principales. Esto ayuda a aprovechar al máximo el uso gratuito deGitHub Codespaces. De todos modos, puedes cambiar o quitar estas directivas en la configuración de la organización. Para obtener más información, consulte "Restringir el acceso a los tipos de máquina".

Cuando la ventaja Codespaces Education deje de estar en versión beta, si tu organización supera su asignación gratuita para el uso de GitHub Codespaces, se te facturará por el uso adicional. Para más información, consulta "Acerca de la facturación de GitHub Codespaces".

Habilitar los Codespaces para tu organización

GitHub Codespaces está disponible para su uso con GitHub Classroom para las organizaciones que usan GitHub Team. Si cumples los requisitos para obtener la ventaja Codespaces Education, debes habilitar GitHub Codespaces mediante GitHub Classroom, en lugar de hacerlo directamente en la configuración de la organización. De lo contrario, se facturará a la organización directamente por todo el uso de GitHub Codespaces.

Habilitación de Codespaces para una organización al crear un aula

  1. Inicia sesión en GitHub Classroom.

  2. Haga clic en New classroom.

    Botón "Aula nueva"

  3. En la lista de organizaciones, da clic en aquella que te gustaría utilizar para tu aula. Las organizaciones que cumplan los requisitos de GitHub Codespaces incluirán una nota en la que se indique. Opcionalmente, puedes crear una organizción nueva. Para más información, vea consulte "Creación de una organización desde cero".

    Selección de una organización para el aula que cumple los requisitos de Codespaces

  4. En la página "Asigna un nombre al aula", en "Codespaces en el aula", haz clic en Habilitar. Ten en cuenta que esto habilitará GitHub Codespaces para todos los repositorios y usuarios de la organización.

    Habilitación de Codespaces para la organización en la página "Configuración de los aspectos básicos del aula"

  5. Cuando esté todo listo para la creación del aula, haz clic en Crear aula.

Habilitación de Codespaces para una organización mediante un aula existente

  1. Inicia sesión en GitHub Classroom. 1. En la lista de aulas, da clic en aquella que quieras ver. Aula en la lista de aulas de una organización 1. Debajo del nombre del aula, haz clic en Configuración. Pestaña "Settings" (Configuración) para el aula

  2. En "GitHub Codespaces", haz clic en Habilitar. Esto habilitará GitHub Codespaces para todos los repositorios y usuarios de la organización. También se agrega una nueva directiva de Codespaces para restringir los tipos de máquina de todos los codespaces de la organización a dos máquinas principales.

    Habilitación de Codespaces para la organización en la configuración del aula existente

También puedes usar los mismos métodos que antes para deshabilitar GitHub Codespaces para la organización. Ten en cuenta que esto deshabilitará GitHub Codespaces para todos los usuarios y repositorios de la organización.

Configuración de una tarea para usar Codespaces

Si quieres que los alumnos tengan GitHub Codespaces disponible para una asignación, puedes seleccionar GitHub Codespaces como editor compatible para la asignación. Al crear una tarea, en la página "Agregar el código de inicio y elegir el IDE en línea opcional", en "Agregar un editor compatible", selecciona GitHub Codespaces en el menú desplegable.

Selección de Codespaces como editor compatible para la tarea

Si usas un repositorio de plantillas para una tarea, puedes definir un contenedor de desarrollo en el repositorio para personalizar las herramientas y los entornos de ejecución disponibles para los alumnos cuando inician un codespace para trabajar en la tarea. Si no defines un contenedor de desarrollo, GitHub Codespaces usará una configuración predeterminada, que contiene muchas de las herramientas comunes que los alumnos podrían necesitar para el desarrollo. Para obtener más información sobre cómo definir un contenedor de desarrollo, consulta "Incorporación de una configuración de contenedor de desarrollo en el repositorio".

Inicio de una asignación mediante GitHub Codespaces

Cuando un alumno abre una tarea, el archivo LÉAME del repositorio indica qué IDE recomienda el profesor para el trabajo.

Captura de pantalla de la nota de Codespaces en el archivo LÉAME sobre el repositorio de la tarea de los alumnos

Los alumnos pueden iniciar un codespace nuevo o existente haciendo clic en el botón Abrir en GitHub Codespace en el archivo LÉAME, o haciendo clic en el botón Código en la página principal del repositorio de asignaciones, luego seleccione la pestaña Codespaces. En la pestaña Codespaces puede seleccionar un codespace existente o crear uno nuevo. Para obtener más información, consulta "Creación de un codespace para un repositorio".

Inicio de un nuevo codespace en el repositorio de tareas

Los profesores pueden ver el codespace de cada alumno para una tarea en la página de información general de la tarea. Puedes hacer clic en el icono Codespaces a la derecha de la fila de cada alumno para iniciar el codespace.

Información general de tareas del profesor con los codespaces de los alumnos

Cuando te conectes a un codespace a través de un explorador, se habilitará automáticamente el guardado automático. Si quieres guardar los cambios en el repositorio, deberás confirmar los cambios e insertarlos en una rama remota. Si dejas que el codespace se ejecute sin interacción durante 30 minutos de forma predeterminada, el tiempo de espera se agotará y el codespace dejará de ejecutarse. Los datos se conservarán desde la última vez que hayas realizado un cambio. Para obtener más información sobre el ciclo de vida de un codespace, consulta "Ciclo de vida de un codespace".