0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【AWS】Step Functions × Sysprepで実現する「元環境を壊さない」Windows AMI自動生成パイプラインの構築

0
Last updated at Posted at 2026-07-29

概要

運用環境の Windows EC2 インスタンスから定期的に最新のゴールデン AMI(マスターイメージ)を作成し、Auto Scaling 用の起動テンプレート(Launch Template) を更新する運用、手動でやると結構手間ですよね。

特に Windows の場合、以下のような課題があります。

  • Sysprep の不可逆性: 直接 Sysprep を実行するとそのインスタンス自体が初期化されてしまい、元の環境として再利用できなくなる。
  • 手作業のミス・手間: 停止 wait ➔ AMI 作成 ➔ 一時インスタンス起動 ➔ SSM で Sysprep ➔ 再度 AMI 化 ➔ 後始末… という工程が多く、手動だとミスが起きやすい。

そこで今回、AWS Step Functions(JSONata 仕様) を活用し、「元サーバには一切影響を与えずに、完全自動で Sysprep 済みの最新 AMI 作成&起動テンプレート更新まで行うパイプライン」 をチームで構築してみました!

※ 本記事に登場するシステム名、リソース名、IPアドレスなどはすべて仮称およびダミーデータであり、実際の運用環境を示すものではありません。

全体構成とアーキテクチャフロー

全体としては「元インスタンスから直接 Sysprep するのではなく、一度クローン用の中間 AMI を経由して作業用インスタンスを一時作成し、そこで Sysprep を行う」というアプローチを取っています。

処理の全体像は以下の通りです。

主なポイント・工夫した点

1. 「非破壊型 Sysprep」による安全設計

Sysprep は SID(セキュリティ識別子)の再生成などを行うため、一度実行したインスタンスは元の状態に戻せません。本フローでは以下のようなステップを踏むことで元環境を安全に保護しています。

2. EC2 Fast Launch によるスケールアウト高速化

Windows インスタンスは初期起動に時間がかかるのが難点ですが、作成した Final AMI に対して EC2 Fast Launch を有効化するステップを入れておくことで、Auto Scaling 等でのスケールアウト時間を劇的に短縮できます。

3. ステートマシン構文に「JSONata」を採用

Step Functions の比較的新しい記述形式(2024年11月22日~)である JSONata(QueryLanguage: "JSONata")を使用しています。{% ... %} 形式で直感的に変数代入(Assign)や文字列連結、三項演算子が書けるため、Step Functions 特有の ResultPath や Parameters の煩雑さが大幅に軽減されました。

※従来のJSONPathならLambdaを挟む必要があった複雑な文字列加工や条件分岐(例:タグ名からの起動テンプレート取得や日時フォーマット生成)が、JSONataのおかげでStep Functions単体で書けるから便利!

ステートマシン定義(ASL)

実際に作成した Step Functions(Amazon States Language)の定義コードです。

