Acerca de GitHub Codespaces
GitHub Codespaces es un entorno de desarrollo instantáneo basado en la nube que usa un contenedor para proporcionarle lenguajes comunes, herramientas y utilidades para el desarrollo. GitHub Codespaces también es configurable, lo que permite crear un entorno de desarrollo personalizado que sea el mismo para todos los usuarios del proyecto. Consulta Inicio rápido para GitHub Codespaces.
Una vez que GitHub Codespaces está habilitado en una organización o empresa, los usuarios pueden crear un espacio de código a partir de cualquier rama o confirmación en un repositorio de la organización o empresa y comenzar a desarrollar utilizando recursos informáticos basados en la nube. Puede conectarse a un espacio de código desde el explorador o localmente mediante Visual Studio Code.
Para empezar a trabajar con GitHub Codespaces, consulta Inicio rápido para GitHub Codespaces. Para 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 ya has creado, consulta Apertura de un codespace existente. Para más información sobre cómo funciona GitHub Codespaces, consulta Análisis en profundidad de GitHub Codespaces.
Configurar GitHub Codespaces como editor preferido para una tarea en las asignaciones de GitHub Classroom es beneficioso tanto para los estudiantes 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 espacio de código está basado en la nube y no requiere ninguna configuración local. Los alumnos pueden iniciar un espacio de código para un repositorio de asignaciones directamente en Visual Studio Code su 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 más información sobre contenedores de desarrollo, consulta Introducción a los contenedores dev.
Nota:
Los codespaces individuales se eliminan automáticamente si se detienen y se dejan sin usar durante un tiempo prolongado. Consulta Configuración de la eliminación automática de los codespaces.
Los estudiantes verificados pueden utilizar GitHub Codespaces de forma gratuita, hasta un máximo de 180 horas de núcleo al mes, en sus cuentas personales. La cantidad mensual de almacenamiento y las horas de uso del núcleo de las que disponen los estudiantes equivalen a la cantidad incluida en las cuentas GitHub Pro. Para más información, consulta 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.
Información sobre el Codespaces beneficio educativo para docentes verificados
La ventaja Codespaces Educación ofrece a los profesores verificados una asignación mensual gratuita de GitHub Codespaces horas para utilizar 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 ventaja de Codespaces Education se encuentra actualmente en versión preliminar pública y está sujeta a cambios. Durante la versión versión preliminar pública, su 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. Consulta Envío de solicitud a GitHub Education como profesor.
Una vez que tengas la confirmación de que eres un profesor verificado, visita GitHub EducationPara profesores para actualizar la organización a GitHub Team. Consulte Productos de GitHub.
Si cumples los requisitos para la ventaja Codespaces Educación, cuando habilites GitHub Codespaces en GitHub Classroom para tu organización, GitHub añadirá automáticamente una directiva de espacios de código para restringir los tipos de máquina de todos los espacios de código de la organización a máquinas de 2 núcleos. Esto le ayuda a aprovechar al máximo el uso gratuito GitHub Codespaces . De todos modos, puedes cambiar o quitar estas directivas en la configuración de la organización. Consulta Restringir el acceso a los tipos de máquina.
Cuando el beneficio Codespaces Educación deje de estar disponible en versión preliminar pública, si tu organización supera su asignación gratuita para el uso de GitHub Codespaces, se le facturará el uso adicional. Consulta facturación de GitHub Codespaces.
Activación de Codespaces para su organización
GitHub Codespaces está disponible para su uso con GitHub Classroom para organizaciones que usan GitHub Team. Si cumples los requisitos para el beneficio Codespaces Educación, debes habilitar GitHub Codespaces a través de GitHub Classroom, en lugar de habilitarlo directamente en la configuración de tu organización. De lo contrario, se le facturará directamente a su organización por todo el uso de GitHub Codespaces.
Habilitación de Codespaces para una organización al crear un aula
- Inicia sesión en GitHub Classroom.
- En el lado derecho de la página, haga clic en Nueva aula.
- En la lista de organizaciones, da clic en aquella que te gustaría utilizar para tu aula. Las organizaciones que son aptas para GitHub Codespaces tendrán una nota que muestra que son elegibles. Opcionalmente, puedes crear una organizción nueva. Consulta Crear una organización nueva desde cero.
- En la página "Ponle nombre a tu aula", en "Codespaces en tu aula", haga clic en Activar. Tenga en cuenta que esto habilitará GitHub Codespaces para todos los repositorios y usuarios de la organización.
- 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
-
Inicia sesión en GitHub Classroom.
-
En la lista de aulas, da clic en aquella que quieras ver.
-
Debajo del nombre del aula, haz clic en Settings.
-
En "GitHub Codespaces", haga 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.
También puede usar los mismos métodos mencionados anteriormente para deshabilitar GitHub Codespaces para su organización. Tenga en cuenta que esto deshabilitará GitHub Codespaces para todos los usuarios y repositorios de la organización.
Configurar una asignación para usar Codespaces
Para poner GitHub Codespaces a disposición de los alumnos para una tarea, puede elegir GitHub Codespaces como editor compatible para la tarea. Al crear una nueva asignación, en la página "Agregar el código de inicio y elegir el IDE en línea opcional", en "Agregar un editor compatible", seleccione GitHub Codespaces en el menú desplegable.
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 define 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 más información sobre cómo definir un contenedor de desarrollo, consulta Incorporación de una configuración de contenedor de desarrollo al 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.
Los alumnos pueden iniciar un espacio de código nuevo o existente haciendo clic en el botón Abrir en GitHub Codespace del archivo LÉAME, o haciendo clic en el botón Código de la página principal del repositorio de asignaciones y seleccionando la pestaña Codespaces. En la pestaña Codespaces puede seleccionar un espacio de código existente o crear uno nuevo. Consulta Creación de un codespace para un repositorio.
Los profesores pueden ver el codespace de cada alumno para una tarea en la página de resumen de la tarea. Puedes hacer clic en el icono Codespaces a la derecha de la fila de cada alumno para iniciar el codespace.
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 más información sobre el ciclo de vida de un codespace, consulta Ciclo de vida de un codespace.