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

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 上のすべてのデータが完全に削除されます。この操作は元に戻せません。

次のステップ​