Использование Vagrant и Ansible

Введение

Vagrant — инструмент для управления виртуальными машинами, позволяющий настраивать и использовать воспроизводимые рабочие среды на основе различных платформ виртуализации и облачных платформ. Он также интегрирован с Ansible в качестве провайдера для этих виртуальных машин, и эти два инструмента хорошо работают вместе.

Это руководство опишет, как использовать Vagrant 1.7+ и Ansible вместе.

Если вы не знакомы с Vagrant, вы должны посетить документацию.

В этом руководстве предполагается, что Ansible уже установлен и работает. Запуск из Git-хранилища допустим. Следуйте руководству Установка для получения дополнительной информации.

Настройка Vagrant

Первый шаг после установки Vagrant — создание Vagrantfile и его настройка в соответствии с вашими потребностями. Это подробно описано в документации Vagrant, но вот быстрый пример, который включает раздел для использования провайдера Ansible для управления одной машиной:

# This guide is optimized for Vagrant 1.7 and above.
# Although versions 1.6.x should behave very similarly, it is recommended
# to upgrade instead of disabling the requirement below.
Vagrant.require_version ">= 1.7.0"

Vagrant.configure(2) do |config|

  config.vm.box = "ubuntu/trusty64"

  # Disable the new default behavior introduced in Vagrant 1.7, to
  # ensure that all Vagrant machines will use the same SSH key pair.
  # See https://github.com/mitchellh/vagrant/issues/5005
  config.ssh.insert_key = false

  config.vm.provision "ansible" do |ansible|
    ansible.verbose = "v"
    ansible.playbook = "playbook.yml"
  end
end

Обратите внимание на раздел config.vm.provision, который относится к Ansible-плейбуку под названием playbook.yml в той же директории, что и Vagrantfile. Vagrant запускает провайдера после того, как виртуальная машина загрузится и будет готова для доступа по SSH.

Существует множество параметров Ansible, которые можно настроить в вашем Vagrantfile. Для получения дополнительной информации посетите документацию провайдера Ansible.

$ vagrant up

Это запустит ВМ и выполнит плейбук развёртывания (при первом запуске ВМ).

Чтобы повторно запустить плейбук на уже существующей ВМ, просто выполните:

$ vagrant provision

Это повторно выполнит плейбук на существующей ВМ.

Обратите внимание, что включение опции ansible.verbose укажет Vagrant на отображение полной команды ansible-playbook используемой за кулисами, как показано в этом примере:

$ PYTHONUNBUFFERED=1 ANSIBLE_FORCE_COLOR=true ANSIBLE_HOST_KEY_CHECKING=false ANSIBLE_SSH_ARGS='-o UserKnownHostsFile=/dev/null -o ControlMaster=auto -o ControlPersist=60s' ansible-playbook --private-key=/home/someone/.vagrant.d/insecure_private_key --user=vagrant --connection=ssh --limit='machine1' --inventory-file=/home/someone/coding-in-a-project/.vagrant/provisioners/ansible/inventory/vagrant_ansible_inventory playbook.yml

Эта информация может быть очень полезной для отладки проблем интеграции и также может использоваться для ручного выполнения Ansible из оболочки, как описано в следующем разделе.

Ручное выполнение Ansible

Иногда вам может потребоваться запустить Ansible вручную на машинах. Это быстрее, чем запускать vagrant provision и довольно легко сделать.

В нашем примере Vagrantfile Vagrant автоматически создает файл инвентаризации Ansible в .vagrant/provisioners/ansible/inventory/vagrant_ansible_inventory. Эта инвентаризация настроена в соответствии с SSH-туннелем, автоматически созданным Vagrant. Типичный автоматически созданный файл инвентаризации для одномашинной среды может выглядеть примерно так:

# Generated by Vagrant

default ansible_ssh_host=127.0.0.1 ansible_ssh_port=2222

Если вы хотите запустить Ansible вручную, вам нужно убедиться, что вы передаёте командам ansible или ansible-playbook правильные аргументы, по крайней мере для имени пользователя, приватного ключа SSH и инвентаризации.

Вот пример с использованием глобального ключа Vagrant (config.ssh.insert_key должно быть установлено на false в вашем Vagrantfile):

$ ansible-playbook --private-key=~/.vagrant.d/insecure_private_key -u vagrant -i .vagrant/provisioners/ansible/inventory/vagrant_ansible_inventory playbook.yml

Вот второй пример, использующий случайный приватный ключ, который Vagrant 1.7+ автоматически настраивает для каждой новой ВМ (каждый ключ хранится в пути, подобном .vagrant/machines/[machine name]/[provider]/private_key):

$ ansible-playbook --private-key=.vagrant/machines/default/virtualbox/private_key -u vagrant -i .vagrant/provisioners/ansible/inventory/vagrant_ansible_inventory playbook.yml

Расширенные примеры использования

В главе «Советы и хитрости» документации провайдера Ansible содержится подробная информация о более продвинутых функциях Ansible, таких как:

• как параллельно выполнить плейбук в многомашинной среде
• как интегрировать локальный файл конфигурации ansible.cfg