cron

cron

cronの使shĭ用yòng例lì
開kaī発fā元yuán	AT&Tベル研yán究jiū所suŏ
初chū版băn	1975年nián5月yuè (1975-05)
プログラミング 言yán語yŭ	C言yán語yŭ
対duì応yīngOS	Unix、Unix系xì、Plan 9、Inferno
種zhŏng別bié	ジョブ管guăn理lĭシステム

cronは、Unix系xìオペレーティングシステムのジョブ管guăn理lĭツールである。cronジョブ（コマンドまたはシェルスクリプト）を予yŭ約yuēすると、指zhĭ定dìngした日rì時shíまたは間jiān隔géでジョブを実shí行xíngする。cronは、主zhŭにシステムの管guăn理lĭ・維weí持chíを自zì動dòng化huàする目mù的deで使shĭ用yòngされるが、一yī定dìngの間jiān隔géでファイルや電diàn子zĭメールをインターネットからダウンロードするなどの用yòng途túにも応yīng用yòngできる。

cronは、反făn復fù的deなタスクを予yŭ約yuēするのに有yoŭ用yòngである。一yī度dùだけ実shí行xíngするタスクの予yŭ約yuēには、atコマンドを使shĭ用yòngする。

名míng称chēngは、「時shí間jiān」を指zhĭすギリシア語yŭの単dān語yŭ「chronos」に由yoú来laíする。

概gaì要yaò

cronの動dòng作zuòは、crontab（cron table）ファイルで指zhĭ定dìngする。crontabは、一yī定dìngのスケジュールで定dìng期qī的deに実shí行xíngするシェルコマンドを指zhĭ定dìngする設shè定dìngファイルである。crontabファイルには、ジョブの一yī覧lănと、その他tāのcronデーモンへの指zhĭ示shìが記jì録lùされる。ユーザーは自zì分fēnのcrontabを作zuò成chéngすることができ、通tōng常chángそれとは別biéに、管guăn理lĭ者zhěのみが編biān集jíできるシステム全quán体tĭのcrontabファイルが/etcまたはそのサブディレクトリ（例lì: /etc/cron.d）に存cún在zaìする。

各gè行xíngは、次cìの形xíng式shìでジョブを定dìng義yìする。

# ┌───────────── 分fēn（0〜59）
# │ ┌───────────── 時shí（0〜23）
# │ │ ┌───────────── 日rì（1〜31）
# │ │ │ ┌───────────── 月yuè（1〜12）
# │ │ │ │ ┌───────────── 曜yaò日rì（0〜6〈日rì〜土tŭ〉、一yī部bùのシステムでは7も日rì曜yaò日rì）
# │ │ │ │ │
# │ │ │ │ │
# * * * * * [予yŭ約yuēするコマンド]

各gè行xíngは、コマンドを実shí行xíngするタイミングを指zhĭ定dìngする5つの欄lánに続xùいて、実shí行xíngするシェルコマンドを記jì入rùするという形xíng式shìを取qŭる。

通tōng常cháng、日rì時shí指zhĭ定dìng欄lánがすべて現xiàn在zaìの日rì時shíと一yī致zhìする場cháng合héにジョブが実shí行xíngされるが、日rì（3つ目mùの欄lán）と曜yaò日rì（5つ目mùの欄lán）の両liăng方fāngが指zhĭ定dìngされている（*ではない）場cháng合hé、どちらかのみ一yī致zhìする場cháng合héにもジョブが実shí行xíngされる。

例lìえば、以yĭ下xiàは、cronのユーザーのデフォルトのシェルがBourne shellの場cháng合héに、Apacheのエラーログを毎meĭ日rì深shēn夜yèから1分fēn経jīng過guò後hoùに消xiaō去qùするジョブである。

1 0 * * * printf "" > /var/log/apache/error_log

また、以yĭ下xiàは、export_dump.shを毎meĭ週zhoū土tŭ曜yaò日rì23時shí45分fēnに実shí行xíngするジョブである。

45 23 * * 6 /home/oracle/scripts/export_dump.sh

