Start/Stop VMs v2 を Azure サブスクリプションにデプロイする

[アーティクル]
06/01/2023

Start/Stop VMs v2 機能をインストールするには、この記事の手順を順番に実行します。セットアッププロセスが完了したら、要件に合わせてカスタマイズするスケジュールを構成します。

アクセス許可とポリシーに関する考慮事項

デプロイの前および最中に、次の考慮事項に留意してください。

このソリューションでは、Start/Stop v2 のデプロイに対する適切なロールベースのアクセス制御 (RBAC) のアクセス許可を持つユーザーが、Start/Stop VMs v2 インスタンスのスコープで仮想マシンのスケジュールを追加、削除、管理することができます。この動作は仕様です。実際には、仮想マシンに対する明示的なアクセス許可を持たないユーザーでも、仮想マシンを管理している Start/Stop v2 ソリューションを変更するためのアクセス許可を持っていれば、その仮想マシンに対する開始、停止、自動停止の操作を作成できます。
Start/Stop v2 ソリューションにアクセスできるすべてのユーザーが、Start/Stop v2 アプリケーションで使用される Application Insights インスタンスに保存されているコスト、節約、操作履歴、その他のデータを見ることができます。
Start/Stop v2 ソリューションを管理するときは、Start/Stop v2 ソリューションに対するユーザーのアクセス許可を考慮する必要があります (特に、ターゲット仮想マシンを直接変更するアクセス許可をユーザーが持っていない場合)。
Start/Stop v2 ソリューションを新規または既存のリソースグループにデプロイすると、StartStopV2 の値を持つ SolutionNameという名前のタグが、Start/Stop v2 によってデプロイされたリソースグループとそのリソースに追加されます。これらのリソースのその他のタグはすべて削除されます。リソースタグに基づいて管理操作を拒否する Azure ポリシーがある場合は、このタグのみを含むリソースの管理操作を許可する必要があります。

機能をデプロイする

デプロイは、Start/Stop VMs v2 の GitHub 組織から開始されます。この機能は、サブスクリプション内のすべてのリソースグループにわたるすべての VM を、そのサブスクリプション内の 1 つのデプロイから管理することを目的としていますが、組織の運用モデルまたは要件に基づいて、別のインスタンスをインストールすることもできます。また、複数のサブスクリプション全体で VM を一元的に管理するように構成することもできます。

管理と削除を簡単にするために、Start/Stop VMs v2 を専用のリソースグループにデプロイすることをお勧めします。

注意

現在、このソリューションでは、既存のストレージアカウントまたは Application Insights リソースの指定はサポートされていません。

注意

関数アプリとストレージアカウントの名前付け形式が変更されました。グローバルな一意性を保証するため、ランダムで一意の文字列が、これらのリソースの名前に追加されるようになりました。

ブラウザーを開いて、Start/Stop VMs v2 の GitHub 組織に移動します。
お使いの Azure VM が作成されている Azure クラウド環境に基づいて、デプロイオプションを選択します。
メッセージが表示されたら、Azure portal にサインインします。
ドロップダウンボックスから適切なプランを選択します。ゾーン冗長プラン (Start/StopV2-AZ) を選択するとき、次のリージョンのいずれかでデプロイを作成する必要があります。
- オーストラリア東部
- ブラジル南部
- カナダ中部
- 米国中部
- 米国東部
- 米国東部 2
- フランス中部
- ドイツ中西部
- 東日本
- 北ヨーロッパ
- 東南アジア
- 英国南部
- 西ヨーロッパ
- 米国西部 2
- 米国西部 3
[作成] を選択します。これにより、Azure portal にカスタムの Azure Resource Manager のデプロイページが開きます。

次の値を入力します。

