インフラ担当のクラウドエンジニアが作成する成果物を解説 ─「詳細設計書/パラメータシート編」

クラウド環境の設計・構築において、「詳細設計書」はシステムの安定運用を支える重要なドキュメントです。Azureなどのクラウド環境では、リソースのパラメータや構成を明確に定義し、「誰が作業しても同じ環境を再現できる」ようにすることが求められます。

本記事では、Azure仮想マシン（VM）を例に、詳細設計書の役割や記載内容、作成時のポイントを解説します。この記事を参考に、詳細設計書の作り方から実際のインフラ設計に活用する流れを押さえましょう。

詳細設計書とは？

詳細設計書とは、クラウド環境におけるインフラ構成や各リソースのパラメータを詳細に定義する設計書です。基本設計書をもとに、仮想マシン（VM）、ネットワーク、ストレージ、セキュリティ設定など、具体的な設定値や構築手順を記載するのが特徴です。

詳細設計書を作成する目的は、構築の標準化、設定ミスの防止、情報共有の効率化、トラブルシューティングの迅速化です。特にクラウド環境では、多くのリソースが動的に変化するため、一貫した設計情報を文書化することで、チーム間の認識のズレを防ぎ、安定した運用を実現できます。

基本設計書との違い

項目	基本設計書	詳細設計書
目的	システム全体の設計方針を決める	リソースの設定を詳細に定義する
記載内容	構成図、要件、アーキテクチャ設計	VMやネットワークの具体的なパラメータ
誰が作成するか	設計リーダー、クラウドアーキテクト	インフラエンジニア
使う場面	設計フェーズ全体の指針	実装・構築フェーズ

詳細設計書は、基本設計書の内容を具体的な設定値に落とし込んだものです。基本設計書では、システム全体の方針や設計思想を定め、どのような構成・技術を採用するかを決定します。一方、詳細設計書では、これを基に各リソースの具体的な設定内容を定義します。

詳細設計書を作成する目的

詳細設計書を作成する主な目的は、インフラ環境の統一、構築ミスの防止、情報共有の効率化、トラブルシューティングの迅速化です。

クラウド環境では、仮想マシン（VM）、ネットワーク、ストレージ、セキュリティなど、さまざまなリソースを適切に構成する必要があります。詳細設計書を作成することで、誰が作業しても同じ環境を構築できるようになり、属人化を防ぐことができます。

また、設定の誤りを防ぐためにも、事前にパラメータを明確に定義しておくことが重要です。さらに、システムの変更時や障害発生時に設計情報をすぐに確認できるため、スムーズな対応が可能になります。

詳細設計書に盛り込む内容

詳細設計書には、システムの安定運用を実現するために必要な情報を整理し、明確に記載することが求められます。Azure仮想マシン（VM）を含むクラウド環境では、適切なパラメータ設定がシステムのパフォーマンスやセキュリティに大きく影響を与えます。

ここでは、詳細設計書に盛り込むべき主要な項目を9つのカテゴリに分けて解説します。

基本情報

項目	設定値	備考
VM名	Ops-Today-vm	仮想マシンの名前
リソースグループ	Ops-Today-vm-rg	VMを管理するリソースグループ
場所（リージョン）	Japan East	データセンターのリージョン
サブスクリプション	(例)Azure Production	所属するサブスクリプション
サブスクリプションID	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx	一意の識別子
可用性ゾーン	ゾーン1	耐障害性を高めるためのゾーン指定
オペレーションシステム	Windows Server 2016 Datacenter – x64 Gen2	VMのOS
サイズ	Standard_DS1_v2	vCPU: 1 / RAM: 3.5GiB
パブリックIPアドレス	有(生成時に割り当てられる)	インターネット経由の接続に利用
仮想ネットワーク/サブネット	Ops-Today-vm-vnet/subnet-web	VM が所属するネットワーク
DNS名	(例)vm-web-01.japaneast.cloudapp.azure.com	カスタムDNS名が設定されている場合に表示

基本情報には、Azureポータルで仮想マシン（VM）の概要ページに表示されるリソースグループ、リージョン、サブスクリプション、ネットワーク設定などの情報を記載します。これらの情報は、VMの管理やトラブルシューティングの際に必要となるため、詳細設計書に明確に定義しておくことが重要です。

特にサブスクリプションIDやDNS名は、一意の識別子として利用されるため、他のリソースとの関連性を把握しやすくするためにも、正確に記載しておきましょう。

ディスク

項目	設定値	備考
OSディスク名	Ops-Today-vm-disk	一意の識別名を設定
OSディスクの種類	PremiumSSD	パフォーマンス要件に応じて選定
OSディスクサイズ	128GB	最低限のストレージ要件
ディスク暗号化	有効（Microsoft管理キー）	Azure Managed DiskEncryptionを使用
スナップショット	毎日1回	バックアップポリシーに基づく
バックアップ対象	OSディスクのみ	Azure Backupで管理

詳細設計書にディスク情報を記載する際は、ディスクの種類やサイズ、暗号化設定、バックアップの有無を明確に整理することが重要です。特に、AzureではOSディスクとデータディスクの管理方法が異なるため、混同しないように記載ルールを統一すると、運用時の混乱を防ぐことができます。

