Saltar al contenido principal
Versión: 2.x

Continuar como nueva ejecución

El patrón Continuar como nueva ejecución permite que un workflow activo se reinicie con nuevos argumentos. Es útil para:

  • Evitar que el historial crezca sin límite.
  • Modelar bucles iterativos o workflows recursivos.
  • Dividir workflows prolongados en ejecuciones más pequeñas y manejables conservando la continuidad.

Usar continueAsNew​

Para reiniciar como nueva ejecución, llama a continueAsNew(...) dentro de handle(). Es una transición de ejecución de primera clase.

use function Workflow\V2\activity;
use function Workflow\V2\continueAsNew;
use Workflow\V2\Workflow;

class CounterWorkflow extends Workflow
{
public function handle(int $count = 0, int $max = 3)
{
$result = activity(CountActivity::class, $count);

if ($count >= $max) {
return [
'count' => $result,
'workflow_id' => $this->workflowId(),
'run_id' => $this->runId(),
];
}

return continueAsNew($count + 1, $max);
}
}

En este ejemplo:

  • El workflow ejecuta una actividad en cada iteración.
  • Si no ha alcanzado el máximo, continúa como nueva ejecución con argumentos incrementados.
  • Solo devuelve el resultado final al terminar el bucle.

Al continuar como nueva ejecución:

  • El id de instancia sigue estable; WorkflowStub::runId() avanza a la ejecución más reciente.
  • La ejecución anterior se cierra como completed / continued y la siguiente empieza de inmediato con un nuevo id.
  • Las señales, consultas, actualizaciones y comandos del operador a nivel de instancia resuelven la ejecución duradera más reciente. Los dirigidos explícitamente a una ejecución siguen vinculados a ella.

Core 2.7.0 y los Servers compatibles conservan las señales recibidas a nivel de instancia cuyo manejador esté declarado en el contrato de comandos y que la ejecución antigua aún no haya aplicado. Se transfieren con las actualizaciones aceptadas pendientes en el orden original de comandos. No cambian los IDs de señal y comando, bytes de argumentos ni fechas de recepción. Una señal ya aplicada no vuelve a entregarse a la sucesora. Conserva el estado de negocio necesario en los argumentos de continueAsNew(); el estado local arbitrario no se copia automáticamente.

Una señal dirigida a una ejecución nunca cambia de destino. Si no puede aplicarse antes del cierre, recibe el rechazo explícito descrito en aceptación y cierre de señales. La ausencia de declaraciones heredadas no autoriza su traspaso; esas señales se cierran explícitamente en la predecesora.

Los bucles prolongados pueden desprenderse del historial sin inventar otro id público de workflow en cada transición.

Desde Workflow 2.28, las actividades y los temporizadores que la ejecución que se cierra nunca esperó se cancelan al continuar como nueva ejecución; los hijos, en cambio, se entregan a la ejecución continuada. Consulte Perdedores cuando se cierra la ejecución.

Presupuesto de historial​

El código puede observar la longitud actual del historial y una sugerencia de continuación mediante contexto explícito del runtime. Así puede traspasar deliberadamente antes de alcanzar límites costosos.

En Workflow 2.26 y versiones posteriores, usa shouldContinueAsNewAtStep() y historyBudgetAtStep(). Solo cuentan el historial registrado antes del paso actual del workflow, así que la misma línea devuelve la misma respuesta en cada replay. Un bucle que comprueba el presupuesto en cada iteración continúa como nueva ejecución una sola vez, en la primera iteración que supera el umbral.

Los métodos anteriores leen todo el historial actual. Dentro de un bucle, una iteración anterior puede ver en el replay un total posterior y tomar una rama distinta de la que tomó la primera vez. No han cambiado, así que las ejecuciones que ya decidieron con ellos siguen reproduciéndose.

use function Workflow\V2\activity;
use function Workflow\V2\continueAsNew;
use Workflow\V2\Workflow;

