Vagrant — przenośne środowiska deweloperskie dla programistów

Opublikowano: 10 kwietnia 2026 · Kategoria: VPS / DevOps

"U mnie działa" to jeden z najczęstszych problemów w programowaniu. Vagrant rozwiązuje go przez opisanie środowiska deweloperskiego jako kodu w pliku Vagrantfile. Każdy developer w zespole uruchamia identyczną VM jednym poleceniem — bez instalowania ręcznie PHP, Nginx, MySQL czy Node.js w konkretnych wersjach. Vagrant szczególnie błyszczy gdy testujesz konfigurację serwerów (Ansible, Puppet, Salt), potrzebujesz symulować środowisko produkcyjne z systemd, lub projekty wymagają izolacji na poziomie kernela. Ten artykuł pokazuje kompletną konfigurację od Vagrantfile po multi-machine.

Instalacja Vagrant i VirtualBox

# Ubuntu / Debian — Vagrant
wget -O- https://apt.releases.hashicorp.com/gpg | \
  sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] \
  https://apt.releases.hashicorp.com $(lsb_release -cs) main" | \
  sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update && sudo apt install vagrant -y

# VirtualBox (domyślny provider)
sudo apt install virtualbox -y

# macOS
brew tap hashicorp/tap
brew install hashicorp/tap/vagrant
brew install --cask virtualbox

# Windows (PowerShell jako Administrator)
winget install Hashicorp.Vagrant
winget install Oracle.VirtualBox

# Sprawdź instalację
vagrant --version
vagrant plugin list

# Przydatne pluginy
vagrant plugin install vagrant-vbguest    # Automatyczne VirtualBox Guest Additions
vagrant plugin install vagrant-disksize   # Zmiana rozmiaru dysku
vagrant plugin install vagrant-hostmanager  # Automatyczne /etc/hosts

Vagrantfile — podstawowa konfiguracja

Vagrantfile to plik Ruby opisujący maszynę wirtualną. Zaczyna się od vagrant init i jest commitowany do repozytorium — każdy developer uruchamia identyczne środowisko:

# Inicjalizacja Vagrantfile
vagrant init ubuntu/jammy64

# Vagrantfile — kompletna konfiguracja środowiska LEMP
Vagrant.configure("2") do |config|
  # Box — gotowy obraz Ubuntu 22.04 z Vagrant Cloud
  config.vm.box = "ubuntu/jammy64"
  config.vm.box_version = ">= 20240101.0.0"

  # Hostname i FQDN
  config.vm.hostname = "dev.local"

  # Forwarded port — dostęp z hosta do VM
  config.vm.network "forwarded_port", guest: 80, host: 8080, id: "nginx"
  config.vm.network "forwarded_port", guest: 3306, host: 3306, id: "mysql"

  # Private network — stały IP dla VM
  config.vm.network "private_network", ip: "192.168.56.10"

  # Shared folders — synchronizacja kodu
  config.vm.synced_folder "./src", "/var/www/html",
    owner: "www-data", group: "www-data",
    mount_options: ["dmode=775,fmode=664"]

  # NFS (szybszy niż VirtualBox default)
  # config.vm.synced_folder "./src", "/var/www/html", type: "nfs"

  # Provider — zasoby VM
  config.vm.provider "virtualbox" do |vb|
    vb.name   = "lemp-dev"
    vb.memory = 2048    # 2 GB RAM
    vb.cpus   = 2
    vb.gui    = false   # Bez okna GUI (headless)

    # Optymalizacja VirtualBox
    vb.customize ["modifyvm", :id, "--natdnshostresolver1", "on"]
    vb.customize ["modifyvm", :id, "--natdnsproxy1", "on"]
  end

  # Provisioner shell — instalacja LEMP
  config.vm.provision "shell", inline: <<-SHELL
    export DEBIAN_FRONTEND=noninteractive
    apt-get update -q
    apt-get install -yq nginx php8.2-fpm php8.2-mysql mysql-server
    systemctl enable nginx php8.2-fpm mysql
    systemctl start nginx php8.2-fpm mysql
  SHELL
end

Provisioning przez Ansible

