Vagrant

Guia abrangente de comandos e fluxos de trabalho do HashiCorp Vagrant para gerenciamento de ambientes de desenvolvimento e provisionamento de máquinas virtuais.

Instalação e Configuração

Comando	Descrição
`vagrant version`	Mostrar versão do Vagrant
`vagrant -h`	Mostrar informações de ajuda
`vagrant init`	Inicializar novo Vagrantfile
`vagrant init ubuntu/jammy64`	Inicializar com caixa específica

Gerenciamento de Boxes

Operações de Box

Comando	Descrição
`vagrant box list`	Listar caixas instaladas
`vagrant box add ubuntu/jammy64`	Adicionar caixa
`vagrant box add --name mybox /path/to/box.box`	Adicionar caixa local
`vagrant box remove ubuntu/jammy64`	Remover caixa
`vagrant box update`	Atualizar todas as caixas
`vagrant box update --box ubuntu/jammy64`	Atualizar caixa específica

Informações de Box

Comando	Descrição
`vagrant box outdated`	Verificar caixas desatualizadas
`vagrant box prune`	Remover versões antigas de box
`vagrant box repackage ubuntu/jammy64`	Reembalar caixa

Gerenciamento do Ciclo de Vida da VM

Operações Básicas

Comando	Descrição
`vagrant up`	Iniciar e provisionar VM
`vagrant halt`	Desligar VM
`vagrant reload`	Reiniciar VM
`vagrant destroy`	Destruir VM
`vagrant suspend`	Suspender VM
`vagrant resume`	Retomar VM suspensa

Status e Informações da VM

Comando	Descrição
`vagrant status`	Mostrar status da VM
`vagrant global-status`	Mostrar status de todas as VMs
`vagrant global-status --prune`	Limpar entradas inválidas

SSH e Acesso

Operações de SSH

Comando	Descrição
`vagrant ssh`	SSH no VM
`vagrant ssh-config`	Mostrar configuração SSH
`vagrant ssh -- -L 8080:localhost:80`	SSH com encaminhamento de porta

Provisionamento

Comandos de Provisionamento

Comando	Descrição
`vagrant provision`	Executar provisionadores
`vagrant provision --provision-with shell`	Executar provisionador específico
`vagrant up --provision`	Iniciar e provisionar
`vagrant reload --provision`	Reiniciar e provisionar

Ambientes Multi-Máquina

Comandos Multi-Máquina

Comando	Descrição
`vagrant up web`	Iniciar máquina específica
`vagrant ssh web`	SSH para máquina específica
`vagrant halt db`	Parar máquina específica
`vagrant destroy --force`	Destruir todos sem confirmação

Snapshots

Gerenciamento de Snapshots

Comando	Descrição
`vagrant snapshot save snapshot_name`	Salvar snapshot
`vagrant snapshot list`	Listar snapshots
`vagrant snapshot restore snapshot_name`	Restaurar snapshot
`vagrant snapshot delete snapshot_name`	Excluir snapshot

Gerenciamento de Plugins

Operações de Plugin

Comando	Descrição
`vagrant plugin list`	Listar plugins instalados
`vagrant plugin install vagrant-vbguest`	Instalar plugin
`vagrant plugin uninstall vagrant-vbguest`	Desinstalar plugin
`vagrant plugin update`	Atualizar todos os plugins

Exemplos de Vagrantfile

Vagrantfile Básico

Vagrant.configure("2") do|config|
  config.vm.box = "ubuntu/jammy64"
  config.vm.hostname = "myserver"

  # Network configuration
  config.vm.network "private_network", ip: "192.168.56.10"
  config.vm.network "forwarded_port", guest: 80, host: 8080

  # Provider configuration
  config.vm.provider "virtualbox" do|vb|
    vb.memory = "2048"
    vb.cpus = 2
    vb.name = "MyVM"
  end

  # Provisioning
  config.vm.provision "shell", inline: <<-SHELL
    apt-get update
    apt-get install -y nginx
    systemctl enable nginx
    systemctl start nginx
  SHELL
