https://github.com/nginx/docker-extension

https://github.com/nginx/docker-extension

Last synced: about 21 hours ago
JSON representation

• Host: GitHub
• URL: https://github.com/nginx/docker-extension
• Owner: nginx
• License: apache-2.0
• Created: 2023-03-13T16:28:34.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-02-22T19:08:13.000Z (7 months ago)
• Last Synced: 2024-09-19T06:37:47.182Z (6 days ago)
• Language: TypeScript
• Size: 445 KB
• Stars: 22
• Watchers: 5
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# NGINX Docker Desktop Extension

![NGINX Docker Extension Instance Screen](docs/NGINX-dd-extension.png)

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.

```shell

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

```

To install the extension

```shell

docker extension install nginx/nginx-dd-extension

```

To remove the extension

```shell

docker remove nginx/nginx-dd-extension

```

## Release

```shell

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.

```shell

npm install

npm run dev

```

2. enable debugging for the NGINX Docker Extension.

```shell

docker extension dev debug nginx/nginx-dd-extension 

```

```shell

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](https://community.nginx.org/joinslack).

- Get involved with the project by contributing! See the

  [contributing guide](CONTRIBUTING.md) for details.

- For security issues, [email us]([email protected]), mentioning

  NGINX Unit in the subject and following the [CVSS

  v3.1](https://www.first.org/cvss/v3.1/specification-document) spec.

## Backlog

### Re-Expose new Ports

```shell

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

```shell

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

```