[Документация Yandex Cloud](../../../index.md) > [Yandex Compute Cloud](../../index.md) > [Пошаговые инструкции](../index.md) > Файловые хранилища > Подключить файловое хранилище к ВМ # Подключить файловое хранилище к виртуальной машине {% note warning %} [Файловое хранилище](../../concepts/filesystem.md) можно подключить только к [ВМ](../../concepts/vm.md) под управлением [операционной системы](../../concepts/filesystem.md#os) Linux с версией ядра 5.4 или выше. Чтобы проверить версию ядра, выполните команду `sudo uname -r`. {% endnote %} 1. Если ВМ запущена и работает ([статус](../../concepts/vm-statuses.md) `RUNNING`), [остановите ее](../vm-control/vm-stop-and-start.md#stop). 1. Привяжите файловое хранилище к ВМ в Compute Cloud: {% list tabs group=instructions %} - Консоль управления {#console} 1. В [консоли управления](https://kz.console.yandex.cloud) выберите [каталог](../../../resource-manager/concepts/resources-hierarchy.md#folder), в котором создано файловое хранилище. 1. Перейдите в сервис **Compute Cloud**. 1. На панели слева выберите ![image](../../../_assets/console-icons/nodes-right.svg) **Файловые хранилища**. 1. Выберите нужное хранилище. 1. Перейдите на вкладку **Виртуальные машины**. 1. Нажмите кнопку ![image](../../../_assets/console-icons/plus.svg) **Подключить к ВМ**. 1. В открывшемся окне: 1. Выберите ВМ. 1. Укажите имя устройства, под которым файловое хранилище будет доступно в ВМ. Сохраните это значение: оно понадобится при монтировании хранилища. 1. Нажмите **Подключить к ВМ**. - CLI {#cli} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. 1. Посмотрите описание команды [CLI](../../../cli/index.md) для подключения файлового хранилища к ВМ: ```bash yc compute instance attach-filesystem --help ``` 1. Получите список файловых хранилищ в [каталоге](../../../resource-manager/concepts/resources-hierarchy.md#folder) по умолчанию: ```bash yc compute filesystem list ``` Результат: ```text +----------------------+-------------------+------------+---------------+--------+-------------+ | ID | NAME | SIZE | ZONE | STATUS | DESCRIPTION | +----------------------+-------------------+------------+---------------+--------+-------------+ | epdtcr9blled******** | first-filesystem | 1073741824 | kz1-a | READY | | | epd3f4gv8bs4******** | second-filesystem | 1073741824 | kz1-a | READY | | +----------------------+-------------------+------------+---------------+--------+-------------+ ``` 1. Получите список виртуальных машин в каталоге по умолчанию: ```bash yc compute instance list ``` Результат: ```text +----------------------+-------+---------------+---------+--------------+-------------+ | ID | NAME | ZONE ID | STATUS | EXTERNAL IP | INTERNAL IP | +----------------------+-------+---------------+---------+--------------+-------------+ | epdj4upltbiv******** | vm-01 | kz1-a | RUNNING | 51.250.**.** | 192.168.*.* | | 1pc3088tkv4m******** | vm-02 | kz1-a | RUNNING | 84.201.**.** | 192.168.*.* | +----------------------+-------+---------------+---------+--------------+-------------+ ``` 1. Подключите файловое хранилище к ВМ: ```bash yc compute instance attach-filesystem \ --id <идентификатор_ВМ> \ --filesystem-id <идентификатор_файлового_хранилища> \ --device-name <имя_устройства> ``` Где: * `--id` — идентификатор ВМ. Вместо идентификатора вы можете указать имя ВМ в параметре `--name`. * `--filesystem-id` — идентификатор файлового хранилища. Вместо идентификатора вы можете указать имя файлового хранилища в параметре `--filesystem-name`. * `--device-name` — имя устройства, под которым файловое хранилище будет доступно в ВМ. Необязательный параметр. По умолчанию в качестве имени устройства используется идентификатор файлового хранилища. Результат: ```text 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 {#tf} Если у вас еще нет Terraform, [установите его и настройте провайдер Yandex Cloud](../../../tutorials/infrastructure-management/terraform-quickstart.md#install-terraform). Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, [аутентифицируйтесь](../../../terraform/authentication.md) соответствующим способом. Если вы не указали для ВМ параметр `allow_stopping_for_update` в значении `true`, сделайте это. Чтобы подключить файловое хранилище к ВМ, добавьте к ее описанию блок `filesystem` с параметром `filesystem_id` (смотрите пример). 1. Откройте файл конфигурации Terraform и добавьте фрагмент с описанием хранилища к описанию ВМ: {% cut "Пример описания хранилища в конфигурации ВМ в Terraform" %} ```hcl ... resource "yandex_compute_instance" "vm-1" { name = "test-vm" platform_id = "standard-v3" zone = "kz1-a" filesystem { filesystem_id = "fhmaikp755gr********" } } ... ``` {% endcut %} 1. Примените изменения: 1. В терминале перейдите в директорию с конфигурационным файлом. 1. Проверьте корректность конфигурации с помощью команды: ```bash terraform validate ``` Если конфигурация является корректной, появится сообщение: ```bash Success! The configuration is valid. ``` 1. Выполните команду: ```bash terraform plan ``` В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет. 1. Примените изменения конфигурации: ```bash terraform apply ``` 1. Подтвердите изменения: введите в терминале слово `yes` и нажмите **Enter**. Проверить присоединение хранилища к ВМ можно в [консоли управления](https://kz.console.yandex.cloud) или с помощью команды [CLI](../../../cli/index.md): ```bash yc compute instance get <имя_ВМ> ``` - API {#api} Воспользуйтесь методом REST API [attachFilesystem](../../api-ref/Instance/attachFilesystem.md) для ресурса [Instance](../../api-ref/Instance/index.md) или вызовом gRPC API [InstanceService/AttachFilesystem](../../api-ref/grpc/Instance/attachFilesystem.md). {% endlist %} 1. Смонтируйте файловое хранилище на ВМ. 1. Если вы не знаете имя устройства для монтирования, получите его: ```bash yc compute instance get <имя_ВМ> ``` Результат: ```text ... filesystems: - mode: READ_WRITE device_name: storagename filesystem_id: epdb1jata63j******** ... ``` Сохраните значение поля `device_name` в блоке `filesystems`. Это имя устройства для монтирования, которое понадобится далее. 1. [Подключитесь](../vm-connect/ssh.md) к ВМ по [SSH](../../../glossary/ssh-keygen.md). 1. Выполните команду: ```bash sudo mount -t virtiofs <имя_устройства> <путь_монтирования> ``` Где: * `<имя_устройства>` — значение поля `device_name`, сохраненное ранее. В примере выше имя устройства — `storagename`. У вас имя устройства может отличаться. * `<путь_монтирования>` — каталог или диск, в который будет смонтировано файловое хранилище. Например: `/mnt/vfs0`. 1. Проверьте, что файловое хранилище смонтировано: ```bash df -T ``` Результат: ```text Filesystem Type 1K-blocks Used Available Use% Mounted on udev devtmpfs 988600 0 988600 0% /dev tmpfs tmpfs 203524 780 202744 1% /run /dev/vda2 ext4 13354932 1909060 10861420 15% / tmpfs tmpfs 1017604 0 1017604 0% /dev/shm tmpfs tmpfs 5120 0 5120 0% /run/lock tmpfs tmpfs 1017604 0 1017604 0% /sys/fs/cgroup tmpfs tmpfs 203520 0 203520 0% /run/user/1000 storagename virtiofs 66774660 0 66774660 0% /mnt/vfs0 ``` 1. Чтобы файловое хранилище монтировалось при каждом запуске ВМ, добавьте в файл `/etc/fstab` строку вида: ```text <имя_устройства> <путь_монтирования> virtiofs rw 0 0 ```