end

Configuração Multi-Máquina

Vagrant.configure("2") do|config|
  # Web server
  config.vm.define "web" do|web|
    web.vm.box = "ubuntu/jammy64"
    web.vm.hostname = "web"
    web.vm.network "private_network", ip: "192.168.56.10"

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

    web.vm.provision "shell", inline: <<-SHELL
      apt-get update
      apt-get install -y nginx
    SHELL
  end

  # Database server
  config.vm.define "db" do|db|
    db.vm.box = "ubuntu/jammy64"
    db.vm.hostname = "database"
    db.vm.network "private_network", ip: "192.168.56.11"

    db.vm.provider "virtualbox" do|vb|
      vb.memory = "2048"
      vb.cpus = 2
    end

    db.vm.provision "shell", inline: <<-SHELL
      apt-get update
      apt-get install -y mysql-server
    SHELL
  end
end

Configuração Avançada

Vagrant.configure("2") do|config|
  config.vm.box = "ubuntu/jammy64"
  config.vm.box_version = "20230607.0.0"

  # Synced folders
  config.vm.synced_folder ".", "/vagrant", disabled: true
  config.vm.synced_folder "./app", "/var/www/html",
    owner: "www-data", group: "www-data"

  # Network configuration
  config.vm.network "private_network",
    ip: "192.168.56.10",
    netmask: "255.255.255.0"

  config.vm.network "public_network",
    bridge: "en0: Wi-Fi (AirPort)"

  # Port forwarding
  config.vm.network "forwarded_port", guest: 80, host: 8080
  config.vm.network "forwarded_port", guest: 443, host: 8443

  # Provider-specific configuration
  config.vm.provider "virtualbox" do|vb|
    vb.gui = false
    vb.memory = "4096"
    vb.cpus = 4
    vb.name = "Development Server"

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

  # Multiple provisioners
  config.vm.provision "shell", inline: <<-SHELL
    apt-get update
    apt-get upgrade -y
  SHELL

  config.vm.provision "file",
    source: "./configs/nginx.conf",
    destination: "/tmp/nginx.conf"

  config.vm.provision "shell", path: "scripts/setup.sh"

  config.vm.provision "ansible" do|ansible|
    ansible.playbook = "playbook.yml"
    ansible.inventory_path = "inventory"
  end
end

Métodos de Provisionamento

Provisionamento Shell

# Inline shell commands
config.vm.provision "shell", inline: <<-SHELL
  apt-get update
  apt-get install -y docker.io
  usermod -aG docker vagrant
SHELL

# External script
config.vm.provision "shell", path: "scripts/bootstrap.sh"

# Privileged and non-privileged
config.vm.provision "shell", privileged: false, inline: <<-SHELL
  echo "Running as vagrant user"
SHELL

# Environment variables
config.vm.provision "shell", env: \\\\{"DEBIAN_FRONTEND" => "noninteractive"\\\\}, inline: <<-SHELL
  apt-get install -y mysql-server
SHELL

Provisionamento de Arquivo

config.vm.provision "file",
  source: "~/.ssh/id_rsa.pub",
  destination: "~/.ssh/authorized_keys"

config.vm.provision "file",
  source: "./configs/",
  destination: "/tmp/configs"

Provisionamento Ansible

config.vm.provision "ansible" do|ansible|
  ansible.playbook = "site.yml"
  ansible.inventory_path = "inventory/vagrant"
  ansible.limit = "all"
  ansible.verbose = "v"

  ansible.extra_vars = \\\\{
    nginx_port: 80,
    database_name: "myapp"
  \\\\}
end

Provisionamento Docker