Provisioner Ansible uruchamia playbook Ansible wewnątrz (lub na hoście) przy starcie VM. To idealne rozwiązanie gdy chcesz testować playbooki przed uruchomieniem na produkcji — Vagrant daje identyczne środowisko jak produkcyjny VPS:

# Vagrantfile z Ansible provisioner
Vagrant.configure("2") do |config|
  config.vm.box = "ubuntu/jammy64"
  config.vm.network "private_network", ip: "192.168.56.10"

  # Ansible na hoście (wymaga Ansible zainstalowanego na hoście)
  config.vm.provision "ansible" do |ansible|
    ansible.playbook       = "provisioning/playbook.yml"
    ansible.inventory_path = "provisioning/inventory"
    ansible.limit          = "all"
    ansible.verbose        = "v"
    ansible.extra_vars = {
      "env" => "development",
      "nginx_port" => 80,
    }
  end

  # Lub: Ansible lokalnie wewnątrz VM (ansible_local)
  # — nie wymaga Ansible na hoście, przydatne dla Windows
  config.vm.provision "ansible_local" do |ansible|
    ansible.playbook = "provisioning/playbook.yml"
    ansible.install_mode = :pip  # Instaluj Ansible przez pip
    ansible.pip_args = "ansible-core==2.15.*"
  end
end

# provisioning/playbook.yml
---
- name: Konfiguracja środowiska deweloperskiego
  hosts: all
  become: yes
  roles:
    - nginx
    - php-fpm
    - mysql

# Użycie:
# vagrant up             # Uruchom VM i zastosuj provisioning
# vagrant provision      # Ponowne provisioning bez restartu VM
# vagrant reload --provision  # Restart + provisioning

Multi-machine — symulacja środowiska produkcyjnego

# Vagrantfile — multi-machine (web + db)
Vagrant.configure("2") do |config|
  config.vm.box = "ubuntu/jammy64"

  # Serwer webowy
  config.vm.define "web" do |web|
    web.vm.hostname = "web.local"
    web.vm.network "private_network", ip: "192.168.56.10"
    web.vm.network "forwarded_port", guest: 80, host: 8080

    web.vm.provider "virtualbox" do |vb|
      vb.name   = "web-dev"
      vb.memory = 1024
      vb.cpus   = 1
    end

    web.vm.provision "ansible" do |ansible|
      ansible.playbook = "provisioning/web.yml"
    end
  end

  # Serwer bazy danych
  config.vm.define "db" do |db|
    db.vm.hostname = "db.local"
    db.vm.network "private_network", ip: "192.168.56.11"

    db.vm.provider "virtualbox" do |vb|
      vb.name   = "db-dev"
      vb.memory = 1024
      vb.cpus   = 1
    end

    db.vm.provision "ansible" do |ansible|
      ansible.playbook = "provisioning/db.yml"
    end
  end
end

# Komendy multi-machine
vagrant up           # Uruchom wszystkie VM
vagrant up web       # Uruchom tylko "web"
vagrant ssh web      # Połącz się z VM "web"
vagrant halt db      # Zatrzymaj VM "db"
vagrant status       # Status wszystkich VM
vagrant destroy -f   # Usuń wszystkie VM (bez pytania)

Vagrant Cloud — gotowe boxes

Vagrant Cloud (app.vagrantup.com) to publiczne repozytorium gotowych boxes — obrazów VM. Najpopularniejsze boxes dla developerów:

# Zarządzanie boxes
vagrant box add ubuntu/jammy64          # Pobierz box
vagrant box list                        # Wylistuj zainstalowane boxes
vagrant box update                      # Zaktualizuj wszystkie boxes
vagrant box remove ubuntu/jammy64       # Usuń box

# Budowanie własnego box z Packer
# packer build ubuntu.pkr.hcl
# vagrant box add my-lemp ./output/package.box

# Wydajność — porady
# 1. Używaj NFS zamiast VirtualBox shared folders
config.vm.synced_folder ".", "/vagrant", type: "nfs"
# 2. Cachuj apt packages (vagrant-cachier plugin)
if Vagrant.has_plugin?("vagrant-cachier")
  config.cache.scope = :box
end
# 3. Zmień tryb synchronizacji na rsync dla read-heavy
config.vm.synced_folder "./dist", "/var/www/html/dist", type: "rsync"

Najczęstsze pytania