Подключить файловое хранилище к виртуальной машине

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

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

   yc compute instance attach-filesystem --help
   

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

   yc compute filesystem list
   

   Результат:

   +----------------------+-------------------+------------+---------------+--------+-------------+
   |          ID          |        NAME       |    SIZE    |     ZONE      | STATUS | DESCRIPTION |
   +----------------------+-------------------+------------+---------------+--------+-------------+
   | epdtcr9blled******** | first-filesystem  | 1073741824 | ru-central1-a | READY  |             |
   | epd3f4gv8bs4******** | second-filesystem | 1073741824 | ru-central1-a | READY  |             |
   +----------------------+-------------------+------------+---------------+--------+-------------+
   

3. Получите список виртуальных машин в каталоге по умолчанию:

   yc compute instance list
   

   Результат:

   +----------------------+-------+---------------+---------+--------------+-------------+
   |          ID          | NAME  |    ZONE ID    | STATUS  |  EXTERNAL IP | INTERNAL IP |
   +----------------------+-------+---------------+---------+--------------+-------------+
   | epdj4upltbiv******** | vm-01 | ru-central1-a | RUNNING | 51.250.**.** | 192.168.*.* |
   | 1pc3088tkv4m******** | vm-02 | ru-central1-a | RUNNING | 84.201.**.** | 192.168.*.* |
   +----------------------+-------+---------------+---------+--------------+-------------+
   

4. Подключите файловое хранилище к ВМ:

   yc compute instance attach-filesystem \
     --id <идентификатор_ВМ> \
     --filesystem-id <идентификатор_файлового_хранилища> \
     --device-name <имя_устройства>
   

   Где:

   • --id — идентификатор ВМ.

     Вместо идентификатора вы можете указать имя ВМ в параметре --name.

   • --filesystem-id — идентификатор файлового хранилища.

     Вместо идентификатора вы можете указать имя файлового хранилища в параметре --filesystem-name.

   • --device-name — имя устройства, под которым файловое хранилище будет доступно в ВМ. Необязательный параметр.

     По умолчанию в качестве имени устройства используется идентификатор файлового хранилища.

   Результат:

   id: epdj4upltbiv********
   folder_id: b1g681qpemb4********
   created_at: "2024-04-29T15:50:19Z"
   name: vm-01
   ...
   filesystems:
   - mode: READ_WRITE
     device_name: attached-filesystem
     filesystem_id: epdtcr9blled********
   ...
   

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

Если вы не указали для ВМ параметр allow_stopping_for_update в значении true, сделайте это.

Чтобы подключить файловое хранилище к ВМ, добавьте к ее описанию блок filesystem с параметром filesystem_id (см. пример).

1. Откройте файл конфигурации Terraform и добавьте фрагмент с описанием хранилища к описанию ВМ:

   Пример описания хранилища в конфигурации ВМ в Terraform

   ...
   resource "yandex_compute_instance" "vm-1" {
     name        = "test-vm"
     platform_id = "standard-v3"
     zone        = "ru-central1-a"
   
     filesystem {
       filesystem_id = "fhmaikp755gr********"
     }
   }
   ...
   

2. Примените изменения:

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

Проверить присоединение хранилища к ВМ можно в консоли управления или с помощью команды CLI:

yc compute instance get <имя_ВМ>

Воспользуйтесь методом REST API attachFilesystem для ресурса Instance или вызовом gRPC API InstanceService/AttachFilesystem.