Skip to main content

Utilizar el control de código fuente en tu codespace

Después de hacer cambios en un archivo de tu codespace, puedes confirmar los cambios rápidamente y subir tu actualización al repositorio remoto.

Nota: El uso de GitHub Codespaces con un IDE de JetBrains se encuentra actualmente en versión beta pública y está sujeto a cambios.

Sobre el control de código fuente en GitHub Codespaces

Puedes llevar a cabo todas las acciones de Git que necesites directamente dentro de tu codespace. Por ejemplo, puedes recuperar cambios del repositorio remoto, cambiar de rama, crear una rama nueva, confirmar y subir cambios y crear solicitudes de cambios. Puedes utilizar la terminal integrada dentro de tu codespace para ingresar comandos de Git o puedes hacer clic en los iconos u opciones de menú para completar las tareas más comunes de Git. Esta guía te explica cómo utilizar la interface de usuario gráfica para el control de código fuente.

Para obtener más información sobre la compatibilidad con Git en Visual Studio Code, consulta "Uso del control de versiones en VS Code" en la documentación de Visual Studio Code.

El control de código fuente del cliente web de Visual Studio Code usa el mismo flujo de trabajo que la aplicación de escritorio de Visual Studio Code. Para obtener más información, consulta "Uso del control de versiones en VS Code" en la documentación de Visual Studio Code.

Un flujo de trabajo típico para actualizar un archivo utilizando GitHub Codespaces sería:

  • Desde la rama predeterminada de tu repositorio en GitHub, crea un codespace. Consulta "Creación de un codespace para un repositorio".
  • En tu codespace, crea una rama nueva para trabajar en ella.
  • Haz tus cambios y guárdalos.
  • Confirme el cambio.
  • Levanta una solicitud de cambios.

Acerca de la bifurcación automática

Puedes crear un codespace para cualquier repositorio al que tengas acceso de escritura. Si solo tienes acceso de lectura a un repositorio, puedes crear un codespace para el repositorio siempre que puedas bifurcarlo.

No es necesario bifurcar el repositorio antes de crear el codespace. Por ejemplo, puedes crear un codespace desde el repositorio para examinar el proyecto y realizar cambios experimentales y, a continuación, eliminar el codespace si ya no lo necesitas.

Si realizas una confirmación desde el codespace, GitHub Codespaces crea una bifurcación del repositorio en tu cuenta y la vincula al codespace o vincula el codespace a una bifurcación existente si ya tienes una para el repositorio. Después, puedes insertar los cambios en la bifurcación y crear una solicitud de incorporación de cambios para proponer los cambios en el repositorio ascendente.

Nota: Si eliminas el repositorio de bifurcación, se eliminan los espacios de código vinculados a la bifurcación, incluso aunque los crearas originalmente desde el repositorio ascendente.

Si realizas una confirmación desde la línea de comandos, verás un mensaje que te preguntará si quieres continuar con la vinculación del codespace a una bifurcación nueva o existente. Escribe y para continuar. Si confirmas cambios desde la vista Control de código fuente en VS Code, o desde la barra de navegación de un IDE de JetBrains, el codespace se vincula automáticamente a una bifurcación sin que se te solicite.

Cuando GitHub Codespaces crea una bifurcación o vincula el codespace a una bifurcación existente, sucede lo siguiente.

  • El token de acceso asociado con el codespace se actualiza para incluir el permiso read y write para la bifurcación, además del permiso read para el repositorio ascendente.
  • En la configuración de Git, el repositorio ascendente se reasigna al nombre upstream y la bifurcación se agrega como un nuevo repositorio remoto con el nombre origin.

De forma predeterminada, los comandos de control de código fuente a los que accedes desde la interfaz de usuario del editor, como el botón Sincronizar cambios en VS Code, tienen como destino la bifurcación. Si trabajas desde la línea de comandos, puedes usar origin para hacer referencia a la bifurcación y upstream hacer referencia al repositorio ascendente. Por ejemplo, puedes capturar los cambios del repositorio ascendente para asegurarte de que el codespace esté actualizado con los últimos cambios en el proyecto.

