Skip to main content

Resumen de GitHub Codespaces

En esta guía se presenta GitHub Codespaces y se proporcionan detalles de cómo funciona y cómo usarlo.

¿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 se ejecuta en una máquina virtual hospedada por GitHub. Puedes elegir el tipo de máquina que deseas usar, en función de los recursos que necesites. Hay disponibles varios tipos de máquina, empezando por un procesador de 2 núcleos, 4 GB de RAM y 32 GB de almacenamiento.

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.

Un diagrama que muestra cómo funciona GitHub Codespaces

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 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".

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.

Puedes crear y usar un codespace para cualquier repositorio que puedas clonar. También puedes usar una plantilla para crear codespaces que no estén asociados inicialmente a un repositorio. 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. Los codespaces creados a partir de plantillas siempre se cobran 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 más información, consulta "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 más información, consulta "Habilitación de GitHub Codespaces para la organización". Puedes establecer un límite de gasto para el uso de GitHub Codespaces en tu organización o cuenta empresarial. Para más información, consulta "Administración de los límites 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, consulta "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 más información, vea "Eliminación de un codespace".

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, consulte "Introducción a los contenedores de desarrollo".

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, vea "Personalización del codespace".

Facturación para Codespaces

Para obtener más información sobre los precios, el almacenamiento y el 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.

Costs for GitHub Codespaces are always billed monthly, even if your account is otherwise billed annually. Para obtener información sobre cómo los propietarios de las organizaciones y los administradores de facturación pueden controlar el límite de gasto de GitHub Codespaces en una organización, consulta "Administración de los límites de gasto de GitHub Codespaces".