SystemsManagerChangeCalendarとは

SystemsManagerの機能の一つで、カレンダー内の特定の日付・時間に「イベント」を挿入することで、そのイベント間のアクションの実行を制御を行える機能です。

例えば、「毎日定時にSystems Manager Automation ランブックからEC2インスタンスを停止させているが、この日だけは停止させたくない」といった場合に、対象日にイベントを設定しておくことでインスタンスを停止させないということができます。

更にEventBridgeとも連携できるため、柔軟にイベントの管理が行えます。

以下公式ドキュメントです。

AWS Systems Manager の一機能である Change Calendar では、指定したアクション (Systems Manager Automation ランブックなど) が AWS アカウントで実行できるまたはできない日付と時刻の範囲を設定できます。Change Calendar では、このような範囲はイベントと呼ばれます。Change Calendar エントリを作成すると、ChangeCalendar タイプの Systems Manager のドキュメントが作成されます。

使ってみる

実際に使ってみます。
以下の構成のようなイメージで作成します。

Systems Manager Automation ランブックの設定

まず、ChangeCalendarで実行管理するサンプルのメンテナンスウィンドウを作成します。
実行するタスクは「AWS-RestartEC2Instance」、実行時間は15分毎としています。

しばらく放置して正しく実行されていることを確認します。

カレンダーの作成

次にカレンダーを作成します。

最近の発表でカレンダーをインポートして作成することができるというアップデートがありましたので、こちらを利用します。

適当なイベントをGoogleカレンダーに入れ、エクスポートします。

※後にインポートしてわかったのですが、Googleカレンダーの設定が日本標準時だとうまくインポートできません。なので、Googleカレンダーの設定を協定世界時に直してからエクスポートしてください。
↓日本標準時で15:30~16:30のイベントを入れたカレンダーをインポートすると以下のように表示されます。

その後、マネージドコンソールのインポートから先ほどエクスポートした.ics形式のカレンダーをインポートします。
カレンダータイプはそれぞれ

デフォルトで開く：イベントがある場合、タスクを実行しない。
デフォルトで閉じる：イベントがある場合のみタスクを実行する。

となります。

作成すると以下のようにカレンダーが表示されます。

タスクにカレンダーの状態確認ステップを追加

タスクのステップにカレンダーの状態を確認するステップを挟みます。

「ドキュメント」から「AWS-RestartEC2Instance」を選択し、クローンの作成を押下します。

次にドキュメントエディタから以下のように編集し「オートメーションを作成する」を押します。

※AccountID,CalendarNameは置換して下さい。

Copy-AWS-RestartEC2Instance

{
    "description": "Restart EC2 instances(s)",
    "schemaVersion": "0.3",
    "assumeRole": "{{ AutomationAssumeRole }}",
    "parameters": {
      "InstanceId": {
        "type": "StringList",
        "description": "(Required) EC2 Instance(s) to restart"
      },
      "AutomationAssumeRole": {
        "type": "String",
        "description": "(Optional) The ARN of the role that allows Automation to perform the actions on your behalf.",
        "default": ""
      }
    },
    "mainSteps": [
      {
        "name": "checkChangeCalendarOpen",
        "action": "aws:assertAwsResourceProperty",
        "inputs": {
          "Service": "ssm",
          "Api": "GetCalendarState",
          "CalendarNames": [
        "arn:aws:ssm:ap-northeast-1:<AccountID:document/<CalendarName>"
          ],
          "PropertySelector": "$.State",
          "DesiredValues": [
        "OPEN"
          ]
        },
        "nextStep": "stopInstances"
      },
      {
        "name": "stopInstances",
        "action": "aws:changeInstanceState",
        "inputs": {
          "InstanceIds": "{{ InstanceId }}",
          "DesiredState": "stopped"
        }
      },
      {
        "name": "startInstances",
        "action": "aws:changeInstanceState",
        "inputs": {
          "InstanceIds": "{{ InstanceId }}",
          "DesiredState": "running"
        }
      }
    ]
      }

参考：

作成が完了したら「メンテナンスウィンドウ」からドキュメント「AWS-RestartEC2Instance」を「Copy-AWS-RestartEC2Instance」に変更します。

実行確認

イベントが予定されている時間のみ、実行が行われていないか確認します。
対象時間の実行履歴を見てみると...

ChangeCalendarから「OPEN」が返ってきていない為、失敗となっています！

イベントの時間が過ぎると、成功に戻りました。

まとめ

ChangeCalendarでssmAutomationランブックの実行制御を行えることを確認しました。これにより、Cronなどで表現しきれない急なイベントが発生しても、カレンダーにイベントを入れるだけで実行の調整が行えます。
今回はCalendarからOPENが返ってこない場合はエラーという単純な制御でしたが、作りこみ次第でよりいい感じにできると思います。
機会があれば試してみたいです。

SystemsManagerChangeCalendarでssmAutomationランブックの実行を制御する