また、ディスクの暗号化設定やスナップショットのポリシーは、セキュリティやバックアップ方針に影響を与えるため、どの設定が有効になっているのかを明示的に記載するのが望ましいです。

ディスクのサイズについても、最小要件を満たすだけでなく、将来的な拡張性を考慮した記述を心がけると、スムーズな運用が可能になります。

ネットワーク設定

項目	設定値	備考
VNet名	Ops-Today-vm-vnet	仮想ネットワーク名
サブネット名	Ops-Today-vm-subnet	サブネットの名前
プライベートIP	10.0.0.x	内部通信用IP
パブリックIP	あり	外部通信用IP
NSG	Ops-Today-vm-nsg	セキュリティルールを適用
DNSサーバ	(仮)Azure DNS	既定のDNSサーバー設定

ネットワーク設定を詳細設計書に記載する際は、仮想ネットワーク（VNet）、サブネット、IPアドレスの設定を中心に整理します。特に、VNet名やサブネット名を一貫性のある命名規則に基づいて記載することが大切です。

アタッチ予定のNSGやDNSサーバを記載し、ネットワーク全体がイメージできるような記載を心がけましょう。

負荷分散

項目	設定値	備考
負荷分散の有無	あり	Azure Load Balancerを使用
ロードバランサー名	Ops-Today-vm-lb	負荷分散用リソース
種類	パブリックロードバランサー	インターネット向けの負荷分散
バックエンドプール	Ops-Today-vm-pool	VMが所属するプール
ヘルスプローブ	HTTP80	ポート80で死活監視
ロードバランサールール	TCP80→TCP80	HTTPトラフィックを分散

負荷分散の設定を詳細設計書に記載する際は、ロードバランサーの種類（Azure LoadBalancerまたはApplication Gateway）や、負荷分散対象となるバックエンドプールの構成を明確に定義します。

特に、ヘルスプローブ（監視設定）やルール設定を詳細に記述することで、障害発生時の対応がスムーズになります。

可用性とスケーリング

項目	設定値	備考
可用性オプション	可用性ゾーン	ゾーン障害対策のために設定
可用性ゾーン	ゾーン1	VMを配置するゾーン
可用性セット	未設定	ゾーンを使用するため不要
スケールセットの有無	あり	自動スケーリングを設定
最小インスタンス数	2	最低2台を維持
最大インスタンス数	5	負荷に応じて最大5台まで拡張
スケーリング条件	CPU使用率70%以上でスケールアウト	負荷に応じて動的調整
負荷分散の連携	Azure LoadBalancer	負荷分散と併用

可用性とスケーリングの設定を詳細設計書に記載する際は、システムの耐障害性と負荷変動への対応方針を明確に定義することが重要です。

Azureでは可用性セットや可用性ゾーンを活用することで、インフラの耐障害性を向上できます。これらの設定が適切に記載されていないと、単一障害点（SPOF）のリスクが高まり、システムの可用性が低下する可能性があります。

また、スケールセット（VMSS）を利用する場合は、最小・最大インスタンス数、スケール条件、負荷分散との連携などを具体的に記載することで、システムの安定運用がしやすくなります。

バックアップ

項目	設定値	備考
バックアップの有無	あり	Azure Backupを利用
バックアップ対象	OSディスクのみ	データディスクは対象外
バックアップポリシー名	Ops-Today-vm-bk-policy	一貫性のあるポリシー名を設定
バックアップ頻度	毎日1回（午前2時）	業務時間外に実施
保持期間	30日	30日間バックアップを保持
復旧ポイント数	最新7世代	最大7世代の復旧ポイントを保存
スナップショットの取得	あり	迅速な復旧のために設定
災害対策（ASR）の有無	なし	必要に応じて設定

バックアップの設定を詳細設計書に記載する際は、どのリソースを、どの頻度で、どれくらいの期間保持するのかを明確に定義することが重要です。

特に、Azure Backupを利用する場合は、バックアップポリシーを明確にし、OSディスクやデータディスクのバックアップ有無を記載することで、障害発生時の復旧対応をスムーズに進めることができます。

自動シャットダウン

項目	設定値	備考
自動シャットダウンの有無	有効	不要な時間帯のコスト削減
シャットダウン時刻	23:00 (JST)	日本時間基準で設定
通知の有無	有効	シャットダウン前に通知を送信
通知先メールアドレス	(例)infra-team@example.com	インフラチームへ通知
スケジュール変更権限	インフラ管理者のみ	権限管理を明確にする

自動シャットダウンの設定を詳細設計書に記載する際は、コスト最適化と運用ポリシーを考慮して、どの時間帯にシャットダウンを行うかを明確にすることが重要です。

特に、開発・検証環境では夜間や週末に不要なVMを自動的に停止することで、無駄なコストを削減できます。

また、シャットダウンの際に通知を送信する設定を有効にすることで、意図しない停止を防ぐことができます。

診断設定

項目	設定値	備考
診断の有無	有効	トラブルシューティングのために設定
ブート診断	有効	VMの起動プロセスを記録
診断ストレージアカウント	opstodaystorage	ログ保存用ストレージ
メトリクス収集	CPU、メモリ、ディスク、IOPS	パフォーマンス監視用
ログ収集先	Azure Monitor	統合管理のため設定
アクティビティログ	有効	すべての変更履歴を記録
アラート設定	CPU使用率80%超過時	負荷監視用