$ git fetch upstream

Cuando hayas realizado algunos cambios, podrás insertarlos en una rama de características de la bifurcación.

$ git push origin my-feature-branch

Para obtener más información, vea "Acerca de las bifurcaciones".

Publicación de un codespace creado a partir de una plantilla

Al crear un codespace a partir de un repositorio de plantillas o una plantilla en la página "Tus codespaces", el trabajo que realices no se almacenará en un repositorio de GitHub hasta que no publiques el codespace. Para obtener más información, consulta "Creación de un codespace a partir de una plantilla".

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

Crear o cambiar de rama

  1. Si la rama actual no se muestra en la barra de estado, en la parte inferior de tu codespace, haga clic derecho en la barra de estado y seleccione Source control (Control de código fuente).
  2. Haz clic en el nombre de rama en la barra de estado. La rama en la barra de estado
  3. En el menú desplegable, haga clic en la rama a la que quiera cambiar o indique el nombre de una rama nueva y haga clic en Create nre branch (Crear rama). Elección en el menú de la rama

Sugerencia: Si alguien ha modificado recientemente un archivo en el repositorio remoto, en la rama a la que hayas cambiado quizá no veas estos cambios hasta que los extraigas en el codespace.

Configramr tus cambios

  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", haga clic en + junto al archivo que ha cambiado, o junto a Cambios si ha cambiado varios archivos y quiere agregarlos todos. Barra lateral de control de código fuente con el botón de almacenamiento provisional resaltado
  3. Teclea un mensaje de confirmación que describa el cambio que hiciste. Barra de control de código fuente con un mensaje de confirmación
  4. Para confirmar tus cambios planeados, haz clic en la marca de verificación en la parte superior de la barra lateral del control de código fuente. Clic en el icono de marca de verificación

Extraer cambios del repositorio remoto

Puedes extraer cambios del repositorio remoto hacia tu codespace en cualquier momento.

  1. En la barra de actividad, haga clic en la vista Control de código fuente. Vista de control de código fuente
  2. En la parte superior de la barra lateral, haz clic en los puntos suspensivos ( ... ). Botón de puntos suspensivos para las opciones Ver y Más acciones
  3. En el menú desplegable, haz clic en Extraer.

Si el la configuración del contenedor dev cambió desde que creaste el codespace, puedes aplicar los cambios si recompilas el contenedor para el codespace. Para más información, vea "Introducción a los contenedores de desarrollo".

Configurar tu codespace para que recupere los cambios nuevos automáticamente

Puedes configurar tu codespace para que recupere automáticamente los detalles de cualquier confirmación nueva que se haya hecho al repositorio remoto. Esto te permite ver si tu copia local del repositorio está desactualizada, en cuyo caso, podrías elegir extraer los cambios nuevos.

Si la operación de búsqueda detecta cambios nuevos en el repositorio remoto, verás la cantidad de confirmaciones nuevas en la barra de estado. Luego podrás extraer los cambios en tu copia local.

  1. Haga clic en el botón Administrar en la parte inferior de la barra de actividad. Botón Administrar
  2. En el menú, haga clic en Configuración.
  3. En la página Configuración, busque: autofetch. Búsqueda de captura automática
  4. Para capturar detalles de las actualizaciones de todos los remotos registrados para el repositorio actual, establezca Captura automática de Git en all. Habilitación de la captura automática de Git
  5. Si quiere cambiar la cantidad de segundos entre cada captura automática, edite el valor de Git: Periodo de captura automática.

