sandstorm / drydock

Docker Debugging Tools: docker exec, but with root shell; docker vscode; PHP SPX & Xdebug

drydock - Docker Debugging Tools

This is a set of useful CLI tools to help debugging Docker containers:

General Tooling

• drydock execroot: Like docker exec, but always spawn a root shell
• drydock vscode: Open Visual Studio Code (with the Containers extension), allowing to edit any file as root

PHP Specific Tooling

• drydock spx: Install and enable the SPX Profiler PHP extension into a running container (without restart).
• drydock xdebug: Install and enable the Xdebug PHP extension into a running container (without restart). Additionally, supports mounting extra folders over webdav for a better OSX debugging experience.

Installation

We have tested the tools in OSX. They also can work on other platforms, but were not tested there yet.

1. Run the following command to install via homebrew (OSX):

   brew install sandstorm/tap/drydock

2. Done :)

   drydock --help  

Documentation

click the links for the full documentation for each command

• drydock execroot [containername]
• drydock vscode [containername]
• drydock spx [containername]
• drydock xdebug [containername]

License

MIT