名前	値
リージョン	新しいリソース用にご自身に近いリージョンを選択します。
リソースグループ名	Start/Stop VMs 用の個々のリソースが含まれるリソースグループの名前を指定します。
Resource Group Region (リソースグループのリージョン)	リソースグループのリージョンを選択します。たとえば [米国中部] です。
Azure Function App Name (Azure Function App 名)	URL パスに有効な名前を入力します。入力した名前は、Azure Functions 内での一意性を確保するために検証されます。
Application Insights Name (Application Insights 名)	Start/Stop VMs の分析を保持する Application Insights インスタンスの名前を指定します。
Application Insights Region (Application Insights のリージョン)	Application Insights インスタンスのリージョンを指定します。
ストレージアカウント名	Start/Stop VMs の実行テレメトリを格納する Azure Storage アカウントの名前を指定します。
電子メールアドレス	状態の通知を受信する 1 つ以上の電子メールアドレスをコンマ (,) で区切って指定します。

Start/Stop VMs template deployment configuration

ページ下部の [確認および作成] を選択します。
[作成] を選択してデプロイを開始します。
画面の上部にあるベルのアイコン (通知) を選択して、デプロイの状態を確認します。 "デプロイを実行しています" と表示されます。デプロイが完了するまでお待ちください。
通知ウィンドウで [リソースグループに移動] を選択します。次のような画面が表示されます。

Note

お客様がトラブルシューティングのためにサポートチームに連絡してきたときにより良く支援できるよう、運用およびハートビートのテレメトリが収集されています。また、サービスの有効性を判断できるよう、仮想マシンでサービスが動作した時間と、仮想マシンが再通知された期間を確認するため、仮想マシンのイベント履歴も収集されています。

複数のサブスクリプションを有効にする

Start/Stop のデプロイが完了したら、次の手順を実行して、Start/Stop VMs v2 で複数のサブスクリプションに対してアクションを実行できるようにします。

デプロイ中に指定した Azure Function App 名の値をコピーします。
Azure portal で第 2 のサブスクリプションに移動します。
[アクセス制御 (IAM)] を選択します。
[追加]>[ロールの割り当ての追加] を選択して、[ロールの割り当ての追加] ページを開きます。
次のロールを割り当てます。詳細な手順については、「Azure portal を使用して Azure ロールを割り当てる」を参照してください。

設定値

Role 共同作成者

アクセスの割り当て先ユーザー、グループ、またはサービスプリンシパル

メンバー <Azure Function App 名>

設定	値
Role	共同作成者
アクセスの割り当て先	ユーザー、グループ、またはサービスプリンシパル
メンバー	<Azure Function App 名>

スケジュールの構成の概要

VM の起動と停止を制御するためのオートメーションの方法を管理するには、要件に基づいて、含まれているロジックアプリを 1 つ以上構成します。

Scheduled - 開始と停止のアクションは、Azure Resource Manager とクラシックの VM に対して指定したスケジュールに基づきます。 ststv2_vms_Scheduled_start と ststv2_vms_Scheduled_stop により、スケジュール設定された開始と停止が構成されます。
Sequenced - 開始と停止のアクションは、事前定義されたシーケンス処理タグの付いた VM を対象とするスケジュールに基づきます。サポートされているのは、sequencestart および sequencestop の 2 つの名前付きタグのみです。 ststv2_vms_Sequenced_start と ststv2_vms_Sequenced_stop により、シーケンスされた開始と停止が構成されます。

注意

このシナリオでサポートされるのは、Azure Resource Manager の VM のみです。
AutoStop - この機能は、CPU 使用率に基づいて Azure Resource Manager とクラシックの両方の VM に対して停止アクションを実行するためにのみ使用されます。また、スケジュールに基づく "アクションの実行" の場合もあります。この場合、VM に関するアラートが作成され、条件に基づいて停止アクションを実行するためのアラートがトリガーされます。ststv2_vms_AutoStop により、自動停止機能が構成されます。

追加のスケジュールが必要な場合は、Azure portal の [クローン] オプションを使用して、提供されているロジックアプリのいずれかを複製することができます。

Select the Clone option to duplicate a logic app

スケジュールされた起動と停止のシナリオ

Azure Resource Manager とクラシック VM のスケジュールされた起動と停止のアクションを構成するには、次の手順を実行します。たとえば、ststv2_vms_Scheduled_start のスケジュールを構成し、朝オフィスにいるときに起動し、ststv2_vms_Scheduled_stop のスケジュールに基づき、夕方退社するときにサブスクリプション全体のすべての VM を停止することができます。

VM を起動するだけのロジックアプリの構成はサポートされています。

