メインコンテンツまでスキップ

完全な Web アプリケーション基盤を構築する

このガイドでは、Web 層とデータベース層からなる 2 層の Web アプリケーションのインフラ全体を、1 回の terraform apply コマンドで構築します。この構成は実際のプロジェクトの出発点として使用できます。環境ごとの値はすべて変数にまとめてあるため、新しい環境を構築するときに編集するファイルは 1 つだけです。

アーキテクチャ​

Internet
│
Floating IP │ Floating IP
┌──────────┴──────────┐
┌────────────────┼─────────────────────┼──────────── VPC ─┐
│ shop-staging-web-subnet (NAT_ROUTED, 10.50.1.0/24) │
│ shop-staging-web-sg (ACL): 80, 443, 22 オフィスから │
│ ┌──────────┴─────────┐ ┌─────────┴──────────┐ │
│ │ shop-staging-web-01│ │ shop-staging-web-02│ │
│ └──────────┬─────────┘ └─────────┬──────────┘ │
│ └──────────┬──────────┘ │
│ │ 5432, 22 │
│ shop-staging-db-subnet (ISOLATED, 10.50.2.0/24) │
│ shop-staging-db-sg (ACL): 5432, 22 web subnet から │
│ ┌──────────┴──────────┐ │
│ │ shop-staging-db-01 │── shop-staging- │
│ │ (10.50.2.10) │ db-data 100 GB │
│ └─────────────────────┘ │
└──────────────────────────────────────────────────────────┘
構成要素目的
Web subnetWeb サーバー用の Subnet です。NAT gateway を経由して Internet へ送信方向のアクセスを行います。
Database subnetデータベース用の分離された Subnet です。Internet へのルーティングはありません。
Web 用の Instance 2 台Web アプリケーションを実行します。各 Instance に Floating IP が 1 つあります。
データベース用の Instance 1 台データベースを実行します。データは 100 GB の専用 disk に保存されます。
Web Security GroupInternet からの HTTP と HTTPS を許可し、SSH はオフィスのネットワークからのみ許可します。
Database Security GroupWeb サーバーからのデータベース接続と SSH のみを許可します。
tagコストを追跡するために、すべてのリソースに environment と project を付与します。

前提条件​

  • ✅ セットアップと設定 を完了していること。
  • ✅ VPC に、Subnet 2 つ、Instance 3 台、disk 1 つ、Floating IP 2 つ、Security Group 2 つ分の quota が残っていること。
  • ✅ マシンに RSA の SSH key ペアがあること(例: ~/.ssh/id_rsa.pub)。
  • ✅ SSH をオフィスのネットワークからのみ許可するために、オフィスのパブリックアドレス範囲を把握していること。

フォルダー構成​

shop-infra フォルダーを作成し、以下のファイルを配置します。機能ごとにファイルを分けると、各部分を見つけやすく、レビューもしやすくなります。

shop-infra/
├── versions.tf # Terraform と provider のバージョン
├── variables.tf # 変数の宣言
├── terraform.tfvars # 環境の変数の値
├── data.tf # VPC、image、flavor、storage policy の参照
├── tags.tf # 共通の tag
├── network.tf # Subnet
├── compute.tf # SSH key と Instance
├── storage.tf # データ disk
├── security.tf # Security Group と rule
├── public-ip.tf # Floating IP
└── outputs.tf # apply 後に出力する情報

バージョンと変数の宣言​

# versions.tf
terraform {
required_version = ">= 1.5"

required_providers {
fptcloud = {
source = "fpt-corp/fptcloud"
version = "~> 0.3"
}
}
}

provider "fptcloud" {
timeout = 30
}

timeout = 30 を指定すると、Terraform は各操作を最大 30 分待機します。複数の Instance を同時に作成する場合に適しています。

# variables.tf
variable "vpc_name" {
description = "デプロイ先の VPC の名前。"
type = string
}

variable "environment" {
description = "環境の名前。例: staging、production。"
type = string
}

