mirror of
https://codeberg.org/scip/esctl.git
synced 2026-08-24 11:04:18 +02:00
153 lines
2.9 KiB
Markdown
153 lines
2.9 KiB
Markdown
[](https://ci.codeberg.org/repos/16999)
|
|
|
|
# esctl
|
|
|
|
Elasticsearch CLI
|
|
|
|
## Usage
|
|
|
|
Command tree:
|
|
|
|
```console
|
|
ccr
|
|
follower
|
|
add
|
|
delete
|
|
pause
|
|
renew
|
|
resume
|
|
show
|
|
unfollow
|
|
info
|
|
pause
|
|
resume
|
|
status
|
|
cluster
|
|
list
|
|
settings
|
|
list
|
|
set
|
|
status
|
|
doc
|
|
add
|
|
help
|
|
index
|
|
alias
|
|
create
|
|
delete
|
|
list
|
|
allocation
|
|
close
|
|
create
|
|
delete
|
|
list
|
|
modify
|
|
show
|
|
node
|
|
list
|
|
show
|
|
repl
|
|
search
|
|
shard
|
|
list
|
|
show
|
|
snapshot
|
|
list
|
|
show
|
|
version
|
|
```
|
|
|
|
Configure `esctl` with environment variables:
|
|
|
|
- `ES_URI`: elasticsearch uri
|
|
- `ES_USER`: username
|
|
- `ES_PASS`: password
|
|
|
|
Or create a config file such as this:
|
|
|
|
```yaml
|
|
clusters:
|
|
default:
|
|
uri: https://es.foo.bar:9200/
|
|
user: elastic
|
|
pass: 123456
|
|
other:
|
|
uri: https://myes.foo:9200/
|
|
user: elastic
|
|
pass: asdasdasd
|
|
```
|
|
|
|
and specify it with `-c configfile`. You may also put clusters into a
|
|
default config file in `~/.config/esctl/config.yaml`. In this case you
|
|
can omit `-c ...`.
|
|
|
|
If you want to work on a specific cluster, specify its name with the
|
|
global `-C` option.
|
|
|
|
## Introduction
|
|
|
|
FIXME
|
|
|
|
## Installation
|
|
|
|
The tool does not have any dependencies. Just download the binary for
|
|
your platform from the releases page and you're good to go.
|
|
|
|
### Installation using a pre-compiled binary
|
|
|
|
You can use [stew](https://github.com/marwanhawari/stew) to install esctl:
|
|
```default
|
|
stew install https://codeberg.org/scip/esctl
|
|
```
|
|
|
|
Or go to the [latest release page](https://codeberg.org/scip/esctl/releases/)
|
|
and look for your OS and platform. There are two options to install the binary:
|
|
|
|
Directly download the binary for your platform,
|
|
e.g. `esctl-linux-amd64-0.0.2`, rename it to `esctl` (or whatever
|
|
you like more!) and put it into your bin dir (e.g. `$HOME/bin` or as
|
|
root to `/usr/local/bin`).
|
|
|
|
Be sure to verify the signature of the binary file. For this also
|
|
download the matching `esctl-linux-amd64-0.0.2.sha256` file and:
|
|
|
|
```shell
|
|
cat esctl-linux-amd64-0.0.2.sha25 && sha256sum esctl-linux-amd64-0.0.2
|
|
```
|
|
You should see the same SHA256 hash.
|
|
|
|
You may also download a binary tarball for your platform, e.g.
|
|
`esctl-linux-amd64-0.0.2.tar.gz`, unpack and install it. GNU Make is
|
|
required for this:
|
|
|
|
```shell
|
|
tar xvfz esctl-linux-amd64-0.0.2.tar.gz
|
|
cd esctl-linux-amd64-0.0.2
|
|
sudo make install
|
|
```
|
|
|
|
### Installation from source
|
|
|
|
Check out the repository and execute `go build`, then copy the
|
|
compiled binary to your `$PATH`.
|
|
|
|
Or, if you have GNU Make installed, just execute:
|
|
|
|
```default
|
|
make
|
|
sudo make install
|
|
```
|
|
|
|
# Report bugs
|
|
|
|
[Please open an issue](https://codeberg.org/scip/esctl/issues). Thanks!
|
|
|
|
# License
|
|
|
|
This work is licensed under the terms of the General Public Licens
|
|
version 3.
|
|
|
|
# Author
|
|
|
|
Copyleft (c) 2026 Thomas von Dein
|