Proceso de desarrollo utilizando el espacio de trabajo de sucursal

El espacio de trabajo de rama es un espacio de trabajo vinculado a un espacio de trabajo de origen. Permite a los desarrolladores trabajar en cambios en un entorno aislado, comprender cómo se relaciona su trabajo con otras áreas de trabajo y promover los cambios en el área de trabajo principal con confianza.

La relación (vínculo) entre un área de trabajo de rama y su área de trabajo de origen se establece cuando el usuario realiza la creación de una rama. Para los desarrolladores de Fabric, la creación de una rama crea una nueva rama de Git a partir de la rama conectada al área de trabajo de origen. El usuario puede elegir entre crear un nuevo espacio de trabajo conectado a una nueva rama creada, o usar un espacio de trabajo existente cambiando su sucursal Git a la recién creada.

Note

Si configuras un flujo de automatización que realiza las mismas acciones que la ramificación, utiliza la API Create Workspace Relation, en versión preliminar, para crear la relación del espacio de trabajo de rama. Llama a esta API una vez que el flujo prepare el espacio de trabajo de la rama, cree la rama de Git y configure la conexión de Git del espacio de trabajo.

Espacio de trabajo de sucursal

La relación de espacio de trabajo de rama tiene varias representaciones visuales en la interfaz de Fabric:

  • Árbol de espacio de trabajo: Representa el espacio de trabajo fuente como el padre del espacio de trabajo de la rama

    Captura de pantalla de la jerarquía en árbol de los espacios de trabajo con espacios de trabajo en rama.

  • Pistas de espacio de trabajo: Opción de navegación desde el espacio de trabajo de la sucursal al espacio de trabajo de origen

    Captura de pantalla de migajas de espacios de trabajo de sucursal.

  • Control de código fuente: pestaña branches relacionadas

    Captura de pantalla de ramas relacionadas con el espacio de trabajo de sucursal.

Operación de ramificación

De forma predeterminada, cuando se completa una operación de bifurcación, todos los elementos de la rama de origen se incluyen en el área de trabajo de destino. Este comportamiento puede cambiarse seleccionando Seleccionar elementos individualmente durante la configuración de ramificación, permitiendo que solo se incluyan elementos seleccionados en el espacio de trabajo objetivo para agilizar la experiencia de codificación.

Como desarrollador de Fabric, el flujo de bifurcación sería el siguiente:

  1. En el panel Control de código fuente, selecciona Crear rama.

    Captura de pantalla de la opción de ramificación del control de código fuente.

  2. Especifique si desea crear una nueva área de trabajo o bifurcarla en una existente. Introduce los nombres de la nueva rama y espacio de trabajo, o selecciona el espacio de trabajo existente en la lista desplegable. Si decides expandirte a un nuevo espacio de trabajo, podrías activar o desactivar el perfil de administrador Usar el espacio de trabajo de la sucursal (Vista previa)

Note

La opción de perfil de administrador de espacio de trabajo de sucursal (Vista previa) solo está disponible cuando un administrador de espacio de trabajo ha configurado un perfil. Cuando te expandes desde un espacio de trabajo de sucursal existente, esta opción solo está disponible si el espacio de trabajo principal tiene configurado un perfil de administrador de sucursal. Para más información, consulte Configurar perfiles de administrador de espacios de trabajo de sucursales (Vista previa).

Antes de que comience la ramificación, Fabric valida si tu identidad puede completar la operación. Si la validación falla, Fabric muestra un error y impide que la operación se inicie. Puede que necesites usar el perfil de administrador configurado para continuar, o expandirte a un espacio de trabajo existente. Esta validación temprana impide una operación que de otro modo fallaría.

  1. Comprueba la opción Seleccionar elementos individualmente por si quieres trabajar solo en un subconjunto de elementos del espacio de trabajo de la rama. Verá la captura de pantalla siguiente al crear una nueva área de trabajo con bifurcación selectiva.

Importante

Cuando te expandes a un espacio de trabajo existente, los elementos que no se guardan en Git pueden eliminarse. Compromete cualquier cosa que quieras conservar antes de continuar. Debes confirmar que entiendes este riesgo antes de comenzar la operación de diversificación.