{
  "QueryLanguage": "JSONata",
  "Comment": "サンプル:AMI作成自動化パイプライン\n\n[Usage]\n{\n  \"TemplateServerName\": \"app-template-01\",\n  \"BackupFlag\": \"true\"\n}",
  "StartAt": "InitializeParameters",
  "TimeoutSeconds": 9000,
  "States": {
    "InitializeParameters": {
      "Type": "Pass",
      "Comment": "パラメータおよびループカウンターの初期化",
      "Assign": {
        "TargetLaunchTemplateName": "{% $lookup({'app-template-01': 'demo-lt-app', 'web-template-01': 'demo-lt-web'}, $states.context.Execution.Input.TemplateServerName) %}",
        "FastLaunchTemplateName": "demo-lt-fastlaunch",
        "BackupVaultName": "Vault-Demo-7Days",
        "BackupDeleteAfterDays": 7,
        "TemplateServer2InstanceType": "t3.large",
        "TemplateServer2KeyName": "demo-common-key",
        "TemplateServer2SubnetId": "subnet-0123456789abcdef0",
        "TemplateServer2SecurityGroupIds": [
          "sg-0123456789abcdef0"
        ],
        "TemplateServer2IamProfileName": "DemoAmiAutomationInstanceRole",
        "FastLaunchTargetResourceCount": 2,
        "LoopCount_Stop": 0,
        "LoopCount_Ami1": 0,
        "LoopCount_SSM": 0,
        "LoopCount_Sysprep": 0,
        "LoopCount_Ami2": 0
      },
      "Next": "CheckValidTemplateServerName"
    },
    "CheckValidTemplateServerName": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $exists($TargetLaunchTemplateName) %}",
          "Next": "IdentifyTemplateServer"
        }
      ],
      "Default": "InvalidTemplateServerNameFail"
    },
    "InvalidTemplateServerNameFail": {
      "Type": "Fail",
      "Error": "InvalidTemplateServerName",
      "Cause": "指定された TemplateServerName がマッピング定義に存在しません。"
    },
    "IdentifyTemplateServer": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:describeInstances",
      "Arguments": {
        "Filters": [
          {
            "Name": "tag:Name",
            "Values": [
              "{% $states.context.Execution.Input.TemplateServerName %}"
            ]
          }
        ]
      },
      "Assign": {
        "InstanceId": "{% $count($states.result.Reservations) > 0 and $count($states.result.Reservations[0].Instances) > 0 ? $states.result.Reservations[0].Instances[0].InstanceId : '' %}",
        "InstanceState": "{% $count($states.result.Reservations) > 0 and $count($states.result.Reservations[0].Instances) > 0 ? $states.result.Reservations[0].Instances[0].State.Name : '' %}",
        "OriginalName": "{% $states.context.Execution.Input.TemplateServerName %}"
      },
      "Next": "CheckInstanceExists",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "CheckInstanceExists": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $InstanceId = '' %}",
          "Next": "FailInstanceNotFound"
        },
        {
          "Condition": "{% $InstanceState = 'stopped' %}",
          "Next": "CreatePrimaryAMI"
        }
      ],
      "Default": "StopTemplateServer"
    },
    "FailInstanceNotFound": {
      "Type": "Fail",
      "Error": "InstanceNotFoundException",
      "Cause": "指定されたタグ(Tag:Name)の EC2 インスタンスが見つかりませんでした。"
    },
    "StopTemplateServer": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:stopInstances",
      "Arguments": {
        "InstanceIds": [
          "{% $InstanceId %}"
        ]
      },
      "Next": "WaitBeforeCheckTemplateServerStopped",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "WaitBeforeCheckTemplateServerStopped": {
      "Type": "Wait",
      "Seconds": 15,
      "Next": "CheckTemplateServerStopped"
    },
    "CheckTemplateServerStopped": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:describeInstances",
      "Arguments": {
        "InstanceIds": [
          "{% $InstanceId %}"
        ]
      },
      "Next": "IsTemplateServerStopped",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "IsTemplateServerStopped": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $count($states.input.Reservations) > 0 and $count($states.input.Reservations[0].Instances) > 0 and $states.input.Reservations[0].Instances[0].State.Name = 'stopped' %}",
          "Next": "CreatePrimaryAMI"
        }
      ],
      "Default": "IncrementLoopCount_Stop"
    },
    "IncrementLoopCount_Stop": {
      "Type": "Pass",
      "Assign": {
        "LoopCount_Stop": "{% $LoopCount_Stop + 1 %}"
      },
      "Next": "CheckLoopCount_Stop"
    },
    "CheckLoopCount_Stop": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $LoopCount_Stop >= 40 %}",
          "Next": "FailPollingTimeout"
        }
      ],
      "Default": "WaitBeforeCheckTemplateServerStopped"
    },
    "CreatePrimaryAMI": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:createImage",
      "Arguments": {
        "InstanceId": "{% $InstanceId %}",
        "Name": "{% $OriginalName & '_' & $replace($substring($states.context.Execution.StartTime, 0, 10), '-', '') & '_' & $replace($substring($states.context.Execution.StartTime, 11, 5), ':', '') %}"
      },
      "Assign": {
        "PrimaryAmiId": "{% $states.result.ImageId %}",
        "PrimaryAmiName": "{% $OriginalName & '_' & $replace($substring($states.context.Execution.StartTime, 0, 10), '-', '') & '_' & $replace($substring($states.context.Execution.StartTime, 11, 5), ':', '') %}"
      },
      "Next": "WaitBeforeCheckAmiAvailable",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "WaitBeforeCheckAmiAvailable": {
      "Type": "Wait",
      "Seconds": 30,
      "Next": "CheckAmiAvailable"
    },
    "CheckAmiAvailable": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:describeImages",
      "Arguments": {
        "ImageIds": [
          "{% $PrimaryAmiId %}"
        ]
      },
      "Next": "IsAmiAvailable",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "IsAmiAvailable": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $count($states.input.Images) > 0 and $states.input.Images[0].State = 'available' %}",
          "Next": "CheckBackupFlag"
        }
      ],
      "Default": "IncrementLoopCount_Ami1"
    },
    "IncrementLoopCount_Ami1": {
      "Type": "Pass",
      "Assign": {
        "LoopCount_Ami1": "{% $LoopCount_Ami1 + 1 %}"
      },
      "Next": "CheckLoopCount_Ami1"
    },
    "CheckLoopCount_Ami1": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $LoopCount_Ami1 >= 60 %}",
          "Next": "FailPollingTimeout"
        }
      ],
      "Default": "WaitBeforeCheckAmiAvailable"
    },
    "CheckBackupFlag": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $exists($states.context.Execution.Input.BackupFlag) and ($lowercase($states.context.Execution.Input.BackupFlag) in ['true']) %}",
          "Next": "BackupToVault"
        }
      ],
      "Default": "LaunchTemplateServer2"
    },
    "BackupToVault": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:backup:startBackupJob",
      "Arguments": {
        "BackupVaultName": "{% $BackupVaultName %}",
        "ResourceArn": "{% 'arn:aws:ec2:' & $split($states.context.Execution.Id, ':')[3] & ':' & $split($states.context.Execution.Id, ':')[4] & ':instance/' & $InstanceId %}",
        "IamRoleArn": "{% 'arn:aws:iam::' & $split($states.context.Execution.Id, ':')[4] & ':role/service-role/AWSBackupDefaultServiceRole' %}",
        "Lifecycle": {
          "DeleteAfterDays": "{% $BackupDeleteAfterDays %}"
        }
      },
      "Next": "LaunchTemplateServer2",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "LaunchTemplateServer2": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:runInstances",
      "Arguments": {
        "ImageId": "{% $PrimaryAmiId %}",
        "InstanceType": "{% $TemplateServer2InstanceType %}",
        "KeyName": "{% $TemplateServer2KeyName %}",
        "IamInstanceProfile": {
          "Name": "{% $TemplateServer2IamProfileName %}"
        },
        "MaxCount": 1,
        "MinCount": 1,
        "NetworkInterfaces": [
          {
            "DeviceIndex": 0,
            "AssociatePublicIpAddress": true,
            "SubnetId": "{% $TemplateServer2SubnetId %}",
            "Groups": "{% $TemplateServer2SecurityGroupIds %}"
          }
        ],
        "TagSpecifications": [
          {
            "ResourceType": "instance",
            "Tags": [
              {
                "Key": "Name",
                "Value": "{% $PrimaryAmiName & '-sysprep' %}"
              }
            ]
          },
          {
            "ResourceType": "volume",
            "Tags": [
              {
                "Key": "Name",
                "Value": "{% $PrimaryAmiName & '-sysprep' %}"
              }
            ]
          }
        ]
      },
      "Assign": {
        "TemplateServer2InstanceId": "{% $states.result.Instances[0].InstanceId %}"
      },
      "Next": "WaitBeforeCheckSSMReady",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "WaitBeforeCheckSSMReady": {
      "Type": "Wait",
      "Seconds": 30,
      "Next": "CheckSSMReady"
    },
    "CheckSSMReady": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ssm:describeInstanceInformation",
      "Arguments": {
        "Filters": [
          {
            "Key": "InstanceIds",
            "Values": [
              "{% $TemplateServer2InstanceId %}"
            ]
          }
        ]
      },
      "Next": "IsSSMReady",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "IsSSMReady": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $count($states.input.InstanceInformationList) > 0 and $states.input.InstanceInformationList[0].PingStatus = 'Online' %}",
          "Next": "RunSysprepAndShutdown"
        }
      ],
      "Default": "IncrementLoopCount_SSM"
    },
    "IncrementLoopCount_SSM": {
      "Type": "Pass",
      "Assign": {
        "LoopCount_SSM": "{% $LoopCount_SSM + 1 %}"
      },
      "Next": "CheckLoopCount_SSM"
    },
    "CheckLoopCount_SSM": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $LoopCount_SSM >= 40 %}",
          "Next": "FailPollingTimeout"
        }
      ],
      "Default": "WaitBeforeCheckSSMReady"
    },
    "RunSysprepAndShutdown": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ssm:sendCommand",
      "Arguments": {
        "DocumentName": "AWS-RunPowerShellScript",
        "InstanceIds": [
          "{% $TemplateServer2InstanceId %}"
        ],
        "TimeoutSeconds": 1800,
        "Parameters": {
          "commands": [
            "$configPath = 'C:\\ProgramData\\Amazon\\EC2Launch\\config\\agent-config.yml'",
            "(Get-Content $configPath) -replace 'type: doNothing', 'type: random' | Set-Content $configPath",
            "& 'C:\\Program Files\\Amazon\\EC2Launch\\EC2Launch.exe' sysprep --shutdown"
          ]
        }
      },
      "Assign": {
        "SysprepCommandId": "{% $states.result.Command.CommandId %}"
      },
      "Next": "WaitBeforeCheckSysprepStopped",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "WaitBeforeCheckSysprepStopped": {
      "Type": "Wait",
      "Seconds": 60,
      "Next": "CheckSysprepStopped"
    },
    "CheckSysprepStopped": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:describeInstances",
      "Arguments": {
        "InstanceIds": [
          "{% $TemplateServer2InstanceId %}"
        ]
      },
      "Next": "IsSysprepStopped",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "IsSysprepStopped": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $count($states.input.Reservations) > 0 and $count($states.input.Reservations[0].Instances) > 0 and $states.input.Reservations[0].Instances[0].State.Name = 'stopped' %}",
          "Next": "CreateFinalAMI"
        }
      ],
      "Default": "GetSysprepCommandInvocation"
    },
    "GetSysprepCommandInvocation": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ssm:getCommandInvocation",
      "Arguments": {
        "CommandId": "{% $SysprepCommandId %}",
        "InstanceId": "{% $TemplateServer2InstanceId %}"
      },
      "Assign": {
        "SysprepCommandStatus": "{% $states.result.Status %}"
      },
      "Next": "IsSysprepCommandFailed",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "IsSysprepCommandFailed": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $SysprepCommandStatus in ['Failed', 'TimedOut', 'Cancelled'] %}",
          "Next": "FailSysprepCommandError"
        }
      ],
      "Default": "IncrementLoopCount_Sysprep"
    },
    "FailSysprepCommandError": {
      "Type": "Fail",
      "Error": "SysprepCommandException",
      "Cause": "SSM経由のSysprep実行コマンドが失敗、タイムアウト、またはキャンセルされました。"
    },
    "IncrementLoopCount_Sysprep": {
      "Type": "Pass",
      "Assign": {
        "LoopCount_Sysprep": "{% $LoopCount_Sysprep + 1 %}"
      },
      "Next": "CheckLoopCount_Sysprep"
    },
    "CheckLoopCount_Sysprep": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $LoopCount_Sysprep >= 60 %}",
          "Next": "FailPollingTimeout"
        }
      ],
      "Default": "WaitBeforeCheckSysprepStopped"
    },
    "CreateFinalAMI": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:createImage",
      "Arguments": {
        "InstanceId": "{% $TemplateServer2InstanceId %}",
        "Name": "{% $PrimaryAmiName & '-baseimage' %}"
      },
      "Assign": {
        "FinalAmiId": "{% $states.result.ImageId %}"
      },
      "Next": "WaitBeforeCheckFinalAmiAvailable",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "WaitBeforeCheckFinalAmiAvailable": {
      "Type": "Wait",
      "Seconds": 30,
      "Next": "CheckFinalAmiAvailable"
    },
    "CheckFinalAmiAvailable": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:describeImages",
      "Arguments": {
        "ImageIds": [
          "{% $FinalAmiId %}"
        ]
      },
      "Next": "IsFinalAmiAvailable",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "IsFinalAmiAvailable": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $count($states.input.Images) > 0 and $states.input.Images[0].State = 'available' %}",
          "Next": "UpdateLaunchTemplate"
        }
      ],
      "Default": "IncrementLoopCount_Ami2"
    },
    "UpdateLaunchTemplate": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:createLaunchTemplateVersion",
      "Arguments": {
        "LaunchTemplateName": "{% $TargetLaunchTemplateName %}",
        "SourceVersion": "$Default",
        "LaunchTemplateData": {
          "ImageId": "{% $FinalAmiId %}"
        }
      },
      "Assign": {
        "NewVersionNumber": "{% $states.result.LaunchTemplateVersion.VersionNumber %}"
      },
      "Next": "EnableFastLaunch",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "IncrementLoopCount_Ami2": {
      "Type": "Pass",
      "Assign": {
        "LoopCount_Ami2": "{% $LoopCount_Ami2 + 1 %}"
      },
      "Next": "CheckLoopCount_Ami2"
    },
    "CheckLoopCount_Ami2": {
      "Type": "Choice",
      "Choices": [
        {
          "Condition": "{% $LoopCount_Ami2 >= 60 %}",
          "Next": "FailPollingTimeout"
        }
      ],
      "Default": "WaitBeforeCheckFinalAmiAvailable"
    },
    "EnableFastLaunch": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:enableFastLaunch",
      "Arguments": {
        "ImageId": "{% $FinalAmiId %}",
        "MaxParallelLaunches": 6,
        "SnapshotConfiguration": {
          "TargetResourceCount": "{% $FastLaunchTargetResourceCount %}"
        },
        "LaunchTemplate": {
          "LaunchTemplateName": "{% $FastLaunchTemplateName %}",
          "Version": "$Default"
        }
      },
      "Next": "GetPrimaryAmiSnapshots",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "GetPrimaryAmiSnapshots": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:describeImages",
      "Arguments": {
        "ImageIds": [
          "{% $PrimaryAmiId %}"
        ]
      },
      "Assign": {
        "PrimaryAmiSnapshotIds": "{% $append([], $states.result.Images[0].BlockDeviceMappings[Ebs].Ebs.SnapshotId) %}"
      },
      "Next": "DeregisterPrimaryAMI",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "DeregisterPrimaryAMI": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:deregisterImage",
      "Arguments": {
        "ImageId": "{% $PrimaryAmiId %}"
      },
      "Next": "DeletePrimaryAmiSnapshots",
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "DeletePrimaryAmiSnapshots": {
      "Type": "Map",
      "Items": "{% $PrimaryAmiSnapshotIds %}",
      "ItemProcessor": {
        "ProcessorConfig": {
          "Mode": "INLINE"
        },
        "StartAt": "DeleteSnapshot",
        "States": {
          "DeleteSnapshot": {
            "Type": "Task",
            "Resource": "arn:aws:states:::aws-sdk:ec2:deleteSnapshot",
            "Arguments": {
              "SnapshotId": "{% $states.input %}"
            },
            "End": true,
            "Retry": [
              {
                "ErrorEquals": ["States.TaskFailed"],
                "IntervalSeconds": 2,
                "MaxAttempts": 3,
                "BackoffRate": 2
              }
            ]
          }
        }
      },
      "Next": "TerminateTempServer"
    },
    "TerminateTempServer": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ec2:terminateInstances",
      "Arguments": {
        "InstanceIds": [
          "{% $TemplateServer2InstanceId %}"
        ]
      },
      "End": true,
      "Retry": [
        {
          "ErrorEquals": ["States.TaskFailed"],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ]
    },
    "FailPollingTimeout": {
      "Type": "Fail",
      "Error": "PollingTimeoutException",
      "Cause": "リソースのステータス待ち処理が規定のループ回数を超過しました。"
    }
  }
}