variable "project" {
description = "プロジェクトの名前。リソース名の接頭辞として使用します。"
type = string
}
# variables.tf
variable "office_cidr" {
description = "Web サーバーへの SSH を許可するオフィスのパブリック IP 範囲。"
type = string
}

variable "ssh_public_key_path" {
description = "SSH public key のパス。"
type = string
default = "~/.ssh/id_rsa.pub"
}

variable "web_count" {
description = "Web 用の Instance の数。"
type = number
default = 2
}
# variables.tf
variable "attach_security_groups" {
description = "destroy の前に false に設定し、Instance から Security Group を外します。"
type = bool
default = true
}

環境の値は terraform.tfvars に記述します。以下の値をご自身の情報に置き換えてください。

# terraform.tfvars
vpc_name = "example-vpc"
environment = "staging"
project = "shop"
office_cidr = "203.0.113.0/24"
web_count = 2

情報の参照​

flavor はハードウェア構成で選択するため、この構成は修正せずに別の VPC でも動作します。

# data.tf
data "fptcloud_vpc" "this" {
name = var.vpc_name
}
# data.tf
data "fptcloud_image" "ubuntu" {
vpc_id = data.fptcloud_vpc.this.id

filter {
key = "name"
values = ["UBUNTU-22.04"] # VPC で利用できる image に置き換えてください
match_by = "substring"
}
}
# data.tf
data "fptcloud_flavor" "web" {
vpc_id = data.fptcloud_vpc.this.id

filter {
key = "cpu"
values = ["2"]
}
filter {
key = "memory_mb"
values = ["4096"]
}
}
# data.tf
data "fptcloud_flavor" "db" {
vpc_id = data.fptcloud_vpc.this.id

filter {
key = "cpu"
values = ["4"]
}
filter {
key = "memory_mb"
values = ["8192"]
}
}
# data.tf
data "fptcloud_storage_policy" "ssd" {
vpc_id = data.fptcloud_vpc.this.id

filter {
key = "name"
values = ["Premium-SSD"] # VPC で利用できる storage policy に置き換えてください
}
}

tag と名前の接頭辞​

# tags.tf
resource "fptcloud_tagging" "environment" {
key = "environment"
value = var.environment
scope_type = "ORG"
}

resource "fptcloud_tagging" "project" {
key = "project"
value = var.project
scope_type = "ORG"
}

locals {
name_prefix = "${var.project}-${var.environment}"
tag_ids = [fptcloud_tagging.environment.id, fptcloud_tagging.project.id]
image_name = data.fptcloud_image.ubuntu.images[0].name
policy_id = data.fptcloud_storage_policy.ssd.storage_policies[0].id
}
注記

組織にすでに environment と project の tag がある場合は、新しく作成するのではなく、data source fptcloud_tagging でそれらの tag を読み取ってください。tag の例 を参照してください。

ネットワーク​

# network.tf
resource "fptcloud_subnet" "web" {
vpc_id = data.fptcloud_vpc.this.id
name = "${local.name_prefix}-web-subnet"
type = "NAT_ROUTED"
cidr = "10.50.1.0/24"
gateway_ip = "10.50.1.1"
tag_ids = local.tag_ids
}

resource "fptcloud_subnet" "db" {
vpc_id = data.fptcloud_vpc.this.id
name = "${local.name_prefix}-db-subnet"
type = "ISOLATED"
cidr = "10.50.2.0/24"
gateway_ip = "10.50.2.1"
tag_ids = local.tag_ids
}

VPC 内の既存の Subnet と重複しない CIDR 範囲を 2 つ選択してください。

Instance​

# compute.tf
resource "fptcloud_ssh_key" "deployer" {
name = "${local.name_prefix}-deployer"
public_key = file(pathexpand(var.ssh_public_key_path))
}

