【テンプレあり】英語インフラ構成書の書き方|ITプロジェクトで使える日英フォーマット付き

※本サイトで紹介している商品・サービス等の外部リンクには、アフィリエイト広告が含まれる場合があります。

技術英語の実践術

英語でインフラ構成書を作るよう求められたとき、何を書けばいいか迷った経験はないだろうか。

インフラ構成書はシステムのサーバー・ネットワーク・クラウドリソースの構成を一元管理するドキュメントだ。グローバルチームでは英語が基本になるが、7つのセクション構成さえ押さえれば英語でも問題なく書ける。

この記事では、インフラ構成書に必要な7つの構成要素と、そのまま使える日英テンプレートを紹介する。コピペして使えばすぐに実務で活用できる。


インフラ構成書に必要な7つの構成要素

インフラ構成書はシステムの物理・論理構成を定義し、運用・障害対応・変更管理の基盤となるドキュメントだ。以下の7つが標準的な構成要素になる。

  1. 基本情報(Document Info)
  2. システム概要(System Overview)
  3. ネットワーク構成(Network Architecture)
  4. サーバー・リソース一覧(Server / Resource Inventory)
  5. ミドルウェア・ソフトウェア構成(Middleware & Software Stack)
  6. セキュリティ設定(Security Configuration)
  7. 変更履歴(Change Log)

なぜ英語で書くのか

グローバルチームではインフラ構成書も英語が共通言語になる。英語で書くことで、海外ベンダーやクラウドプロバイダーとのやり取りがスムーズになる。

「誰が見ても同じ環境を再現できる」ことが、インフラ構成書の最大の目的だ。

インフラ構成書とアーキテクチャ設計書の使い分け

アーキテクチャ設計書は「なぜその構成を選んだか」の設計思想と判断根拠を記述するドキュメントだ。一方、インフラ構成書は「実際にどのリソースが・どの設定で・どこにあるか」の実態を記録する。両方を整備することで、設計と実装の一貫性が保たれる。

アーキテクチャ設計書のテンプレートは英語アーキテクチャ設計書の書き方でも紹介しているので合わせて確認してほしい。


テンプレートをダウンロード(Word)

以下のWordファイルをダウンロードして、プロジェクトに合わせてカスタマイズして使ってほしい。表の列・行はそのまま追加・削除できる。

📥 日本語テンプレートをダウンロード(Word)
📥 Download English Template (Word)

日本語版テンプレート(コピペOK)

基本情報

項目内容
システム名(例:〇〇管理システム)
バージョンv1.0
作成日YYYY-MM-DD
作成者(名前・役職)
承認者(名前・役職)
最終更新日YYYY-MM-DD
ステータスDraft / In Review / Approved

システム概要

項目内容
システム目的(例:受注・在庫・出荷を一元管理するWebアプリケーション)
環境本番(Production) / ステージング(Staging) / 開発(Development)
クラウドプロバイダーAWS / GCP / Azure / オンプレミス
リージョン(例:ap-northeast-1)
可用性要件(例:99.9% SLA)
RTO / RPORTO: 4時間 / RPO: 1時間

ネットワーク構成

項目設定値備考
VPC / VNET名vpc-prod-001本番環境VPC
CIDRブロック10.0.0.0/16
パブリックサブネット10.0.1.0/24(AZ-a), 10.0.2.0/24(AZ-c)ALB用
プライベートサブネット10.0.11.0/24(AZ-a), 10.0.12.0/24(AZ-c)アプリ・DB用
インターネットゲートウェイigw-prod-001
NATゲートウェイnat-prod-001(AZ-a), nat-prod-002(AZ-c)冗長化構成
セキュリティグループsg-alb / sg-app / sg-db役割別に分離

サーバー・リソース一覧

リソースID種別インスタンスタイプOS / エンジン役割配置IPアドレス
i-001EC2t3.mediumAmazon Linux 2Webサーバー(ALB配下)プライベートサブネット AZ-a10.0.11.10
i-002EC2t3.mediumAmazon Linux 2Webサーバー(ALB配下)プライベートサブネット AZ-c10.0.12.10
rds-001RDSdb.r6g.largeMySQL 8.0プライマリDBプライベートサブネット AZ-a10.0.11.50
rds-002RDSdb.r6g.largeMySQL 8.0スタンバイDB(Multi-AZ)プライベートサブネット AZ-c10.0.12.50
cache-001ElastiCachecache.r6g.largeRedis 7.0セッション・キャッシュプライベートサブネット AZ-a10.0.11.60
s3-001S3静的ファイル・ログ保管リージョン