IAM ポリシー設定

Step Functions の実行ロールには、EC2、SSM、AWS Backup などの操作権限が必要です。最小権限原則を意識して設定します。

Step Functions 実行ロールのIAMポリシー(JSON)

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "EC2Permissions",
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeInstances",
        "ec2:StopInstances",
        "ec2:CreateImage",
        "ec2:DescribeImages",
        "ec2:RunInstances",
        "ec2:CreateTags",
        "ec2:DescribeLaunchTemplateVersions",
        "ec2:CreateLaunchTemplateVersion",
        "ec2:ModifyLaunchTemplate",
        "ec2:EnableFastLaunch",
        "ec2:DisableFastLaunch",
        "ec2:DeregisterImage",
        "ec2:DeleteSnapshot",
        "ec2:DescribeSnapshots",
        "ec2:TerminateInstances"
      ],
      "Resource": "*"
    },
    {
      "Sid": "BackupPermissions",
      "Effect": "Allow",
      "Action": [
        "backup:StartBackupJob"
      ],
      "Resource": "*"
    },
    {
      "Sid": "SSMPermissions",
      "Effect": "Allow",
      "Action": [
        "ssm:DescribeInstanceInformation",
        "ssm:SendCommand",
        "ssm:GetCommandInvocation"
      ],
      "Resource": "*"
    },
    {
      "Sid": "XRayPermissions",
      "Effect": "Allow",
      "Action": [
        "xray:PutTraceSegments",
        "xray:PutTelemetryRecords",
        "xray:GetSamplingRules",
        "xray:GetSamplingTargets"
      ],
      "Resource": "*"
    },
    {
      "Sid": "PassRolePermissions",
      "Effect": "Allow",
      "Action": "iam:PassRole",
      "Resource": [
        "arn:aws:iam::*:role/DemoAmiAutomationInstanceRole",
        "arn:aws:iam::*:role/service-role/AWSBackupDefaultServiceRole"
      ],
      "Condition": {
        "StringEquals": {
          "iam:PassedToService": [
            "ec2.amazonaws.com",
            "backup.amazonaws.com"
          ]
        }
      }
    }
  ]
}