Levantar una solicitud de cambios

  1. Después de haber confirmado los cambios en la copia local del repositorio, haga clic en el icono Create Pull Request. Barra lateral de control de código fuente con el botón de almacenamiento provisional resaltado
  2. Verifica que el repositorio y la rama local desde la que estás haciendo la fusión y la rama y repositorio remotos hacia los que estés haciendo la fusión sean correctos. Después, asigna un nombre y descripción a la solicitud de cambios. Barra lateral de control de código fuente con el botón de almacenamiento provisional resaltado
  3. Haga clic en Crear.

Subir cambios a tu repositorio remoto

Puedes insertar cambios que hayas guardado y confirmado. Esto aplica a aquellos de la rama ascendente en el repositorio remoto. Puede que necesites hacer eso si aún no estás listo para crear una solicitud de cambios o si prefieres crearla en GitHub.

  1. En la parte superior de la barra lateral, haz clic en los puntos suspensivos ( ... ). Botón de puntos suspensivos para las opciones Ver y Más acciones
  2. En el menú desplegable, haz clic en Insertar.

Publicación de un codespace creado a partir de una plantilla

Al crear un codespace a partir de un repositorio de plantillas o una plantilla en la página "Tus codespaces", el trabajo que realices no se almacenará en un repositorio de GitHub hasta que no publiques el codespace. Para obtener más información, consulta "Creación de un codespace a partir de una plantilla".

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

Crear o cambiar de rama

  1. Si la rama actual no se muestra en la barra de estado, en la parte inferior de tu codespace, haga clic derecho en la barra de estado y seleccione Source control (Control de código fuente).
  2. Haz clic en el nombre de rama en la barra de estado. La rama en la barra de estado
  3. En el menú desplegable, haga clic en la rama a la que quiera cambiar o indique el nombre de una rama nueva y haga clic en Create nre branch (Crear rama). Elección en el menú de la rama

Sugerencia: Si alguien ha modificado recientemente un archivo en el repositorio remoto, en la rama a la que hayas cambiado quizá no veas estos cambios hasta que los extraigas en el codespace.

Configramr tus cambios

  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", haga clic en + junto al archivo que ha cambiado, o junto a Cambios si ha cambiado varios archivos y quiere agregarlos todos. Barra lateral de control de código fuente con el botón de almacenamiento provisional resaltado
  3. Teclea un mensaje de confirmación que describa el cambio que hiciste. Barra de control de código fuente con un mensaje de confirmación
  4. Para confirmar tus cambios planeados, haz clic en la marca de verificación en la parte superior de la barra lateral del control de código fuente. Clic en el icono de marca de verificación

Extraer cambios del repositorio remoto

Puedes extraer cambios del repositorio remoto hacia tu codespace en cualquier momento.

  1. En la barra de actividad, haga clic en la vista Control de código fuente. Vista de control de código fuente
  2. En la parte superior de la barra lateral, haz clic en los puntos suspensivos ( ... ). Botón de puntos suspensivos para las opciones Ver y Más acciones
  3. En el menú desplegable, haz clic en Extraer.

Si el la configuración del contenedor dev cambió desde que creaste el codespace, puedes aplicar los cambios si recompilas el contenedor para el codespace. Para más información, vea "Introducción a los contenedores de desarrollo".

Configurar tu codespace para que recupere los cambios nuevos automáticamente

Puedes configurar tu codespace para que recupere automáticamente los detalles de cualquier confirmación nueva que se haya hecho al repositorio remoto. Esto te permite ver si tu copia local del repositorio está desactualizada, en cuyo caso, podrías elegir extraer los cambios nuevos.

Si la operación de búsqueda detecta cambios nuevos en el repositorio remoto, verás la cantidad de confirmaciones nuevas en la barra de estado. Luego podrás extraer los cambios en tu copia local.

  1. Haga clic en el botón Administrar en la parte inferior de la barra de actividad. Botón Administrar
  2. En el menú, haga clic en Configuración.
  3. En la página Configuración, busque: autofetch. Búsqueda de captura automática
  4. Para capturar detalles de las actualizaciones de todos los remotos registrados para el repositorio actual, establezca Captura automática de Git en all. Habilitación de la captura automática de Git
  5. Si quiere cambiar la cantidad de segundos entre cada captura automática, edite el valor de Git: Periodo de captura automática.

