Storage の例
storage disk は、Instance の root disk とは別のブロックディスクです。アプリケーションのデータを別の disk に分けておくと、OS に影響を与えずに容量の拡張、バックアップ、別の Instance へのデータ移動を行えます。概念の詳細については Storage Disks の概要 を参照してください。
前提条件
- ✅ セットアップと設定 を完了していること。
- ✅ disk を割り当てる Instance があること。以下の例では、既存の 2 台の Instance
app-server-01とapp-server-02を読み取ります。これらは Instance の例 に従って作成できます。
共通設定
# shared.tf
data "fptcloud_vpc" "example" {
name = "example-vpc"
}
data "fptcloud_storage_policy" "ssd" {
vpc_id = data.fptcloud_vpc.example.id
filter {
key = "name"
values = ["Premium-SSD"]
}
}
# shared.tf
data "fptcloud_instance" "app" {
vpc_id = data.fptcloud_vpc.example.id
name = "app-server-01"
}
data "fptcloud_instance" "standby" {
vpc_id = data.fptcloud_vpc.example.id
name = "app-server-02"
}
実際の構成で、Instance を同じ Terraform フォルダーで作成している場合は、fptcloud_instance.app.id を直接使用できます。
Instance に割り当てるデータ disk
最も一般的なケースで、アプリケーションのデータ専用の disk です。Terraform は disk を作成し、disk が Instance に割り当てられるまで待機します。
# disk.tf
resource "fptcloud_storage" "app_data" {
vpc_id = data.fptcloud_vpc.example.id
name = "app-data-disk"
type = "EXTERNAL"
size_gb = 200
storage_policy_id = data.fptcloud_storage_policy.ssd.storage_policies[0].id
instance_id = data.fptcloud_instance.app.id
}
新しく割り当てた disk は空の状態です。使用する前に、Storage Disks のトラブルシューティング の Newly Attached Disk Does Not Appear Inside the Instance の項に従って、Instance の OS 内で disk をフォーマットしてください。
Instance に割り当てない disk
instance_id 引数を省略すると、独立した disk を作成できます。後で作成する Instance 用に disk を事前に用意する場合などに使用します。
# disk.tf
resource "fptcloud_storage" "spare" {
vpc_id = data.fptcloud_vpc.example.id
name = "spare-disk"
type = "EXTERNAL"
size_gb = 100
storage_policy_id = data.fptcloud_storage_policy.ssd.storage_policies[0].id
}
割り当てるときは、instance_id を追加して terraform apply を実行します。
1 台の Instance に複数の disk
データとログを 2 つの disk に分けると、それぞれの disk に適した容量と storage policy を設定できます。
# disks.tf
locals {
app_disks = {
data = 200
logs = 50
}
}
resource "fptcloud_storage" "app" {
for_each = local.app_disks
vpc_id = data.fptcloud_vpc.example.id
name = "app-${each.key}-disk"
type = "EXTERNAL"
size_gb = each.value
storage_policy_id = data.fptcloud_storage_policy.ssd.storage_policies[0].id
instance_id = data.fptcloud_instance.app.id
}
disk を別の Instance に移動する
EXTERNAL の disk は、データを保持したまま Instance 間で移動できます。instance_id を新しい Instance に変更し、terraform apply を実行します。
# disk.tf
resource "fptcloud_storage" "shared_data" {
vpc_id = data.fptcloud_vpc.example.id
name = "shared-data-disk"
type = "EXTERNAL"
size_gb = 100
storage_policy_id = data.fptcloud_storage_policy.ssd.storage_policies[0].id
instance_id = data.fptcloud_instance.standby.id # 以前は Instance app
}
disk を Instance から取り外し、他の Instance にも割り当てない場合は、instance_id の行を削除して terraform apply を実行します。
Storage Disks のトラブルシューティング で推奨されているとおり、disk を移動または取り外す前に、OS 内で disk をアンマウントしてください。
容量の拡張と storage policy の変更
disk を拡張するには size_gb を増やします。disk を別の性能レベルに移行するには storage_policy_id を変更します。どちらの変更もその場で実行され、データは保持されます。
# disk.tf
data "fptcloud_storage_policy" "fast" {
vpc_id = data.fptcloud_vpc.example.id
filter {
key = "name"
values = ["Premium-SSD-6000"] # VPC で利用できる storage policy に置き換えてください
}
}
# disk.tf
resource "fptcloud_storage" "reports" {
vpc_id = data.fptcloud_vpc.example.id
name = "reports-disk"
type = "EXTERNAL"
size_gb = 300 # 以前は 200
storage_policy_id = data.fptcloud_storage_policy.fast.storage_policies[0].id
instance_id = data.fptcloud_instance.app.id
}
容量を拡張した後は、Instance の Storage Disk を管理する に従って、Instance の OS で対応するパーティションを拡張する必要があります。
disk の容量は増やすことのみ可能で、減らすことはできません。provider は terraform plan の段階で小さい値をブロックしないため、apply の前に十分に確認してください。
Instance の Snapshot
OS のアップグレードなどの大きな変更の前に Snapshot を作成しておくと、以前の状態に戻すことができます。各 fptcloud_snapshot は 1 つの Snapshot であり、apply 時に作成され、destroy 時に削除されます。
# snapshot.tf
resource "fptcloud_snapshot" "before_upgrade" {
vpc_id = data.fptcloud_vpc.example.id
instance_id = data.fptcloud_instance.app.id
name = "app-before-upgrade"
}
Snapshot の名前は 1 ~ 30 文字で、英字、数字、アンダースコア、ハイフン、ピリオド、空白を使用できます。詳しくは Snapshots の概要 を参照してください。
storage disk のよく使う引数
| 引数 | 必須 | 変更した場合 |
|---|---|---|
vpc_id | はい | 作成後は変更できません。 |
name | はい | その場で名前を変更します。EXTERNAL の disk の場合、名前は VPC 内の他の disk と重複できません。 |
type | はい | 変更できません。apply でエラーになります。値は EXTERNAL、LOCAL です。 |
size_gb | はい | その場で容量を拡張します。 |
storage_policy_id | はい | その場で storage policy を変更します。 |
instance_id | いいえ | EXTERNAL の場合は、その場で disk を移動または取り外します。LOCAL の場合は、作成時に必須で、変更できません。 |
tag_ids | いいえ | その場で tag を更新します。 |
データ disk には EXTERNAL を使用することを推奨します。LOCAL の disk は 1 台の Instance に固定され、移動や取り外しはできません。
Instance の root disk には fptcloud_storage を使用しないでください。root disk は fptcloud_instance の storage_size_gb と storage_policy_id で管理されます。
disk の削除
構成から disk を削除するか、terraform destroy を実行すると、Terraform は disk を Instance から取り外し、disk を削除して、削除が完了するまで待機します。
disk を削除すると、disk 上のすべてのデータが完全に削除されます。この操作は元に戻せません。