Различия

Здесь показаны различия между двумя версиями данной страницы.

--- wiki:vagrant [2016/07/24 15:13]
добавил два подраздела, пофиксил опечатки.
+++ wiki:vagrant [2016/08/26 22:44] (текущий)
[Provisioning with Puppet]
@@ Строка 6: / Строка 6: @@
 ===== Установка vagrant + VirtualBox=====
 Устанавливать будем с официального сайта, скачав подходящие deb-пакеты.
-При этом нужно учесть, что последняя версия vagrant(1.8.4) **НЕ** поддерживает последнюю версию VirtualBox(5.1.0).
 [[http://download.virtualbox.org/virtualbox/5.0.24/virtualbox-5.0_5.0.24-108355~Ubuntu~trusty_amd64.deb|ссылка на х64 версию VirtualBox для 14.04]]
@@ Строка 162: / Строка 161: @@
 и адрес назначится автоматически.
-больше информации и приватных сетях
+больше информации о приватных сетях
 [[https://www.vagrantup.com/docs/networking/private_network.html|тут]]
@@ Строка 248: / Строка 247: @@
 ===== Синхронизация каталогов=====
-"Из коробки" vagrant синхронизирует каталог хоста с Vagrantfile в директорию /vagrant
+"Из коробки" vagrant синхронизирует каталог хоста с Vagrantfile в директорию /vagrant виртуальной машины.
-виртуальной машины.
-Для того, чтоб указать дополнительный каталоги для синхронизации, нужно добавить
+Для того, чтоб указать дополнительный каталоги для синхронизации, нужно добавить следующую строку в Vagrantfile:
-следующую строку в Vagrantfile:
 <code>
 config.vm.synced_folder "src/", "/var/www/html"
@@ Строка 258: / Строка 255: @@
 Первым указывается путь на хосте, вторым - гостевой путь.
-Если на хостовой машине указывать относительный путь, то корневым будет каталог
+Если на хостовой машине указывать относительный путь, то корневым будет каталог с Vagrantfile.
-с Vagrantfile.
 Если абсолютный путь, то он абсолютный :)
-Путь на гостевой машине должен быть *только* абсолютный.
+Путь на гостевой машине должен быть **только** абсолютный.
 Если директорий не существует, они будут созданы рекурсивно.
 Дополнительные опции:
-  * **disabled** - если указать True, то синхронизация будет отключена. Удобно, если
+  * **disabled** - если указать True, то синхронизация будет отключена. Удобно, если нам не нужна "изкоробочная" синхронизация.
-нам не нужна "изкоробочная" синхронизация.
+  * **mount_options** - дополнительные параметры, которые будут переданы команде mount при монтировании
-  * **mount_options** - дополнительные параметры, которые будут переданы команде
-    mount при монтировании
   *  **type** - полезная опция, которая позволяет выбрать тип синхронизации. Доступны следующие варианты:
     * NFS
@@ Строка 280: / Строка 274: @@
 <note important> тип NFS доступен только для Linux-host!</note>
-Если эта поция не указана, то vagrant выберет сам самую подходящую.
+Если эта поция не указана, то vagrant выберет сам подходящую.
-Я рекомендую для Linux-гостей использовать rsync - этот тип //не// требует
+Я рекомендую для Linux-гостей использовать rsync - этот тип //не// требует дополнений гостевых систем, автоматически установить rsync на всех гостей.
-дополнений гостевых систем, автоматически установить rsync на всех гостей.
+Также, доступны дополнительные плюшки, такие как vagrant rsync и vagrant rsync-auto ( о них ниже)
-Также, доступны дополнительные плюшки, такие как vagrant rsync и vagrant
-rsync-auto ( о них ниже)
   * **id** - имя, которое будет показываться при команде mount в гостевой
     машине. Имеет смысл использовать, если у вас несколько расшареных каталогов
@@ Строка 292: / Строка 284: @@
 ==Рассмотрим подробнее вариант rsync==
 Первое - этот тип **работает** только **в одну сторону**
-Каталоги, которые синхронизированы через rsync синхронизируются автоматически
+Каталоги, которые синхронизированы через rsync синхронизируются автоматически только один раз - при инициализации машины (vagrant up\vagrant reload).
-только один раз - при инициализации машины (vagrant up\vagrant reload).
 Принудительно синхронизировать можно двумя путями:
   - vagrant rsync
@@ Строка 304: / Строка 295: @@
 reload. </note>
-Второй же работает в режиме демона и отслеживает изменения на хосте.
+Второй же работает в режиме демона и отслеживает изменения на хосте. Это удобно, так как один каталог можно шарить на несколько машин сразу, передавая изменения на всех гостей.
-Это удобно, так как один каталог можно шарить на несколько машин сразу,
-передавая изменения на всех гостей.
 <note important>Если вы хотите сделать изменения в Vagrantfile, для начали
@@ Строка 405: / Строка 394: @@
 ===== Конфигурирование нескольких машин=====
-В одном Vagrantfile может быть столько мащин, сколько нам нужно.
+В одном Vagrantfile может быть столько машин, сколько нам нужно.
 Задать их можно двумя способами:
   * Используя цикл
-  * Отдельно задавая каждую мащину
+  * Отдельно задавая каждую машину
 Очевидно, что циклом удобно поднимать машины, которые буду отличаться только
@@ Строка 694: / Строка 683: @@
 Учитывая, что данный пример собран на основе предыдущих разделов, пояснять не буду - комментарии в коде дают всё необходимое.
+=====Vagrant provision=====
+Итак, у нас есть десяток машин. Некоторые из них одинаковы - ноды с приложением
+и машины со средой для разработки. В данном случае имеет смысл использовать
+подготовку машин. vagrant позволяет использовать несколько решений:
+  * **Puppet**
+  * **Ansible**
+  * **Salt**
+  * **Shell**
+  * **Chef**
+  * **Docker**
+При чём некоторые из них, например, Chef, Puppet, Salt имеют несколько вариантов
+использования (мастер-агент, без мастера, запуск локально).
+Автоматически provision запускается только в двух случаях:
+vagrant up и vagrant reload. Если вы хотите запустить подготовку машин
+принудительно, то необхожимо это явно указать. Например:
+<code>
+vagrant resume --provision %machine_name
+</code>
+<code>
+vagrant provision %machine_name
+</code>
+Рассмотрим самый простой вариант - shell.
+====Provisioning with shell====
+В этом подразделе рассмотрим пост-конфигурацию машин с помощью shell.
+Парочка примеров, естественно будет под Linux, хотя и PowerShell тоже годится.
+Чтоб vagrant исполнил код после загрузки необходимо добавить пару строк в
+Vagrantfile.
+===Выполнение одной команды===
+Если необходимо выполнить одну команду (например, удалить какой-то стандартный
+файл), то удобнее всего использовать следующую форму записи:
+<code>
+Vagrant.configure("2") do |config|
+  config.vm.provision "shell",
+    inline: "echo Hello, World"
+end
+</code>
+Эта строка задаёт тип провизора (подготовщика). Мы указали shell.
+<code>
+config.vm.provision "shell",
+</code>
+строкой
+<code>
+inline: "echo Hello, World"
+</code>
+Мы задаём непосредственно команду. Всё, что идёт после двоеточия, будет
+выполнено в интерпретаторе по-умолчанию.
+Есть несколько полезных команд, которые могут использоваться вместе с shell.
+**args** - аргументы, которые будут переданы при выполнении команды или скрипта.
+Могут быть заданы как обычной строкой, так и массивом.
+Пример ниже показывает использование:
+<code>
+Vagrant.configure("2") do |config|
+  config.vm.provision "shell" do |s|
+    s.inline = "echo $1"
+    s.args   = "'hello, world!'"
+  end
+end
+</code>
+Обратите внимание на одинарные кавычки вокруг hello, world!
+они обязательны.
+Результатом будет вывод:
+hello, world!\\
+Можно задать список аргументов массивом - это удобно тем, что можно не
+заморачиваться с кавычками и задать несколько аргументов:
+<code>
+Vagrant.configure("2") do |config|
+  config.vm.provision "shell" do |s|
+    s.inline = "echo $1; touch $2"
+    s.args   = ["hello, world!", "new_file.txt"]
+  end
+end
+</code>
+**privileged** - определяет, от какого юзера запускать команду. По-умолчанию
+установленно True, что запустит скритп от root. Если команда должна запускаться
+от стандартного юзера (vagrant), то установите значения False.
+===Выполнение скрипта. Пишем скрипт на shell в Vagrantfile===
+Если вам нужно выполнить не одну строку, а целый скрипт, то удобнее это сделать
+немного по-другому - как сказано в официальной документации - "добавим совсем
+немного Ruby и получим отличный способ объеденить bash и Vagrantfile."
+<code>
+$script = <<END
+echo "I am provisioning..."
+touch 1.txt
+echo "I'm a text from Vagrantfile!" > 1.txt
+echo "File was created, you can test it now!"
+END
+Vagrant.configure("2") do |config|
+  config.vm.provision "shell", inline: $script
+end
+</code>
+Тут мы создаём переменную script, в переменную пихаем нужные нам команды.
+Далее вызываем наш текст командой:
+<code>
+  config.vm.provision "shell", inline: $script
+</code>
+Всё предельно просто.
+===Выполнение скрипта. Используем внешний файл===
+Не трудно представить, что у большинства есть любимые, оттестированные годами
+скрипты, которые привыкли выполнять сразу же, после установки голой системы.
+В данном случае очень подойдёт умение vagrant выполнять внещние скрипты.
+Делается это следующим образом:
+<code>
+Vagrant.configure("2") do |config|
+  config.vm.provision "shell", path: "script.sh"
+end
+</code>
+При этом, корень относится в директории с Vagrantfile, если он путь
+относительно.
+Без проблем можно использовать и абсолютные пути (нормально работают и вещи
+вроде ~)
+Есть очень полезная возможность - можно в path указать даже URL, по которому
+доступен скрипт.
+Если же у вас скрипт необходимо запустить из определённой директории внутри
+гостевой машины, vagrant позволяет делать и это.
+Необходимо лищь указать необходимую директорию командой **upload_path.**
+====Provisioning with Ansible====
+<note important> Тут не будет рассматриваться работа непосредстваенно Ansible,
+рассматривается взаимодействие vagrant и Ansible! </note>
+Если вы не знакомы с Ansible, то рекомендую, для начала прочесть [[Ansible
+|вот эту]] статью.
+При необходимости создать полноценное окружение разработчика, или если нужно
+развернуть СУБД и БД из дампа, то более целесообразно использовать более мощные
+инструменты.
+Одним из таких инструментов является Ansible.
+Чтобы применить Ansible через vagrant необходимо сделать следующее:
+  * на хостовой машине должен быть установлен Ansible
+  * прописать в Vagrantfile ((В этом разделе листинги взяты с официального сайта vagrant)) примерно следующее:
+<code>
+Vagrant.configure("2") do |config|
+  #
+  # Run Ansible from the Vagrant Host
+  #
+  config.vm.provision "ansible" do |ansible|
+    ansible.playbook = "playbook.yml"
+  end
+end
+</code>
+При этом, Playbook.yml должен находиться в одном каталоге с Vagrantfile.
+После того, как машина будет поднята, vagrant запустит Ansible.
+Так как сам по себе Ansible не требует никакого агента на целевой машине (ноде),
+то всё, что нужно сделать - указать верные данные в инвентори-файле.
+Если используется публичная сеть, то указываем ip ноды, если используется
+приватная сеть, то необходимо указать ip локалхоста (обычно 127.0.0.1) и порт.
+Для Ansible имеется достаточно много опций, узнать их можно на
+[[https://www.vagrantup.com/docs/provisioning/ansible_common.htmlё|странице
+официальной документации vagrant]]
+Помимо того, что можно запускать Ansible с хоста, его можно также запускать и в
+самой гостевой мащине. Называется это [[https://www.vagrantup.com/docs/provisioning/ansible_local.html|Ansible local]].
+Преимущество в том, что нет необходимости устанавливать Ansible на хост. Вы
+можете просто загрузить роль с вашего репозитория или с Ansible galaxy и она
+выполнится.
+Недостатки - на каждую машину необходимо устанавливать Ansible (есть хук, о нём ниже), отсутствие централизованного управления. То есть, если в дальнейшем будет необходимость управлять машинами посредством Ansible, то этот метод не для вас.
+По-умолчанию, vagrant попробует сам установить Ansible на гостувую машину, для этот предусмтрено несколько опций:
+**install_mode** - по-факту, это выбор репозитория, откуда будет устанавливаться
+Ansible. Если оставить значение __default__, то будет выбран:
+  -ppa:ansible/ansible - для гостя Ubuntu + family
+  -EPEL - RedHat-family
+  -main repo - Debian, OpenSuse, FreeBSD, Arch, etc.
+Есть другое значение - pip. Тогда установка будет производиться посредтсвом pip.
+vagrant сначала установит pip на гостя, а затем установит Ansible.
+Этот вариант предпочтительней, так как это гарантирует, что версия будет свежая
+и одинаковая для всех нод.
+Часть Vagrantfile, которая отвечает  за Ansible local практически ничем не
+отличается от обычного Ansible:
+<code>
+Vagrant.configure("2") do |config|
+  config.vm.provision "ansible_local" do |ansible|
+    ansible.playbook = "playbook.yml"
+  end
+end
+</code>
+Подробнее о хуке, а именно о том, как использовать Ansible local для создания полноценной инфраструктуры. С помощью одного Vagrantfile можно создать ноды, которые будут разворачиваться Ansible, который установлен в виртуальной машине.
+Всё, что нужно сделать вам - написать Vagrantfile, роли для Ansible с inventory
+и немного подправить конфигурацию Ansible.
+Разберём всё подробнее.
+Vagrantfile:
+<code>
+Vagrant.configure("2") do |config|
+  config.vm.box = "ubuntu/trusty64"
+  config.vm.define "node1" do |machine|
+    machine.vm.network "private_network", ip: "172.17.177.21"
+  end
+  config.vm.define "node2" do |machine|
+    machine.vm.network "private_network", ip: "172.17.177.22"
+  end
+  config.vm.define 'controller' do |machine|
+    machine.vm.network "private_network", ip: "172.17.177.11"
+    machine.vm.provision :ansible_local do |ansible|
+      ansible.playbook       = "example.yml"
+      ansible.verbose        = true
+      ansible.install        = true
+      ansible.limit          = "all"
+      ansible.inventory_path = "inventory"
+    end
+  end
+end
+</code>
+Создаём две машины - node1 и node2. Это будут машины, которые мы будем
+конфигурировать с помощью Ansible, который установим на третью машину -
+controller.
+vagrant сам установит на нужную машину Ansible. Что нам нужно - так это сделать
+нормальный инвентори файл, в котором будут указаны ip адреса наших нод.
+Вот пример для этого файла:
+<code>
+controller ansible_connection=local
+node1      ansible_ssh_host=172.17.177.21 ansible_ssh_private_key_file=/vagrant/.vagrant/machines/node1/virtualbox/private_key
+node2      ansible_ssh_host=172.17.177.22 ansible_ssh_private_key_file=/vagrant/.vagrant/machines/node2/virtualbox/private_key
+</code>
+И этот файлик положим в директорию с Vagrantfile, в корень.
+Последний штрих - нам необходимо создать свой файл Ansible.cfg. В нём мы укажем,
+некоторые опции для ssh-коннекта, а именно - подключаться ко всем хостам без
+подтверждения
+<code>
+[defaults]
+host_key_checking = no
+[ssh_connection]
+ssh_args = -o ControlMaster=auto -o ControlPersist=60s -o UserKnownHostsFile=/dev/null -o IdentitiesOnly=yes
+</code>
+Всё, можно делать vagrant up и смотреть, как создаётся окружение.
+====Provisioning with Puppet====
+<note important> Тут не будет рассматриваться работа непосредстваенно Puppet,
+рассматривается взаимодействие vagrant и Puppet! </note>
+Для тех, кто привык использовать [[https://puppet.com/|Puppet]], есть возможность использовать этот
+инструмент с vagrant.
+Для этого нам нужна следующая структура Vagrantfile:
+<code>
+ config.vm.provider "virtualbox" do |vb|
+     vb.gui = false
+     vb.memory=256
+     vb.cpus=1
+     vb.check_guest_additions=false
+ config.vm.box="puppetlabs/centos-7.2-64-puppet"
+end
+ config.vm.define "node1" do |n1|
+   n1.vm.network "private_network", ip: "192.168.0.101"
+   n1.vm.network "forwarded_port", guest: 80, host: 8081
+   n1.vm.hostname ="node1"
+ end
+</code>
+Основное изменение, которое отличает vagrant и Puppet, от vagrant и Ansible -
+vagrant **не** может сам установить Puppet в гостя, поэтому строкой
+<code>
+config.vm.box="puppetlabs/centos-7.2-64-puppet"
+</code>
+Мы сказали, что в качестве основы для гостя необходимо использовать специальный,
+официальный дистрибутив от команды Puppet, в котором уже будет присутствовать
+агент.
+<note>
+докер, паппет.
+</note>
  * [[FIXME]]
 {{tag>vagrant}}

Vagrant Сравнение версий

Различия