1 import Bull, { Job, JobOptions, Queue } from 'bull'
2 import { jobStates } from '@server/helpers/custom-validators/jobs'
3 import { CONFIG } from '@server/initializers/config'
4 import { processVideoRedundancy } from '@server/lib/job-queue/handlers/video-redundancy'
6 ActivitypubFollowPayload,
7 ActivitypubHttpBroadcastPayload,
8 ActivitypubHttpFetcherPayload,
9 ActivitypubHttpUnicastPayload,
11 DeleteResumableUploadMetaFilePayload,
15 MoveObjectStoragePayload,
17 VideoFileImportPayload,
19 VideoLiveEndingPayload,
20 VideoRedundancyPayload,
21 VideoTranscodingPayload
22 } from '../../../shared/models'
23 import { logger } from '../../helpers/logger'
24 import { JOB_ATTEMPTS, JOB_COMPLETED_LIFETIME, JOB_CONCURRENCY, JOB_TTL, REPEAT_JOBS, WEBSERVER } from '../../initializers/constants'
25 import { Redis } from '../redis'
26 import { processActivityPubCleaner } from './handlers/activitypub-cleaner'
27 import { processActivityPubFollow } from './handlers/activitypub-follow'
28 import { processActivityPubHttpBroadcast } from './handlers/activitypub-http-broadcast'
29 import { processActivityPubHttpFetcher } from './handlers/activitypub-http-fetcher'
30 import { processActivityPubHttpUnicast } from './handlers/activitypub-http-unicast'
31 import { refreshAPObject } from './handlers/activitypub-refresher'
32 import { processActorKeys } from './handlers/actor-keys'
33 import { processEmail } from './handlers/email'
34 import { processMoveToObjectStorage } from './handlers/move-to-object-storage'
35 import { processVideoFileImport } from './handlers/video-file-import'
36 import { processVideoImport } from './handlers/video-import'
37 import { processVideoLiveEnding } from './handlers/video-live-ending'
38 import { processVideoTranscoding } from './handlers/video-transcoding'
39 import { processVideosViews } from './handlers/video-views'
41 type CreateJobArgument =
42 { type: 'activitypub-http-broadcast', payload: ActivitypubHttpBroadcastPayload } |
43 { type: 'activitypub-http-unicast', payload: ActivitypubHttpUnicastPayload } |
44 { type: 'activitypub-http-fetcher', payload: ActivitypubHttpFetcherPayload } |
45 { type: 'activitypub-http-cleaner', payload: {} } |
46 { type: 'activitypub-follow', payload: ActivitypubFollowPayload } |
47 { type: 'video-file-import', payload: VideoFileImportPayload } |
48 { type: 'video-transcoding', payload: VideoTranscodingPayload } |
49 { type: 'email', payload: EmailPayload } |
50 { type: 'video-import', payload: VideoImportPayload } |
51 { type: 'activitypub-refresher', payload: RefreshPayload } |
52 { type: 'videos-views', payload: {} } |
53 { type: 'video-live-ending', payload: VideoLiveEndingPayload } |
54 { type: 'actor-keys', payload: ActorKeysPayload } |
55 { type: 'video-redundancy', payload: VideoRedundancyPayload } |
56 { type: 'delete-resumable-upload-meta-file', payload: DeleteResumableUploadMetaFilePayload } |
57 { type: 'move-to-object-storage', payload: MoveObjectStoragePayload }
59 export type CreateJobOptions = {
64 const handlers: { [id in JobType]: (job: Job) => Promise<any> } = {
65 'activitypub-http-broadcast': processActivityPubHttpBroadcast,
66 'activitypub-http-unicast': processActivityPubHttpUnicast,
67 'activitypub-http-fetcher': processActivityPubHttpFetcher,
68 'activitypub-cleaner': processActivityPubCleaner,
69 'activitypub-follow': processActivityPubFollow,
70 'video-file-import': processVideoFileImport,
71 'video-transcoding': processVideoTranscoding,
72 'email': processEmail,
73 'video-import': processVideoImport,
74 'videos-views': processVideosViews,
75 'activitypub-refresher': refreshAPObject,
76 'video-live-ending': processVideoLiveEnding,
77 'actor-keys': processActorKeys,
78 'video-redundancy': processVideoRedundancy,
79 'move-to-object-storage': processMoveToObjectStorage
82 const jobTypes: JobType[] = [
84 'activitypub-http-broadcast',
85 'activitypub-http-fetcher',
86 'activitypub-http-unicast',
87 'activitypub-cleaner',
93 'activitypub-refresher',
97 'move-to-object-storage'
102 private static instance: JobQueue
104 private queues: { [id in JobType]?: Queue } = {}
105 private initialized = false
106 private jobRedisPrefix: string
108 private constructor () {
111 init (produceOnly = false) {
112 // Already initialized
113 if (this.initialized === true) return
114 this.initialized = true
116 this.jobRedisPrefix = 'bull-' + WEBSERVER.HOST
117 const queueOptions = {
118 prefix: this.jobRedisPrefix,
119 redis: Redis.getRedisClientOptions(),
121 maxStalledCount: 10 // transcoding could be long, so jobs can often be interrupted by restarts
125 for (const handlerName of (Object.keys(handlers) as JobType[])) {
126 const queue = new Bull(handlerName, queueOptions)
130 .catch(err => logger.error('Cannot pause queue %s in produced only job queue', handlerName, { err }))
133 const handler = handlers[handlerName]
135 queue.process(this.getJobConcurrency(handlerName), handler)
136 .catch(err => logger.error('Error in job queue processor %s.', handlerName, { err }))
138 queue.on('failed', (job, err) => {
139 logger.error('Cannot execute job %d in queue %s.', job.id, handlerName, { payload: job.data, err })
142 queue.on('error', err => {
143 logger.error('Error in job queue %s.', handlerName, { err })
146 this.queues[handlerName] = queue
149 this.addRepeatableJobs()
153 for (const queueName of Object.keys(this.queues)) {
154 const queue = this.queues[queueName]
159 createJob (obj: CreateJobArgument, options: CreateJobOptions = {}): void {
160 this.createJobWithPromise(obj, options)
161 .catch(err => logger.error('Cannot create job.', { err, obj }))
164 createJobWithPromise (obj: CreateJobArgument, options: CreateJobOptions = {}) {
165 const queue = this.queues[obj.type]
166 if (queue === undefined) {
167 logger.error('Unknown queue %s: cannot create job.', obj.type)
171 const jobArgs: JobOptions = {
172 backoff: { delay: 60 * 1000, type: 'exponential' },
173 attempts: JOB_ATTEMPTS[obj.type],
174 timeout: JOB_TTL[obj.type],
175 priority: options.priority,
179 return queue.add(obj.payload, jobArgs)
182 async listForApi (options: {
189 const { state, start, count, asc, jobType } = options
191 const states = state ? [ state ] : jobStates
192 let results: Job[] = []
194 const filteredJobTypes = this.filterJobTypes(jobType)
196 for (const jobType of filteredJobTypes) {
197 const queue = this.queues[jobType]
198 if (queue === undefined) {
199 logger.error('Unknown queue %s to list jobs.', jobType)
203 const jobs = await queue.getJobs(states, 0, start + count, asc)
204 results = results.concat(jobs)
207 results.sort((j1: any, j2: any) => {
208 if (j1.timestamp < j2.timestamp) return -1
209 else if (j1.timestamp === j2.timestamp) return 0
214 if (asc === false) results.reverse()
216 return results.slice(start, start + count)
219 async count (state: JobState, jobType?: JobType): Promise<number> {
220 const states = state ? [ state ] : jobStates
223 const filteredJobTypes = this.filterJobTypes(jobType)
225 for (const type of filteredJobTypes) {
226 const queue = this.queues[type]
227 if (queue === undefined) {
228 logger.error('Unknown queue %s to count jobs.', type)
232 const counts = await queue.getJobCounts()
234 for (const s of states) {
242 async removeOldJobs () {
243 for (const key of Object.keys(this.queues)) {
244 const queue = this.queues[key]
245 await queue.clean(JOB_COMPLETED_LIFETIME, 'completed')
249 private addRepeatableJobs () {
250 this.queues['videos-views'].add({}, {
251 repeat: REPEAT_JOBS['videos-views']
252 }).catch(err => logger.error('Cannot add repeatable job.', { err }))
254 if (CONFIG.FEDERATION.VIDEOS.CLEANUP_REMOTE_INTERACTIONS) {
255 this.queues['activitypub-cleaner'].add({}, {
256 repeat: REPEAT_JOBS['activitypub-cleaner']
257 }).catch(err => logger.error('Cannot add repeatable job.', { err }))
261 private filterJobTypes (jobType?: JobType) {
262 if (!jobType) return jobTypes
264 return jobTypes.filter(t => t === jobType)
267 private getJobConcurrency (jobType: JobType) {
268 if (jobType === 'video-transcoding') return CONFIG.TRANSCODING.CONCURRENCY
269 if (jobType === 'video-import') return CONFIG.IMPORT.VIDEOS.CONCURRENCY
271 return JOB_CONCURRENCY[jobType]
274 static get Instance () {
275 return this.instance || (this.instance = new this())
279 // ---------------------------------------------------------------------------