¿Qué es un codespace?
Un codespace es un ambiente de desarrollo que se hospeda en la nube. Puedes personalizar tu proyecto para GitHub Codespaces confirmando los archivos de configuración en el repositorio (lo que se conoce a menudo como configuración como código). Esta acción crea una configuración de codespace repetible para todos los usuarios del proyecto.
Cada codespace que creas se hospeda en GitHub en un contenedor Docker, el cual se ejecuta en una máquina virtual. Puedes elegir entre una selección de tipos de máquina virtual que tienen desde 2 núcleos, 8 GB de RAM y 32 GB de almacenamiento hasta 32 núcleos, 64 GB de RAM y 128 GB de almacenamiento.
De forma predeterminada, los codespaces se crean a partir de una imagen de Ubuntu Linux que incluye una selección de lenguajes y herramientas populares, pero puedes usar una imagen basada en cualquier distribución de Linux y configurarla según tus requisitos específicos. Independientemente de tu sistema operativo local, el codespace se ejecutará en un entorno de Linux. Windows y MacOS no son sistemas operativos compatibles con el contenedor remoto.
Puedes conectarte a tus codespaces desde el explorador, desde Visual Studio Code, desde la aplicación de puerta de enlace de JetBrains o mediante GitHub CLI. Al conectarte, accedes directamente al contenedor Docker. No tienes acceso al host de máquina virtual de Linux externo.
Uso de GitHub Codespaces
Para comenzar a desarrollar utilizando recursos de cómputo basados en la nube, puedes crear un codespace desde una plantilla o cualquier rama o confirmación en un repositorio. Al crear un codespace a partir de una plantilla, puedes empezar desde una plantilla en blanco o elegir una plantilla adecuada para el trabajo que estás haciendo.
Para empezar a trabajar con GitHub Codespaces, consulta "Inicio rápido de 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 creaste, 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".
Uso de codespaces propiedad de tu cuenta personal
Todas las cuentas de GitHub.com tienen una cuota mensual de uso gratuito de GitHub Codespaces incluida en el plan Gratis o Pro. Puedes empezar a usar GitHub Codespaces en tu cuenta personal sin cambiar ninguna configuración ni proporcionar detalles de pago.
Si creas un codespace desde un repositorio propiedad de la organización, el uso del codespace se cobrará a la organización (si la organización está configurada para ello) o a tu cuenta personal.
Para seguir usando GitHub Codespaces más allá del almacenamiento y del uso de proceso mensuales incluidos, proporciona la información de pago y establece un límite de gasto. Para obtener más información, vea «Acerca de la facturación de GitHub Codespaces».
Uso de codespaces propiedad de la organización
Los propietarios de la organización pueden habilitar el uso de GitHub Codespaces, facturables a la organización o a la cuenta de empresa. Esto se aplica a codespaces creados a partir de repositorios propiedad de la organización. Para obtener más información, vea «Habilitación de GitHub Codespaces en la organización». Puedes establecer un límite de gasto para el uso de GitHub Codespaces en tu organización o cuenta empresarial. Para obtener más información, vea «Administración del límite de gasto para GitHub Codespaces».
Si el uso de un codespace va a facturarse a una organización o empresa, se muestra cuando se crea el codespace. Para obtener más información, vea «Creación de un codespace para un repositorio». Los codespaces que se facturan a una organización, o a su empresa matriz, son propiedad de la organización y pueden ser eliminados por un propietario de esta. Para obtener más información, vea «Borrar un codespace».
Your ability to create codespaces from organization-owned repositories depends on several factors, including the repository's visibility and the settings of the organization or its parent enterprise. For more information, see "Solucionar problemas de creación y borrado de codespaces."
Personalización de GitHub Codespaces
Para personalizar los runtimes y las herramientas del codespace, puedes crear una o varias configuraciones de contenedor de desarrollo para el repositorio. Agregar configuraciones de contenedor de desarrollo al repositorio permite definir una elección de diferentes entornos de desarrollo que sean adecuados para el trabajo que harán las personas en el repositorio.
Si creas un codespace desde un repositorio sin configuraciones de contenedor de desarrollo, GitHub Codespaces clonará tu repositorio en un entorno con la imagen de codespace predeterminada que incluye muchas herramientas, lenguajes y entornos en tiempo de ejecución. Si creas un codespace a partir de una plantilla, puedes empezar con alguna configuración inicial sobre la imagen predeterminada. Para obtener más información, vea «Introducción a los contenedores dev».
Puedes personalizar aspectos del entorno de codespace mediante un repositorio de dotfiles público. Puedes usar dotfiles para establecer alias y preferencias de shell, o para instalar tus preferencias personales de las herramientas que quieras usar. Si usas GitHub Codespaces en el explorador o en Visual Studio Code, puedes usar Settings Sync para proporcionar al editor de codespace la misma configuración, métodos abreviados de teclado, fragmentos de código y extensiones que has configurado en la instalación local de Visual Studio Code.
Para más información, consulta "Personalizar tu codespace".
Facturación para Codespaces
Para obtener información sobre precios, almacenamiento y uso de GitHub Codespaces, consulta "Acerca de la facturación de GitHub Codespaces".
Nota: Debes establecer un límite de gasto distinto de cero en tu cuenta personal, de organización o de empresa para que se pueda facturar a la cuenta por el uso de GitHub Codespaces.
De forma predeterminada, todas las cuentas tienen un límite de gasto de GitHub Codespaces de 0 USD. Esto impide que se creen codespaces o que se abran codespaces existentes, si esto supone que se incurra en un costo facturable para la cuenta personal, de organización o de empresa. En el caso de las cuentas personales, siempre se pueden crear y usar codespaces si la cuenta no ha alcanzado el límite de uso mensual incluido. En el caso de las organizaciones y las empresas, el límite de gasto predeterminado significa que, para que los usuarios puedan crear codespaces que se facturan a la organización, o a su empresa matriz, el límite debe cambiarse a un valor superior a 0 USD.
Los costes de GitHub Codespaces siempre se facturan mensualmente, incluso si la cuenta se factura anualmente. Para obtener información sobre cómo los propietarios de organizaciones y los administradores de facturación pueden controlar el límite de gasto de GitHub Codespaces en una organización, consulta "Administración del límite de gasto para GitHub Codespaces".