AWSSupport-UpgradeWindowsAWSDrivers - AWS Systems Manager オートメーションランブックリファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWSSupport-UpgradeWindowsAWSDrivers

説明

AWSSupport-UpgradeWindowsAWSDrivers ランブックは、指定された EC2 インスタンスでストレージおよびネットワーク AWS ドライバーをアップグレードまたは修復します。このランブックは、SSM エージェントを呼び出すことにより、最新バージョンの AWS ドライバーをオンラインでインストールしようと試みます SSM エージェントが接続可能でない場合、明示的に要求された場合にランブックは AWS ドライバーのオフラインインストールを実行できます。

注記

オンラインおよびオフラインのどちらでアップグレードした場合も、いずれかのオペレーションが試行される前に AMI が作成されます。この AMI はオートメーションが完了した後も維持されます。AMI へのアクセスを保護したり、削除したりするのはサービス利用者の責任となります。オンライン方法はアップグレードプロセスの一部としてインスタンスを再起動しますが、オフライン方法では、提供された EC2 インスタンスを停止してから起動する必要があります。

重要

us-east-1 リージョン以外では、インスタンスが VPC エンドポイントを使用して AWS Systems Manager に接続されている場合、このランブックは失敗します。このランブックはドメインコントローラーでも失敗します。ドメインコントローラーで AWS PV ドライバーを更新するには、ドメインコントローラーのアップグレード (AWS PV アップグレード)を参照してください。

この自動化を実行する (コンソール)

ドキュメントタイプ

Automation

所有者

Amazon

[Platforms] (プラットフォーム)

Linux、macOS、Windows

パラメータ

  • AllowOffline

    型: 文字列

    有効な値: true | false

    デフォルト: false

    説明: (オプション) オンラインインストールが実行できない場合にオフラインでドライバーのアップグレードを許可する場合は、この値を true に設定します。注意: オフライン方式では、指定された EC2 インスタンスを停止してから起動する必要があります。インスタンスストアボリュームに保存されているデータは失われます。Elastic IP を使用していない場合、パブリック IP アドレスが変わります。

  • AutomationAssumeRole

    型: 文字列

    説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。

  • ForceUpgrade

    型: 文字列

    有効な値: true | false

    デフォルト: false

    説明: (オプション) オフラインのみ - インスタンスに既に最新のドライバーがインストールされている場合でも、オフラインでドライバーのアップグレードを続行できるようにする場合は、これを true に設定します。

  • InstanceId

    型: 文字列

    説明: (必須) Windows Server の EC2 インスタンスの ID。

  • SubnetId

    型: 文字列

    デフォルト： SelectedInstanceSubnet

    説明: (オプション) オフラインのみ - オフラインでドライバアップグレードを実行するために使用される EC2Rescue インスタンスのサブネット ID。サブネット ID が指定されていない場合、Systems Manager Automation は新しい VPC を作成します。

    重要

    サブネットは と同じアベイラビリティーゾーンに存在し InstanceId、SSM エンドポイントへのアクセスを許可する必要があります。

必要な IAM アクセス許可

AutomationAssumeRole パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。

コマンドを受信する EC2 インスタンスには、少なくとも、オートメーションを実行してコマンドをインスタンスに送信する ssm:StartAutomationExecution と ssm: SendCommandのアクセス許可を含む IAM ロールと、オートメーション出力を読み取るための ssm:GetAutomationExecution が必要です。AmazonSSMManagedInstanceCore Amazon マネージドポリシーを IAM ロールにアタッチして、これらのアクセス許可を提供できます。ただし、この目的には、オートメーション IAM ロール AmazonSSMAutomationRole を使用することをお勧めします。詳細については、「IAM を使用して自動化のロールを設定する」を参照してください。

オフラインアップグレードを実行する場合、必要なアクセス権限は「AWSSupport-StartEC2RescueWorkflow」を参照してください。

ドキュメントステップ

  1. aws:assertAwsResourceProperty - 入力インスタンスが Windows であることを確認します。

  2. aws:assertAwsResourceProperty - 入力インスタンスがマネージドインスタンスであることを確認します。その場合、オンラインアップグレードが開始され、その他の場合はオフラインアップグレードが評価されます。

    1. (オンラインアップグレード) インプットインスタンスがマネージドインスタンスの場合は以下のようになります。

      1. aws:createImage - AMI バックアップを作成します。

      2. aws:createTags - AMI バックアップにタグを付けます。

      3. aws:runCommand - AWS-ConfigureAWSPackage 経由で ENA ネットワークドライバーをインストールします。

      4. aws:runCommand - AWS-ConfigureAWSPackage 経由で NVMe ドライバーをインストールします。

      5. aws:runCommand - AWS-ConfigureAWSPackage 経由で AWS PV ドライバーをインストールします。

    2. (オフラインアップグレード) インプットインスタンスがマネージドインスタンスでない場合は以下のようになります。

      1. aws:assertAwsResourceProperty - AllowOffline フラグが true に設定されていることを確認します。設定されている場合は、オフラインアップグレードが開始されます。そうでない場合、このオートメーションは終了します。

      2. aws:changeInstanceState - ソースインスタンスを停止します。

      3. aws:changeInstanceState - ソースインスタンスを強制停止します。

      4. aws:createImage - ソースインスタンスの AMI バックアップを作成します。

      5. aws:createTags - ソースインスタンスの AMI バックアップにタグを付けます。

      6. aws:executeAwsApi - インスタンスの ENA を有効にします

      7. aws:assertAwsResourceProperty - ForceUpgrade フラグをアサートします。

      8. 強制オフラインアップグレード) ForceUpgrade = true の場合は、 を実行してドライバー強制アップグレードスクリプトAWSSupport-StartEC2RescueWorkflowで aws:executeAutomation を呼び出します。これにより、インストールされている現在のバージョンに関係なくドライバーがインストールされます

      9. （オフラインアップグレード) ForceUpgrade = false の場合は、ドライバーアップグレードスクリプトAWSSupport-StartEC2RescueWorkflowを使用して aws:executeAutomationを実行して を呼び出します。

[Outputs] (出力)

preUpgradeBackup.ImageId

preOfflineUpgradeバックアップ。ImageId

installAwsEnaNetworkDriverOnInstance.Output

installAWSNVMeOnInstance.Output

installAWSPVDriverOnInstance.Output

upgradeDriversOffline出力

forceUpgradeDriversオフライン.出力