Создать сверхбыстрое сетевое хранилище с тремя репликами (SSD)

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Посмотрите описание команды CLI для создания дисков:

   yc compute disk create --help
   

2. Чтобы создать высокопроизводительный диск с именем ssd-io-disk, выполните команду:

   yc compute disk create \
     --name ssd-io-disk \
     --zone kz1-a \
     --type network-ssd-io-m3 \
     --size 93G \
     --kms-key-id <идентификатор_ключа>
   

   Где:

   • --name — имя диска.

   • --zone — зона доступности.

   • --type — тип диска.

   • --size — размер диска.

   • --kms-key-id — идентификатор симметричного ключа KMS для создания зашифрованного диска. Необязательный параметр.

     Для создания зашифрованного диска нужна роль kms.keys.user или выше.

     Важно

     Задать настройки шифрования можно только при создании диска. Шифрование диска нельзя будет отключить или изменить. Также нельзя будет включить шифрование для уже созданного диска.

     Если деактивировать ключ, которым были зашифрованы диск, снимок или образ, доступ к данным будет приостановлен, пока ключ не будет снова активирован.

     Внимание

     Если удалить ключ или его версию, которыми были зашифрованы диск, снимок или образ, то доступ к данным будет безвозвратно потерян. Подробнее см. Удаление версии ключа.

   Результат:

   id: a7li08c1fd8l********
   folder_id: aoerb349fdhb********
   created_at: "2024-11-25T21:22:20Z"
   name: ssd-io-disk
   type_id: network-ssd-io-m3
   zone_id: kz1-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********
   

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы создать высокопроизводительный диск:

1. Опишите в конфигурационном файле Terraform параметры ресурсов, которые необходимо создать:

   resource "yandex_compute_disk" "empty-fast-disk" {
     name       = "<имя_диска>"
     type       = "network-ssd-io-m3"
     zone       = "<зона_доступности>"
     size       = 93
     block_size = 4096
     kms_key_id = <идентификатор_ключа>
   }
   

   Где:

   • name — имя диска. Формат имени:

     • длина — от 2 до 63 символов;
     • может содержать строчные буквы латинского алфавита, цифры и дефисы;
     • первый символ — буква, последний — не дефис.

   • type — тип создаваемого диска: ssd-io-m3.

   • zone — зона доступности. Зона доступности для диска должна соответствовать зоне группы размещения, в которой вы хотите создать диск.

   • size — размер диска в ГБ, должен быть кратен 93 ГБ. Максимальный размер диска зависит от заданного размера блока.

   • block_size — размер блока в байтах (минимальный объем хранения информации на диске). По умолчанию размер блоков всех создаваемых дисков равен 4 КБ, однако для дисков больше 8 ТБ этого недостаточно. Подробнее см. в разделе Создать пустой диск с блоком большого размера.

   • kms_key_id — идентификатор симметричного ключа KMS для создания зашифрованного диска. Необязательный параметр.

     Для создания зашифрованного диска нужна роль kms.keys.user или выше.

     Важно

     Задать настройки шифрования можно только при создании диска. Шифрование диска нельзя будет отключить или изменить. Также нельзя будет включить шифрование для уже созданного диска.

     Если деактивировать ключ, которым были зашифрованы диск, снимок или образ, доступ к данным будет приостановлен, пока ключ не будет снова активирован.

     Внимание

     Если удалить ключ или его версию, которыми были зашифрованы диск, снимок или образ, то доступ к данным будет безвозвратно потерян. Подробнее см. Удаление версии ключа.

   Более подробную информацию о ресурсе yandex_compute_disk см. в документации провайдера.

2. Создайте ресурсы:

   1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.

   2. Проверьте корректность конфигурационного файла с помощью команды:

      terraform validate
      

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.
      

   3. Выполните команду:

      terraform plan
      

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

   4. Примените изменения конфигурации:

      terraform apply
      

   5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

   Terraform создаст все требуемые ресурсы. Проверить появление ресурсов можно в консоли управления или с помощью команды CLI:

   yc compute disk list
   

Воспользуйтесь методом REST API create для ресурса Disk или вызовом gRPC API DiskService/Create.