Debugging with ngrok
Question:
How can I debug with ngrok?
Answer:
ngrok can be used to open a public tunnel to the VM which will provide access to the web application running inside the VM from devices not running in the same network. This can be, for example, used to test the website running inside your VM with your mobile phone.
Activate ngrok Inside The VM
ngrok is not active by default. You can activate it by adding the following line to the .customer_provision.yml inside the roles: section:
- role: ngrok
vars:
projects:
- de
Where de is the Project identifier you want to use ngrok for. You can add multiple Projects if you need to.
Then provision your Docker container or VM again:
vagrant up [--provider=docker] --provision
Because there are still issues with supervisor and systemd on Docker, you may need to reload the Docker container if you're using one.
vagrant reload ; vagrant ssh
List Active Tunnels
To get a list of all Active Tunnels, run the following command inside the VM / Docker container:
curl http://localhost:4040/api/tunnels | json_pp
The Tunnel URL listed under public_url can be used to access the respective project from any device.