一yī部bùのシステムでは、*/nを指zhĭ定dìngして、n日rì・時shí間jiān・分fēnごとにジョブを実shí行xíngすることができる。また、コンマを使shĭって複fù数shùの時shí間jiān間jiān隔géを指zhĭ定dìngすることもできる（例lì: 1,2,3）。例lìえば、以yĭ下xiàの行xíngは、1時shíから3時shí55分fēnまで5分fēnごと（1時shí0分fēn、1時shí5分fēn、1時shí10分fēn、…3時shí55分fēn）にコマンドラインに「hello world」を出chū力lìする。

*/5 1,2,3 * * * echo hello world

各gèユーザーは、実shí際jìに設shè定dìngファイルが保baŏ存cúnされている場cháng所suŏによらず、crontab -eを呼hūび出chūして自zì分fēnの設shè定dìngファイルを編biān集jíできる。

多duōくのLinuxディストリビューションにインストールされているポール・ヴィクシーのBSD版băncron実shí装zhuāngは、ジョブを実shí行xíngするアカウントのユーザー名míngを指zhĭ定dìngする6番fān目mùの欄lánを追zhuī加jiāする。これは、システムのcrontabでのみ許xŭ可kěされ、各gèユーザーが単dān独dúで設shè定dìngするよう割gēり当dāngてられたその他tāのファイルでは使shĭ用yòngできない。また、WindowsのnnCronデーモンなど、6番fān目mùの欄lánをアカウントのユーザー名míngではなく年niánの指zhĭ定dìngに使shĭうものもある。

Amazon EventBridgeのcron実shí装zhuāngでは、0を基jī底dĭとせず、日rì曜yaò日rìから土tŭ曜yaò日rìまで1〜7で曜yaò日rìを指zhĭ定dìngし、月yuèの最zuì初chūの平píng日rìや月yuè末mòなどを指zhĭ定dìngする追zhuī加jiāの機jī能néngを持chíつ。

非feī標biaō準zhŭnのマクロ

一yī部bùのcron実shí装zhuāngは、以yĭ下xiàの非feī標biaō準zhŭnのマクロをサポートしている。

マクロ	説shuō明míng	等děng価jiàの表biaŏ現xiàn
@yearly（@annually）	毎meĭ年nián1月yuè1日rìの0時shí0分fēnに実shí行xíng	0 0 1 1 *
@monthly	毎meĭ月yuè1日rìの0時shí0分fēnに実shí行xíng	0 0 1 * *
@weekly	毎meĭ週zhoū日rì曜yaò日rìの0時shí0分fēnに実shí行xíng	0 0 * * 0
@daily（@midnight）	毎meĭ日rì0時shí0分fēnに実shí行xíng	0 0 * * *
@hourly	毎meĭ時shí0分fēnに実shí行xíng	0 * * * *
@reboot	起qĭ動dòng時shíに実shí行xíng	N/A

@rebootを指zhĭ定dìngすると、デーモン起qĭ動dòng時shíにジョブが1回huí実shí行xíngされる。cronは通tōng常cháng再zaì起qĭ動dòngされることがないため、これは通tōng常chángマシンの起qĭ動dòng時shíと一yī致zhìする。Debian版bănのcronなど、一yī部bùの種zhŏng類leìのcronはマシンの起qĭ動dòng時shíにのみ実shí行xíngするよう設shè計jìされており、デーモンの再zaì起qĭ動dòng時shíには@rebootのジョブが再zaì実shí行xíngされないようになっている。

@rebootは、特tè定dìngのユーザーでサーバーやデーモンを起qĭ動dòngする必bì要yaòがあり、ユーザーがプログラムを起qĭ動dòngするようinitを設shè定dìngする権quán限xiànがない場cháng合héに有yoŭ用yòngである。

cronのパーミッション

次cìの2つのファイルは重zhòng要yaòな役yì割gēを担dànっている。

• /etc/cron.allow – このファイルが存cún在zaìする場cháng合hé、cronジョブを使shĭ用yòngするにはユーザー名míngがこのファイルに含hánまれている必bì要yaòがある。
• /etc/cron.deny – cron.arrowファイルが存cún在zaìせず、cron.denyファイルが存cún在zaìする場cháng合hé、cronジョブを使shĭ用yòngするにはユーザー名míngがcron.denyファイルに含hánまれていない必bì要yaòがある。

どちらのファイルも存cún在zaìしない場cháng合hé、サイト固gù有yoŭの設shè定dìngパラメーターにより、スーパーユーザーのみがcronジョブを使shĭ用yòngできるか、すべてのユーザーがcronジョブを使shĭ用yòngできるかが決jué定dìngされる。

