CRON 式

TeamCity を使用すると、cron(英語) 形式を使用して通常の操作を柔軟にスケジュールできます。現在、cron のような式がスケジュールトリガーとサーバーのクリーンアップでサポートされています。

TeamCity は cron 式を扱うために石英(英語)を使います。以下の例を参照するか、CronMaker(英語) ユーティリティを使用して Quartz cron 形式に基づいて式を生成することを検討してください。

TeamCity の cron 形式

cron 式は、6 つのフィールドと、空白で区切られた 1 つのオプションのフィールドで構成されます。フィールドはそれぞれ次のように説明されます。

フィールド名	値	特殊キャラクター
秒	0\-59	, \- * /
分	0\-59	, \- * /
時間	0\-23	, \- * /
月の日付	1\-31	、\- * ? /LW
月	1 月～ 12 月 1 ～ 12 日	, \- * /
曜日	1\-7 または日曜日 \- 土曜日	, \- * ? /L #
年 (オプション)	空、1970\-2099	, \- * /

特殊文字の説明については、Quartz CronTrigger チュートリアル(英語)を参照してください。

サンプル

スケジュール	クロン式
2 時間ごとに: 30	`0 30 0/2 * * ? *`
毎日午後 11 時 45 分	`0 45 23 * * ? *`
毎週日曜日の午前 1:00	`0 0 1 ? * 1 *`
毎月末日の午前 10:00 と午後 10:00	`0 0 10,22 L * ? *`
平日は 2 時間おき、土日はなし	`0 0 0/2 ? * 2-6 *`

この表の cron 式の形式は次のとおりです。

Sec Min Hour Day-of-month Month Day-of-week Year

他の例(英語)も参照してください。

Kotlin DSL

Kotlin DSL を使用して、0 0 0/2 ? * 2-6 * cron 式でスケジュールトリガーを構成します。

object Build : BuildType({
    triggers {
        schedule {
            schedulingPolicy = cron {
                seconds = "0"
                minutes = "0"
                hours = "0/2"
                dayOfMonth = "?"
                month = "*"
                dayOfWeek = "2-6"
                year = "*"
            }
            triggerBuild = always()
        }
    }
})

2025 年 4 月 07 日

関連ページ：

スケジュールトリガーの設定

スケジュールトリガーを使用すると、特定の構成でビルドを自動的に実行するためのスケジュールを定義できます。1 つのビルド構成に複数のスケジュールトリガーを追加できます。現在のプロジェクト設定のスケジュールを構築するセクションには、構成されたビルド時間が表示されます。トリガー条件：このセクションでは、タイミングや VCS ルールなどのスケジュールトリガーのパラメーターについて説明します。日時定期的なビルドをスケジュールしたり、特定の日時を設定したりできます。特定のタイムゾーンで毎日または毎週の指定...

TeamCity データのクリーンアップ

TeamCity のクリーンアップ機能により、古いビルドデータや不要なビルドデータを自動的に削除できます。サーバーのクリーンアップ構成は管理 | サーバー管理 | クリーンアップ設定で使用可能です。クリーンアップスケジュールの設定が可能で、一般的なクリーンアップ情報が表示されます。特定のプロジェクトに関連するクリーンアップルールはプロジェクト設定で設定されます | クリーンアップルール。これらのルールは、どのデータをクリーンアップし、どのデータを保持するかを定義します。これらは、プロジェクトまた...

変更状態

この記事では、検出されたビルド変更またはコミットに応じて表示される視覚的なインジケーターを一覧表示します。保留変更は、現在ビルドキューにあるビルドに統合される予定です。変更がビルドに正常に統合された場合でも、別のビルドに追加されるようにスケジュールされている場合、変更は保留中として表示されます。正常に実行変更は、正常に実行されているビルドに統合されています。成功変更はビルドに統合され、正常に終了しました。実行中および失敗変更は、失敗しているビルドに統合されています。失敗変更は、失敗したビルドに統...

ビルド状態

プロジェクトページのビルド構成の拡大表示に、ビルド状態アイコンが各ビルドの横に表示されます。構築国：正常に実行ビルドは正常に実行されています。成功指定されたすべてのビルド構成でビルドが正常に終了しました。実行中および失敗ビルドが失敗しています。失敗少なくとも 1 つの指定されたビルド構成でビルドが失敗しました。キャンセルビルドは取り消されました。キャンセル / 中止ビルド実行中のビルドを停止すると、ビルドステータスがキャンセル済みとして表示されます。実行中のビルドは、