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 a partir de una plantilla

Si vas a iniciar un nuevo proyecto, puedes crear un codespace a partir de una plantilla en blanco o elegir una plantilla especialmente diseñada para el tipo de trabajo que deseas realizar.

Acerca de las plantillas para GitHub Codespaces

Si vas a iniciar un nuevo proyecto, puedes crear un codespace a partir de una plantilla para empezar con el trabajo de desarrollo rápidamente. Podrás trabajar en el proyecto en un entorno de desarrollo basado en la nube, guardar los archivos en la nube y publicar el trabajo en un nuevo repositorio remoto que puedes compartir con otros usuarios o clonar en la máquina local.

Nota: Los codespaces creados a partir de una plantilla, no a partir de un repositorio, siempre se facturan a tu cuenta personal. Para más información, consulta "Acerca de la facturación de GitHub Codespaces".

Puedes empezar con una plantilla en blanco, elegir entre las plantillas que mantiene GitHub para tecnologías populares como React o Jupyter Notebook, o iniciar un codespace desde cualquier repositorio de plantilla en GitHub. Con una plantilla en blanco, empezarás con un directorio vacío, con acceso a los recursos de proceso basados en la nube y a las herramientas, lenguajes y entornos en tiempo de ejecución que vienen preinstalados con la imagen de codespace predeterminada. Con otras plantillas, obtendrás archivos de inicio para la tecnología con la que estás trabajando y, normalmente, algunos archivos adicionales, como un archivo Léame, un archivo .gitignore y archivos de configuración de contenedor de desarrollo que contienen algunas opciones de configuración de entorno personalizadas. Para obtener más información sobre los contenedores de desarrollo y la imagen predeterminada, consulta "Introducción a los contenedores de desarrollo".

Por ejemplo, si creas un codespace a partir de la plantilla de React de GitHub, llegarás a un área de trabajo que contiene archivos de plantilla para una aplicación sencilla, como index.js, app.js y package.json. Poco después de que se abra el codespace, se iniciará automáticamente un servidor de desarrollo y podrás ver la aplicación en ejecución en una pestaña sencilla del explorador en el cliente web de VS Code.

Captura de pantalla de la plantilla de React que se ejecuta en un codespace

Los archivos y la configuración incluidos en las plantillas se definen en repositorios de plantilla. El repositorio de plantilla se clona en el codespace al crear el codespace. Después, se corta el vínculo y el codespace no se vincula a un repositorio remoto hasta que publicas en uno.

Sugerencia: Para ayudar a los usuarios a empezar a trabajar con el marco, la biblioteca u otro proyecto, puedes configurar un repositorio de plantilla para utilizarlo con GitHub Codespaces. Para obtener más información, consulta "Configuración de un repositorio de plantilla para GitHub Codespaces".

Creación de un codespace a partir de una plantilla de GitHub

Las plantillas que mantiene GitHub, incluida la plantilla en blanco, están disponibles en la página "Tus codespaces".

  1. Ves a la página "Tus codespaces" en github.com/codespaces. 1. Para ver la lista completa de plantillas, en "Explorar plantillas de inicio rápido", haz clic en Ver todo.

    Captura de pantalla de la sección "Explorar plantillas de inicio rápido", con la opción "Ver todo" resaltada

  2. Opcionalmente, para ver el repositorio de plantilla que contiene los archivos de una plantilla, haz clic en el nombre de la plantilla.

    Captura de pantalla de la sección "Explorar plantillas de inicio rápido", con la opción "React" resaltada

  3. En la plantilla que deseas iniciar, haz clic en Usar esta plantilla.

    Captura de pantalla de las plantillas de inicio rápido, con el botón "Usar esta plantilla" resaltado en la plantilla React

Al crear un nuevo codespace a partir de una plantilla, siempre se abre en el cliente web de Visual Studio Code. Puedes volver a abrir un codespace existente en cualquier editor compatible. Para obtener más información, consulta "Apertura de un codespace existente".

Creación de un codespace a partir de un repositorio de plantilla

Puedes crear un codespace a partir de cualquier repositorio de plantilla y, a continuación, publicar tu trabajo en un nuevo repositorio cuando estés a punto. Para obtener más información sobre los repositorios de plantilla, consulta "Crear un repositorio desde una plantilla".

  1. En GitHub.com, navega a la página principal del repositorio. 1. Haz clic en Usar esta plantilla y luego en Abrir en un codespace.

    Captura de pantalla del botón "Usar esta plantilla" y el menú desplegable

    Nota: Si eres el responsable del mantenimiento del repositorio de plantilla y deseas confirmar los cambios en el propio repositorio de plantilla, debes crear un codespace a partir de la lista desplegable Código. Para obtener más información, consulta "Creación de un codespace para un repositorio".

