Proyectos de vista previa y de prueba temporal

Son dos conceptos relacionados cuyo objetivo común es mantener el trabajo experimental alejado del trabajo que realmente importa.

Proyectos temporales#

Un proyecto temporal es un proyecto normal que se pretende desechar. Úsalo para probar Coroid en un código base desconocido, validar un cambio en las políticas antes de aplicarlo de forma generalizada o explorar un enfoque al que no estés comprometido.

Su principal ventaja es el aislamiento. Los experimentos realizados en un proyecto temporal no contaminan el historial de tareas, las métricas ni el contexto del proyecto en el que confía tu equipo.

Elimínalos cuando hayas terminado. Si un proyecto temporal sobrevive seis meses, habrá pasado inadvertidamente a ser un proyecto real, sin contar con la configuración adecuada que eso implica.

Entornos de vista previa#

Una vista previa muestra tu aplicación modificada en ejecución, generada a partir de la rama que produjo la tarea.

Esto es importante porque algunas cosas no pueden determinarse solo con revisar una diferencia de código. Si una página se renderiza correctamente, si un flujo funciona de principio a fin o si un cambio tiene el aspecto deseado: todo esto requiere que la aplicación esté en ejecución.

Las vistas previas son lo que pruebas en navegador ejecutan contra ellas, y lo que los revisores abren cuando una captura de pantalla no basta para resolver la duda.

Previsualizar el cambio de una tarea#

En la Fábrica, abra una tarea que esté pendiente de revisión. Bajo ¿Qué ha cambiado?, el Vista previa panel inicia la rama de la tarea con un solo clic.

• Iniciando: se instalan las dependencias de la rama y la aplicación se inicia. La primera ejecución puede tardar unos minutos.
• Listo: la aplicación en ejecución aparece dentro del panel. Abrir la muestra en una pestaña nueva, y el panel indica cuánto tiempo queda para la vista previa.
• Detener la finaliza antes de tiempo. Una vista previa que se ejecuta en Coroid se detiene sola después de una hora.

Si la compilación falla, Reintentar la inicia de nuevo y Mostrar registro muestra qué salió mal. Un cambio sin página web para abrir, como un cambio en el backend o en una biblioteca, muestra No hay nada que mostrar en el navegador en lugar de un botón.

Al iniciar una vista previa que ya está en proceso de inicio o en ejecución, se abre la misma vista previa, por lo que dos revisores nunca inician dos copias.

Dónde se ejecuta una vista previa#

Usted no elige dónde se ejecuta una vista previa:

• Entorno aislado de Coroid: es el predeterminado. Coroid compila la rama de la tarea en un contenedor aislado que no recibe sus secretos. No necesita pull request ni hacer push, por lo que también funciona para repositorios que permanecen dentro de Coroid.
• Vercel: cuando el proyecto tiene Vercel conectado para despliegues directos (configuración del proyecto → Integraciones → Evidencia de revisión), Vercel compila la rama y la sirve en una dirección de vista previa de Vercel. Se aplican las protecciones de despliegue propias de Vercel, por lo que la vista previa se abre en una pestaña nueva en lugar de dentro del panel.

Un repositorio en modo local únicamente nunca sale de Coroid y siempre muestra vistas previas en el entorno aislado de Coroid.

La dirección de una vista previa es larga e impredecible, pero cualquiera que la tenga puede abrir la vista previa mientras se ejecuta. Trátela como cualquier enlace a trabajo no publicado.

Cómo llegan las vistas previas a tu pull request#

El enlace de pull request Coroid para una tarea lleva a su vista previa: Previsualizar este cambio en Coroid abre la revisión de la tarea e inicia la vista previa. El enlace requiere iniciar sesión en Coroid; la dirección de la vista previa en sí no se publica en la solicitud de extracción.

Si ya dispones de despliegues de vista previa — desde la aplicación Git de tu proveedor de hosting o tu CI — Coroid también los vincula como evidencia de revisión, de modo que el enlace aparezca junto al cambio en lugar de tener que buscarlo en otro lugar.

Lo esencial es que la evidencia de verificación y el código que la genera lleguen juntos.

Cuándo usar cada uno#

• Para probar Coroid o un enfoque que puedas desechar → proyecto temporal
• Para comprobar que un cambio específico se comporta correctamente → vista previa

Se complementan: un proyecto temporal puede tener vistas previas como cualquier otro proyecto.

Relacionado#

• Crear y configurar un proyecto
• Evidencia de revisión
• Proveedores de evidencia de revisión