シナリオごとに、アクションの対象を 1 つ以上のサブスクリプション、1 つまたは複数のリソースグループにすることができ、1 つ以上の VM を包含または除外リストに指定できます。同じロジックアプリ内でまとめて指定することはできません。

Azure portal にサインインしてから、 [ロジックアプリ] に移動します。
スケジュールされた起動を構成する場合、ロジックアプリの一覧から [ststv2_vms_Scheduled_start] を選択します。スケジュールされた停止を構成する場合は、 [ststv2_vms_Scheduled_stop] を選択します。
左側のウィンドウで [ロジックアプリデザイナー] を選択します。
ロジックアプリデザイナーが表示されたら、デザイナーウィンドウで [繰り返し] を選択して、ロジックアプリのスケジュールを構成します。特定の繰り返しオプションの詳細については、繰り返しタスクのスケジュールに関する記事を参照してください。

デザイナーウィンドウで、 [関数] - [お試しください] を選択して、ターゲット設定を構成します。要求本文で、サブスクリプション内のすべてのリソースグループにわたって VM を管理する場合は、次の例に示すように要求本文を変更します。

{
  "Action": "start",
  "EnableClassic": false,
  "RequestScopes": {
    "ExcludedVMLists": [],
    "Subscriptions": [
      "/subscriptions/12345678-1234-5678-1234-123456781234/"
    ]
 }
}

次の例のように、各値をコンマで区切って subscriptions 配列内に複数のサブスクリプションを指定します。

"Subscriptions": [
      "/subscriptions/12345678-1234-5678-1234-123456781234/",
      "/subscriptions/11111111-0000-1111-2222-444444444444/"
    ]

要求本文で、特定のリソースグループの VM を管理する場合は、次の例に示すように要求本文を変更します。指定する各リソースパスは、コンマで区切る必要があります。必要に応じて、リソースグループを 1 つ以上指定できます。

この例では、仮想マシンの除外についても示しています。 VM を除外するには、VM のリソースパスを指定するかワイルドカードを使用します。

{
  "Action": "start",
  "EnableClassic": false,
  "RequestScopes": {
    "Subscriptions": [
      "/subscriptions/12345678-1234-5678-1234-123456781234/",
      "/subscriptions/11111111-0000-1111-2222-444444444444/"
     ],
    "ResourceGroups": [
      "/subscriptions/12345678-1234-5678-1234-123456781234/resourceGroups/rg1/",
      "/subscriptions/11111111-0000-1111-2222-444444444444/resourceGroups/rg2/"
    ],
    "ExcludedVMLists": [
     "/subscriptions/12345678-1234-5678-1234-123456781234/resourceGroups/vmrg1/providers/Microsoft.Compute/virtualMachines/vm1"
    ]
  }
}

ここでは、両方のサブスクリプションで、VM 名が Az と Bz で始まるもの以外のすべての VM に対してアクションが実行されます。

{
  "Action": "start",
  "EnableClassic": false,
  "RequestScopes": {
    "ExcludedVMLists": [“Az*”,“Bz*”],
   "Subscriptions": [
      "/subscriptions/12345678-1234-5678-1234-123456781234/",
      "/subscriptions/11111111-0000-1111-2222-444444444444/"

    ]
  }
}

要求本文で、サブスクリプション内の特定の VM セットを管理する場合は、次の例に示すように要求本文を変更します。指定する各リソースパスは、コンマで区切る必要があります。必要に応じて、VM を 1 つ指定できます。

{
  "Action": "start",
  "EnableClassic": false,
  "RequestScopes": {
    "ExcludedVMLists": [],
    "VMLists": [
      "/subscriptions/12345678-1234-5678-1234-123456781234/resourceGroups/rg1/providers/Microsoft.Compute/virtualMachines/vm1",
      "/subscriptions/12345678-1234-5678-1234-123456781234/resourceGroups/rg3/providers/Microsoft.Compute/virtualMachines/vm2",
      "/subscriptions/11111111-0000-1111-2222-444444444444/resourceGroups/rg2/providers/Microsoft.ClassicCompute/virtualMachines/vm30"

    ]
  }
}

ロジックアプリの [概要] ウィンドウで、 [有効] を選択します。

