NGINX Docker Desktop Extension

The NGINX Docker Desktop Extension can be used to manage the instance configuration of a running NGINX container.

Development

Before we can interactively develop the Extensions frontend, it must be installed first.

To build the extension locally.

docker build -t nginx/nginx-dd-extension .

To install the extension

docker extension install nginx/nginx-dd-extension

To remove the extension

docker remove nginx/nginx-dd-extension

Release

docker buildx build --push --no-cache --platform=linux/amd64,linux/arm64 -t nginx/nginx-docker-extension:0.0.1 .

Start Docker Extension Development Server

1. start the UI node server in the ui directory. Make sure you install the dev dependencies at the first.

npm install
npm run dev

2. enable debugging for the NGINX Docker Extension.

docker extension dev debug nginx/nginx-dd-extension 

docker extension dev ui-source nginx/nginx-dd-extension http://localhost:3000 

Community

• The go-to place to start asking questions and share your thoughts is our Slack channel.

• Get involved with the project by contributing! See the contributing guide for details.

• For security issues, email us, mentioning NGINX Unit in the subject and following the CVSS v3.1 spec.

Backlog

Re-Expose new Ports

docker commit CONTAINERID NEWIMAGE
docker run NEWIMAGE -p ... -p.... -v POSSIBLE MOUNTS

Export Configuration

Export configuration files from inside the container to a projects directory on the local computer

docker cp CONTAINERID:/etc/nginx/conf.d/test.conf ./something/....