Создать файловое хранилище

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

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

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

   yc compute filesystem create --help
   

2. Создайте файловое хранилище в каталоге по умолчанию:

   yc compute filesystem create \
     --name <имя_файлового_хранилища> \
     --type <тип_файлового_хранилища> \
     --zone <зона_доступности> \
     --size <размер_файлового_хранилища> \
     --labels <ключ>=<значение>
   

   Где:

   • --name — имя файлового хранилища. Требования к имени:

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

   • --type — тип файлового хранилища. Возможные значения: network-hdd или network-ssd.

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

   • --size — размер файлового хранилища. Необязательный параметр. Значение по умолчанию 150 ГБ.

     По умолчанию значение задается в байтах. Чтобы указать размер в мегабайтах или гигабайтах, используйте суффиксы M и G. Например: 2048M или 2G.

   • --labels — метки файлового хранилища в формате <ключ>=<значение>. Необязательный параметр.

     Чтобы указать несколько меток, перечислите их через запятую: <ключ_1>=<значение_1>,<ключ_2>=<значение_2>,...,<ключ_n>=<значение_n>.

   Результат:

   done (11s)
   id: epdcago8e5lr********
   folder_id: b1gt6g8ht345********
   created_at: "2024-05-02T05:56:39Z"
   name: my-sample-fs
   labels:
     key1: value1
     key2: value2
     key3: value3
   type_id: network-hdd
   zone_id: ru-central1-a
   size: "1073741824"
   status: READY
   

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

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

   provider "yandex" {
     zone = "ru-central1-a"
   }
   
   resource "yandex_compute_filesystem" "default" {
     name   = "<имя_файлового_хранилища>"
     type   = "<тип_файлового_хранилища>"
     zone   = "<зона_доступности>"
     size   = <размер_файлового_хранилища>
     labels = {
       <ключ_метки_1> = "<значение_метки_1>"
       <ключ_метки_2> = "<значение_метки_2>"
     }
   }
   

   Где:

   • name — имя файлового хранилища. Обязательный параметр.
   • type — тип файлового хранилища. Возможные значения: network-hdd или network-ssd. По умолчанию выбирается тип файлового хранилища network-hdd. Необязательный параметр.
   • zone — зона доступности. Необязательный параметр.
   • size — размер файлового хранилища в ГБ. Необязательный параметр. Значение по умолчанию 150 ГБ.
   • labels — метка ресурса в формате <ключ> = "<значение>". Необязательный параметр.

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

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

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

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

yc compute filesystem get <имя_файлового_хранилища>

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