シーケンス処理された起動と停止のシナリオ

分散アプリケーションアーキテクチャ内の複数の Azure Resource Manager VM に 2 つ以上のコンポーネントを含む環境では、コンポーネントの起動および停止順序を指定できることが重要です。このシナリオを構成する前に、概要ページで説明されているように、sequencestart タグと Sequencestart タグをターゲット VM に適用していることを確認してください。

シーケンス処理された起動を構成する場合、ロジックアプリの一覧から [ststv2_vms_Sequenced_start] を選択します。シーケンス処理された停止を構成する場合は、 [ststv2_vms_Sequenced_stop] を選択します。
左側のウィンドウで [ロジックアプリデザイナー] を選択します。
ロジックアプリデザイナーが表示されたら、デザイナーウィンドウで [繰り返し] を選択して、ロジックアプリのスケジュールを構成します。特定の繰り返しオプションの詳細については、繰り返しタスクのスケジュールに関する記事を参照してください。

デザイナーペインで、[Function-Try] を選択してターゲット設定を構成し、上部メニューの [</> コードビュー] ボタンを選択して、Function-Try 要素のコードを編集します。要求本文で、サブスクリプション内のすべてのリソースグループにわたって VM を管理する場合は、次の例に示すように要求本文を変更します。

{
  "Action": "start",
  "EnableClassic": false,
  "RequestScopes": {
    "ExcludedVMLists": [],
    "Subscriptions": [
      "/subscriptions/12345678-1234-5678-1234-123456781234/"
    ]
 },
   "Sequenced": true
}

次の例のように、各値をコンマで区切って subscriptions 配列内に複数のサブスクリプションを指定します。

"Subscriptions": [
      "/subscriptions/12345678-1234-5678-1234-123456781234/",
      "/subscriptions/11111111-0000-1111-2222-444444444444/"
    ]

要求本文で、特定のリソースグループの VM を管理する場合は、次の例に示すように要求本文を変更します。指定する各リソースパスは、コンマで区切る必要があります。必要に応じて、リソースグループを 1 つ指定できます。

この例では、ワイルドカードを使用するスケジュールされた起動/停止の例と比較した、リソースパスによる仮想マシンの除外も示しています。

{
  "Action": "start",
  "EnableClassic": false,
  "RequestScopes": {
    "Subscriptions":[
      "/subscriptions/12345678-1234-5678-1234-123456781234/",
      "/subscriptions/11111111-0000-1111-2222-444444444444/"
    ],
    "ResourceGroups": [
      "/subscriptions/12345678-1234-5678-1234-123456781234/resourceGroups/rg1/",
      "/subscriptions/11111111-0000-1111-2222-444444444444/resourceGroups/rg2/"
    ],
    "ExcludedVMLists": [
     "/subscriptions/12345678-1234-5678-1234-123456781234/resourceGroups/vmrg1/providers/Microsoft.Compute/virtualMachines/vm1"
    ]
  },
   "Sequenced": true
}

{
  "Action": "start",
  "EnableClassic": false,
  "RequestScopes": {
    "ExcludedVMLists": [],
    "VMLists": [
      "/subscriptions/12345678-1234-5678-1234-123456781234/resourceGroups/rg1/providers/Microsoft.Compute/virtualMachines/vm1",
      "/subscriptions/12345678-1234-5678-1234-123456781234/resourceGroups/rg2/providers/Microsoft.ClassicCompute/virtualMachines/vm2",
      "/subscriptions/11111111-0000-1111-2222-444444444444/resourceGroups/rg2/providers/Microsoft.ClassicCompute/virtualMachines/vm30"
    ]
  },
   "Sequenced": true
}

自動停止シナリオ

Start/Stop VMs v2 は、営業時間外などの非ピーク期間中に使用されていないマシンを評価し、プロセッサ使用率が指定されたパーセンテージ未満の場合は自動的にシャットダウンすることで、サブスクリプションで実行中の Azure Resource Manager およびクラシック VM のコストを管理する上で役立ちます。

要求本文の次のメトリックアラートプロパティでは、カスタマイズがサポートされています。

