Подключить к Cloud Backup виртуальную машину или сервер, расположенные за пределами Yandex Cloud
С помощью сервиса Yandex Cloud Backup вы можете выполнять резервное копирование и восстановление из резервных копий виртуальных машин и серверов, расположенных в вашей собственной инфраструктуре или инфраструктуре стороннего провайдера.
Чтобы подключить внешнюю ВМ или сервер к Cloud Backup, эти ресурсы должны работать под управлением одной из поддерживаемых операционных систем.
Для корректной работы агента Cloud Backup ВМ должна соответствовать минимальным требованиям.
Чтобы подключить внешнюю ВМ или сервер под управлением ОС семейства Linux Ubuntu к Cloud Backup:
-
В консоли управления
выберите каталог, в котором нужно подключить внешний ресурс к Cloud Backup. -
Перейдите в сервис Cloud Backup.
-
На панели слева выберите
Подключённые ресурсы. -
В правом верхнем углу нажмите кнопку
Подключить внешний ресурс. -
В открывшемся окне Подключение внешнего ресурса:
- В поле Тип ресурса выберите тип внешнего ресурса, который хотите подключить: Внешняя виртуальная машина или Внешний сервер.
- В поле Политики резервного копирования выберите одну или несколько политик резервного копирования, которые будут автоматически применены к внешнему ресурсу после установки агента. Политики также можно привязать позже.
- В блоке Команда для установки агента Cloud Backup скопируйте команду для установки агента Cloud Backup на внешний ресурс.
-
Подключитесь к внешней ВМ или серверу и выполните скопированную команду с правами администратора.
Результат:
... Fetched instance id from file: cdgd246kiae3******** fetched registration token: 802C-AE... installing agent with rain https://ru01-cloud.cyberprotect.ru (log: /var/log/baas-agent-installer/log.txt) Trying to register agent using RegisterAgent... Agent registered with id E6B1A5DC-ECE0-****-A9B8-AFD2******** -
Убедитесь, что внешний ресурс подключен к Cloud Backup. Для этого на странице
Подключённые ресурсы откройте вкладку Внешние виртуальные машины или Внешние серверы в зависимости от типа подключенного ресурса. Подключенный ресурс появится в списке.
-
Установите и инициализируйте Yandex Cloud CLI.
Вы можете установить Yandex Cloud CLI как непосредственно на ВМ или сервер, для которых хотите настроить резервное копирование, так и на любой другой компьютер.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду
yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров--folder-nameили--folder-id. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. -
Получите код сценария, необходимого для установки агента Cloud Backup на внешний ресурс. Команда для получения кода зависит от типа ресурса, который вы хотите подключить к сервису:
Виртуальная машинаСерверyc backup agent install-external vmРезультат:
sudo apt-get update && sudo apt-get install -y jq gawk curl && curl https://storage.yandexcloud.net/backup-distributions/agent_installer_external_vm.sh | sudo bash -s -- --instance-registration-token="13d1d696-0ea4-****-93a9-f8c5********"yc backup agent install-external serverРезультат:
sudo apt-get update && sudo apt-get install -y jq gawk curl && curl https://storage.yandexcloud.net/backup-distributions/agent_installer_external_server.sh | sudo bash -s -- --instance-registration-token="ed6991f2-f364-****-a08e-75a7********" -
Выполните полученный на предыдущем шаге bash-сценарий:
Виртуальная машинаСерверsudo apt-get update && \ sudo apt-get install -y jq gawk curl && \ curl https://storage.yandexcloud.net/backup-distributions/agent_installer_external_vm.sh | sudo bash -s -- --instance-registration-token="13d1d696-0ea4-****-93a9-f8c5********"sudo apt-get update && \ sudo apt-get install -y jq gawk curl && \ curl https://storage.yandexcloud.net/backup-distributions/agent_installer_external_server.sh | sudo bash -s -- --instance-registration-token="ed6991f2-f364-****-a08e-75a7********"Результат:
... Fetched instance id from file: cdgd246kiae3******** fetched registration token: 802C-AE... installing agent with rain https://ru01-cloud.cyberprotect.ru (log: /var/log/baas-agent-installer/log.txt) Trying to register agent using RegisterAgent... Agent registered with id E6B1A5DC-ECE0-****-A9B8-AFD2********В результате внешний ресурс будет привязан к Cloud Backup и получит идентификатор. В приведенном примере идентификатор ресурса —
cdgd246kiae3********. -
Убедитесь, что внешний ресурс подключен к Cloud Backup, указав полученный на предыдущем шаге идентификатор:
yc backup vm get <идентификатор_внешнего_ресурса_в_Cloud_Backup>Результат:
compute_instance_id: cdgd246kiae3******** created_at: "2026-04-24T14:23:06.382900082Z" updated_at: "2026-04-29T19:48:22.013489248Z" enabled: true status: IDLE last_backup_time: "2026-04-27T13:07:05Z" next_backup_time: "2026-04-29T21:00:00Z" resource_id: d1fdd342-0ea8-****-9906-fa6c******** is_active: true init_status: REGISTRED metadata: "null" type: EXTERNAL_VM agent_info: current_version: 18.0.38811
- Получите команду для установки агента Cloud Backup на внешний ресурс. Для этого воспользуйтесь методом REST API getAgentInstallCommand для ресурса Setup или вызовом gRPC API SetupService/GetAgentInstallCommand. В параметрах запроса укажите тип подключаемого ресурса (
EXTERNAL_VMилиEXTERNAL_SERVER). - Подключитесь к внешней ВМ или серверу и выполните полученную команду с правами администратора.
- После установки агента внешний ресурс будет автоматически зарегистрирован в Cloud Backup. Чтобы получить список подключенных ресурсов, воспользуйтесь методом REST API list для ресурса Resource или вызовом gRPC API ResourceService/List.
Чтобы получить возможность создавать резервные копии подключенного внешнего ресурса в Cloud Backup и восстанавливать этот ресурс из резервных копий, привяжите ресурс к политике резервного копирования. Подробнее читайте в инструкции Привязать защищаемый ресурс к политике резервного копирования.