Sign inSign up

rustyx/etcdv3-browser

By rustyx

•Updated 3 months ago

A simple etcd v3 browser written in Go and Vue.js.

Image
5

10K+

rustyx/etcdv3-browser repository overview

⁠etcdv3-browser

A simple etcd (v3) web-based browser.

etcd browser

Main features:

  • Hierarchical display
  • Real-time updates - when something changes in ETCD, the web UI is automatically updated
  • Editing ETCD contents (if enabled)

⁠Running

The application is designed to be run in Docker.

For example, the following starts etcd and etcdv3-browser in Docker:

docker network create my_net
docker run -d --name etcd -p 2379:2379 --net my_net quay.io/coreos/etcd:v3.6.7 /usr/local/bin/etcd --listen-client-urls http://0.0.0.0:2379 --advertise-client-urls=http://127.0.0.1:2379
docker run -d --name etcdv3-browser --net my_net -p 8081:8081 -e HTTP_PORT=8081 -e ETCD=etcd:2379 -e EDITABLE=1 rustyx/etcdv3-browser

Open http://localhost:8081⁠

If port 8081 is occupied, change all instances of 8081 above to some other port.

⁠Configuration

Environment variables:

variabledescriptiondefault
HTTP_PORTlisten port8081
ETCDetcd endpointetcd:2379
CORSallowed originshttp://localhost:*
EDITABLEset to 1 to enable edit functionality0
PREFIXonly browse keys under a given prefix
USERNAMEoptionally send a username to etcd
PASSWORDoptionally send a password to etcd

⁠Development environment

Initial setup: install Go 1.22+, Node.js 22+.

⁠Backend
cd backend
go build
./etcdv3-browser
⁠Frontend
cd frontend
npm run serve
⁠Running unit tests
cd backend
go test ./...
cd frontend
npm run test:unit
⁠Lints and code quality checks
cd frontend
npm run lint
⁠Building a Docker image
docker build . -t rustyx/etcdv3-browser

Tag summary

Content type

Image

Digest

sha256:3ec011689…

Size

12.1 MB

Last updated

3 months ago

docker pull rustyx/etcdv3-browser