Какова рекомендуемая практика обновления запущенных рабочих процессов?
Если уже есть запущенные выполнения, созданные с использованием предыдущей реализации рабочего процесса, то внесение любого изменения кода или обновление логики рабочего процесса приводит к «недетерминированной ошибке» от Cadence, поскольку он не может воспроизвести историю для существующих выполнений рабочего процесса с использованием обновленной реализации.
Каковы некоторые стратегии выполнения обновлений без нарушения существующих рабочих процессов?
ПолучитьВерсию используется для безопасного выполнения обратно несовместимых изменений в определениях рабочих процессов. Не разрешается обновлять код рабочего процесса, пока рабочие процессы выполняются, так как это может нарушить детерминизм. Решение состоит в том, чтобы иметь как старый код, который используется для воспроизведения существующих рабочих процессов, так и новый, который используется при первом выполнении. GetVersion
возвращает maxSupported
версию при первом выполнении. Эта версия записывается в историю рабочего процесса как маркерное событие. Даже если maxSupported
версия изменена, версия, которая была записана, возвращается при воспроизведении. DefaultVersion
константа содержит версию кода, которая ранее не версионировалась. Например, изначально рабочий процесс имеет следующий код:
err = cadence.ExecuteActivity(ctx, foo).Get(ctx, nil)
он должен быть обновлен до
err = cadence.ExecuteActivity(ctx, bar).Get(ctx, nil)
Обратно совместимый способ выполнения обновления:
v := GetVersion(ctx, "fooChange", DefaultVersion, 1)
if v == DefaultVersion {
err = cadence.ExecuteActivity(ctx, foo).Get(ctx, nil)
} else {
err = cadence.ExecuteActivity(ctx, bar).Get(ctx, nil)
}
Затем bar нужно изменить на baz:
v := GetVersion(ctx, "fooChange", DefaultVersion, 2)
if v == DefaultVersion {
err = cadence.ExecuteActivity(ctx, foo).Get(ctx, nil)
} else if v == 1 {
err = cadence.ExecuteActivity(ctx, bar).Get(ctx, nil)
} else {
err = cadence.ExecuteActivity(ctx, baz).Get(ctx, nil)
}
Позже, когда нет рабочих процессов, выполняющих DefaultVersion, соответствующую ветку можно удалить:
v := GetVersion(ctx, "fooChange", 1, 2)
if v == 1 {
err = cadence.ExecuteActivity(ctx, bar).Get(ctx, nil)
} else {
err = cadence.ExecuteActivity(ctx, baz).Get(ctx, nil)
}
В настоящее время не существует поддерживаемого способа полностью удалить вызов GetVersion после того, как он был представлен. Сохраните его, даже если осталась одна ветвь:
GetVersion(ctx, "fooChange", 2, 2)
err = cadence.ExecuteActivity(ctx, baz).Get(ctx, nil)
Это необходимо, так как GetVersion
выполняет проверку версии по истории рабочего процесса и не принимает решения, если код рабочего процесса несовместим с ним.
Java имеет аналогичный API Рабочий процесс.getVersion.