An End-to-End Testing framework of Nginx Configurations.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 4a76ecc Mar 5, 2018


An integration testing framework for Nginx that will test your configuration. Every test involves verifying that a request will correctly flow through Nginx, to an upstream cluster and properly handles the response.

Maven Central with version prefix filter Build Status Image License

Snow-Globe completes an integration test by parsing the configuration, dynamically building an upstream file, and with Docker, it starts up Nginx with the configuration and verifies an actual request/response flow matches the test specifications. Snow-Globe stubs the upstreams so that the entire environment can be fully controlled.


This project uses Java to run the tests and framework, and Docker to build the isolated enviornment for each test.

Below are the version requirements:

  • Docker (1.12.0 or greater)
  • Docker Compose (1.7.0 or greater)
  • Java JDK (version 1.8.0 or greater)

How to use Snow-Globe

Snow-Globe documentation is found on the github pages for the project:

If you want to skip reading and just try it out. Head over to our example project to run tests yourself: