Skip to main content

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.

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 contenedor de desarrollo 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 dev".

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 del navegador simple de VS Code que representa la aplicación web en la plantilla de React de GitHub.

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, vea «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. En la esquina superior izquierda de GitHub.com, selecciona y haz clic en **Codespaces ** para acceder a la página de “Tus codespaces” en github.com/codespaces.

  2. 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". "Ver todo" está resaltada con un contorno naranja oscuro.

  3. 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" de la página codespaces. Se muestran tres plantillas y los nombres de las plantillas se resaltan con contornos naranjas.

  4. En el nombre de la plantilla que deseas iniciar, haz clic en Usar esta plantilla.

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, vea «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 plantillas, consulta "Crear un repositorio desde una plantilla".

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

  2. 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 expandido para mostrar la opción "Abrir en un codespace".

    Nota: Si eres el responsable del mantenimiento del repositorio de plantillas y quieres confirmar los cambios en el propio repositorio, debes crear un codespace desde la lista desplegable Código. Para obtener más información, vea «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, vea «Apertura de un codespace existente».

Publicación en un repositorio en GitHub

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.

Nota: Si un codespace no publicado se factura actualmente a una organización, la publicación del codespace transfiere la propiedad y la facturación del codespace a tu cuenta personal. Para obtener más información, vea «Acerca de la facturación de GitHub Codespaces».

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.

    Captura de pantalla de la barra de actividad de VS Code con el botón Control de código fuente resaltado con un contorno naranja.

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

    Captura de pantalla de la barra lateral "Control de código fuente" con el botón de almacenamiento provisional (un signo más), a la derecha de "Cambios", resaltado con un contorno naranja oscuro.

    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, haga clic en Publicar en GitHub en la vista “Control de código fuente” y, luego, omita el 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.

    Captura de pantalla de la barra lateral "Control de código fuente" con un mensaje de confirmación y, debajo, el botón "Confirmar" resaltado con un contorno naranja oscuro.

  4. Haz clic en Publicar rama.

    Captura de pantalla de la barra lateral "Control de código fuente" que muestra el botón "Publicar rama".

  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 de nombre de repositorio en VS Code. Se muestran dos opciones para publicar en un repositorio privado o público.

    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 de un mensaje de confirmación de un repositorio publicado con éxito, que muestra el botón "Abrir en GitHub".

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. En la esquina superior izquierda de GitHub.com, selecciona y haz clic en **Codespaces ** para acceder a la página de “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 menú desplegable de un codespace, en la que se muestra la opció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 de la lista desplegable "Publicar en un nuevo repositorio", con el campo "Nombre", las opciones "Pública" y "Privada" y el botón "Crear repositorio".

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

Información adicional