コンテンツにスキップ

決まった時刻の起動を有効にする

メンバーのスケジュールが、止まっているワークスペースを決まった時刻に起動して、プロンプトを実行できるようにします。 スケジューラーは既定で有効です。ここでは、無効にする方法と、起動の遅い配備で待ち時間を延ばす方法を扱います。

あなたがやること 起きること
何もしない スケジューラーは 1 分ごとに動く。スケジュールがなければ何もしない
SchedulerInterval=0 にする 決まった時刻の起動はすべて止まり、Console は「スケジュール」を隠す
ScheduleWakeTimeout を延ばす 起動に時間のかかるワークスペースでも、最初の試行で間に合う

スケジュールを作って使う側の手順は 決まった時刻に実行する にあります。

30-ingress に 4 つのパラメータがあります。既定のままにするときは空欄にします。 同じ値をスタックに書き写すと、製品の既定が変わっても追随しません。

パラメータ Control Plane の環境変数 既定 中身
SchedulerInterval AF_SCHEDULER_INTERVAL 1m スケジューラーがスケジュールを確認する間隔。0 で完全に無効になり、何も起動せず、Console の「スケジュール」も消える
ScheduleWakeTimeout AF_SCHEDULE_WAKE_TIMEOUT 300s 1 回の実行で、起動した Agent の応答を待つ時間。下の注意を参照
ScheduleSettle AF_SCHEDULE_SETTLE 5m 起動したワークスペースを、実行のあとも止めずにおく時間。ターンの途中でアイドル停止されないようにする
ScheduleJitter AF_SCHEDULE_JITTER 2m cron の実行を、この幅の中で、スケジュールごとに決まった量だけずらす。9 時ちょうどに全員のワークスペースが一斉に起動しないようにする。0 で時刻どおり

ecs-ec2 では、測らずに ScheduleWakeTimeout を下げないでください。

  • 待ち時間は起動を指示した時点から数えます。スロットの起動、ECS への登録、ホームのマウントはバックグラウンドで進むので、計測は Control Plane のログの Agent healthy Ns after Start より 20 秒ほど前に始まっています
  • ある配備では、同じワークスペース・同じスケジュール・同じスロットで、5 日続けて朝の起動に 65〜131 秒かかりました。90 秒の待ち時間では、5 回のうち 3 回が知らせもなく実行されませんでした
  • 待ち時間をこのばらつきの範囲内に設定すると、止まっているワークスペースの朝のスケジュールが、動いたり動かなかったりします
  • 届かなかった実行は、そのあと 15 分のあいだ、次の間隔ごとにやり直します。ただし、やり直すたびにワークスペースを起動し直すので、最初の試行で間に合う長さにしておきます

エージェント向け

この指示をエージェントに送ると、このページを読ませられます。

https://agent-fleet.org/docs/ja/operate/aws-ecs/schedules/index.md を読んで