Al crear un nuevo codespace a partir de una plantilla, siempre se abre en el cliente web de Visual Studio Code. Puedes volver a abrir un codespace existente en cualquier editor compatible. Para obtener más información, consulta "Apertura de un codespace existente".

Publicación en un repositorio en GitHub Enterprise Cloud

Cuando trabajas en un codespace creado a partir de una plantilla, el trabajo se guarda en una máquina virtual en la nube, pero no se almacena en un repositorio en GitHub.

Puedes guardar tus archivos, cerrar y detener el codespace y retomar el trabajo más adelante. Normalmente, Git viene preinstalado y el directorio de trabajo se inicializará automáticamente como repositorio de Git a menos hayas empezado desde la plantilla en blanco de GitHub. Esto significa que puedes usar Git de inmediato para el control de código fuente local, como la adición y la confirmación de archivos.

Sin embargo, si eliminas un codespace no publicado o si se elimina automáticamente al no usarse durante el período de retención, tu trabajo también se eliminará. Para conservar el trabajo y permitir que otros usuarios trabajen en el proyecto, deberás publicar el codespace en un repositorio en GitHub.

Publicación desde VS Code

Si estás trabajando en un codespace, podrás publicarlo desde la aplicación de escritorio o el cliente web de VS Code.

  1. En la barra de actividad, haga clic en la vista Control de código fuente. Vista de control de código fuente

  2. Para agregar los cambios al "stage", haz clic en + junto al archivo que hayas añadido o cambiado o junto a Cambios si has cambiado varios archivos y quieres agregarlos todos al "stage".

    Barra lateral de control de código fuente con el botón de almacenamiento provisional resaltado

    Nota: Si empiezas desde una plantilla en blanco de GitHub, no verás una lista de cambios a menos que ya hayas inicializado el directorio como repositorio de Git. Para publicar codespaces creados a partir de la plantilla en blanco, haz clic en Publicar en GitHub en la vista Control de código fuente y, luego, ve al paso 5.

  3. Para confirmar los cambios agregados al "stage", escribe un mensaje de confirmación en el que se describa el cambio realizado y, a continuación, haz clic en Confirmar.

    Barra de control de código fuente con un mensaje de confirmación

  4. Haz clic en Publicar rama.

    Captura de pantalla del botón "Publicar rama" en VS Code

  5. En la lista desplegable "Nombre del repositorio", escribe un nombre para el nuevo repositorio y selecciona Publicar en el repositorio privado GitHub o Publicar en el repositorio público GitHub .

    Captura de pantalla de la lista desplegable "Nombre del repositorio" en VS Code

    El propietario del nuevo repositorio será la cuenta GitHub con la que creaste el codespace.

  6. También puedes hacer clic en Abrir en GitHub en el elemento emergente que aparece en la esquina inferior derecha del editor para ver el nuevo repositorio en GitHub.com.

    Captura de pantalla del elemento emergente "Abrir en GitHub" en VS Code

Cuando se publica un codespace, tienes acceso a una mayor variedad de opciones para personalizar tu experiencia de GitHub Codespaces. Por ejemplo, se puede:

Publicación desde GitHub.com

Puedes publicar un codespace no publicado desde la página "Tus codespaces" en GitHub.com. Esto resulta útil si deseas publicar un codespace que no tienes abierto actualmente en el explorador. Si lo haces, el trabajo se conservará en un repositorio, pero no habrá un vínculo entre el codespace existente y el nuevo repositorio. Sin embargo, puedes ir al nuevo repositorio y crear un codespace desde allí, y este codespace estará conectado al repositorio.

  1. Ves a la página "Tus codespaces" en github.com/codespaces.

  2. Junto al codespace no publicado, haz clic en los puntos suspensivos ( ... ) y selecciona Publicar en un nuevo repositorio.

    Captura de pantalla del botón "Publicar en un nuevo repositorio"

  3. Elige un nombre para el nuevo repositorio, establécelo como Público o Privado y haz clic en Crear repositorio.

    Captura de pantalla del menú desplegable "Publicar en un nuevo repositorio"

  4. Opcionalmente, para ver el nuevo repositorio, haz clic en Ver repositorio.

Información adicional