AutoStop_MetricName
AutoStop_Condition
AutoStop_Threshold
AutoStop_Description
AutoStop_Frequency
AutoStop_Severity
AutoStop_Threshold
AutoStop_TimeAggregationOperator
AutoStop_TimeWindow

Azure Monitor メトリックアラートのしくみと構成方法の詳細については、Azure Monitor のメトリックアラートに関する記事を参照してください。

自動停止を構成する場合、ロジックアプリの一覧から [ststv2_vms_AutoStop] を選択します。
左側のウィンドウで [ロジックアプリデザイナー] を選択します。
ロジックアプリデザイナーが表示されたら、デザイナーウィンドウで [繰り返し] を選択して、ロジックアプリのスケジュールを構成します。特定の繰り返しオプションの詳細については、繰り返しタスクのスケジュールに関する記事を参照してください。

{
  "Action": "stop",
  "EnableClassic": false,    
  "AutoStop_MetricName": "Percentage CPU",
  "AutoStop_Condition": "LessThan",
  "AutoStop_Description": "Alert to stop the VM if the CPU % falls below the threshold",
  "AutoStop_Frequency": "00:05:00",
  "AutoStop_Severity": "2",
  "AutoStop_Threshold": "5",
  "AutoStop_TimeAggregationOperator": "Average",
  "AutoStop_TimeWindow": "06:00:00",
  "RequestScopes":{        
    "Subscriptions":[
        "/subscriptions/12345678-1111-2222-3333-1234567891234/",
        "/subscriptions/12345678-2222-4444-5555-1234567891234/"
    ],
    "ExcludedVMLists":[]
  }        
}

{
  "Action": "stop",
  "AutoStop_Condition": "LessThan",
  "AutoStop_Description": "Alert to stop the VM if the CPU % falls below the threshold",
  "AutoStop_Frequency": "00:05:00",
  "AutoStop_MetricName": "Percentage CPU",
  "AutoStop_Severity": "2",
  "AutoStop_Threshold": "5",
  "AutoStop_TimeAggregationOperator": "Average",
  "AutoStop_TimeWindow": "06:00:00",
  "EnableClassic": false,
  "RequestScopes": {
    "ExcludedVMLists": [],
    "ResourceGroups": [
      "/subscriptions/12345678-1111-2222-3333-1234567891234/resourceGroups/vmrg1/",
      "/subscriptions/12345678-1111-2222-3333-1234567891234/resourceGroupsvmrg2/",
      "/subscriptions/12345678-2222-4444-5555-1234567891234/resourceGroups/VMHostingRG/"
      ]
  }
}

{
  "Action": "stop",
  "AutoStop_Condition": "LessThan",
  "AutoStop_Description": "Alert to stop the VM if the CPU % falls below the threshold",
  "AutoStop_Frequency": "00:05:00",
  "AutoStop_MetricName": "Percentage CPU",
  "AutoStop_Severity": "2",
  "AutoStop_Threshold": "5",
  "AutoStop_TimeAggregationOperator": "Average",
  "AutoStop_TimeWindow": "06:00:00",
  "EnableClassic": false,
  "RequestScopes": {
    "ExcludedVMLists": [],
    "VMLists": [
      "/subscriptions/12345678-1111-2222-3333-1234567891234/resourceGroups/rg3/providers/Microsoft.ClassicCompute/virtualMachines/Clasyvm11",
      "/subscriptions/12345678-1111-2222-3333-1234567891234/resourceGroups/vmrg1/providers/Microsoft.Compute/virtualMachines/vm1"
    ]
  }
}

VM のタグ

また、VM 自体のタグを設定して、特定の VM を開始および停止アクションに含めたり除外したりすることもできます。タグを追加するには、特定の VM に移動し、左側のメニューから [タグ] を選択し、ssv2excludevm という名前のタグを追加します。開始または停止アクションからこの VM を除外するには、この新しいタグの値を true に設定します。アクションに VM を含めるには、この値を false に設定します。これにより、ペイロード構成で ExcludedVMLists を更新することなく、特定の VM を除外できます。

次のステップ

Start/Stop VMs v2 機能によって管理されている Azure VM の状態を監視し、その他の管理タスクを実行する方法については、Start/Stop VMs の管理に関する記事を参照してください。