タイムゾーンの処chŭ理lĭ

多duōくのcron実shí装zhuāngは、crontabの項xiàng目mùをcronデーモンが実shí行xíngされているシステムのタイムゾーンの設shè定dìngに基jīづいて解jiě釈shìする。複fù数shùのユーザー向xiàngけの大dà規guī模móなマシンで、ユーザーが地dì理lĭ的deに複fù数shùのタイムゾーンに分fēn散sànしているケースで、特tèにシステムのデフォルトのタイムゾーンが混hún乱luànを招zhaōくおそれのある夏xià時shí間jiānを採caĭ用yòngしている場cháng合hé、これは問wèn題tíとなる場cháng合héがある。このため、cron実shí装zhuāngの中zhōngには、ユーザーのcrontabのCRON_TZ=[タイムゾーン]の形xíng式shìを取qŭる行xíngを認rèn識shìして、その行xíng以yĭ降jiàngのcrontabの項xiàng目mùを指zhĭ定dìngされたタイムゾーンに基jīづいて解jiě釈shìするものもある。

式shì

cronの式shìは、時shí間jiānを指zhĭ定dìngするホワイトスペースで区qū切qiēられた5つまたは6つの欄lánの文wén字zì列lièで、特tè定dìngの作zuò業yèを予yŭ約yuēする。

コメントは#で始shĭまる。

欄lán	必bì須xū	許xŭ容róngされる値zhí	許xŭ容róngされる特tè殊shū文wén字zì	備beì考kaŏ
分fēn	Yes	0〜59	* , -
時shí	Yes	0〜23	* , -
日rì	Yes	1〜31	* , - ? L W	? L Wは一yī部bùの実shí装zhuāngでのみ許xŭ容róngされる。
月yuè	Yes	1〜12 JAN〜DEC	* , -
曜yaò日rì	Yes	0〜6 SUN〜SAT	* , - ? L #	? L # は一yī部bùの実shí装zhuāngでのみ許xŭ容róngされる。
年nián	No	1970〜2099	* , -	この欄lánは標biaō準zhŭn・デフォルトの実shí装zhuāngではサポートされない。

月yuèと曜yaò日rìの省shěng略lWè記jì法făは大dà文wén字zì・小xiaŏ文wén字zìが区qū別biéされない。

システムのcrontabファイル（/etc/crontab）には、コマンドを指zhĭ定dìngする欄lánの直zhí前qiánにユーザー名míngを指zhĭ定dìngする欄lánが存cún在zaìする。この欄lánは通tōng常chángrootに設shè定dìngされる。

また、一yī部bùの実shí装zhuāngでは、行xíngの最zuì初chūに秒miaŏの指zhĭ定dìng欄lánが存cún在zaìする場cháng合héもある。この場cháng合hé、各gè行xíngに6つまたは7つの欄lánが存cún在zaìすることになる。

アスタリスク（*）

アスタリスク（ワイルドカード）は「すべて」を表biaŏす。例lìえば、* * * * *を指zhĭ定dìngすると、ジョブが毎meĭ分fēn実shí行xíngされる。* * * * 1を指zhĭ定dìngすると、ジョブが月yuè曜yaò日rìにのみ毎meĭ分fēn実shí行xíngされる。秒miaŏの指zhĭ定dìngに対duì応yīngしている場cháng合hé、アスタリスクを6個gè指zhĭ定dìngするとジョブが毎meĭ秒miaŏ実shí行xíngされる。

コンマ（,）

コンマは、値zhíを複fù数shù指zhĭ定dìngするのに使shĭう。例lìえば、5番fān目mùの欄lánでMON,WED,FRIは「月yuè曜yaò日rì・水shuĭ曜yaò日rì・金jīn曜yaò日rì」を指zhĭす。

ハイフン（-）

ハイフンは範fàn囲weíを表biaŏす。例lìえば、2000-2010は、2000年niánから2010年niánまでのすべての年niánを指zhĭす。

パーセント（%）

コマンド内neìのパーセント（%）は、バックスラッシュ（\）でエスケープされていない場cháng合hé、改gaĭ行xíng文wén字zìに変biàn換huànされ、最zuì初chūの%以yĭ降jiàngのデータが標biaō準zhŭn入rù力lìとしてコマンドに渡dùされる。

