Versiones y estado de la entrega
Crea una versión a partir de una entrega terminada, solicita un despliegue de pruebas, lee su estado y su evidencia, acepta o rechaza la prueba, y entiende qué hace y qué no hace la aprobación para producción.
- Disponibilidad: Experimental
- Evidencia: Leído del código fuente
- Guía práctica
Antes de empezar
- Una entrega planificada debe decir Resultados aceptados · lista para una versión: todos los resultados de su alcance fueron aceptados.
- Necesitas el hash de commit completo de lo que se va a probar: los 40 caracteres hexadecimales.
- Necesitas el permiso Tomar decisiones.
- El flujo de publicación del proyecto, la dirección de pruebas y los servicios los configura la persona que opera la instalación, en Infraestructura. Para que una solicitud se ejecute, un proceso de despliegue debe estar habilitado y en funcionamiento.
Cuatro palabras que no son lo mismo
| Palabra | En esta página significa | No significa |
|---|---|---|
| Solicitud | Elegiste Solicitar despliegue de pruebas. Existe una solicitud de publicación congelada | Que se haya enviado algo a GitHub |
| Aprobación | Una persona registró una decisión: el alcance, el resultado de la prueba, o producción | Que algo se haya ejecutado |
| Envío | El proceso de despliegue mandó la solicitud al proveedor | Que el proveedor haya terminado, ni siquiera empezado |
| Finalización verificada | Se observó que la ejecución terminó y se leyó la evidencia esperada de cada componente y coincidió | Solo que un flujo de trabajo salió en verde |
La interfaz las mantiene separadas, y también lo hace cada estado de abajo. El vocabulario de estados del trabajo tiene las definiciones completas.
Crear una versión
- Abre Versiones («Prueba una versión concreta.»). «Una versión vincula una entrega planificada terminada con un hash de commit completo.»
- En Crear una versión, completa Nombre de la versión, elige la Entrega planificada terminada, y pega el Hash de commit completo («Los 40 caracteres hexadecimales.»).
- Elige Crear versión.
Resultado esperado: la versión aparece como Versión preparada, con «De {name}» y el hash.
| Ves | Significado |
|---|---|
| «Una entrega planificada aparece aquí cuando se aceptan todos los resultados de su alcance.» | Todavía no hay ninguna entrega terminada |
| «Escribe el hash de commit completo, de 40 caracteres.» | Se pegó un hash corto |
| «Primero deben aceptarse todos los resultados de la entrega planificada.» | Todavía hay un resultado abierto |
| «Autoriza trabajo de corrección para la versión rechazada antes de preparar un reemplazo.» | Estás reemplazando una versión rechazada: autoriza primero la corrección. La versión nueva muestra entonces «Reemplaza a la versión rechazada {name}» |
Solicitar un despliegue de pruebas
En una Versión preparada, elige Solicitar despliegue de pruebas.
Resultado esperado: la versión dice Despliegue de pruebas solicitado, y debajo aparece un intento. El panel te lo recuerda: «La cola necesita un proceso de despliegue conectado. Solicitar la publicación no significa que ya se haya publicado.»
La solicitud congela lo que se aprobó: el repositorio, la rama, el flujo de trabajo, la revisión, el destino, la lista de componentes y la evidencia que se va a exigir. Abre Configuración de publicación aprobada en el intento para leerla, con su identificador. Una configuración que cambie después no puede desviar una solicitud que ya se hizo.
Solo se ejecuta una publicación de pruebas por proyecto a la vez: «Ya hay una publicación de pruebas en curso para este proyecto.»
Leer el estado de un intento
Cada intento muestra un estado, una frase y, cuando ya existe, Ver ejecución.
| Estado | Frases que puedes ver | Significado |
|---|---|---|
| En cola | «A la espera del proceso de despliegue.» | Solicitado. Todavía no se envió nada |
| En ejecución | «Comprobando la rama y el flujo de trabajo.», «Envío iniciado.», «El flujo de trabajo está en ejecución.», «A la espera de la aprobación del entorno en GitHub.» | Enviado, sin terminar. La aprobación de un entorno ocurre en GitHub, no aquí |
| Completado | «El flujo de trabajo se completó.» | La ejecución terminó y se leyó su evidencia. La versión dice Flujo de pruebas completado |
| Falló | «El flujo de trabajo falló.» o un motivo específico | La ejecución falló, o una comprobación la rechazó antes de desplegar nada, por ejemplo «La rama cambió después de aprobarse esta versión. No se desplegó nada.» |
| Requiere atención | «El resultado del envío es desconocido. Identifica su ejecución en GitHub antes de continuar.» | Delegate no sabe si existe una ejecución. Consulta la reconciliación |
Evidencia
Debajo del intento se lista cada componente de la aplicación con un estado (Verificado, Sin verificar o Falta), un detalle y, cuando está disponible, un resumen criptográfico. Es lo que el flujo de trabajo protegido informó sobre lo que compiló y desplegó; Delegate comprueba que pertenezca exactamente a esta ejecución, a este intento y a esta revisión. No es una prueba independiente de la aplicación en funcionamiento.
Con el perfil de evidencia que solo informa el resultado del flujo de trabajo, los componentes quedan Sin verificar, y una versión así no se puede aprobar para producción.
Aceptar o rechazar la prueba
Cuando la versión dice Flujo de pruebas completado:
- Elige Abrir la aplicación de pruebas y comprueba el cambio tú. Ver ejecución y registros abre la ejecución.
- Decide:
- Aceptar: escribe ¿Qué verificaste? y elige Aceptar resultado de las pruebas. La versión dice Pruebas aceptadas, con «Pruebas aceptadas por {actor}».
- Rechazar: abre El despliegue de pruebas no pasó la verificación, escribe ¿Qué falló? y elige Rechazar el resultado de las pruebas. «Rechazar termina esta versión: nunca podrá aprobarse para producción. Una revisión corregida se convierte en una versión nueva.»
Un flujo de trabajo que se completó no es una prueba que pasó. Solo tu decisión hace avanzar la versión.
Cuando el resultado es incierto
Un intento en Requiere atención (o Falló) ofrece un formulario para reanudar la verificación de una ejecución que ya existe. Aparece en Requiere mi atención como La publicación de pruebas requiere atención.
- Abre la página de Actions del repositorio en GitHub y busca la ejecución que corresponde a esta versión.
- En Delegate, completa Número de la ejecución de GitHub, tomado de su URL y ¿Qué verificaste?.
- Elige Reanudar verificación. «Indica la ejecución de GitHub que ya existe. Esto reanuda la verificación sin iniciar otro despliegue.»
Resultado esperado: «Se reanudó la verificación de la ejecución existente.», y el intento continúa observando esa ejecución. La acción queda registrada con tu nota. Nunca inicia un flujo de trabajo, no cambia el código fuente, no reintenta un despliegue fallido ni crea un recurso.
| Ves | Significado |
|---|---|
| «Esa ejecución no coincide con el repositorio, el flujo de trabajo, la rama y la revisión aprobados.» | Es otra ejecución. No se cambió nada |
| «Esa ejecución empezó antes de esta solicitud de publicación.» | No puede ser la ejecución de esta solicitud |
| «Usa el identificador numérico que aparece al final de la URL de la ejecución en GitHub.» | El valor no es un número de ejecución |
| «Esta operación cambió mientras la revisabas. Actualiza y revísala de nuevo.» | El intento avanzó mientras el formulario estaba abierto, por ejemplo porque el proceso de despliegue encontró la ejecución. Actualiza; puede que ya no te quede nada por hacer |
| «Faltan uno o más artefactos de componentes. Revisa la ejecución antes de reanudar la verificación.» | La ejecución terminó sin toda su evidencia |
| «Esta operación anterior no tiene una aprobación verificada. Crea una nueva operación revisada.» | La solicitud es anterior a las aprobaciones congeladas y no se puede reanudar |
Producción
En una versión que dice Pruebas aceptadas, el panel dice: «La aprobación exige evidencia verificada de cada componente. Esto registra la aprobación de la versión probada; la ejecución en producción no está conectada.»
- Escribe una Nota de aprobación.
- Elige Aprobar para producción.
Resultado esperado: la versión dice Producción aprobada · ejecución pendiente, con «Producción aprobada por {actor}. La ejecución no está conectada; no se publicó nada.»
La aprobación se rechaza con «Verifica el artefacto de cada componente antes de aprobar para producción.» cuando algún componente no está Verificado, y con «La revisión aprobada no coincide con esta versión.» cuando el hash es distinto.
Límites
Siguiente acción
Si la prueba se rechazó, autoriza trabajo de corrección y prepara una versión nueva. Si algo está trabado, consulta Recuperación en Delegate.
Relacionado: Vocabulario de estados del trabajo · Trabajo externo · Límites vigentes