Vagrant для виртуальных лабораторий: boxes, providers и Vagrantfile

Что делает Vagrant и чем он отличается от гипервизора

Vagrant — это CLI-инструмент управления средой, а не гипервизор. Он читает Vagrantfile, скачивает или использует локальный box, вызывает provider для создания VM, передаёт ему параметры и запускает подготовку гостевой системы. Само выполнение гостевого кода, виртуальные процессоры, память, диски и сеть предоставляет provider и лежащий под ним продукт виртуализации.

Поэтому Vagrant не заменяет VirtualBox, VMware Workstation, Hyper-V, KVM/libvirt или серверную платформу. О различиях гипервизоров и уровнях виртуализации читайте в статье «Гипервизоры и типы виртуализации: Type 1, Type 2, полная и паравиртуализация».

Подготовьте хост и выберите provider

До создания проекта установите Vagrant для своей поддерживаемой хостовой ОС и один выбранный provider со всеми требуемыми компонентами. Набор поддерживаемых ОС, встроенных providers и дополнительные зависимости зависят от релиза Vagrant, provider и хостовой ОС: сверяйте матрицу совместимости в официальной документации Vagrant и документации provider.

• VirtualBox: установлены Vagrant и совместимый VirtualBox. Для первого стенда обычно достаточно встроенного provider virtualbox.
• VMware Workstation: установлены Vagrant, совместимый VMware Workstation и компоненты VMware provider для Vagrant. В зависимости от актуального выпуска это может включать отдельный плагин и служебный компонент; совместимость и лицензионные условия проверяют по документации Vagrant и VMware.
• Другой provider: кроме Vagrant могут потребоваться отдельный плагин, локальная служба, API-доступ, драйверы или системные пакеты. Например, работа с KVM/libvirt относится к отдельному стеку; его подготовка описана в статье «KVM, QEMU и libvirt в Linux: установка, VM, virsh и Guest Agent».

vagrant --version

В выводе должна быть установленная версия Vagrant. Если команда не найдена, проверьте установку программы и переменную PATH.

vagrant plugin list

Команда выводит установленные плагины, но не перечисляет все доступные providers: встроенный provider, например VirtualBox, может отсутствовать в списке. Фактическую доступность выбранного provider проверьте после создания проекта явной командой `vagrant up --provider=имя_provider`; при ошибке проверьте продукт виртуализации, плагин, служебные компоненты и совместимость версий.

Выберите box, совместимый с provider

Box — не универсальный файл виртуального диска. Это пакет с метаданными и файлами, подготовленный для определённого provider. В метаданных каталога box обычно указываются версии box, варианты provider, архитектуры, URL загрузки и контрольные суммы. Один издатель может публиковать отдельные варианты одного образа для virtualbox, VMware и других платформ — либо не публиковать нужный вариант вовсе.

1. Выберите издателя box и проверьте в его карточке или документации поддерживаемую гостевую ОС, архитектуру, provider и условия использования.
2. Выберите версию box, которая существует для нужного provider, и зафиксируйте её в Vagrantfile через config.vm.box_version.
3. Проверьте, что образ предназначен для вашей архитектуры хоста и поддерживает нужный способ доступа, например SSH для Linux-гостя.
4. Сверьте лицензию box и лицензионные условия гостевой ОС отдельно. Разрешение на загрузку одного образа не означает право распространять, модифицировать или использовать другой образ либо другую редакцию ОС.

Создайте каталог проекта и минимальный Vagrantfile

Ниже — сквозной пример для virtualbox. Сначала выберите существующие имя и версию box, затем замените ими значения publisher/box и required-box-version непосредственно в Vagrantfile. Значения CPU и памяти в примере также скорректируйте с учётом ресурсов хоста и требований гостевой ОС. Команды записаны для POSIX-совместимой оболочки; в PowerShell используйте эквивалентные команды создания каталога и перехода в него.

mkdir vagrant-lab
cd vagrant-lab
vagrant init

Vagrant.configure("2") do |config|
  config.vm.define "lab" do |lab|
    # Замените значения на существующий box и его версию для VirtualBox.
    lab.vm.box = "publisher/box"
    lab.vm.box_version = "required-box-version"
    lab.vm.hostname = "lab-guest"

    # Частная сеть с адресом, выделяемым механизмом provider.
    lab.vm.network "private_network", type: "dhcp"

    # Для минимального стенда общая папка отключена явно.
    # Включайте её только поддерживаемым выбранным provider способом.
    lab.vm.synced_folder ".", "/vagrant", disabled: true

    lab.vm.provider "virtualbox" do |vb|
      vb.name = "lab-virtualbox"
      vb.cpus = 2
      vb.memory = 2048
    end

    lab.vm.provision "shell", inline: <<-SHELL
      set -eu
      install -d -m 0755 /opt/lab
      printf '%s\n' 'provisioned-by-vagrant' > /opt/lab/marker
      chmod 0644 /opt/lab/marker
    SHELL
  end
end

vagrant validate

Ожидаемый результат — сообщение, что Vagrantfile валиден. Если команда сообщает об ошибке, исправьте имя переменной, кавычки или структуру Ruby-конфигурации и повторите проверку.

В примере три имени решают разные задачи. config.vm.define задаёт имя машины в Vagrant: оно используется в командах вроде vagrant up lab. config.vm.hostname задаёт hostname внутри Guest OS. vb.name задаёт отображаемое имя объекта VM в VirtualBox. Они могут совпадать, но это не одно и то же.

Запустите VM и управляйте её жизненным циклом

