nginx-config-scaffold is a tool to help you scaffold out nginx config dependencies, such as hostnames for upstreams and proxy destinations, and to create dummy certificates to allow you to test nginx configs (using nginx -t) without having to have your full nginx environment available.
Install with npm install @zeph1rus/nginx-config-scaffold
You'll need a version of Node.JS greater than 12.0.0, greater than 16 is HIGHLY RECOMMENDED!
If you're testing nginx configs in an ephemeral CI environment such as GitHub Actions, Gitlab, or Bitbucket cloud, just install nginx, copy your config to the nginx config directory, and run
npx run nginx-config-scaffold --basedir <your-config-dir>
by default, we only create certificates, if you wish for your hosts file to be updated with proxies or upstreams there are additional parameters to add.
One most Unixey platforms we will try to write to /etc/hosts, on Solaris it's /etc/inet/hosts and on Windows we try C:\WINDOWS\SYSTEM32\DRIVERS\ETC\HOSTS
--basedir <baseDir> Directory to scan configs from recursively
--upstreams Add upstreams to hosts file
--proxies Add proxy hosts to hosts file
--dryrun Don't make changes, just tell me what actions would be performed
--help/-h This help
We've provided a sample dockerfile and entrypoint.sh to allow you to build a docker image and use that to test. You will want to update MY_CONFDIR_CHANGE_ME to match your config directory
When run this container will exit with a non-zero exit code if the test fails
FROM alpine:latest
RUN apk add nginx nodejs npm
COPY MY_CONFDIR_CHANGE_ME /etc/nginx
RUN mkdir /opt/app
WORKDIR "/opt/app"
COPY "entrypoint.sh" "."
RUN chmod u+x entrypoint.sh
RUN npm i @zeph1rus/nginx-config-scaffold
ENTRYPOINT ["./entrypoint.sh"]
#!/usr/bin/env sh
npx nginx-config-scaffold --basedir /etc/nginx --upstreams --proxies
nginx -t
This should work fine on NGINX plus installs, as long as you have it installed, if not the tests will fail on nginx-plus specific directives.