ミドルウェア・ソフトウェア構成

リソースIDミドルウェア / ソフトウェアバージョン役割備考
i-001, i-002Nginx1.24リバースプロキシSSL終端
i-001, i-002Node.js20.x LTSアプリケーションランタイム
i-001, i-002PM25.xプロセス管理
rds-001, rds-002MySQL8.0RDBMSMulti-AZ構成
cache-001Redis7.0セッション管理・キャッシュ
CloudWatch監視・ログ集約
AWS WAFWebアプリケーションファイアウォール

セキュリティ設定

項目設定内容
通信暗号化HTTPS(TLS 1.2以上)。ALBでSSL終端。EC2間はHTTP(VPC内)
DBアクセス制御プライベートサブネット内のみ接続可。セキュリティグループで制限
IAMロールEC2にIAMロールを付与。アクセスキーをインスタンスに持たせない
シークレット管理DB接続情報はAWS Secrets Managerで管理
ログ保管アクセスログ・アプリログはS3に90日保管。CloudWatch Logsに30日保管
脆弱性スキャンAmazon Inspectorを有効化。月次レポートを確認
バックアップRDS自動バックアップ(保持期間7日)。S3はバージョニング有効

変更履歴

バージョン変更日変更者変更内容
v1.0YYYY-MM-DD(名前)初版作成
v1.1YYYY-MM-DD(名前)NATゲートウェイを冗長化構成に変更
v1.2YYYY-MM-DD(名前)ElastiCache(Redis)を追加

英語版テンプレート(コピペOK)

Document Info

FieldValue
System Name(e.g., [System Name] Management System)
Versionv1.0
Created DateYYYY-MM-DD
Author(Name / Role)
Approved By(Name / Role)
Last UpdatedYYYY-MM-DD
StatusDraft / In Review / Approved

System Overview

FieldValue
System Purpose(e.g., Web application for centralized management of orders, inventory, and shipping)
EnvironmentProduction / Staging / Development
Cloud ProviderAWS / GCP / Azure / On-premises
Region(e.g., ap-northeast-1)
Availability Requirement(e.g., 99.9% SLA)
RTO / RPORTO: 4 hours / RPO: 1 hour

Network Architecture

ItemValueNotes
VPC / VNet Namevpc-prod-001Production VPC
CIDR Block10.0.0.0/16
Public Subnet10.0.1.0/24 (AZ-a), 10.0.2.0/24 (AZ-c)For ALB
Private Subnet10.0.11.0/24 (AZ-a), 10.0.12.0/24 (AZ-c)For app & DB
Internet Gatewayigw-prod-001
NAT Gatewaynat-prod-001 (AZ-a), nat-prod-002 (AZ-c)Redundant configuration
Security Groupssg-alb / sg-app / sg-dbSeparated by role

Server / Resource Inventory

Resource IDTypeInstance TypeOS / EngineRolePlacementIP Address
i-001EC2t3.mediumAmazon Linux 2Web server (behind ALB)Private subnet AZ-a10.0.11.10
i-002EC2t3.mediumAmazon Linux 2Web server (behind ALB)Private subnet AZ-c10.0.12.10
rds-001RDSdb.r6g.largeMySQL 8.0Primary DBPrivate subnet AZ-a10.0.11.50
rds-002RDSdb.r6g.largeMySQL 8.0Standby DB (Multi-AZ)Private subnet AZ-c10.0.12.50
cache-001ElastiCachecache.r6g.largeRedis 7.0Session & cachePrivate subnet AZ-a10.0.11.60
s3-001S3Static files & log storageRegion

Middleware & Software Stack

Resource IDMiddleware / SoftwareVersionRoleNotes
i-001, i-002Nginx1.24Reverse proxySSL termination
i-001, i-002Node.js20.x LTSApplication runtime
i-001, i-002PM25.xProcess management
rds-001, rds-002MySQL8.0RDBMSMulti-AZ configuration
cache-001Redis7.0Session management & caching
CloudWatchMonitoring & log aggregation
AWS WAFWeb Application Firewall

Security Configuration