config.vm.provision "docker" do|d|
  d.pull_images "nginx"
  d.pull_images "mysql:8.0"

  d.run "nginx",
    args: "-p 80:80 -v /vagrant/html:/usr/share/nginx/html"

  d.run "mysql",
    args: "-e MYSQL_ROOT_PASSWORD=secret -p 3306:3306"
end

Configuração de Rede

Redes Privadas

# Static IP
config.vm.network "private_network", ip: "192.168.56.10"

# DHCP
config.vm.network "private_network", type: "dhcp"

# Multiple interfaces
config.vm.network "private_network", ip: "192.168.56.10"
config.vm.network "private_network", ip: "10.0.0.10"

Redes Públicas

Would you like me to continue with the remaining translations or placeholders for the empty sections?```ruby

Bridge to default interface

config.vm.network “public_network”

Bridge to specific interface

config.vm.network “public_network”, bridge: “en0: Wi-Fi (AirPort)“

Static IP on public network

config.vm.network “public_network”, ip: “192.168.1.100”


### Port Forwarding
```ruby
# Basic port forwarding
config.vm.network "forwarded_port", guest: 80, host: 8080

# Multiple ports
config.vm.network "forwarded_port", guest: 80, host: 8080
config.vm.network "forwarded_port", guest: 443, host: 8443
config.vm.network "forwarded_port", guest: 3306, host: 3306

# Auto-correct port conflicts
config.vm.network "forwarded_port", guest: 80, host: 8080, auto_correct: true

Provider Configuration

VirtualBox Provider

config.vm.provider "virtualbox" do|vb|
  vb.gui = true
  vb.memory = "4096"
  vb.cpus = 4
  vb.name = "MyVM"

  # Advanced settings
  vb.customize ["modifyvm", :id, "--vram", "128"]
  vb.customize ["modifyvm", :id, "--accelerate3d", "on"]
  vb.customize ["modifyvm", :id, "--clipboard", "bidirectional"]
end

VMware Provider

config.vm.provider "vmware_desktop" do|vmware|
  vmware.vmx["memsize"] = "4096"
  vmware.vmx["numvcpus"] = "4"
  vmware.vmx["displayName"] = "MyVM"
end

Hyper-V Provider

config.vm.provider "hyperv" do|hv|
  hv.memory = 4096
  hv.cpus = 4
  hv.vmname = "MyVM"
end

Synced Folders

Basic Synced Folders

# Default synced folder (disabled)
config.vm.synced_folder ".", "/vagrant", disabled: true

# Custom synced folder
config.vm.synced_folder "./src", "/var/www/html"

# With options
config.vm.synced_folder "./app", "/var/www/html",
  owner: "www-data",
  group: "www-data",
  mount_options: ["dmode=775,fmode=664"]

NFS Synced Folders

config.vm.synced_folder "./", "/vagrant",
  type: "nfs",
  nfs_udp: false,
  nfs_version: 4

SMB Synced Folders (Windows)

config.vm.synced_folder "./", "/vagrant",
  type: "smb",
  smb_username: "username",
  smb_password: "password"

Best Practices

Performance Optimization

Resource Allocation: Allocate appropriate CPU and memory
Synced Folders: Use NFS for better performance on macOS/Linux
Box Selection: Choose minimal base boxes
Snapshot Management: Use snapshots for quick rollbacks
Provider Optimization: Configure provider-specific optimizations

Security

SSH Keys: Use SSH keys instead of passwords
Network Isolation: Use private networks when possible
Firewall: Configure appropriate firewall rules
Updates: Keep boxes and Vagrant updated
Secrets: Don’t commit secrets to version control

Development Workflow

Version Control: Include Vagrantfile in version control
Documentation: Document setup and usage
Consistency: Use same environment across team
Testing: Test provisioning scripts
Cleanup: Regularly clean up unused VMs and boxes

Troubleshooting

Logs: Check Vagrant and provider logs
SSH: Use vagrant ssh-config for debugging
Networking: Test network connectivity
Provisioning: Test provisioning scripts separately
Resources: Monitor host system resources