AccessUpdateTaskConfig.kt
/*
Copyright (C) 2026 Sber
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package org.archtool.configuration.tasks
import com.github.kagkarlsson.scheduler.task.CompletionHandler
import com.github.kagkarlsson.scheduler.task.Task
import com.github.kagkarlsson.scheduler.task.helper.Tasks
import com.github.kagkarlsson.scheduler.task.schedule.Schedules
import org.archtool.configuration.ServiceProperties
import org.archtool.data.model.AccessUpdateTaskModel
import org.archtool.data.model.TaskStepStatus
import org.archtool.data.model.UpdateStatus
import org.archtool.helper.UpdateServiceClient
import org.archtool.service.HistoryService
import org.archtool.service.TaskRelaunchService
import org.slf4j.LoggerFactory
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
@Configuration
class AccessUpdateTaskConfig {
private val log = LoggerFactory.getLogger(javaClass)
companion object {
const val TASK_NAME = "ams-access-task"
const val TASK_SPAWNER_NAME = "ams-access-spawner-task"
const val GLOBAL_INSTANCE_ID = "ams-access-task-instance"
}
@Bean
fun accessUpdateTask(
seafAmsServiceClient: UpdateServiceClient,
serviceProperties: ServiceProperties,
historyService: HistoryService,
taskRelaunchService: TaskRelaunchService
): Task<AccessUpdateTaskModel> {
return Tasks.custom(
TASK_NAME,
AccessUpdateTaskModel::class.java
).execute { instance, context ->
val data = instance.data ?: AccessUpdateTaskModel()
val completeRun = taskRelaunchService.onComplete(context.schedulerClient, AccessUpdateRelaunch)
try {
when (data.currentStep) {
AccessUpdateTaskModel.Step.START_AMS_UPDATE -> {
// Первый шаг нового запуска: история должна содержать только шаги текущего запуска.
// Повтор шага (seaf-ams занят) тоже очищает историю — в ней только этот шаг.
historyService.clearTaskHistory(TASK_NAME, GLOBAL_INSTANCE_ID)
val status = seafAmsServiceClient.update()
when (status.status) {
UpdateStatus.SCHEDULED -> {
// seaf-ams принял запрос: обновление начнётся после него. Шаг запуска завершён,
// ход обновления отслеживает CHECK_AMS.
val launchDescription = "Запущено новое обновление seaf-ams"
historyService.saveUpdateStatus(
taskName = TASK_NAME,
taskInstance = GLOBAL_INSTANCE_ID,
stepName = data.currentStep.name,
stepStatus = TaskStepStatus.SUCCESS,
successMessage = launchDescription
)
log.info("Запуск обновления seaf-ams: {}", launchDescription)
data.currentStep = AccessUpdateTaskModel.Step.CHECK_AMS
CompletionHandler.OnCompleteReschedule(
Schedules.fixedDelay(serviceProperties.amsAccessSchedulerRate),
data
)
}
UpdateStatus.ERROR -> {
historyService.saveUpdateStatus(
taskName = TASK_NAME,
taskInstance = GLOBAL_INSTANCE_ID,
stepName = data.currentStep.name,
stepStatus = TaskStepStatus.ERROR,
errorMessage = status.errorMessage
)
log.error("Ошибка запуска обновления seaf-ams: {}", status.errorMessage)
completeRun
}
else -> {
// seaf-ams выполняет обновление, начатое до запроса, и запрос не принял: его итог
// не покрывает изменения, ради которых запущена задача. Повторяем запуск, пока
// seaf-ams не примет запрос.
historyService.saveUpdateStatus(
taskName = TASK_NAME,
taskInstance = GLOBAL_INSTANCE_ID,
stepName = data.currentStep.name,
stepStatus = TaskStepStatus.IN_PROGRESS
)
log.debug("seaf-ams уже выполняет обновление (статус {}), повторяем запуск", status.status)
CompletionHandler.OnCompleteReschedule(
Schedules.fixedDelay(serviceProperties.amsAccessSchedulerRate),
data
)
}
}
}
AccessUpdateTaskModel.Step.CHECK_AMS -> {
val status = seafAmsServiceClient.status()
historyService.saveUpdateStatus(
taskName = TASK_NAME,
taskInstance = GLOBAL_INSTANCE_ID,
stepName = data.currentStep.name,
stepStatus = TaskStepStatus.from(status.status),
errorMessage = status.errorMessage
)
log.debug("Проверка статуса seaf-ams: {}", status)
when (status.status) {
UpdateStatus.SUCCESS -> {
log.info("Seaf-ams успешно обновлен. Задача завершена.")
completeRun
}
UpdateStatus.SCHEDULED -> {
log.trace("Обновление seaf-ams еще не начато, продолжаем наблюдение")
CompletionHandler.OnCompleteReschedule(
Schedules.fixedDelay(serviceProperties.amsAccessSchedulerRate),
data
)
}
UpdateStatus.IN_PROGRESS -> {
log.trace("Обновление seaf-ams выполняется, продолжаем наблюдение")
CompletionHandler.OnCompleteReschedule(
Schedules.fixedDelay(serviceProperties.amsAccessSchedulerRate),
data
)
}
UpdateStatus.ERROR -> {
log.error("Обновление seaf-ams завершилось с ошибкой: {}", status.errorMessage)
completeRun
}
}
}
}
} catch (e: Exception) {
historyService.saveUpdateStatus(
taskName = TASK_NAME,
taskInstance = GLOBAL_INSTANCE_ID,
stepName = data.currentStep.name,
stepStatus = TaskStepStatus.ERROR,
errorMessage = e.message
)
log.error("Критическая ошибка на шаге ${data.currentStep}: ${e.message}", e)
completeRun
} catch (e: Throwable) {
// Error — фиксируем статус в истории и пробрасываем дальше, не пытаясь продолжить
// штатную логику планирования.
historyService.saveUpdateStatus(
taskName = TASK_NAME,
taskInstance = GLOBAL_INSTANCE_ID,
stepName = data.currentStep.name,
stepStatus = TaskStepStatus.ERROR,
errorMessage = e.message
)
log.error("Критическая ошибка JVM на шаге ${data.currentStep}: ${e.message}", e)
throw e
}
}
}
@Bean
fun accessUpdateTaskSpawner(
serviceProperties: ServiceProperties,
taskRelaunchService: TaskRelaunchService
) : Task<Void> {
return Tasks.recurring(
TASK_SPAWNER_NAME,
Schedules.fixedDelay(serviceProperties.amsAccessSchedule)
).execute { instance, context ->
val schedulerClient = context.schedulerClient
try {
val isScheduled = taskRelaunchService.submit(schedulerClient, AccessUpdateRelaunch, AccessUpdateTaskModel())
if (isScheduled) {
log.info("Процесс обновления seaf-ams успешно запущен.")
} else {
log.info("Обновление seaf-ams уже выполняется, повторный запуск поставлен в очередь.")
}
} catch (e: Exception) {
log.error("Непредвиденная ошибка при старте задачи обновления seaf-ams: ${e.message}", e)
} catch (e: Throwable) {
log.error("Критическая ошибка JVM при старте задачи обновления seaf-ams: ${e.message}", e)
throw e
}
}
}
}