インフラ基本設計について
目次
はじめに
こんにちは!kotaroです。
今回(2025年9月~11月)、某システムのインフラ基本設計フェーズに参画しました。これまで私はAWSを専門とし、主に詳細設計や構築フェーズでの経験が多かったのですが、基本設計に深く関わるのは今回が初めてでした。そこで、どのような作業を行ったのか、どんな成果物を作成したのかを備忘録として残しておきます。
なぜこのブログを書こうと思ったのか?
基本設計フェーズは、インフラエンジニアにとって「どこまでやるのか」「どんなアウトプットが必要なのか」が曖昧になりがちです。私自身、参画前は「コードを作るくらい?」というイメージでしたが、実際にはもっと多岐にわたる作業がありました。これから同じフェーズに入る方の参考になればと思います。
私のバックグラウンド
- インフラエンジニア歴:約5年
- AWS認定資格:全冠取得
- IaaS・サーバレスの経験あり
- これまでのプロジェクト:詳細設計~構築が中心
成果物
今回の基本設計フェーズで作成した成果物は以下の通りです。それぞれの目的や工夫した点も合わせて記載します。
概要設計書
目的:インフラ構成を俯瞰できる資料を作成し、アプリチームや運用チームとの共通認識を形成すること。
内容:
- リソース命名規則(例:
<env>-<service>-<role>形式) - タグ設計(コスト管理・運用効率化のため)
- 機能別リソース一覧(アプリチームが理解しやすいように機能単位で整理)
- 構成図(VPC、サブネット、セキュリティグループ、主要サービスの関係性)
工夫した点:
スタック単位ではなく機能単位で整理したこと。理由は、アプリチームが「どの機能がどのリソースに紐づくか」を把握しやすくするためです。詳細設計ではスタック単位に切り替える予定なので、フェーズごとに見せ方を変えることを意識しました。
ネットワーク要件一覧表
目的:通信要件を明確化し、セキュリティやパフォーマンスの観点で漏れを防ぐ。
記載項目:
- 送信元サーバ/送信先サーバ
- IPアドレス、環境区分(開発・検証・本番)
- 認証方式(IAM認証、Basic認証など)
- 通信開始トリガー(API呼び出し、バッチ処理など)
- プロトコル/ポート/必要帯域
- 経路(Direct Connect、Client VPNなど)
- アクセス制御(SG、NACL、ポリシー)
ポイント:
API GatewayやLambdaのタイムアウト設定もここで考慮しました。例えば、API Gatewayのデフォルトタイムアウトは29秒ですが、Lambda側の処理時間が長い場合は設計段階で調整が必要です。このあたりはアプリチームとの連携が重要でした。
環境方針書
目的:開発・検証・本番環境の構成方針を整理し、リソースのスケールや冗長化の考え方を明確化。
記載内容:
- 環境ごとの構成図(簡略版)
- 冗長化方針(AZ分散、Auto Scalingの有無)
- 運用ポリシー(バックアップ、監視)
ソフトウェア構成一覧
目的:EC2やLambdaにインストールするライブラリ・ソフトウェアを明確化し、構築手順書のベースとする。
記載内容:
- OSバージョン
- ミドルウェア(Apache、Tomcatなど)
- ライブラリ(Java、Pythonなど)
- セキュリティパッチ適用方針
アーキテクチャ検証計画書/結果報告書
目的:設計したアーキテクチャが要件を満たすか検証するための計画と結果を記載。
検証項目例:
- Client VPN経由での疎通確認
- RDS接続確認
- IAMポリシーの適用確認
結果報告書では、実測値や確認方法を明記しました。オンプレとの疎通は今回は未実施でしたが、AWS内の疎通確認は完了しました。
成果物まとめ
| 成果物名 | 用途 |
| 概要設計書 | インフラ構成の全体像を整理し、命名規則・タグ設計・機能別リソース一覧を明確化 |
| ネットワーク要件一覧表 | 通信要件(送信元・送信先・認証方式・ポート・経路)を整理し、アクセス制御方針を定義 |
| 環境方針書 | 開発・検証・本番環境の構成方針(冗長化、スケーリング、運用ポリシー)を明確化 |
| ソフトウェア構成一覧 | 各EC2やLambdaにインストールするOS、ミドルウェア、ライブラリを定義 |
| アーキテクチャ検証計画書 | 設計したアーキテクチャの妥当性を確認するための検証項目・方法を計画 |
| アーキテクチャ検証結果報告書 | 検証結果(実施内容、確認方法、実測値)を記録し、設計の有効性を証明 |
おわりに
今回の基本設計フェーズでは、資料作成とコード作成がほぼ半々の割合でした。特にCDKを使ったPoC環境のデプロイは、設計の妥当性を確認するうえで非常に有効でした。
学びポイント:
- 基本設計では「資料作成だけ」ではなく、コードで検証することが重要
- ネットワーク要件の整理は、後工程のトラブル防止に直結する
- アプリチームとの連携を意識した資料構成が必要
今後は詳細設計フェーズに入り、開発環境へのデプロイや構築手順書の作成を進めます。その際も、今回の経験を活かして効率的に進めたいと思います。