resource "fptcloud_instance" "web" {
count = var.web_count

vpc_id = data.fptcloud_vpc.this.id
name = format("%s-web-%02d", local.name_prefix, count.index + 1)
image_name = local.image_name
flavor_name = data.fptcloud_flavor.web.flavors[0].name
subnet_id = fptcloud_subnet.web.id
storage_size_gb = 40
storage_policy_id = local.policy_id
ssh_key = fptcloud_ssh_key.deployer.public_key
status = "POWERED_ON"
tag_ids = local.tag_ids
}
# compute.tf
resource "fptcloud_instance" "db" {
vpc_id = data.fptcloud_vpc.this.id
name = "${local.name_prefix}-db-01"
image_name = local.image_name
flavor_name = data.fptcloud_flavor.db.flavors[0].name
subnet_id = fptcloud_subnet.db.id
private_ip = "10.50.2.10"
storage_size_gb = 40
storage_policy_id = local.policy_id
ssh_key = fptcloud_ssh_key.deployer.public_key
status = "POWERED_ON"
tag_ids = local.tag_ids
}

データベース用の Instance には固定 IP 10.50.2.10 を割り当てます。これにより、Web サーバー上のアプリケーションの設定で、変わらないアドレスを指定できます。

データ disk​

# storage.tf
resource "fptcloud_storage" "db_data" {
vpc_id = data.fptcloud_vpc.this.id
name = "${local.name_prefix}-db-data"
type = "EXTERNAL"
size_gb = 100
storage_policy_id = local.policy_id
instance_id = fptcloud_instance.db.id
tag_ids = local.tag_ids
}

Security Group​

作成直後の Instance はすぐにはプライベート IP を報告しない場合があるため、Instance のプライベート IP は data source fptcloud_instance で読み取ります。

# security.tf
data "fptcloud_instance" "web" {
count = var.web_count

vpc_id = data.fptcloud_vpc.this.id
id = fptcloud_instance.web[count.index].id
}

data "fptcloud_instance" "db" {
vpc_id = data.fptcloud_vpc.this.id
id = fptcloud_instance.db.id
}
# security.tf
resource "fptcloud_security_group" "web" {
vpc_id = data.fptcloud_vpc.this.id
name = "${local.name_prefix}-web-sg"
subnet_id = fptcloud_subnet.web.id
type = "ACL"
apply_to = var.attach_security_groups ? data.fptcloud_instance.web[*].private_ip : []
tag_ids = local.tag_ids
}

resource "fptcloud_security_group" "db" {
vpc_id = data.fptcloud_vpc.this.id
name = "${local.name_prefix}-db-sg"
subnet_id = fptcloud_subnet.db.id
type = "ACL"
apply_to = var.attach_security_groups ? [data.fptcloud_instance.db.private_ip] : []
tag_ids = local.tag_ids
}
# security.tf
locals {
web_rules = {
http = { port = "80", source = "ALL" }
https = { port = "443", source = "ALL" }
ssh = { port = "22", source = var.office_cidr }
}

db_rules = {
postgres = "5432"
ssh = "22"
}
}
# security.tf
resource "fptcloud_security_group_rule" "web" {
for_each = local.web_rules

vpc_id = data.fptcloud_vpc.this.id
security_group_id = fptcloud_security_group.web.id
direction = "INGRESS"
action = "ALLOW"
protocol = "TCP"
port_range = each.value.port
sources = [each.value.source]
description = "Allow ${each.key}"
}
# security.tf
resource "fptcloud_security_group_rule" "db" {
for_each = local.db_rules

vpc_id = data.fptcloud_vpc.this.id
security_group_id = fptcloud_security_group.db.id
direction = "INGRESS"
action = "ALLOW"
protocol = "TCP"
port_range = each.value
sources = [fptcloud_subnet.web.cidr]
description = "Allow ${each.key} from the web subnet"
}

変数 attach_security_groups を使うと、インフラを削除する前に Instance から Security Group を外せます。クリーンアップ を参照してください。

Floating IP​

# public-ip.tf
resource "fptcloud_floating_ip" "web" {
count = var.web_count

vpc_id = data.fptcloud_vpc.this.id
tag_ids = local.tag_ids
}

resource "fptcloud_floating_ip_association" "web" {
count = var.web_count

vpc_id = data.fptcloud_vpc.this.id
floating_ip_id = fptcloud_floating_ip.web[count.index].id
instance_id = fptcloud_instance.web[count.index].id
}