Captura de pantalla de selección de elementos individualmente.

  1. Haz clic en el botón Diversificar (los pasos 5-9 solo se aplican cuando se selecciona Seleccionar elementos individualmente )

  2. Esta acción abre un cuadro de diálogo para Seleccionar elementos para el área de trabajo.

  3. Seleccione los elementos que desea para esta área de trabajo.

  4. Haz clic en Crear rama.

    Captura de pantalla de création de branch.

  5. Al realizar la bifurcación selectiva, se requieren todas las dependencias del elemento. Puede usar el botón Seleccionar elementos relacionados para ese propósito. Si no selecciona una de las dependencias, verá la siguiente captura de pantalla del error de dependencia.

    Note

    Puedes seleccionar elementos y empezar a ramificar mientras Fabric calcula sus dependencias en segundo plano. Sin embargo, proceder antes de que se carguen todos los elementos relacionados podría hacer que la operación falle.

  6. Una vez creada la rama, puede comprobar que está en una rama selectiva por el icono de la barra de estado inferior (esquina inferior izquierda). Dice rama selectiva. Captura de pantalla del icono de rama selectiva.

  7. Fabric crea el nuevo espacio de trabajo de la sucursal. Se te lleva automáticamente al nuevo espacio de trabajo. Contiene todos los elementos o solo los elementos que seleccionó en caso de ramificación selectiva.

El espacio de trabajo se sincroniza con tu rama de funcionalidades y se convierte en un entorno aislado para trabajar, como se ilustra a continuación. Ahora puedes trabajar en esta nueva sucursal. La sincronización puede tardar unos minutos. Para obtener más información sobre cómo expandirse, consulte sugerencias de solución de problemas.

Diagrama que muestra el flujo de trabajo de los commits.

  1. Guarde sus cambios y haga "commit" en la rama de características.
  2. Cuando esté listo, cree una solicitud de incorporación de cambios en la rama principal. Los procesos de revisión y combinación se realizan a través del proveedor de Git relacionado en función de la configuración definida por el equipo para ese repositorio.

Una vez completada la revisión y fusión, se crea un nuevo commit en la rama principal. Esta confirmación solicita al usuario que actualice el contenido en el área de trabajo del equipo de desarrollo con los cambios combinados.

Para obtener más información, consulte las limitaciones de bifurcación.

Cómo añadir elementos adicionales a un espacio de trabajo con bifurcación selectiva

Cuando un desarrollador de Fabric necesita agregar elementos que no se seleccionaron durante la operación de bifurcación, los pasos siguientes describen cómo agregar elementos adicionales al área de trabajo:

  1. Vaya al área de trabajo de Fabric necesaria y seleccione Control de código fuente en la parte superior.
  2. A la derecha, selecciona el símbolo de los tres puntos .
  3. Usa el desplegable y selecciona Añadir más elementos.
  4. Esta acción abre un cuadro de diálogo para Seleccionar elementos para el área de trabajo. El cuadro de diálogo Seleccionar Elementos muestra solo los elementos de la rama git que no se hayan seleccionado previamente.
  5. Seleccione los elementos adicionales que desea agregar al área de trabajo.
  6. Haga clic en Agregar. Los elementos seleccionados se agregan a las actualizaciones pendientes en el panel de control de código fuente.
  7. Haga clic en Actualizar todo. Esta operación realiza una actualización desde Git y crea los elementos en el área de trabajo.

Cambio de rama

Si el área de trabajo está conectada a una rama de Git y quiere cambiar a otra rama, puede hacerlo rápidamente desde el panel Control de código fuente sin desconectar y reconectar.

Al cambiar de rama, el área de trabajo se sincroniza con la nueva rama y se invalidan todos los elementos del área de trabajo. Si hay versiones diferentes del mismo elemento en cada rama, se reemplaza el elemento.

Cambiar de rama no afecta a la relación (vínculo) entre el espacio de trabajo de la rama y su espacio de trabajo de origen. El cambio de rama es una modificación del estado de Git. Por lo tanto, cambiar las ramas no crea ni modifica las relaciones del área de trabajo. Si un área de trabajo ya tiene una relación, se conserva.

De forma predeterminada, cambiar la rama de Git de un área de trabajo conectada (o cambiarse a una rama nueva) solo está permitido para los Administradores del área de trabajo. Sin embargo, un administrador del espacio de trabajo puede habilitar la configuración del espacio de trabajo Permitir que los usuarios con, al menos, el rol de Colaborador cambien la rama de Git para permitir cambiar de rama a los miembros/colaboradores. Esta configuración se configura por área de trabajo y requiere una conexión git activa. Para obtener la matriz de permisos completos, consulte Permisos.

Note

Al cambiar las ramas, si el área de trabajo contiene un elemento de la rama anterior, pero no el nuevo, se elimina el elemento. Además, en un espacio de trabajo con bifurcación selectiva, la realización de una operación de cambio restablece la selección de elementos, y todos los elementos de la rama cambiada se sincronizan con el espacio de trabajo.

Para cambiar entre ramas, siga estos pasos:

  1. En el panel Control de código fuente, selecciona Más opciones (...), y, a continuación, selecciona Cambiar de rama.

    Recorte de pantalla de la opción Desproteger nueva rama de Control de código fuente.

  2. Especifique la rama a la que desea conectarse o cree una nueva rama. Esta rama debe contener el mismo directorio que la rama actual.

  3. Marque la casilla en Entiendo que los elementos del área de trabajo se pueden eliminar y no se pueden restaurar. y seleccione Cambiar de rama.

    Captura de pantalla del cambio de ramas.

