mirror of https://github.com/nextcloud/server.git
Merge pull request #27217 from nextcloud/techdebt/noid/make-debugging-a-cron-job-easier
John Molakvoæ
3 years ago
committed by
GitHub
commit
f7a4ff4d63
@ -0,0 +1,156 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
/**
|
||||
* @copyright Copyright (c) 2021, Joas Schilling <coding@schilljs.com>
|
||||
*
|
||||
* @author Joas Schilling <coding@schilljs.com>
|
||||
*
|
||||
* @license GNU AGPL version 3 or any later version
|
||||
*
|
||||
* This program is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as
|
||||
* published by the Free Software Foundation, either version 3 of the
|
||||
* License, or (at your option) any later version.
|
||||
*
|
||||
* This program is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
*
|
||||
*/
|
||||
|
||||
namespace OC\Core\Command\Background;
|
||||
|
||||
use OCP\BackgroundJob\IJob;
|
||||
use OCP\BackgroundJob\IJobList;
|
||||
use OCP\ILogger;
|
||||
use Symfony\Component\Console\Command\Command;
|
||||
use Symfony\Component\Console\Input\InputArgument;
|
||||
use Symfony\Component\Console\Input\InputInterface;
|
||||
use Symfony\Component\Console\Input\InputOption;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
|
||||
class Job extends Command {
|
||||
/** @var IJobList */
|
||||
protected $jobList;
|
||||
/** @var ILogger */
|
||||
protected $logger;
|
||||
|
||||
public function __construct(IJobList $jobList,
|
||||
ILogger $logger) {
|
||||
parent::__construct();
|
||||
$this->jobList = $jobList;
|
||||
$this->logger = $logger;
|
||||
}
|
||||
|
||||
protected function configure(): void {
|
||||
$this
|
||||
->setName('background-job:execute')
|
||||
->setDescription('Execute a single background job manually')
|
||||
->addArgument(
|
||||
'job-id',
|
||||
InputArgument::REQUIRED,
|
||||
'The ID of the job in the database'
|
||||
)
|
||||
->addOption(
|
||||
'force-execute',
|
||||
null,
|
||||
InputOption::VALUE_NONE,
|
||||
'Force execute the background job, independent from last run and being reserved'
|
||||
)
|
||||
;
|
||||
}
|
||||
|
||||
protected function execute(InputInterface $input, OutputInterface $output): int {
|
||||
$jobId = (int) $input->getArgument('job-id');
|
||||
|
||||
$job = $this->jobList->getById($jobId);
|
||||
if ($job === null) {
|
||||
$output->writeln('<error>Job with ID ' . $jobId . ' could not be found in the database</error>');
|
||||
return 1;
|
||||
}
|
||||
|
||||
$this->printJobInfo($jobId, $job, $output);
|
||||
$output->writeln('');
|
||||
|
||||
$lastRun = $job->getLastRun();
|
||||
if ($input->getOption('force-execute')) {
|
||||
$lastRun = 0;
|
||||
$output->writeln('<comment>Forcing execution of the job</comment>');
|
||||
$output->writeln('');
|
||||
|
||||
$this->jobList->resetBackgroundJob($job);
|
||||
}
|
||||
|
||||
$job = $this->jobList->getById($jobId);
|
||||
$job->execute($this->jobList, $this->logger);
|
||||
$job = $this->jobList->getById($jobId);
|
||||
|
||||
if ($lastRun !== $job->getLastRun()) {
|
||||
$output->writeln('<info>Job executed!</info>');
|
||||
$output->writeln('');
|
||||
|
||||
if ($job instanceof \OC\BackgroundJob\TimedJob || $job instanceof \OCP\BackgroundJob\TimedJob) {
|
||||
$this->printJobInfo($jobId, $job, $output);
|
||||
}
|
||||
} else {
|
||||
$output->writeln('<comment>Job was not executed because it is not due</comment>');
|
||||
$output->writeln('Specify the <question>--force-execute</question> option to run it anyway');
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
protected function printJobInfo(int $jobId, IJob $job, OutputInterface$output): void {
|
||||
$row = $this->jobList->getDetailsById($jobId);
|
||||
|
||||
$lastRun = new \DateTime();
|
||||
$lastRun->setTimestamp((int) $row['last_run']);
|
||||
$lastChecked = new \DateTime();
|
||||
$lastChecked->setTimestamp((int) $row['last_checked']);
|
||||
$reservedAt = new \DateTime();
|
||||
$reservedAt->setTimestamp((int) $row['reserved_at']);
|
||||
|
||||
$output->writeln('Job class: ' . get_class($job));
|
||||
$output->writeln('Arguments: ' . json_encode($job->getArgument()));
|
||||
|
||||
$isTimedJob = $job instanceof \OC\BackgroundJob\TimedJob || $job instanceof \OCP\BackgroundJob\TimedJob;
|
||||
if ($isTimedJob) {
|
||||
$output->writeln('Type: timed');
|
||||
} elseif ($job instanceof \OC\BackgroundJob\QueuedJob || $job instanceof \OCP\BackgroundJob\QueuedJob) {
|
||||
$output->writeln('Type: queued');
|
||||
} else {
|
||||
$output->writeln('Type: job');
|
||||
}
|
||||
|
||||
$output->writeln('');
|
||||
$output->writeln('Last checked: ' . $lastChecked->format(\DateTimeInterface::ATOM));
|
||||
if ((int) $row['reserved_at'] === 0) {
|
||||
$output->writeln('Reserved at: -');
|
||||
} else {
|
||||
$output->writeln('Reserved at: <comment>' . $reservedAt->format(\DateTimeInterface::ATOM) . '</comment>');
|
||||
}
|
||||
$output->writeln('Last executed: ' . $lastRun->format(\DateTimeInterface::ATOM));
|
||||
$output->writeln('Last duration: ' . $row['execution_duration']);
|
||||
|
||||
if ($isTimedJob) {
|
||||
$reflection = new \ReflectionClass($job);
|
||||
$intervalProperty = $reflection->getProperty('interval');
|
||||
$intervalProperty->setAccessible(true);
|
||||
$interval = $intervalProperty->getValue($job);
|
||||
|
||||
$nextRun = new \DateTime();
|
||||
$nextRun->setTimestamp($row['last_run'] + $interval);
|
||||
|
||||
if ($nextRun > new \DateTime()) {
|
||||
$output->writeln('Next execution: <comment>' . $nextRun->format(\DateTimeInterface::ATOM) . '</comment>');
|
||||
} else {
|
||||
$output->writeln('Next execution: <info>' . $nextRun->format(\DateTimeInterface::ATOM) . '</info>');
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
Loading…
Reference in New Issue