Update the following files when enhancing nginx-s3-gateway
to integrate with AWS signature whenever AWS releases a new version of signature or you have a new PR:
-
NGINX Proxy:
/etc/nginx/conf.d/default.conf
-
AWS Credentials Lib:
/etc/nginx/include/awscredentials.js
Note: The
fetchCredentials()
is going to be part of here soon. -
AWS Signature Lib per version:
-
S3 Integration Lib:
/etc/nginx/include/s3gateway.js
-
Common Lib for all of NJS:
/etc/nginx/include/utils.js
On the container image, all files with the extension .conf
in the
directory /etc/nginx/conf.d
will be loaded into the configuration
of the base http
block within the main NGINX configuration.
This allows for extension of the configuration by adding additional configuration files into the container image extending the base gateway image.
On the container image there are three NGINX configuration stub files:
/etc/nginx/conf.d/s3_server.conf
/etc/nginx/conf.d/s3_location.conf
/etc/nginx/conf.d/s3listing_location.conf
Each of these files can be overwritten in a container image that inherits from the S3 Gateway container image, so that additional NGINX configuration directives can be inserted into the gateway configuration.
In the examples/ directory, there are Dockerfile
examples that
show how to extend the base functionality of the NGINX S3 Gateway by adding
additional modules.
- Enabling Brotli Compression in Docker
- Enabling GZip Compression in Docker
- Installing Modsecurity in Docker
Automated tests require docker
, docker-compose
, curl
, mc
and md5sum
to be
installed. To run all unit tests and integration tests, run the following command.
If you invoke the test script with a plus parameter, you will need to add your
NGINX repository keys to the plus/etc/ssl/nginx
directory
$ ./test.sh <nginx type - 'oss', 'latest-njs-oss', 'unprivileged', 'plus', or 'latest-njs-plus'>