Revisar e integrar cambios
Lee los tres números de tu copia de trabajo, haz un punto de control, trae lo que otros integraron, revisa el diff, la verificación y los conflictos, e integra. Integrar no es publicar, y no hay ninguna acción de publicar.
- Disponibilidad: Experimental
- Evidencia: Ejecución registrada
- Guía práctica
Antes de empezar
- Tu entorno debe estar en ejecución: el repositorio se lee donde está tu copia de trabajo.
- El punto de control, la actualización y la integración necesitan un rol que pueda escribir: Propietario, Administrador o Desarrollador. Un Lector lee el estado, bajo la línea «Tu rol no puede crear puntos de control ni integrar. El estado de abajo es para leer.»
Tres números
Revisión empieza con Tu copia de trabajo y tu rama. Mantiene separadas tres cosas:
| Número | Significado |
|---|---|
| Guardado, sin confirmar | Archivos guardados en tu entorno que todavía no están en un punto de control |
| Confirmado, sin integrar | Puntos de control de tu rama que el proyecto no tiene |
| Integrado por otros | Trabajo que el proyecto tiene y a tu rama le falta |
Workspace explica los niveles en una línea: «Los archivos guardados viven en el almacenamiento de tu entorno. Un punto de control los confirma en tu rama. Integrar los comparte con el proyecto.»
Cada persona trabaja en una rama propia. El proyecto tiene una rama compartida, y solo la integración escribe en ella.
Punto de control
Punto de control confirma todo lo guardado solo en tu rama y guarda una copia de esa rama fuera de tu entorno, que es lo que sobrevive a la pérdida del almacenamiento del entorno. Nadie más recibe nada.
También se hace un punto de control por ti antes de que tu entorno se detenga, antes de una actualización y antes de una integración. Nada se integra solo.
Traer el trabajo integrado
Traer el trabajo integrado fusiona en tu rama lo que otros integraron. Si fuera a entrar en conflicto, se rechaza y no cambia nada.
Revisar antes de integrar
Elige Revisar antes de integrar. No cambia nada; muestra lo que haría una integración:
| Parte | Qué muestra |
|---|---|
| Cambios que integrar | La diferencia entre tu copia de trabajo, incluido el trabajo sin confirmar, y la rama compartida. Si no hay: «No hay nada que integrar.» |
| Verificación | «Verificación correcta: la copia de trabajo compila», «Verificación fallida: la copia de trabajo no compila» o «Verificación no disponible: no se pudo leer el estado de compilación» |
| «Conflictos con la rama compartida:» y su cantidad | Los archivos en los que una integración entraría en conflicto |
Debajo de la verificación: «Se muestra para que decidas. No bloquea la integración.» Revisar de nuevo la repite después de que cambies algo.
Integrar
Integrar cambios comparte tu trabajo confirmado con la rama compartida del proyecto. Integra cualquiera que pueda escribir: no hay una aprobación obligatoria de otra persona.
| Resultado | Significado |
|---|---|
| «Integración completada» | La rama compartida tiene tu trabajo |
| «Integración: nada que hacer» | No tienes nada propio que integrar, aunque estés atrasado |
| «Integración rechazada. No cambió nada.» | Los conflictos se deciden antes de tocar nada. Con un conflicto (MERGE_CONFLICT) no hay punto de control, ni fusión, ni archivo cambiado, ni cambio en la rama compartida, y Workspace dice «Tu trabajo y la rama compartida cambiaron las mismas líneas. Trae el trabajo integrado, resuelve los archivos e integra de nuevo.» Cuando alguien integró en el mismo instante (NON_FAST_FORWARD): «La rama compartida avanzó mientras esto se ejecutaba. Revisa de nuevo e integra.» |
| «Integración fallida» | No se completó; se muestra el motivo |
La rama compartida solo se mueve hacia adelante. Nunca se fuerza.
Integrar no es publicar
Workspace lo dice sobre el botón: «Integrar comparte tu trabajo confirmado con la rama compartida del proyecto. No es una publicación.»
Integrar hace que tu código forme parte del proyecto para tus colegas. No publica nada, no hace ningún release y no despliega nada, y no hay ninguna acción de publicar en Workspace ni en Projects. Los releases de una aplicación se preparan y se promueven mediante el CDN. Vista previa, integración y publicación son cosas distintas explica las tres.
Límites
- El repositorio del proyecto lo guarda la propia instalación. No hay ningún proveedor de Git alojado conectado, y nada envía cambios a uno.
- Con el entorno detenido, Revisión dice «Inicia el entorno para ver tu copia de trabajo»: «Git se ejecuta dentro de tu entorno, así que su estado y la revisión de integración solo existen mientras está en marcha. No se pierde nada: al detenerlo, tu trabajo guardado se confirmó en tu rama.»
- Dos instancias del servicio integrando un mismo proyecto en el mismo momento no formaron parte de las ejecuciones registradas.