Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.

Creación de un codespace para un repositorio

Puedes crear un codespace para una rama en un repositorio para desarrollar en línea.

Acerca de la creación de un codespace para un repositorio

Puedes crear un codespace en GitHub.com, en Visual Studio Code o utilizando el GitHub CLI. Usa las pestañas de este artículo a fin de mostrar instrucciones para cada una de estas formas de crear un codespace.

Si vas a iniciar un nuevo proyecto, es posible que desees crear un codespace a partir de una plantilla y publicar en un repositorio en GitHub Enterprise Cloud más tarde. Para obtener más información, consulta "Creación de un codespace a partir de una plantilla".

Nota: Si usas un IDE de JetBrains, puedes usar la GitHub CLI para crear un codespace. Después, puedes usar la aplicación de Puerta de enlace de JetBrains para abrir el codespace en un IDE de JetBrains. Para obtener más información, consulta "Uso de codespaces en el IDE de JetBrains".

Puedes usar GitHub Codespaces en tu cuenta personal del GitHub.com, con la cuota de uso gratuito incluido cada mes para las cuentas de los planes Gratis y Pro. 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".

Las organizaciones pueden permitir que los miembros y colaboradores externos creen y usen codespaces a costa de la organización. Para más información, consulta "Habilitación de GitHub Codespaces para la organización".

Cada codespace que crees está únicamente disponible para ti. Nadie más puede trabajar en tu codespace.

Si creas un codespace desde un repositorio, este se asociará a una rama específica, que no puede estar vacía. Puedes crear más de un codespace por repositorio o incluso por rama.

Puede ver todos los codespaces disponibles que ha creado en github.com/codespaces.

Proceso de creación de codespace

Cuando creas un codespace, se suscitan varios pasos para crear y conectarte a tu ambiente de desarrollo:

  • Paso 1: se le asignan una MV y almacenamiento a tu codespace.
  • Paso 2: Se crea el contenedor y se clona tu repositorio.
  • Paso 3: Puedes conectarte al codespace.
  • Paso 4: El codespace sigue con la configuración post-creación.

Para más información sobre lo que sucede al crear un codespace, vea "Análisis en profundidad".

Para obtener más información sobre el ciclo de vida de un codespace, consulta "Ciclo de vida del codespaces".

Si quieres usar enlaces de Git para el codespace, debes configurarlos mediante los scripts de ciclo de vida devcontainer.json, como postCreateCommand. Estos se ejecutan durante el paso 4 anterior. Para obtener más información sobre los scripts de ciclo de vida, consulta la especificación de los contenedores de desarrollo en el sitio web de los contenedores de desarrollo. Como el contenedor de codespace se crea después de clonar el repositorio, cualquier directorio de plantilla de Git configurado en la imagen de contenedor no se aplicará al codespace. En su lugar, deben instalarse los ganchos después de que se crea el codespace.

Puedes editar código, depurar y utilizar comandos de Git mientras desarrollas en un codespace con VS Code. Para más información, consulta la documentación de VS Code.

Para acelerar la creación de codespaces, los administradores de repositorios pueden habilitar precompilaciones de GitHub Codespaces para un repositorio. Para más información, consulta "Acerca de las precompilaciones de GitHub Codespaces".

Creación de un codespace para un repositorio

  1. En GitHub.com, navega a la página principal del repositorio.

  2. Debajo del nombre de repositorio, utiliza el menú desplegable "Rama" y selecciona aquella en la que quieras crear un codespace.

    Menú desplegable Rama

  3. Haz clic en el botón Código y , a continuación, haz clic en la pestaña Codespaces.

    Botón de codespace nuevo

    Si los codespaces de este repositorio son facturables a una organización o a su empresa matriz, debajo del botón Crear codespace en RAMA verás un mensaje que indica quién pagará el codespace.

  4. Crea el codespace, ya sea con las opciones predeterminadas o después de configurar las opciones avanzadas:

    • Uso de las opciones predeterminadas

      Para crear un codespace con las opciones predeterminadas, haz clic en el signo más (). Como alternativa, si actualmente no tienes ningún codespace para este repositorio, puedes hacer clic en Crear codespace en RAMA.

    • Configurar opciones

      Para configurar opciones avanzadas para el codespace, como un tipo de máquina diferente o un archivo determinado devcontainer.json:

      1. Haz clic en los puntos suspensivos ( ... ) de la parte superior derecha de la pestaña Codespaces y selecciona Nuevo con opciones.

        Visualización del tipo de máquina predeterminado

      2. En la página de opciones del codespace, elige tus opciones preferidas en los menús desplegables.

        Página de opciones de codespaces

        Notas

      3. Haga clic en Crear codespace.

