
* feat: update generated client to include schema-management APIs * feat: implement interfaces to decode flags and CSV * feat: implement decoders for different measurement schema column formats * feat: extend bucket CLI commands to support schema type property * feat: add CLI commands to manage measurement schema * test: add unit tests for bucket schema create, update and list commands
influx-cli
CLI for managing resources in InfluxDB v2
Status
This is a work-in-progress effort to decouple the influx
CLI from the OSS influxdb
codebase.
Our goals are to:
- Make it easier to keep the CLI up-to-date with InfluxDB Cloud API changes
- Enable faster turn-around on fixes/features that only affect the CLI
- Allow the CLI to be built & released for a wider range of platforms than the server can support
Building
Run make
to build the CLI. The output binary will be written to bin/$(GOOS)/influx
.
Regenerating OpenAPI client
We use OpenAPITools/openapi-generator
to generate
the underlying HTTP client used by the CLI. Run make openapi
to re-generate the code. You'll need Docker
running locally for the script to work.
Running
After building, use influx -h
to see the list of available commands.
Enabling Completions
The CLI supports generating completions for bash
, zsh
, and powershell
. To enable completions for a
single shell session, run one of these commands:
# For bash:
source <(influx completion bash)
# For zsh:
source <(influx completion zsh)
# For pwsh:
Invoke-Expression ((influx completion powershell) -join "`n`")
To enable completions across sessions, add the appropriate line to your shell's login profile (i.e. ~/.bash_profile
).
Testing
Run make test
to run unit tests.