import { pick } from '@peertube/peertube-core-utils' import { RunnerJobLiveRTMPHLSTranscodingPayload, RunnerJobLiveRTMPHLSTranscodingPrivatePayload, RunnerJobState, RunnerJobStateType, RunnerJobStudioTranscodingPayload, RunnerJobSuccessPayload, RunnerJobType, RunnerJobUpdatePayload, RunnerJobVODAudioMergeTranscodingPayload, RunnerJobVODAudioMergeTranscodingPrivatePayload, RunnerJobVODHLSTranscodingPayload, RunnerJobVODHLSTranscodingPrivatePayload, RunnerJobVODWebVideoTranscodingPayload, RunnerJobVODWebVideoTranscodingPrivatePayload, RunnerJobVideoStudioTranscodingPrivatePayload } from '@peertube/peertube-models' import { saveInTransactionWithRetries } from '@server/helpers/database-utils.js' import { logger, loggerTagsFactory } from '@server/helpers/logger.js' import { RUNNER_JOBS } from '@server/initializers/constants.js' import { sequelizeTypescript } from '@server/initializers/database.js' import { PeerTubeSocket } from '@server/lib/peertube-socket.js' import { RunnerJobModel } from '@server/models/runner/runner-job.js' import { setAsUpdated } from '@server/models/shared/index.js' import { MRunnerJob } from '@server/types/models/runners/index.js' import throttle from 'lodash-es/throttle.js' type CreateRunnerJobArg = { type: Extract payload: RunnerJobVODWebVideoTranscodingPayload privatePayload: RunnerJobVODWebVideoTranscodingPrivatePayload } | { type: Extract payload: RunnerJobVODHLSTranscodingPayload privatePayload: RunnerJobVODHLSTranscodingPrivatePayload } | { type: Extract payload: RunnerJobVODAudioMergeTranscodingPayload privatePayload: RunnerJobVODAudioMergeTranscodingPrivatePayload } | { type: Extract payload: RunnerJobLiveRTMPHLSTranscodingPayload privatePayload: RunnerJobLiveRTMPHLSTranscodingPrivatePayload } | { type: Extract payload: RunnerJobStudioTranscodingPayload privatePayload: RunnerJobVideoStudioTranscodingPrivatePayload } export abstract class AbstractJobHandler { protected readonly lTags = loggerTagsFactory('runner') static setJobAsUpdatedThrottled = throttle(setAsUpdated, 2000) // --------------------------------------------------------------------------- abstract create (options: C): Promise protected async createRunnerJob (options: CreateRunnerJobArg & { jobUUID: string priority: number dependsOnRunnerJob?: MRunnerJob }): Promise { const { priority, dependsOnRunnerJob } = options logger.debug('Creating runner job', { options, ...this.lTags(options.type) }) const runnerJob = new RunnerJobModel({ ...pick(options, [ 'type', 'payload', 'privatePayload' ]), uuid: options.jobUUID, state: dependsOnRunnerJob ? RunnerJobState.WAITING_FOR_PARENT_JOB : RunnerJobState.PENDING, dependsOnRunnerJobId: dependsOnRunnerJob?.id, priority }) await saveInTransactionWithRetries(runnerJob) if (runnerJob.state === RunnerJobState.PENDING) { PeerTubeSocket.Instance.sendAvailableJobsPingToRunners() } return runnerJob } // --------------------------------------------------------------------------- protected abstract specificUpdate (options: { runnerJob: MRunnerJob updatePayload?: U }): Promise | void async update (options: { runnerJob: MRunnerJob progress?: number updatePayload?: U }) { const { runnerJob, progress } = options await this.specificUpdate(options) if (progress) runnerJob.progress = progress if (!runnerJob.changed()) { try { await AbstractJobHandler.setJobAsUpdatedThrottled({ sequelize: sequelizeTypescript, table: 'runnerJob', id: runnerJob.id }) } catch (err) { logger.warn('Cannot set remote job as updated', { err, ...this.lTags(runnerJob.id, runnerJob.type) }) } return } await saveInTransactionWithRetries(runnerJob) } // --------------------------------------------------------------------------- async complete (options: { runnerJob: MRunnerJob resultPayload: S }) { const { runnerJob } = options runnerJob.state = RunnerJobState.COMPLETING await saveInTransactionWithRetries(runnerJob) try { await this.specificComplete(options) runnerJob.state = RunnerJobState.COMPLETED } catch (err) { logger.error('Cannot complete runner job', { err, ...this.lTags(runnerJob.id, runnerJob.type) }) runnerJob.state = RunnerJobState.ERRORED runnerJob.error = err.message } runnerJob.progress = null runnerJob.finishedAt = new Date() await saveInTransactionWithRetries(runnerJob) const [ affectedCount ] = await RunnerJobModel.updateDependantJobsOf(runnerJob) if (affectedCount !== 0) PeerTubeSocket.Instance.sendAvailableJobsPingToRunners() } protected abstract specificComplete (options: { runnerJob: MRunnerJob resultPayload: S }): Promise | void // --------------------------------------------------------------------------- async cancel (options: { runnerJob: MRunnerJob fromParent?: boolean }) { const { runnerJob, fromParent } = options await this.specificCancel(options) const cancelState = fromParent ? RunnerJobState.PARENT_CANCELLED : RunnerJobState.CANCELLED runnerJob.setToErrorOrCancel(cancelState) await saveInTransactionWithRetries(runnerJob) const children = await RunnerJobModel.listChildrenOf(runnerJob) for (const child of children) { logger.info(`Cancelling child job ${child.uuid} of ${runnerJob.uuid} because of parent cancel`, this.lTags(child.uuid)) await this.cancel({ runnerJob: child, fromParent: true }) } } protected abstract specificCancel (options: { runnerJob: MRunnerJob }): Promise | void // --------------------------------------------------------------------------- protected abstract isAbortSupported (): boolean async abort (options: { runnerJob: MRunnerJob }) { const { runnerJob } = options if (this.isAbortSupported() !== true) { return this.error({ runnerJob, message: 'Job has been aborted but it is not supported by this job type' }) } await this.specificAbort(options) runnerJob.resetToPending() await saveInTransactionWithRetries(runnerJob) PeerTubeSocket.Instance.sendAvailableJobsPingToRunners() } protected setAbortState (runnerJob: MRunnerJob) { runnerJob.resetToPending() } protected abstract specificAbort (options: { runnerJob: MRunnerJob }): Promise | void // --------------------------------------------------------------------------- async error (options: { runnerJob: MRunnerJob message: string fromParent?: boolean }) { const { runnerJob, message, fromParent } = options const errorState = fromParent ? RunnerJobState.PARENT_ERRORED : RunnerJobState.ERRORED const nextState = errorState === RunnerJobState.ERRORED && this.isAbortSupported() && runnerJob.failures < RUNNER_JOBS.MAX_FAILURES ? RunnerJobState.PENDING : errorState await this.specificError({ ...options, nextState }) if (nextState === errorState) { runnerJob.setToErrorOrCancel(nextState) runnerJob.error = message } else { runnerJob.resetToPending() } await saveInTransactionWithRetries(runnerJob) if (runnerJob.state === errorState) { const children = await RunnerJobModel.listChildrenOf(runnerJob) for (const child of children) { logger.info(`Erroring child job ${child.uuid} of ${runnerJob.uuid} because of parent error`, this.lTags(child.uuid)) await this.error({ runnerJob: child, message: 'Parent error', fromParent: true }) } } else { PeerTubeSocket.Instance.sendAvailableJobsPingToRunners() } } protected abstract specificError (options: { runnerJob: MRunnerJob message: string nextState: RunnerJobStateType }): Promise | void }