信頼関係(Trust Relationship)

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "states.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

実際に動かしてみた

Step Functions のコンソールから以下のような JSON パラメータを入力して「実行を開始」します。

{
  "TemplateServerName": "app-template-01",
  "BackupFlag": "true"
}

実行中のコンソール画面では、各ステートが緑色に変わっていき、指定した時間どおりに SSM コマンドが実行され、最終的に新しい Launch Template のバージョンが作成されたことが確認できました!

不要になった「一時インスタンス」や「中間 AMI」も自動的にクリーンアップされるため、スナップショットの消し忘れによる不要な課金 も防げます。

◎Sysprep完了待ち(タイムアウト)の調整について

Sysprep 実行後、インスタンスが自動的に「Stopped」になるまでには、インスタンスのスペックや EBS ボリュームのサイズによって想像以上に時間がかかることがあります。
初期の検証ではループ上限を30回(Wait 60秒×30回=約30分)にしていましたが、タイムアウトエラーが発生したため、余裕を持って 60回(約60分) の待機時間を確保するようにステートマシン(CheckLoopCount_Sysprep)を調整しています。

まとめ

今回の仕組みを作ることで、以下のメリットが得られました。

  1. 完全自動化: 定期実行(EventBridge 等)を設定するだけで、常に最新状態のゴールデン AMI が手に入る。
  2. 安全性の確保: 本番環境や元のベースインスタンスを絶対に壊さない構成。
  3. 起動時間の短縮: EC2 Fast Launch をセットで自動化に組み込んだことで、Auto Scaling の応答速度が大幅向上。

Windows サーバの AMI 作成運用に悩んでいる方は、ぜひ参考にしてみてください!

💡 ワンポイント

本記事のSSMスクリプトは EC2Launch v1 向けの記述(EC2Launch.exe)になっています。Windows Server 2022 等で EC2Launch v2 をご使用の場合は、実行コマンドを EC2Launch v2 用(& "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" sysprep など)に適宜読み替えてください。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?