No puede cambiar las ramas si tiene cambios no confirmados en el área de trabajo. Seleccione Cancelar para volver atrás y confirmar los cambios antes de cambiar de rama.

Para conectar el área de trabajo actual a una nueva rama manteniendo el estado del área de trabajo existente, seleccione Cambiar a nueva rama. Obtenga más información sobre cómo comprobar una nueva rama en Resolución de conflictos en Git.

Diversifica con un plan de despliegue

Adjunta un plan de implementación cuando los elementos deban implementarse en un orden específico o cuando los cuadernos, las canalizaciones de datos u otras acciones compatibles deban ejecutarse al crear la rama. El plan de implementación controla cómo Fabric rellena el espacio de trabajo derivado de la rama; no cambia cómo se crean la rama de Git ni el espacio de trabajo.

Antes de empezar, guarda el plan de despliegue y commételo en la rama Git actual con los elementos que referencia. Solo se pueden seleccionar los planes de despliegue disponibles en Git durante la ramificación.

Para ampliarse mediante un plan de despliegue:

  1. En la pestaña Ramas del panel Control de código fuente, selecciona Crear rama con plan de implementación.

    Captura de pantalla del menú de control de versiones con Branch out y el plan de despliegue resaltado.

  2. Configura la nueva rama y el espacio de trabajo destino. Seleccione Siguiente.

    Captura de pantalla del asistente de creación de rama con plan de despliegue con configuraciones de rama y espacio de trabajo.

  3. Selecciona un plan de despliegue en el asistente de ramificación. Para usar el comportamiento estándar de ramificación, seleccione Sin plan de despliegue.

  4. Si seleccionaste Seleccionar elementos individualmente (Vista previa), selecciona los elementos que incluir en el espacio de trabajo ramificado, incluyendo los elementos necesarios para las acciones del plan. Adjuntar el plan no selecciona automáticamente estos elementos.

  5. Selecciona Crear rama.

    Captura de pantalla del asistente de ramificación con un plan de despliegue seleccionado y los elementos del espacio de trabajo listados.

Fabric crea la rama y el espacio de trabajo, y luego utiliza el plan de despliegue mientras llena el espacio de trabajo objetivo. Para ver cómo los elementos seleccionados, las relaciones del plan, la línea de Fabric y las acciones determinan el despliegue, consulta Cómo funciona un plan de despliegue.

Expandirse sin un plan de despliegue funciona como antes: Fabric despliega los elementos seleccionados usando su manejo estándar de dependencias y no ejecuta acciones previas ni posteriores al despliegue.

Limitaciones en la expansión

  • El perfil de administrador del espacio de trabajo de sucursal está en versión preliminar.
  • La ramificación requiere permisos que se muestran en la tabla de permisos.
  • Debe haber una capacidad disponible para esta acción.
  • Todas las limitaciones de nomenclatura de área de trabajo y limitaciones de nomenclatura de rama se aplican al ramificar hacia una nueva área de trabajo.
  • Solo los elementos compatibles con Git están disponibles en el nuevo área de trabajo.
  • La lista de ramas relacionadas solo muestra ramas y áreas de trabajo que tiene permiso para ver.
  • La integración de Git debe estar habilitada.
  • Al bifurcar, se crea una nueva rama y no se copia la configuración de la rama original. Ajusta cualquier configuración o definición para asegurarte de que el nuevo espacio de trabajo cumpla con las políticas de tu organización.
  • Al desconectar un espacio de trabajo de rama de Git, también se elimina su relación con el espacio de trabajo de origen.
  • Al desconectar un espacio de trabajo conectado a Git que tiene espacios de trabajo de rama asociados, también se eliminan todas las relaciones entre esos espacios de trabajo de rama.
  • Al eliminar un espacio de trabajo que tiene espacios de trabajo de rama relacionados, se eliminan todas las relaciones de espacio de trabajo de rama y los espacios de trabajo de rama se convierten en espacios de trabajo normales.
  • Al ramificarse en un área de trabajo existente:
    • El área de trabajo de destino debe admitir una conexión de Git.
    • El usuario debe ser administrador del área de trabajo de destino o Miembro/Colaborador en el área de trabajo de destino con la configuración Permitir que los usuarios con al menos el rol de Colaborador cambien la rama de Git habilitada.
    • El área de trabajo de destino debe tener capacidad.
    • El área de trabajo no puede tener aplicaciones de plantilla.
    • El espacio de trabajo objetivo no puede tener ningún espacio de trabajo ramal relacionado.
    • Cuando te expandes a un espacio de trabajo existente, cualquier elemento que no esté guardado en Git puede perderse. Se recomienda confirmar los elementos que quiera conservar antes de crear una nueva rama.

Contenido relacionado

  • Se actualizó por última vez el