Levantar una solicitud de cambios

  1. Después de haber confirmado los cambios en la copia local del repositorio, haga clic en el icono Create Pull Request. Barra lateral de control de código fuente con el botón de almacenamiento provisional resaltado
  2. Verifica que el repositorio y la rama local desde la que estás haciendo la fusión y la rama y repositorio remotos hacia los que estés haciendo la fusión sean correctos. Después, asigna un nombre y descripción a la solicitud de cambios. Barra lateral de control de código fuente con el botón de almacenamiento provisional resaltado
  3. Haga clic en Crear.

Subir cambios a tu repositorio remoto

Puedes insertar cambios que hayas guardado y confirmado. Esto aplica a aquellos de la rama ascendente en el repositorio remoto. Puede que necesites hacer eso si aún no estás listo para crear una solicitud de cambios o si prefieres crearla en GitHub.

  1. En la parte superior de la barra lateral, haz clic en los puntos suspensivos ( ... ). Botón de puntos suspensivos para las opciones Ver y Más acciones
  2. En el menú desplegable, haz clic en Insertar.

Crear o cambiar de rama

  1. Haz clic en el nombre de la rama en el lado derecho de la barra de estado.

    Captura de pantalla del nombre de la rama en la barra de estado

  2. En el menú emergente, realiza una de las acciones siguientes:

    • Para crear una nueva rama basada en la rama actual, haz clic en el nombre de la rama actual y, a continuación, elige Nueva rama.

      Captura de pantalla de la opción de nueva rama

      Escribe un nombre para la nueva rama y haz clic en Crear.

      Captura de pantalla del cuadro de diálogo Crear rama

    • Para desactivar una rama existente, empieza escribiendo el nombre de la rama que quieres extraer del repositorio. Haz clic en la rama de la lista y, a continuación, haz clic en Extraer del repositorio.

      Captura de pantalla de la opción extraer del repositorio

      Sugerencia: Si alguien ha modificado recientemente un archivo en el repositorio remoto, en la rama a la que hayas cambiado quizá no veas estos cambios hasta que los extraigas en el codespace.

Configramr tus cambios

  1. En el lado derecho de la barra de navegación, haz clic en la marca de verificación.

    Captura de pantalla de la marca de verificación de confirmación

  2. En el cuadro de diálogo Confirmar cambios, escribe un mensaje de confirmación.

  3. Haga clic en Confirmar.

    Como alternativa, haz clic en la flecha abajo situada junto a Confirmar y haz clic en Confirmar e Insertar.

    Captura de pantalla del botón de Confirmar e Insertar

Extraer cambios del repositorio remoto

Puedes extraer cambios de la misma rama en el repositorio remoto y aplicar esos cambios a la copia del repositorio en el que estás trabajando en el codespace.

  1. En el lado derecho de la barra de navegación, haz clic en la flecha que apunta hacia abajo.

    Captura de pantalla del botón de flecha hacia abajo de actualización de proyecto

  2. En el cuadro de diálogo Actualizar proyecto, elige si quieres combinar o fusionar mediante cambio de base los cambios entrantes.

    Captura de pantalla del cuadro de diálogo Actualizar proyecto

  3. Haga clic en OK.

Subir cambios a tu repositorio remoto

Puedes insertar cambios que hayas guardado y confirmado. Esto aplica a aquellos de la rama ascendente en el repositorio remoto. Puede que necesites hacer eso si aún no estás listo para crear una solicitud de cambios o si prefieres crearla en GitHub.

  1. En el lado derecho de la barra de navegación, haz clic en la flecha hacia arriba.

    Captura de pantalla de la flecha hacia arriba de Insertar confirmaciones

  2. En el cuadro de diálogo Insertar confirmaciones, haz clic en Insertar.