etcdmanager

A cross-platform GUI for ETCD


Project maintained by icellmobilsoft Hosted on GitHub Pages — Theme by mattgraham

ETCD Manager

etcd-manager

Alt text

Alt text

Alt text

This is a free, cross-platform ETCD v3 client and GUI. The goal of the project is twofold:

Please note that currently ETCD V2 API is not supported! At the moment, we support V3 only.

Features

Available now (v1.1)

Currently, the following features are implemented:

Coming soon (v1.15)

This next release is mainly for contributors. There will be no new features in this one, instead we gonna focus solely on making it easier to understand how the code works and how to get started with contributing. In order to achieve this, we’ll refactor many parts of the code and we’ll also try to provide better documentation for contributors and a project dashboard.

As for refactoring, some of the things we gonna change are:

Planned

We plan to add tons of cool features in the future. The most important ones are listed below.:

Features

Future platforms

A better organized overview of these plans will be available soon. Stay tuned :)

Installation

End users..

The current stable (prod) version is 1.1. It’s available for Mac OS X (Mojave+), MS Windows (7, 8, 10+) and some major Linux distros (Ubuntu 10.04+, Arch etc). The following are pre-built binaries and they are the recommended way to install.

If you are using a more or less recent major Linux distro (Ubuntu, Redhat, Suse etc), or Ubuntu LTS or some up-to-date rolling release distro like Arch, everything should work fine. Most older Linux systems should be supported as well. However, very old Linux versions might not work as expected. If you have difficulties installing the app, please report the problem in our issue tracker.

Grab one now:

Other packages are available for download as well, please see the releases page.

We are on SnapCraft!

Get it from the Snap Store

Install snap and run the following command:

snap install etcd-manager

Contributors..

You may install the dev version by cloning this repository.

git clone https://github.com/icellmobilsoft/etcdmanager.git

Or you may also install the NPM package (although this is not recommended, since the package might not contain the latest code).

yarn add etcd-manager
cd node_modules/etcd-manager

Please also check out the contribution guide before writing any code.

Running the dev build

Once you have the code, simply execute the following commands:

yarn install

The next step is to compile the GRPC Node extension. This requires the usual build tools (gcc, make etc) to be installed. Make sure you have these, then run:

npm rebuild --target=ELECTRON_VERSION --runtime=electron --dist-url=https://atom.io/download/electron

… where ELECTRON_VERSION is the exact version number of the Electron framework the app uses. You can determine this by running:

yarn list electron

Finally, start the dev server in the following way:

yarn electron:serve

This will start a dev build, and the app should appear shortly.

Usage and support

First of all, in order to work properly, ETCD Manager must be configured.

You need to provide only two mandatory settings: the host and the port ETCD is running at. You’ll find these on the settings screen, under the ETCD tab. If your ETCD host requires authentication, you will also need to provide a password / username pair, which you can do under the auth tab. Please note that (for now), you have to enable ETCD authentication manually (e.g.: via etcdctl). We gonna add GUI for this in the future. There are several additional configuration options, but those are all optional.

Detailed documentation is not available (yet), but you may want to activate quick help, which is available everywhere. Press CTRL / CMD + H to open the help pane. Here you’ll find some basic info as well as all the keyboard shortcuts. This should be enough to get you started.

If you still need help, please feel free to contact us. Open an issue (question / support request).

Once the documentation is ready, we’ll upload it to the website.

Upgrading

If you’ve installed the app using the Windows or Mac installer or the Linux AppImage, you’ll be notified automatically whenever a new release is available. Simply restart the app, and it’ll check for updates.

Otherwise, you have to download and install the new version manually.

As for the dev version, you may update that by the usual means (Yarn or Git). In any case, please read our changelog for an overview of the most recent changes.

Bugs and feature requests

If you find a bug, please report it using our issue tracker.

This is also the place for requesting new features or asking questions. Please label your issue appropriately, use the “bug”, “enchantment” and “question” labels, respectively.