First commit

README.md

@@ -0,0 +1,63 @@
+# minimal nginx
+
+Nginx docker image with a minimal set of modules.
+
+Current modules:
+
+- [geoip2](https://github.com/leev/ngx_http_geoip2_module)
+- stream
+- http_ssl_module
+- http_v2_module
+- http_stub_status_module
+
+## Configuration
+
+Edit [conf.env](conf.env)
+
+```bash
+NGINX_VERSION=1.17.6          # Nginx version to build from
+NGX_GEOIP2_VERSION=3.3        # Nginx geoip2 version to build from
+DOCKER_IMAGE=dcarrillo/nginx  # Docker image
+```
+
+## Build
+
+Build locally:
+
+```bash
+./build.sh
+```
+
+Build locally and upload to a registry (you must be logged in to the registry)
+
+```bash
+./build.sh --push
+```
+
+Build locally, tag image as latest and upload to a registry (you must be logged in to the registry)
+
+```bash
+./build.sh --push --latest
+```
+
+## Testing
+
+Prerequisites:
+
+- docker
+- openssl
+- curl
+
+```bash
+# build local image
+./build.sh
+
+# run tests
+./tests/test.sh
+```
+
+## Who is using this image
+
+[ifconfig.es](https://ifconfig.es) is a web service that displays information about your
+connection, including IP address, geolocation and request http headers. You can easily get
+your public ip address using curl, wget and other command-line http clients.