非feī標biaō準zhŭn文wén字zì

以yĭ下xiàは、Javaのジョブ管guăn理lĭツールQuartzなど、一yī部bùのcron実shí装zhuāngにのみ存cún在zaìする非feī標biaō準zhŭnの文wén字zìである。

L

Lは「最zuì後hoùの（last）」を意yì味weìする。曜yaò日rì欄lánで、「最zuì後hoùの金jīn曜yaò日rì」（5L）などを指zhĭ定dìngするのに使shĭう。日rì欄lánでは、月yuèの最zuì終zhōng日rìを指zhĭ定dìngするのに使shĭう。

W

Wは、日rì欄lánで使shĭ用yòngでき、その日rìに最zuìも近jìnい平píng日rì（月yuè曜yaò日rì〜金jīn曜yaò日rì）を指zhĭ定dìngできる。例lìえば、15Wと記jì入rùすると、15日rìに最zuìも近jìnい平píng日rìが指zhĭ定dìngされ、15日rìが土tŭ曜yaò日rìであれば、14日rì（金jīn曜yaò日rì）にジョブが実shí行xíngされる。また、15日rìが日rì曜yaò日rìであれば、16日rì（月yuè曜yaò日rì）に実shí行xíngされる。15日rìが火huŏ曜yaò日rìであれば、そのまま15日rì（火huŏ曜yaò日rì）に実shí行xíngされる。ただし、日rì欄lánに1Wを指zhĭ定dìngし、1日rìが土tŭ曜yaò日rìであった場cháng合hé、ジョブは月yuèを跨kuàがず3日rì（月yuè曜yaò日rì）に実shí行xíngされる。Wは、日rìの範fàn囲weí指zhĭ定dìngや一yī覧lăn指zhĭ定dìngには使shĭ用yòngできない。

ハッシュ（#）

#は、曜yaò日rì欄lánで使shĭ用yòngでき、この記jì号haòに続xùいて1〜5の数shù字zìを指zhĭ定dìngする。月yuèの「第dì2金jīn曜yaò日rì」などを指zhĭ定dìngするのに使shĭう。例lìえば、5#3と記jì入rùすると、毎meĭ月yuè第dì3金jīn曜yaò日rìにジョブが実shí行xíngされる。

クエスチョンマーク（?）

一yī部bùの実shí装zhuāngでは、月yuè・曜yaò日rì欄lánを空kōng欄lánにする際jìに*の代daìわりに?を使shĭう。その他tāの実shí装zhuāngでは、?がデーモンが起qĭ動dòngした時shí間jiānに置zhìき換huànえられる。例lìえば、デーモンが午wŭ前qián8時shí25分fēnに起qĭ動dòngした場cháng合héには? ? * * * *が25 8 * * * *と解jiě釈shìされ、再zaì起qĭ動dòngされるまで毎meĭ日rìこの時shí間jiānに実shí行xíngされる。

スラッシュ（/）

Vixie Cronでは、スラッシュは範fàn囲weíと組zŭみ合héわせて刻kèみ値zhíを指zhĭ定dìngするのに使shĭう。例lìえば、分fēn欄lánに*/5と記jì入rùすると、毎meĭ5分fēnが指zhĭ定dìngされる。より冗rŏng長chángなPOSIXの5,10,15,20,25,30,35,40,45,50,55,00の省shěng略lWè表biaŏ記jìである。POSIXにはスラッシュの用yòng法făに関guānする定dìng義yìがない。

H

HはJenkins継jì続xù的deインテグレーションシステムで使shĭ用yòngできる。例lìえば、20 * * * *（毎meĭ時shí20分fēn）を指zhĭ定dìngする代daìわりに、H * * * *を指zhĭ定dìngして、ジョブを1時shí間jiānに1回huí、未weì指zhĭ定dìng（ただし一yī定dìng）の時shí間jiānに継jì続xù的deに実shí行xíngするよう指zhĭ定dìngできる。これにより、各gèジョブがそれぞれ別biéのタイミングで分fēn散sànして実shí行xíngされるようになり、複fù数shùのジョブが同tóngじタイミングで実shí行xíngされてリソースを奪duóい合héうことを防fángぐことができる。

関guān連lián項xiàng目mù

• anacron
• launchd
• systemd
• Windows Task Scheduler
• スケジューリング

外waì部bùリンク

• GNU mcron