ItemConfiguration
Communication EncryptionHTTPS (TLS 1.2+). SSL termination at ALB. HTTP within VPC between EC2 instances.
DB Access ControlAccessible only within private subnet. Restricted via security groups.
IAM RoleIAM roles attached to EC2. No access keys stored on instances.
Secret ManagementDB credentials managed via AWS Secrets Manager.
Log RetentionAccess & application logs stored in S3 for 90 days. CloudWatch Logs for 30 days.
Vulnerability ScanAmazon Inspector enabled. Monthly reports reviewed.
BackupRDS automated backups (7-day retention). S3 versioning enabled.

Change Log

VersionDateAuthorChanges
v1.0YYYY-MM-DD(Name)Initial version created.
v1.1YYYY-MM-DD(Name)Updated NAT Gateway to redundant configuration.
v1.2YYYY-MM-DD(Name)Added ElastiCache (Redis).

各セクションの書き方と例文

テンプレートを埋めるときに悩みやすいセクションを解説する。

ネットワーク構成の書き方

ネットワーク構成は「誰でも同じ環境を再現できる」粒度で書く。CIDRブロック・サブネット・セキュリティグループの3点セットが最低限必要だ。

日本語英語
パブリックサブネットはALB専用に割り当てるAssign public subnets exclusively for the ALB.
プライベートサブネットにアプリとDBを配置するPlace the application servers and database in private subnets.
インターネットゲートウェイを通じて外部に接続するConnect to the internet through the internet gateway.
NATゲートウェイで冗長化を確保するEnsure redundancy with NAT Gateways in each availability zone.
セキュリティグループで役割ごとにアクセスを制限するRestrict access per role using security groups.

セキュリティ設定の書き方

セキュリティ設定は「どのレイヤーで・何をどう守るか」を具体的に書く。「セキュリティを強化する」だけでは不十分で、実装済みの設定を明記するのが鉄則だ。

日本語英語
通信はTLS 1.2以上で暗号化するAll communications are encrypted using TLS 1.2 or higher.
アクセスキーをインスタンスに保持しないNo access keys are stored on instances; IAM roles are used instead.
シークレットはSecrets Managerで管理するSecrets are managed via AWS Secrets Manager.
最小権限の原則に基づいてIAMを設計するIAM policies are designed following the principle of least privilege.
脆弱性スキャンを定期的に実施するVulnerability scans are performed on a regular basis.

クラウドインフラ議論の英語フレーズはエンジニアの英語クラウドインフラ議論術でも確認してほしい。


インフラ構成書でよく使う英語表現

実務でよく使う英語表現を場面別にまとめた。

インフラ構成の英語用語

日本語英語
仮想プライベートクラウドVirtual Private Cloud (VPC)
アベイラビリティゾーンAvailability Zone (AZ)
ロードバランサーLoad Balancer
オートスケーリングAuto Scaling
リバースプロキシReverse Proxy
DNS名前解決DNS Resolution
IPアドレスIP Address
CIDRブロックCIDR Block

可用性・障害対応の英語表現

日本語英語
冗長化構成Redundant / Highly available configuration
フェイルオーバーFailover
マルチAZ構成Multi-AZ configuration
RTO(目標復旧時間)Recovery Time Objective (RTO)
RPO(目標復旧時点)Recovery Point Objective (RPO)
ディザスタリカバリDisaster Recovery (DR)
バックアップ・リストアBackup and restore
ヘルスチェックHealth check

セキュリティ・アクセス制御の英語表現

日本語英語
セキュリティグループSecurity group
インバウンドルールInbound rule
アウトバウンドルールOutbound rule
最小権限の原則Principle of least privilege
エンドツーエンド暗号化End-to-end encryption
ゼロトラストZero trust
WAF(Webアプリケーションファイアウォール)Web Application Firewall (WAF)
多要素認証Multi-Factor Authentication (MFA)

英語でのシステム設計議論のフレーズはエンジニアの英語システム設計議論術でまとめているので参考にしてほしい。


まとめ:英語インフラ構成書は7つのセクションで完成する

英語インフラ構成書に必要な構成要素を整理した。

  • システム概要でRTO/RPOなどの非機能要件を明記する
  • ネットワーク構成でCIDR・サブネット・セキュリティグループを具体的に記述する
  • サーバー・リソース一覧で「何が・どこに・どの設定で動いているか」を一覧化する
  • セキュリティ設定で「どのレイヤーで何を守っているか」を明記する

テンプレートをコピーして、実際のリソースIDやIPアドレスに置き換えてほしい。特にセキュリティ設定は実装済みの内容を正確に記録することで、監査対応や障害対応の際に役立つ。

コメント

タイトルとURLをコピーしました