Первый up при необходимости скачает box, создаст VM через VirtualBox, применит конфигурацию и выполнит provisioning. Явный параметр --provider исключает случайный выбор другого доступного provider.

vagrant up lab --provider=virtualbox

Ожидаемый результат — завершение создания VM и статус `running`. При ошибке загрузки проверьте имя, версию и provider box; при ошибке создания — доступность VirtualBox, аппаратной виртуализации и достаточность ресурсов хоста.

vagrant status

После успешного запуска для `lab` ожидается состояние `running`. Статус `not created` означает, что VM ещё не создана или была удалена; при другом provider укажите его явно при следующем `up`.

vagrant ssh lab

После подключения проверьте `hostname` и наличие файла `/opt/lab/marker`. Если SSH недоступен, сначала убедитесь в `vagrant status`, затем проверьте, что box поддерживает SSH и provisioning завершился без ошибки.

hostname
cat /opt/lab/marker
nproc

Для гостевых ОС без SSH способ подключения зависит от communicator и возможностей конкретного provider. Не подменяйте эту проверку попыткой подключиться по случайному IP: используйте способ, предусмотренный выбранным box и конфигурацией Vagrant.

Добавьте shell provisioning без секретов

Provisioning автоматически подготавливает гостевую ОС после создания. В примере выше shell-сценарий создаёт каталог и файл-маркер; повторный запуск приводит к тому же результату. Это пример идемпотентности: скрипт можно применить повторно без накопления дубликатов и без требования ручной очистки.

Shell provisioning по умолчанию обычно выполняется при первом создании машины. Команда vagrant provision запускает его повторно, а vagrant up --provision и vagrant reload --provision позволяют совместить операцию с повторным применением. Идемпотентность не обеспечивается Vagrant автоматически: её должен реализовать автор сценария. Полную настройку ОС, контейнерной среды или приложений следует вести в профильных материалах, а не переносить в один большой Vagrantfile.

Храните описание стенда как код

Добавьте Vagrantfile, отдельные сценарии provisioning и документацию с версиями в систему контроля версий. Каталог .vagrant содержит локальное состояние конкретного развёртывания и обычно не нужен другим участникам проекта. Также исключайте секреты и локальные переопределения согласно принятой политике команды.

.vagrant/
.env
*.local
secrets/

Фиксация Vagrantfile не делает окружение полностью неизменным сама по себе. На результат также влияют релизы Vagrant и provider, версия и содержимое box, версия VirtualBox или VMware Workstation, плагины, обновления гостевой ОС, репозитории пакетов, DNS и другие внешние источники provisioning. Запишите эти зависимости в README проекта или в принятом реестре зависимостей; при необходимости сохраняйте проверенные артефакты и контрольные суммы в разрешённом внутреннем хранилище.

Особенности VMware Workstation и других providers

Для VMware Workstation нельзя просто заменить в команде слово virtualbox на vmware_desktop. Нужны совместимые Vagrant, VMware Workstation и VMware provider, а также VMware box, опубликованный для этого provider. Provider-specific блок в Vagrantfile будет иным: параметры отображаемого имени VM, ресурсов, сети и shared folders определяются документацией VMware provider.

• До запуска через VMware проверьте текущий способ интеграции с Vagrant: требуемый плагин, служебные компоненты, поддерживаемые версии Workstation и Vagrant.
• Проверьте лицензионные условия VMware Workstation, VMware provider и выбранного box для вашей редакции, региона и сценария использования. Условия поставки и доступные права меняются, поэтому их нельзя выводить из старых инструкций или условий другого продукта.
• Явно укажите provider при запуске, например vagrant up lab --provider=vmware_desktop, только если именно такое имя provider указано в актуальной документации установленного компонента.
• Не переносите без проверки параметры VirtualBox, включая vb.name, в VMware provider: это разные интерфейсы конфигурации.

Установка VirtualBox, VMware Workstation и создание первой VM через их графический интерфейс рассмотрены отдельно в статье «VirtualBox и VMware Workstation для лаборатории: выбор и первая VM». Названия разделов интерфейса, статусов и настроек у providers зависят от продукта, версии и хостовой ОС; сверяйте действия с официальным руководством выбранного provider.

Практическая проверка готового стенда

1. Выполните vagrant status и убедитесь, что Vagrant-машина lab имеет статус running.
2. Подключитесь предусмотренным методом: для Linux box из примера — vagrant ssh lab. Внутри гостя выполните hostname и проверьте ожидаемый hostname.
3. Проверьте маркер provisioning: cat /opt/lab/marker должен вывести provisioned-by-vagrant.
4. Проверьте выделенные ресурсы средствами гостевой ОС и сопоставьте их со значениями vb.cpus и vb.memory в Vagrantfile, учитывая возможные различия в отображении со стороны ОС.
5. Откройте VirtualBox и убедитесь, что объект VM отображается под именем lab-virtualbox, заданным через vb.name.
6. Выполните vagrant halt lab, затем снова vagrant up lab --provider=virtualbox и проверьте, что машина остановилась и снова запустилась без ошибок.
7. Если стенд больше не нужен, выполните vagrant destroy lab и подтвердите удаление. Затем vagrant status должен показать, что машина не создана.

Локальная виртуализация для разработки, тестирования и лаборатории через Vagrant удобна именно как повторяемая среда на одном хосте. Она не заменяет проектирование серверной виртуальной инфраструктуры, отказоустойчивость, резервное копирование, мониторинг и эксплуатационные процессы. Для производственного уровня ориентируйтесь на статью «Как спроектировать виртуальную инфраструктуру для продакшена и 1С».