This repository contain Conduktor CLI source code. Conduktor CLI is a command line tool to interact with Conduktor Console. It is strongly inspired by Kubernetes kubectl CLI tool and reuse some of it's concepts.
Look for assets of the last release at https://github.com/conduktor/ctl/releases
How to get the latest docker image:
docker pull conduktor/conduktor-ctl:latest
You will need Go 1.22+ installed and configured on your machine.
To build simply run
go build -o conduktor .
You will find the conduktor
binary at the root of the project.
To run the CLI you will need to provide the Conduktor Console URL and an API access token.
To use Conduktor CLI, you need to define 2 environment variables:
- The URL of Conduktor Console
- Your API token (either a User Token or Application Token). You can generate an API token on
/settings/public-api-keys
page of your Console instance.
CDK_BASE_URL=http://localhost:8080
CDK_TOKEN=<admin-token>
Usage:
conduktor [command]
Available Commands:
apply Upsert a resource on Conduktor
completion Generate the autocompletion script for the specified shell
delete Delete resource of a given kind and name
get Get resource of a given kind
help Help about any command
version Display the version of conduktor
Flags:
-h, --help Help for conduktor
-v, --verbose Show more information for debugging
You can find more usage details on our documentation
If you are using Conduktor behind a teleport proxy, you will need to provide the certificate and key to the CLI using CDK_CERT
and CDK_KEY
environment variables.
First login to your teleport proxy, for example:
tsh login --proxy="$TELEPORT_SERVER" --auth="$TELEPORT_AUTH_METHOD"
tsh apps login console
export CDK_CERT=$(tsh apps config --format=cert)
export CDK_KEY=$(tsh apps config --format=key)
conduktor get application
How to run:
read CDK_TOKEN
export CDK_TOKEN
export CDK_BASE_URL=http://localhost:8080
go run .
How to run unit test:
go test ./...
How to run integration test:
./test_final_exec.sh
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.