インフラ基本設計について

2025.12.07
インフラ基本設計について
この記事をシェアする

はじめに

こんにちは!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環境のデプロイは、設計の妥当性を確認するうえで非常に有効でした。
学びポイント:

  • 基本設計では「資料作成だけ」ではなく、コードで検証することが重要
  • ネットワーク要件の整理は、後工程のトラブル防止に直結する
  • アプリチームとの連携を意識した資料構成が必要

今後は詳細設計フェーズに入り、開発環境へのデプロイや構築手順書の作成を進めます。その際も、今回の経験を活かして効率的に進めたいと思います。

この記事をシェアする
著者:Kotaro
ポケモンが好きなAWSエンジニア