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

インフラを変更・拡張する

アプリケーションの要件は時間とともに変化します。このページでは、実行中のリソースを Terraform で安全に調整する方法を説明します。変更はその場で行い、リソースを再作成せず、データも失いません。

前提条件​

変更の前に plan を確認する​

apply の前には必ず terraform plan を実行し、結果を確認してください。

plan の表示意味
~ update in-placeリソースが更新され、データはそのまま保持されます。
-/+ destroy and then create replacementリソースが削除されてから再作成されます。Instance の場合、root disk 上のデータは失われます。
# forces replacement再作成の原因となる引数を示します。

このページで紹介する変更は、すべてその場での変更です。

ヒント

適用される内容が確認した内容と完全に一致するように、plan を保存してからその plan を apply してください。

terraform plan -out=tfplan
terraform apply tfplan

vCPU と RAM の構成を変更する​

vCPU と RAM を増減するには flavor を変更します。フィルターで flavor を選択している場合は、フィルターの値を編集するだけです。

data "fptcloud_flavor" "app" {
vpc_id = data.fptcloud_vpc.example.id

filter {
key = "cpu"
values = ["4"] # 以前は 2
}
filter {
key = "memory_mb"
values = ["8192"] # 以前は 4096
}
}

この flavor を使用する Instance について、plan には ~ flavor_name と表示されます。apply の後、Terraform は resize が完了するまで待機します。Instance 上のデータと設定はすべてそのまま保持されます。

Resize ガイド によると、resize の前に次の条件を満たす必要があります。

  • Instance が Running または Stopped 状態であること。
  • NVMe storage を使用する Instance は resize に対応していません。
  • GPU が接続されている Instance は、先に GPU を取り外す必要があります。

root disk の容量を増やす​

Instance の storage_size_gb を増やします。

resource "fptcloud_instance" "app" {
# ...
storage_size_gb = 80 # 以前は 40
}

root disk は増やすことしかできません。より小さい値を設定すると、terraform plan は何も変更する前にエラーで停止します。

apply の後、Instance の Storage Disk の管理 に従って、Instance の OS 内で対応するパーティションを拡張する必要があります。

root disk を別のパフォーマンスレベルに移行するには、Instance の storage_policy_id を変更します。この変更もその場で行われます。

データ disk の容量を増やす​

fptcloud_storage の size_gb を増やします。

resource "fptcloud_storage" "app_data" {
# ...
size_gb = 200 # 以前は 100
}

disk はその場で拡張され、データはそのまま保持されます。その後、Instance の OS 内で対応するパーティションを拡張します。

警告

disk の容量は増やすことしかできず、減らすことはできません。provider は terraform plan の段階で size_gb のより小さい値をブロックしないため、apply の前によく確認してください。

Instance を起動・停止する​

status 引数は電源状態を決定します。よくある使い方として、開発用の Instance を業務時間外に停止する方法があります。

variable "dev_running" {
type = bool
default = true
}

resource "fptcloud_instance" "dev" {
# ...
status = var.dev_running ? "POWERED_ON" : "POWERED_OFF"
}
terraform apply -var="dev_running=false" # 終業時
terraform apply -var="dev_running=true" # 始業時

同僚も Portal で Instance を起動・停止していて、Terraform に上書きさせたくない場合は、電源状態を無視するように Terraform に指示します。

resource "fptcloud_instance" "dev" {
# ...
status = "POWERED_ON"

lifecycle {
ignore_changes = [status]
}
}

Instance を追加する​

count で作成した Instance の場合は、数を増やすことで Instance を追加できます。

variable "web_count" {
type = number
default = 3 # 以前は 2
}

Terraform は新しい Instance を追加で作成し、実行中の Instance には影響しません。完全な Web アプリケーション基盤を構築する のように、Security Group の apply_to が Instance のリストから IP を取得している場合は、同じ apply で新しい Instance の IP が Security Group に追加されます。

警告

count を減らすと、インデックスが最も大きい Instance が削除されます。どの Instance が削除されるかを正確に把握するために、plan をよく確認してください。リストの途中にある特定の Instance を削除する必要がある場合は、count の代わりに for_each を使用してください。

リソースを意図的に再作成する​

Instance に問題が発生し、構成からその Instance だけを再作成したい場合は、-replace を使用します。

terraform apply -replace="fptcloud_instance.web[1]"

Terraform は指定したリソースだけを再作成し、他のリソースはそのまま保持します。

重要なリソースを保護する​

データベースサーバーなど、誤って削除すると大きな損害が生じるリソースには prevent_destroy を追加します。Terraform は、image_name、subnet_id、ssh_key の変更による再作成も含め、このリソースを削除するすべての plan を拒否します。

resource "fptcloud_instance" "db" {
# ...

lifecycle {
prevent_destroy = true
}
}

このリソースを意図的に削除するには、先に lifecycle ブロックを削除してください。

次のステップ​