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

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

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --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 — имя устройства, под которым файловое хранилище будет доступно в ВМ, например storagename. Необязательный параметр.

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

   Результат:

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

5. Проверьте привязку хранилища к ВМ:

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

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

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

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

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

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

   ...
   resource "yandex_compute_instance" "vm-1" {
     name        = "vm-01"
     platform_id = "standard-v3"
     zone        = "ru-central1-a"
   
     filesystem {
       filesystem_id = "epdtcr9blled********"
       device_name   = "storagename"
     }
   }
   ...
   

   Сохраните значение device_name: оно понадобится при монтировании хранилища.

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

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

   terraform validate
   

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

   Success! The configuration is valid.
   

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

   terraform plan
   

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

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

   terraform apply
   

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

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

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

Чтобы привязать файловое хранилище к ВМ, воспользуйтесь методом REST API attachFilesystem для ресурса Instance или вызовом gRPC API InstanceService/AttachFilesystem.

Сохраните имя устройства, указанное при привязке: оно понадобится при монтировании хранилища.