Setup the sandbox environment
Some of the examples require the installation of additional dependencies.
It is indicated in the sandbox documentation where this is the case.
Ensure that you have a recent versions of
You will need a minimum version of
20.10 is well tested, and has the benefit of included
The user account running the examples will need to have permission to use Docker on your system.
Full instructions for installing Docker can be found on the Docker website
If you want to use the Windows based Envoy images make sure that you switch Docker to use Windows containers.
The examples use Docker compose configuration version 3.8.
You will need to a fairly recent version of Docker Compose.
20.0+ version of Docker provides a builtin
docker compose command.
The sandboxes are tested using
compose in this way, so this is preferable over using the python version.
See Docker compose installation documenation for more information.
Most of the sandboxes should also work using
The Envoy project is managed using Git.
Clone the Envoy repository
If you have not cloned the Envoy repository already, clone it with:
git clone firstname.lastname@example.org:envoyproxy/envoy
git clone https://github.com/envoyproxy/envoy.git
The following utilities are used in only some of the sandbox examples, and installation is therefore optional.
Many of the examples use the curl utility to make
The jq tool is very useful for parsing
whether it be
HTTP response data, logs or statistics.
Ncat is integrated with Nmap and is available in the standard Nmap download packages (including source code and Linux, Windows, and Mac binaries) available from the Nmap download page.
OpenSSL is a robust, commercial-grade, and full-featured toolkit for
the Transport Layer Security (
TLS) and Secure Sockets Layer (
Windows users can either use an unofficial binary or compile from source.
Check for installation instructions specific to your operating system.