Resolución de errores comunes y troubleshooting en vagrant


Resolución de errores comunes y troubleshooting en vagrant

oscar Escrito por oscar 10 April 2025 46 0

🛠️ Resolución de errores comunes y troubleshooting en vagrant

🧩 The box 'ubuntu/bionic64' could not be found

Causa: Vagrant no puede encontrar la box especificada.

✅ Solución:

  • Verifica que escribiste correctamente el nombre de la box.
  • Asegúrate de tener conexión a internet.
  • Puedes descargarla manualmente:
vagrant box add ubuntu/bionic64 

🔌 SSH connection failed o Connection refused

Causa: La máquina no está corriendo o no respondió al intento de conexión SSH.

✅ Solución:

  1. Asegúrate de estar en la carpeta donde está el Vagrantfile.
  2. Revisa el estado de la VM: vagrant status
  3. Si no está en estado running, ejecútala: vagrant up
  4. Si sigue fallando: vagrant reload o fuerza una nueva conexión: vagrant reload --provision

🗂️ No Vagrant environment found in this directory

Causa: Ejecutaste comandos fuera del directorio que contiene el Vagrantfile.

✅ Solución:

  • Navega al directorio correcto: cd /ruta/a/tu/proyecto

🔒 vagrant ssh no hace nada o queda colgado

Causa: A veces la conexión SSH tarda o se corrompe.

✅ Solución:

  • Detén y reinicia la VM: vagrant halt vagrant up
  • Si sigue fallando, prueba con: vagrant destroy -f vagrant up

⚠️ Esto eliminará la VM y la recreará (no afecta tus archivos del host).

🗝️ Permission denied (publickey) al hacer SSH manual

Causa: Intentas conectarte por SSH sin usar la llave que Vagrant genera.

✅ Solución:

Usa: vagrant ssh O configura el SSH manual con vagrant ssh-config  Y luego: ssh -i .vagrant/machines/default/virtualbox/private_key vagrant@127.0.0.1 -p 2222

📦 Errores de synced_folder o permisos

Causa: La carpeta del host no se puede montar dentro de la VM.

✅ Solución:

  • Verifica que la ruta de la carpeta exista.
  • En Windows, ejecuta el terminal como administrador.
  • Usa rutas absolutas si tienes problemas con rutas relativas. config.vm.synced_folder "C:/miProyecto", "/vagrant"

🧹 La máquina virtual se comporta extraño o está corrupta

✅ Solución:

  • Detén y elimina la VM: vagrant halt vagrant destroy -f
  • Borra el archivo .vagrant/ si existe.
  • Luego vuelve a levantarla:
vagrant up

🧰 Comandos útiles de diagnostico

Comando Qué hace
vagrant status Muestra el estado actual de la VM
vagrant ssh-config Muestra detalles de conexión SSH
vagrant global-status Lista todas las VMs de todos los proyectos
vagrant up --debug Ejecuta con salida detallada para depuración
vagrant reload --provision Reinicia y reaplica configuración y scripts

✅ Consejos generales

  • Siempre ejecuta los comandos desde la carpeta con el Vagrantfile.
  • No edites la VM directamente desde VirtualBox; hazlo desde Vagrant.
  • Asegúrate de que VirtualBox esté actualizado.
  • Si usas Windows, usa Git Bash, PowerShell o WSL para mayor compatibilidad.

Comentario

Debe aceptar antes de enviar