出力情報​

# outputs.tf
output "web_public_ips" {
description = "Web サーバーのパブリックアドレス。"
value = fptcloud_floating_ip.web[*].ip_address
}

output "web_private_ips" {
description = "Web サーバーのプライベートアドレス。"
value = data.fptcloud_instance.web[*].private_ip
}

output "db_private_ip" {
description = "データベースサーバーのプライベートアドレス。"
value = data.fptcloud_instance.db.private_ip
}

デプロイ​

  1. shop-infra フォルダーでターミナルを開き、セットアップと設定 のとおりに接続情報を設定します。

  2. provider をダウンロードします。

    terraform init
  3. 構成の構文を確認します。

    terraform validate
  4. 変更内容をプレビューし、plan を保存します。

    terraform plan -out=tfplan

    web_count = 2 の場合、plan には Plan: 20 to add, 0 to change, 0 to destroy. と表示されます。

  5. 確認した plan をそのまま適用します。

    terraform apply tfplan

Terraform は依存関係の順にリソースを作成します。まず tag と Subnet、次に Instance、disk、Security Group、Floating IP の順です。通常 10 ~ 20 分かかります。完了すると、Terraform は web_public_ips、web_private_ips、db_private_ip を出力します。

ヒント

最初の apply の後に web_private_ips または db_private_ip が空の場合は、terraform apply を再度実行してください。2 回目の実行で IP が読み取られ、Instance に Security Group が割り当てられます。

結果の確認​

  1. FPT Cloud Portal を開き、以下を確認します。

    • Subnet が 2 つあり、3 台の Instance が Running 状態で、disk shop-staging-db-data が shop-staging-db-01 に接続されていること。
    • 2 つの Security Group が正しい Instance に適用されていること。
    • 2 つの Floating IP が 2 台の Web サーバーに割り当てられていること。
  2. オフィスのネットワークから Floating IP 経由で、image のデフォルトユーザーを使って Web サーバーにログインします。

    ssh -i ~/.ssh/id_rsa <user>@<web_public_ip>
  3. Web サーバーから、プライベート IP 10.50.2.10 でデータベースサーバーに接続します。

データ disk は空の disk です。データベースをインストールする前に、Storage Disks のトラブルシューティング に従って disk をフォーマットしてください。

デプロイ後のインフラの変更​

目的編集する箇所結果
Web サーバーを追加するterraform.tfvars の web_count = 3Instance と Floating IP が追加され、新しい IP が web Security Group に追加されます。既存の Instance はそのままです。
データ disk の容量を増やすstorage.tf の size_gb = 200disk がその場で拡張されます。
データベースの構成をスケールアップするdata.fptcloud_flavor.db のフィルターInstance がその場で resize されます。
Web 用のポートを追加で開放するlocal.web_rules に要素を追加新しい rule だけが作成され、既存の rule はそのままです。

apply の前には必ず terraform plan を実行し、結果をよく確認してください。インフラを変更・拡張する も参照してください。

クリーンアップ​

FPT Cloud では、Security Group はどの Instance にも割り当てられていない場合にのみ削除できます。そのため、先に Security Group を外してからインフラを削除します。

  1. Instance から Security Group を外します。

    terraform apply -var="attach_security_groups=false"
  2. インフラ全体を削除します。

    terraform destroy -var="attach_security_groups=false"
  3. yes を入力して確定します。

危険

terraform destroy は、すべての Instance、disk、およびそれらのデータを完全に削除します。保持する必要があるデータは、コマンドを実行する前にバックアップしてください。この操作は元に戻せません。

構成の拡張​

  • Web サーバーを複数の物理サーバーに分散する: Soft Anti Affinity ポリシーを持つ Instance Group に Web 用の Instance を配置します。Instance の例 を参照してください。
  • アップグレード前に Snapshot を作成する: Storage の例 を参照してください。
  • 同じ構成から複数の環境を構築する: 複数の環境向けに構成を整理する を参照してください。

次のステップ​