class PollingWorkflow extends Workflow
{
public function handle(int $iteration = 0)
{
$result = activity(PollActivity::class);

if ($this->shouldContinueAsNew()) {
return continueAsNew($iteration + 1);
}

return ['result' => $result, 'iteration' => $iteration];
}
}

Métodos disponibles​

MétodoTipo de retornoDescripción
$this->historyLength()intNúmero de eventos de historial de la ejecución actual
$this->historySize()intTamaño total de los eventos en bytes
$this->shouldContinueAsNew()booltrue cuando supera el presupuesto configurado de cantidad o bytes
$this->historyBudgetAtStep()arrayEl presupuesto en el paso actual: history_event_count, history_size_bytes, history_fan_out, continue_as_new_recommended, pressure, pressure_dimensions y observation (step_prefix.v1). Workflow 2.26 y versiones posteriores.
$this->shouldContinueAsNewAtStep()boolcontinue_as_new_recommended de historyBudgetAtStep(). Úsalo en bucles. Workflow 2.26 y versiones posteriores.

Configuración​

Los umbrales de recomendación son configurables:

// config/workflows.php
'v2' => [
'history_budget' => [
'continue_as_new_event_threshold' => 10000,
'continue_as_new_size_bytes_threshold' => 5242880, // 5 MB
],
],

shouldContinueAsNew() y shouldContinueAsNewAtStep() devuelven true al superar cualquiera. Los resúmenes también registran history_event_count, history_size_bytes y continue_as_new_recommended para que Waterline señale ejecuciones largas en las vistas de flota.

Conservación de metadatos​

Al continuar, la nueva ejecución hereda automáticamente los metadatos de la anterior:

MetadatosComportamiento de conservación
Atributos de búsquedaSe conserva el mapa combinado completo, incluidas las inserciones/actualizaciones durante la ejecución
MemoSe conserva el mapa combinado completo, incluidas las inserciones/actualizaciones durante la ejecución
Etiquetas de visibilidadSe conservan sin cambios (se fijan una vez al iniciar)
Clave de negocioSe conserva sin cambios
Marcador de compatibilidadSe conserva para dirigir la nueva ejecución a la misma compilación de worker
Posición del cursor de mensajesSe conserva para saber qué mensajes entrantes ya se consumieron mediante Flujos de mensajes

La nueva ejecución comienza con esos metadatos y puede seguir actualizando atributos de búsqueda y memo. Así, un workflow de sondeo prolongado acumula metadatos entre generaciones sin perder estado al desprenderse del historial.

use function Workflow\V2\{activity, continueAsNew, upsertMemo, upsertSearchAttributes};
use Workflow\V2\Workflow;

class PollingWorkflow extends Workflow
{
public function handle(int $iteration = 0)
{
$result = activity(PollActivity::class);

upsertSearchAttributes(['iteration' => (string) $iteration, 'status' => 'polling']);
upsertMemo(['last_result' => $result, 'iteration' => $iteration]);

if ($this->shouldContinueAsNew()) {
// The new run inherits all search attributes and memo
return continueAsNew($iteration + 1);
}

return ['result' => $result, 'iteration' => $iteration];
}
}

Un padre que continúa como nueva ejecución mientras los workflows hijos que inició siguen abiertos los entrega a la ejecución continuada. Consulta Continuar como nueva ejecución e hijos abiertos.

Para bucles prolongados de intervención humana o asistentes, prefiere la fachada de primera clase $this->inbox() / $this->outbox() de Flujos de mensajes. Los mensajes pendientes del flujo y el cursor pasan a la nueva ejecución; los mensajes consumidos permanecen en la original como evidencia histórica. Workflow 2.20.1 y versiones anteriores dejaban los mensajes pendientes del flujo en la ejecución cerrada (workflow#1018, corregido en 2.20.2); consulta Flujos de mensajes.