Infrastructure as Code

SteadyCron は Infrastructure as Code ファーストです。ダッシュボードをクリックする代わりに、YAML マニフェストでジョブを宣言的に記述し、リポジトリにコミットし、CLI でアカウントと同期できます。

マニフェスト

マニフェストはジョブのリストです — HTTP ジョブとハートビートチェックの両方を宣言的に記述します。例えば：

jobs:
  - name: weekly-digest-email
    kind: http
    method: POST
    url: https://api.myapp.com/jobs/digest
    schedule: "0 9 * * 1"
    timezone: Asia/Tokyo
    timeout: 120
    retries: 3

  - name: nightly-db-backup
    kind: heartbeat
    schedule: "0 2 * * *"
    grace: 1800

同期

CLI を使ってアカウントをマニフェストと同期します。

steadycron sync jobs.yaml

sync は宣言的です: 新しいジョブを作成し、変更されたジョブを更新し、ファイルに存在しないサーバー上のジョブを報告します。すべてのマージ時に CI から実行して環境を同一に保ち、ドリフトを排除してください。

認証

CLI は API キーで認証します。ダッシュボードでキーを作成し、マニフェストに含まれないよう環境変数で指定します。

export STEADYCRON_API_KEY=sc_...
steadycron sync jobs.yaml

スコープとキー管理については API と認証 を参照してください。

REST API

CLI が行うことはすべて REST API で直接実行できます — ダッシュボード、CLI、API はすべて同じエンドポイントで構築されています。API と認証 を参照してください。