Skip to content

`openebsctl` is a kubectl plugin to manage OpenEBS storage components.

License

Notifications You must be signed in to change notification settings

openebs/openebsctl

Repository files navigation

OpenEBS Logo

OpenEBSCTL

Go Report Card Contributors release License Releases FOSSA Status codecov.io

OpenEBSCTL is a kubectl plugin to manage OpenEBS storage components.

Project Status

Alpha. Under active development and seeking contributions from the community. The CLI currently supports managing LocalPV-LVM, LocalPV-ZFS and LocalPV-HostPath Engines.

Table of Contents

Installation

OpenEBSCTL is available on Linux, macOS and Windows platforms.

  • (Recommended) The latest binary can be installed via krew

    $ kubectl krew install openebs
    ...
    ...
    $ kubectl krew list
    PLUGIN    VERSION
    openebs    v0.2.0
    ...
    ...
    # to update the openebs plugin
    $ kubectl krew upgrade openebs
    ...
    ...
  • Binaries for Linux, Mac and Windows are available as tarballs and zip in the release page.

  • Or, if you don't want to setup krew, you run the following to get latest version :-

    wget https://raw.githubusercontent.com/openebs/openebsctl/develop/scripts/install-latest.sh -O - | bash

Build

  • Clone this repo to your system. git clone https://github.com/openebs/openebsctl
  • cd openebsctl
  • Run make openebsctl

Usage

  • $ kubectl openebs
    kubectl openebs is a a kubectl plugin for interacting with OpenEBS storage components such as storage(zfspools, volumegroups), volumes, pvcs.
    Find out more about OpenEBS on https://openebs.io/
    
    Usage:
    openebs [command]
    
    Available Commands:
    cluster-info Show component version, status and running components for each installed engine
    completion   Outputs shell completion code for the specified shell (bash or zsh)
    describe     Provide detailed information about an OpenEBS resource
    get          Provides fetching operations related to a Volume/Storage
    help         Help about any command
    version      Shows openebs kubectl plugin's version
    
    Flags:
    -h, --help                help for openebs
    -c, --kubeconfig string   path to config file
    -v, --version             version for openebs
    
    Use "openebs [command] --help" for more information about a command.
  • To know more about various engine specific commands check these:-

Contributing

OpenEBS welcomes your feedback and contributions in any form possible.

For more details checkout CONTRIBUTING.md.

License

FOSSA Status