Creating an ultra high-speed network storage with three replicas (SSD)

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

1. See the description of the CLI command for creating disks:

   yc compute disk create --help
   

2. To create a high-performance disk named ssd-io-disk, run this command:

   yc compute disk create \
     --name ssd-io-disk \
     --zone ru-central1-a \
     --type network-ssd-io-m3 \
     --size 93G \
     --kms-key-id <key_ID>
   

   Where:

   • --name: Disk name.

   • --zone: Availability zone.

   • --type: Disk type.

   • --size: Disk size.

   • --kms-key-id: ID of the KMS symmetric key to create an encrypted disk. This is an optional parameter.

     To create an encrypted disk, you need the kms.keys.user role or higher.

     Warning

     You can specify encryption settings only when creating a disk. You cannot disable or change disk encryption. You also cannot enable encryption for an existing disk.

     If you deactivate the key used to encrypt a disk, image, or snapshot, access to the data will be suspended until you reactivate the key.

     Alert

     If you destroy the key or its version used to encrypt a disk, image, or snapshot, you will irrevocably lose access to the data. For details, see Destroying key versions.

   Result:

   id: a7li08c1fd8l********
   folder_id: aoerb349fdhb********
   created_at: "2024-11-25T21:22:20Z"
   name: ssd-io-disk
   type_id: network-ssd-io-m3
   zone_id: ru-central1-a
   size: "99857989632"
   block_size: "4096"
   status: READY
   disk_placement_policy: {}
   hardware_generation:
     legacy_features:
       pci_topology: PCI_TOPOLOGY_V1
   kms_key:
     key_id: abjbaqdga6hs********
     version_id: abj295dgqnlp********
   

With Terraform, you can quickly create a cloud infrastructure in Yandex Cloud and manage it using configuration files. These files store the infrastructure description written in HashiCorp Configuration Language (HCL). If you change the configuration files, Terraform automatically detects which part of your configuration is already deployed, and what should be added or removed.

Terraform is distributed under the Business Source License. The Yandex Cloud provider for Terraform is distributed under the MPL-2.0 license.

For more information about the provider resources, see the relevant documentation on the Terraform website or its mirror.

If you do not have Terraform yet, install it and configure the Yandex Cloud provider.

To create a high-performance disk, do the following:

1. In the Terraform configuration file, describe the resources you want to create:

   resource "yandex_compute_disk" "empty-fast-disk" {
     name       = "<disk_name>"
     type       = "network-ssd-io-m3"
     zone       = "<availability_zone>"
     size       = 93
     block_size = 4096
     kms_key_id = <key_ID>
   }
   

   Where:

   • name: Disk name. Follow these naming requirements:

     • It must be from 2 to 63 characters long.
     • It can only contain lowercase Latin letters, numbers, and hyphens.
     • It must start with a letter and cannot end with a hyphen.

   • type: Disk type, ssd-io-m3.

   • zone: Availability zone. The availability zone for your disk must match the zone of the placement group where you want to create it. We recommend creating disks in the ru-central1-a or ru-central1-b availability zone.

   • size: Disk size in GB. This must be a multiple of 93 GB. The maximum disk size depends on the specified block size.

   • block_size: Block size in bytes (minimum storage unit on the disk). By default, the block size is 4 KB for all new disks; however, this is insufficient for disks larger than 8 TB. Learn more in Creating an empty disk with a large block.

   • kms_key_id: ID of the KMS symmetric key to create an encrypted disk. This is an optional parameter.

     To create an encrypted disk, you need the kms.keys.user role or higher.

     Warning

     You can specify encryption settings only when creating a disk. You cannot disable or change disk encryption. You also cannot enable encryption for an existing disk.

     If you deactivate the key used to encrypt a disk, image, or snapshot, access to the data will be suspended until you reactivate the key.

     Alert

     If you destroy the key or its version used to encrypt a disk, image, or snapshot, you will irrevocably lose access to the data. For details, see Destroying key versions.

   For more information about the yandex_compute_disk resource, see the relevant provider documentation.

2. Create the resources:

   1. In the terminal, go to the directory where you edited the configuration file.

   2. Make sure the configuration file is correct using this command:

      terraform validate
      

      If the configuration is correct, you will get this message:

      Success! The configuration is valid.
      

   3. Run this command:

      terraform plan
      

      You will see a detailed list of resources. No changes will be made at this step. If the configuration contains any errors, Terraform will show them.

   4. Apply the changes:

      terraform apply
      

   5. Type yes and press Enter to confirm the changes.

   Terraform will create all the required resources. You can check the new resources using the management console or this CLI command:

   yc compute disk list
   

Use the create REST API method for the Disk resource or the DiskService/Create gRPC API call.