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
19.03 is well tested.
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.
Install Docker Compose¶
The examples use Docker compose configuration version 3.7.
You will need to install a fairly recent version of Docker Compose.
1.27.4 is well tested.
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 email@example.com: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.