復元リソースの使用

このドキュメントのtidbcloud_restoreリソースを使用して復元タスクを管理する方法を学習できます。

tidbcloud_restoreリソースの機能は次のとおりです。

バックアップに応じて、 TiDB Cloud Dedicated クラスターの復元タスクを作成します。

前提条件

TiDB Cloud Terraform プロバイダーを入手。
バックアップと復元機能は、 TiDB Cloud Serverless クラスターでは使用できません。復元リソースを使用するには、 TiDB Cloud Dedicated クラスターを作成していることを確認してください。

復元タスクを作成する

クラスターのバックアップを作成した後、 tidbcloud_restoreのリソースを使用して復元タスクを作成することで、クラスターを復元できます。

注記：
小さいノードサイズから同じまたは大きいノードサイズにのみデータを復元できます。

復元用のディレクトリを作成してそこに入ります。

restore.tfファイルを作成します。

例えば：

terraform {
 required_providers {
   tidbcloud = {
     source = "tidbcloud/tidbcloud"
   }
 }
}

provider "tidbcloud" {
 public_key = "your_public_key"
 private_key = "your_private_key"
}
resource "tidbcloud_restore" "example_restore" {
  project_id = tidbcloud_cluster.example_cluster.project_id
  backup_id  = tidbcloud_backup.example_backup.id
  name       = "restoreCluster"
  config = {
    root_password = "Your_root_password1."
    port          = 4000
    components = {
      tidb = {
        node_size : "8C16G"
        node_quantity : 2
      }
      tikv = {
        node_size : "8C32G"
        storage_size_gib : 500
        node_quantity : 6
      }
      tiflash = {
        node_size : "8C64G"
        storage_size_gib : 500
        node_quantity : 2
      }
    }
  }
}

terraform applyコマンドを実行し、確認のためにyesと入力します。

$ terraform apply
tidbcloud_cluster.example_cluster: Refreshing state... [id=1379661944630234067]
tidbcloud_backup.example_backup: Refreshing state... [id=1350048]

Terraform used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols:
  + create

Terraform will perform the following actions:

  # tidbcloud_restore.example_restore will be created
  + resource "tidbcloud_restore" "example_restore" {
      + backup_id        = "1350048"
      + cluster          = {
          + id     = (known after apply)
          + name   = (known after apply)
          + status = (known after apply)
        }
      + cluster_id       = (known after apply)
      + config           = {
          + components    = {
              + tidb    = {
                  + node_quantity = 2
                  + node_size     = "8C16G"
                }
              + tiflash = {
                  + node_quantity    = 2
                  + node_size        = "8C64G"
                  + storage_size_gib = 500
                }
              + tikv    = {
                  + node_quantity    = 6
                  + node_size        = "8C32G"
                  + storage_size_gib = 500
                }
            }
          + port          = 4000
          + root_password = "Your_root_password1."
        }
      + create_timestamp = (known after apply)
      + error_message    = (known after apply)
      + id               = (known after apply)
      + name             = "restoreCluster"
      + project_id       = "1372813089189561287"
      + status           = (known after apply)
    }

Plan: 1 to add, 0 to change, 0 to destroy.

Do you want to perform these actions?
  Terraform will perform the actions described above.
  Only 'yes' will be accepted to approve.

  Enter a value: yes

tidbcloud_restore.example_restore: Creating...
tidbcloud_restore.example_restore: Creation complete after 1s [id=780114]

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.

復元タスクのステータスを確認するには、 terraform state show tidbcloud_restore.${resource-name}コマンドを使用します。

$ terraform state show tidbcloud_restore.example_restore

# tidbcloud_restore.example_restore:
resource "tidbcloud_restore" "example_restore" {
    backup_id        = "1350048"
    cluster          = {
        id     = "1379661944630264072"
        name   = "restoreCluster"
        status = "INITIALIZING"
    }
    cluster_id       = "1379661944630234067"
    config           = {
        components    = {
            tidb    = {
                node_quantity = 2
                node_size     = "8C16G"
            }
            tiflash = {
                node_quantity    = 2
                node_size        = "8C64G"
                storage_size_gib = 500
            }
            tikv    = {
                node_quantity    = 6
                node_size        = "8C32G"
                storage_size_gib = 500
            }
        }
        port          = 4000
        root_password = "Your_root_password1."
    }
    create_timestamp = "2022-08-26T08:16:33Z"
    id               = "780114"
    name             = "restoreCluster"
    project_id       = "1372813089189561287"
    status           = "PENDING"
}

復元タスクのステータスはPENDINGで、クラスターのステータスはINITIALIZINGあることがわかります。

数分間お待ちください。その後、 terraform refersh使用してステータスを更新します。
クラスターのステータスがAVAILABLEに変わると、復元タスクはRUNNINGになり、最終的にSUCCESSになります。

復元されたクラスターは Terraform によって管理されないことに注意してください。復元されたクラスターは輸入するによって管理できます。

復元タスクを更新する

復元タスクを更新できません。

復元タスクを削除する

復元タスクは削除できません。

復元リソースの使用

前提条件

復元タスクを作成する

復元タスクを更新する

復元タスクを削除する

このページは役に立ちましたか？