Después de conectar tu cuenta de GitHub.com a la extensión de GitHub Codespaces, puedes crear un codespace. Para obtener más información sobre la extensión de GitHub Codespaces, consulta el VS Code Marketplace.

  1. En VS Code, en la barra lateral izquierda, haz clic en el icono de Explorador Remoto.

    El icono de Remote Explorer (Explorador remoto) en Visual Studio Code

    Nota: Si el Explorador remoto no se muestra en la barra de actividad:

    1. Abra la paleta de comandos. Por ejemplo, presionando el Comando+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux).
    2. Escriba: codespaces.
    3. Haz clic en Codespaces: Detalles.
  2. Haz clic el icono de Agregar: .

    Opción para crear un codespace en GitHub Codespaces

  3. Escribe el nombre del repositorio en el que quieres desarrollar y selecciónalo.

    Búsqueda de un repositorio para crear un codespace

    Si el repositorio que eliges es propiedad de una organización y esta ha configurado los codespaces de este repositorio de modo que se facturen a la organización o a su empresa principal, en los mensajes posteriores se indicará quién paga el codespace.

  4. Da clic en la rama en la que quieras desarrollar.

    Búsqueda de una rama para crear un codespace

  5. Si se te pide que elijas un archivo de configuración de contenedor de desarrollo, selecciona un archivo en la lista.

    Selección del archivo de configuración de un contenedor de desarrollo para GitHub Codespaces

  6. Elige el tipo de máquina que quieres utilizar.

    Tipos de instancia para un nuevo codespace

    Nota: La elección de los tipos de máquina disponibles puede estar limitada por varios factores. Estos pueden incluir una directiva configurada para la organización o una especificación mínima del tipo de máquina para el repositorio. Para más información, vea "Restricción del acceso a los tipos de máquina" y "Configuración de una especificación mínima para las máquinas de los codespaces".

Para obtener más información sobre GitHub CLI, vea "Acerca de GitHub CLI".

Para crear un codespace, use el subcomando gh codespace create.

gh codespace create

Se te pedirá que elijas un repositorio. Si los codespaces de este repositorio son facturables a una organización o a su empresa matriz, se muestra un mensaje que indica quién pagará el codespace. Luego, se te pedirá que elijas una rama, un archivo de configuración de contenedor de desarrollo (si hay más de uno disponible) y un tipo de máquina (si hay más de uno disponible).

Como alternativa, puedes utilizar marcadores para especificar algunas o todas las opciones:

gh codespace create -r OWNER/REPO -b BRANCH --devcontainer-path PATH -m MACHINE-TYPE

En este ejemplo, reemplaza owner/repo por el identificador del repositorio. Reemplace a branch por el nombre de la rama o el hash SHA completo de la confirmación que quiera que se extraiga inicialmente en el codespace. Si usa la marca -r sin la marca b, el codespace se crea a partir de la rama predeterminada.

Reemplaza path por la ruta de acceso al archivo de configuración de contenedor de desarrollo que desees usar para el nuevo codespace. Si omites este marcador y hay más de un tipo de archivo de contenedor de desarrollo disponible, se te pedirá que lo elijas en una lista. Para obtener más información sobre el archivo de configuración de contenedor de desarrollo, consulta "Introducción a los contenedores de desarrollo".

Reemplace machine-type por un identificador válido para un tipo de máquina disponible. Los identificadores son cadenas como: basicLinux32gb y standardLinux32gb. El tipo de máquinas que están disponibles depende del repositorio, la cuenta personal y la ubicación. Si ingresas un tipo de máquina no disponible o inválido, los tipos disponibles se mostrarán en el mensaje de error. Si omites este marcador y hay más de un tipo de máquina disponible, se te pedirá elegirlo de una lista.

Para obtener los detalles completos de las opciones de este comando, consulta el manual de GitHub CLI.

Información adicional