X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fselection-strategies%2Fweighted-round-robin-worker-choice-strategy.ts;h=fc6f48cf2632a89e0fa1de1afe198ff37eb2cdb7;hb=2c039e4373e86714cdf27e77440b12ee8eb2e4db;hp=6e48f82f2bc877bcf396e0631fb02d9f76dab9a0;hpb=fa6f12966fa14931864dcd13596e080d689464b3;p=poolifier.git diff --git a/src/pools/selection-strategies/weighted-round-robin-worker-choice-strategy.ts b/src/pools/selection-strategies/weighted-round-robin-worker-choice-strategy.ts index 6e48f82f..fc6f48cf 100644 --- a/src/pools/selection-strategies/weighted-round-robin-worker-choice-strategy.ts +++ b/src/pools/selection-strategies/weighted-round-robin-worker-choice-strategy.ts @@ -1,131 +1,114 @@ -import { cpus } from 'os' -import type { AbstractPoolWorker } from '../abstract-pool-worker' -import type { IPoolInternal } from '../pool-internal' +import type { IWorker } from '../worker' +import type { IPool } from '../pool' +import { DEFAULT_WORKER_CHOICE_STRATEGY_OPTIONS } from '../../utils' import { AbstractWorkerChoiceStrategy } from './abstract-worker-choice-strategy' -import type { RequiredStatistics } from './selection-strategies-types' - -/** - * Task run time. - */ -type TaskRunTime = { - weight: number - runTime: number -} +import type { + IWorkerChoiceStrategy, + StrategyPolicy, + TaskStatisticsRequirements, + WorkerChoiceStrategyOptions +} from './selection-strategies-types' /** * Selects the next worker with a weighted round robin scheduling algorithm. * Loosely modeled after the weighted round robin queueing algorithm: https://en.wikipedia.org/wiki/Weighted_round_robin. * - * @template Worker Type of worker which manages the strategy. - * @template Data Type of data sent to the worker. This can only be serializable data. - * @template Response Type of response of execution. This can only be serializable data. + * @typeParam Worker - Type of worker which manages the strategy. + * @typeParam Data - Type of data sent to the worker. This can only be serializable data. + * @typeParam Response - Type of execution response. This can only be serializable data. */ export class WeightedRoundRobinWorkerChoiceStrategy< - Worker extends AbstractPoolWorker, - Data, - Response -> extends AbstractWorkerChoiceStrategy { + Worker extends IWorker, + Data = unknown, + Response = unknown + > + extends AbstractWorkerChoiceStrategy + implements IWorkerChoiceStrategy { /** @inheritDoc */ - public requiredStatistics: RequiredStatistics = { - runTime: true + public readonly strategyPolicy: StrategyPolicy = { + useDynamicWorker: true + } + + /** @inheritDoc */ + public readonly taskStatisticsRequirements: TaskStatisticsRequirements = { + runTime: { + aggregate: true, + average: true, + median: false + }, + waitTime: { + aggregate: false, + average: false, + median: false + }, + elu: { + aggregate: false, + average: false, + median: false + } } - /** - * Worker index where the previous task was submitted. - */ - private previousWorkerIndex: number = 0 - /** - * Worker index where the current task will be submitted. - */ - private currentWorkerIndex: number = 0 /** * Default worker weight. */ - private defaultWorkerWeight: number + private readonly defaultWorkerWeight: number /** - * Per worker task runtime map. + * Worker virtual task runtime. */ - private workerTaskRunTime: Map = new Map< - Worker, - TaskRunTime - >() + private workerVirtualTaskRunTime: number = 0 - /** - * Constructs a worker choice strategy that selects with a weighted round robin scheduling algorithm. - * - * @param pool The pool instance. - */ - public constructor (pool: IPoolInternal) { - super(pool) - this.defaultWorkerWeight = this.computeWorkerWeight() - this.initWorkerTaskRunTime() + /** @inheritDoc */ + public constructor ( + pool: IPool, + opts: WorkerChoiceStrategyOptions = DEFAULT_WORKER_CHOICE_STRATEGY_OPTIONS + ) { + super(pool, opts) + this.setTaskStatisticsRequirements(this.opts) + this.defaultWorkerWeight = this.computeDefaultWorkerWeight() } /** @inheritDoc */ - public choose (): Worker { - const currentWorker = this.pool.workers[this.currentWorkerIndex] - if (this.isDynamicPool === true) { - this.workerTaskRunTime.has(currentWorker) === false && - this.workerTaskRunTime.set(currentWorker, { - weight: this.defaultWorkerWeight, - runTime: 0 - }) - } - const workerVirtualTaskRunTime = - this.getWorkerVirtualTaskRunTime(currentWorker) ?? 0 - const workerTaskWeight = - this.workerTaskRunTime.get(currentWorker)?.weight ?? - this.defaultWorkerWeight - if (this.currentWorkerIndex === this.previousWorkerIndex) { - const workerTaskRunTime = - (this.workerTaskRunTime.get(currentWorker)?.runTime ?? 0) + - workerVirtualTaskRunTime - this.workerTaskRunTime.set(currentWorker, { - weight: workerTaskWeight, - runTime: workerTaskRunTime - }) - } else { - this.workerTaskRunTime.set(currentWorker, { - weight: workerTaskWeight, - runTime: 0 - }) - } - if ( - workerVirtualTaskRunTime < - (this.workerTaskRunTime.get(currentWorker) ?? this.defaultWorkerWeight) - ) { - this.previousWorkerIndex = this.currentWorkerIndex - } else { - this.previousWorkerIndex = this.currentWorkerIndex - this.currentWorkerIndex = - this.pool.workers.length - 1 === this.currentWorkerIndex - ? 0 - : this.currentWorkerIndex + 1 - } - return this.pool.workers[this.currentWorkerIndex] + public reset (): boolean { + this.nextWorkerNodeId = 0 + this.workerVirtualTaskRunTime = 0 + return true } - private computeWorkerWeight () { - let cpusCycleTimeWeight = 0 - for (const cpu of cpus()) { - // CPU estimated cycle time - const numberOfDigit = cpu.speed.toString().length - 1 - const cpuCycleTime = 1 / (cpu.speed / Math.pow(10, numberOfDigit)) - cpusCycleTimeWeight += cpuCycleTime * Math.pow(10, numberOfDigit) - } - return cpusCycleTimeWeight / cpus().length + /** @inheritDoc */ + public update (): boolean { + return true } - private initWorkerTaskRunTime () { - for (const worker of this.pool.workers) { - this.workerTaskRunTime.set(worker, { - weight: this.defaultWorkerWeight, - runTime: 0 - }) + /** @inheritDoc */ + public choose (): number { + const chosenWorkerNodeKey = this.nextWorkerNodeId + const workerVirtualTaskRunTime = this.workerVirtualTaskRunTime + const workerWeight = + this.opts.weights?.[chosenWorkerNodeKey] ?? this.defaultWorkerWeight + if (workerVirtualTaskRunTime < workerWeight) { + this.workerVirtualTaskRunTime = + workerVirtualTaskRunTime + + this.getWorkerTaskRunTime(chosenWorkerNodeKey) + } else { + this.nextWorkerNodeId = + this.nextWorkerNodeId === this.pool.workerNodes.length - 1 + ? 0 + : this.nextWorkerNodeId + 1 + this.workerVirtualTaskRunTime = 0 } + return chosenWorkerNodeKey } - private getWorkerVirtualTaskRunTime (worker: Worker): number | undefined { - return this.pool.getWorkerAverageTasksRunTime(worker) + /** @inheritDoc */ + public remove (workerNodeKey: number): boolean { + if (this.nextWorkerNodeId === workerNodeKey) { + if (this.pool.workerNodes.length === 0) { + this.nextWorkerNodeId = 0 + } else if (this.nextWorkerNodeId > this.pool.workerNodes.length - 1) { + this.nextWorkerNodeId = this.pool.workerNodes.length - 1 + } + this.workerVirtualTaskRunTime = 0 + } + return true } }